victoriametrics-query

Query VictoriaMetrics HTTP endpoints for MetricsQL/PromQL results, labels, alerts, and diagnostics.

45|4|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/VictoriaMetrics/skills --skill victoriametrics-query
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: victoriametrics-query
Source: https://github.com/VictoriaMetrics/skills/tree/main/plugins/query/skills/victoriametrics-query
Command: npx skills add https://github.com/VictoriaMetrics/skills --skill victoriametrics-query

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Query VictoriaMetrics data via HTTP to retrieve metrics, labels, alerts, and diagnostics from VictoriaMetrics directly over HTTP, enabling fast troubleshooting and monitoring workflows.

Core Features & Use Cases

  • Instant and range queries against VictoriaMetrics endpoints
  • Labels and series discovery to map metrics to services
  • Retrieve active alerts, rules, and status information for incident response
  • Export raw data for analysis and reporting

Quick Start

Run a quick query to validate connectivity and fetch the metric up from your VictoriaMetrics endpoint.

Frequently Asked Questions about victoriametrics-query

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

FAQPage Schema
How do I query VictoriaMetrics data via HTTP to retrieve PromQL results?

Query VictoriaMetrics data via HTTP using endpoints like /api/v1/query for instant queries and /api/v1/query_range for range queries. This retrieves MetricsQL and PromQL results directly for on-demand metric analysis and troubleshooting.

Can I retrieve active alerts and rules from VictoriaMetrics endpoints?

Retrieve active alerts and rules from VictoriaMetrics by querying the /api/v1/alerts and /api/v1/rules HTTP endpoints. This provides immediate visibility into alert states and rule configurations for incident response workflows.

What's the best way to discover labels and series in VictoriaMetrics for service mapping?

Discover labels and series in VictoriaMetrics by calling the /api/v1/labels and /api/v1/series HTTP endpoints. This maps available metrics to their corresponding services for comprehensive observability and monitoring.

Does this VictoriaMetrics query approach support exporting raw metric data?

Export raw VictoriaMetrics metric data via the /api/v1/export HTTP endpoint. This enables export-ready data retrieval for offline analysis, reporting, and comprehensive diagnostics across your TSDB.

How do I check VictoriaMetrics TSDB status and diagnostics?

Check VictoriaMetrics TSDB status and diagnostics by querying the /api/v1/status HTTP endpoint. This provides service health checks and internal database status information for troubleshooting workflows.

Does MetricsQL work with VictoriaMetrics HTTP API queries?

MetricsQL works with VictoriaMetrics HTTP API queries alongside standard PromQL. Submitting queries to /api/v1/query or /api/v1/query_range evaluates MetricsQL expressions to return instant and range metric results.