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/....