skills.rest
VictoriaMetrics
VictoriaMetricsOFFICIAL
Explore all skills by this author →
Website𝕏@VictoriaMetricsGitHub

vm-trace-analyzer

Analyze VictoriaMetrics query traces to identify bottlenecks and generate structured performance reports.

45|4|Updated Mar 4, 2026
Search Tags:#trace-analysis#bottleneck-analysis#performance-diagnosis#victoria-metrics#vmtrace#rpc-breakdown
One-click install
npx skills add https://github.com/VictoriaMetrics/skills --skill vm-trace-analyzer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: vm-trace-analyzer
Source: https://github.com/VictoriaMetrics/skills/tree/main/plugins/diagnostics/skills/vm-trace-analyzer
Command: npx skills add https://github.com/VictoriaMetrics/skills --skill vm-trace-analyzer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates analysis of VictoriaMetrics query traces to diagnose slow queries and generate structured performance reports.

Core Features & Use Cases

  • Trace parsing and profiling: extract durations, per-node breakdowns, and bottlenecks from trace JSON.
  • Bottleneck identification: highlight the dominant phase and provide concrete explanations to guide optimization.
  • Report generation: produce a comprehensive evaluation with a clear Recommendations section and upgrade notes for cluster and single-node modes.

Quick Start

Run the trace JSON through the analysis workflow to generate a structured performance report.

Frequently Asked Questions about vm-trace-analyzer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose slow VictoriaMetrics queries using trace JSON?▼

Analyzing trace JSON identifies performance bottlenecks in slow VictoriaMetrics queries by extracting durations and per-node RPC breakdowns. This produces a structured report highlighting dominant phases to guide query optimization.

What does per-node RPC breakdown reveal during VictoriaMetrics trace analysis?▼

Per-node RPC breakdown reveals data-transfer metrics and execution durations across cluster nodes during VictoriaMetrics trace analysis. It highlights the dominant bottleneck phase, providing concrete explanations to guide performance optimization.

Can I analyze traces for both single-node and cluster VictoriaMetrics deployments?▼

Yes, trace analysis applies to both single-node and cluster VictoriaMetrics deployments. The parsing workflow processes trace JSON trees from either mode to output a clear breakdown and bottleneck analysis.

How do I get actionable recommendations from a VictoriaMetrics trace JSON file?▼

Running the trace JSON through the analysis workflow generates a structured performance report containing a clear Recommendations section and upgrade notes for query optimization. This provides actionable steps to resolve bottlenecks.

What is the best way to identify the dominant bottleneck in a VM trace?▼

Parsing the trace JSON tree to evaluate per-node durations is the best way to identify the dominant bottleneck in a VM trace. This isolates the slowest phase and generates a structured performance diagnosis.

Related Skills

Explore More Software Engineering Skills→
macgregormacgregor
10

homelab-investigator

Correlate VictoriaMetrics metrics and VictoriaLogs logs to assess homelab infrastructure health.

Community
Intermediate
Tnemo65Tnemo65

database-optimizer

Analyze slow queries and execution plans to optimize database performance.

Community
Advanced
ROCmROCm
26

open-database

Loads Omnistat telemetry data into VictoriaMetrics for querying and visualization.

Official
Intermediate
JochenYangJochenYang
21

performance-optimizer

Identify performance bottlenecks and optimize application speed across backend, database, and frontend workflows.

Community
Intermediate