#Monitoring Dashboards

This directory contains monitoring dashboard configurations for vLLM, providing comprehensive observability for your vLLM deployments.

#Dashboard Platforms

We provide dashboards for two popular observability platforms:

• Grafana
• Perses

#Dashboard Format Approach

All dashboards are provided in native formats that work across different deployment methods:

#Grafana (JSON)

• ✅ Works with any Grafana instance (cloud, self-hosted, Docker)
• ✅ Direct import via Grafana UI or API
• ✅ Can be wrapped in Kubernetes operators when needed
• ✅ No vendor lock-in or deployment dependencies

#Perses (YAML)

• ✅ Works with standalone Perses instances
• ✅ Compatible with Perses API and CLI
• ✅ Supports Dashboard-as-Code workflows
• ✅ Can be wrapped in Kubernetes operators when needed

#Dashboard Contents

Both platforms provide equivalent monitoring capabilities:

#Quick Start

First, navigate to this example's directory:

cd examples/observability/dashboards

#Grafana

Import the JSON directly into the Grafana UI, or use the API:

curl -X POST http://grafana/api/dashboards/db \
  -H "Content-Type: application/json" \
  -d @grafana/performance_statistics.json

#Perses

Import via the Perses CLI:

percli apply -f perses/performance_statistics.yaml

#Requirements

• Prometheus metrics from your vLLM deployment
• Data source configured in your monitoring platform
• vLLM metrics enabled and accessible

#Platform-Specific Documentation

For detailed deployment instructions and platform-specific options, see:

• Grafana Documentation - JSON dashboards, operator usage, manual import
• Perses Documentation - YAML specs, CLI usage, operator wrapping

#Contributing

When adding new dashboards, please:

1. Provide native formats (JSON for Grafana, YAML specs for Perses)
2. Update platform-specific README files
3. Ensure dashboards work across deployment methods
4. Test with the latest platform versions