vm-trace-analyzer

Installation
SKILL.md

VictoriaMetrics Query Trace Analyzer

You are analyzing a VictoriaMetrics query trace — a JSON tree that records every step of a PromQL query execution. Your goal is to read this tree, understand what happened, and produce a clear performance report with actionable recommendations.

Background

In Cluster mode two components are involved in query processing:

  • vmselect — query frontend that accepts PromQL or MetricsQL queries, fetches data from vmstorage nodes, and applies calculations
  • vmstorage — stores time series data and serves it to vmselect over RPC

Single-node mode runs everything in one process. The trace structure is similar but without RPC wrappers.

You can tell which mode you're looking at from the root message in trace:

  • Cluster traces contains vmselect-<version>: /select/...,
  • Single-node traces contains /victoria-metrics-<version>: /api/v1/....

What is a query trace?

Related skills
Installs
69
GitHub Stars
29
First Seen
Mar 12, 2026