vllm-observability

Standardize Prometheus metrics, dashboards, and tracing guidance for vLLM deployments.

5|1|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/air-gapped/skills --skill vllm-observability
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vllm-observability
Source: https://github.com/air-gapped/skills/tree/main/.claude/skills/vllm-observability
Command: npx skills add https://github.com/air-gapped/skills --skill vllm-observability

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Observability for production vLLM deployments is challenging; operators must derive triage guidance from dispersed sources, and dashboards or raw metrics alone often mislead about latency, queue depth, and GPU saturation.

Core Features & Use Cases

  • Prometheus-based metrics surface at /metrics with vLLM-specific labels; dashboards and alerting recipes expedite incident triage; tracing guidance helps correlate traces with metrics for end-to-end debugging; and references provide best-practice guidance for DCGM, Grafana dashboards, and OTLP tracing.

Quick Start

Run the metrics smoke test against a vLLM endpoint to verify /health, /metrics, and basic observability surfaces.

Frequently Asked Questions about vllm-observability

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

FAQPage Schema
How do I monitor vLLM latency and GPU saturation in production?

To monitor vLLM latency and GPU saturation, you need standardized Prometheus metrics, PromQL templates, and Grafana dashboards. This Skill provides those observability components to surface latency, throughput, queue depth, and GPU diagnostics for production deployments.

What is the best way to set up observability for a vLLM Kubernetes deployment?

Setting up observability for a vLLM Kubernetes deployment involves standardizing metrics exposed at /metrics with vLLM-specific labels. This Skill supplies the required dashboards, alerting recipes, and tracing instructions to enable rapid incident triage and capacity planning.

Can I use Grafana and Prometheus dashboards to trace vLLM queue depth issues?

Yes, you can use Grafana and Prometheus to trace vLLM queue depth issues by correlating metrics with OpenTelemetry traces. This Skill defines concrete metric names and tracing guidance to correlate traces with metrics for end-to-end debugging.

Does this observability toolkit support on-prem clusters or only managed Kubernetes environments?

This observability toolkit supports both on-prem clusters and Kubernetes environments. It standardizes metrics and dashboards for operators and SREs running vLLM, focusing on latency and queue depth diagnostics regardless of the specific infrastructure.

Why do raw vLLM metrics mislead incident triage and how can I fix it?

Raw vLLM metrics often mislead incident triage because they lack unified alerting recipes and dashboard context. You can fix this by standardizing metrics with PromQL templates and correlating traces with metrics using the references provided in this Skill.