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
More from victoriametrics/skills
victoriametrics-query
>
98victorialogs-query
>
88investigating-with-observability
Use when investigating issues, debugging problems for applications, or responding to alerts in the Kubernetes cluster using VictoriaMetrics, VictoriaLogs, or VictoriaTraces.
84victoriametrics-cardinality-analysis
>
80victoriametrics-unused-metrics-analysis
>
76alertmanager-query
>
72