← Back to Docs
Recipe

Grafana Dashboards

Ship production-ready Grafana dashboards for Nimbus telemetry — latency, license checks, and system health.

Overview

Nimbus emits structured metrics to Prometheus via a lightweight sidecar. This recipe covers three core dashboards: License API latency, active session counts, and loader integrity checks. All panels use Grafana 10+ with the native Prometheus data source.

Prerequisites

  • Grafana 10.x or later, connected to Prometheus
  • Nimbus telemetry sidecar running on port 9091
  • Prometheus scrape config targeting the sidecar

Dashboard 1 — License API

Track p50/p95/p99 latency for KeyAuth license validation calls. Add a stat panel for error rate and a time-series panel for request volume. Use rate(nimbus_license_checks_total[5m]) for throughput and histogram_quantile(0.99, rate(nimbus_license_latency_bucket[5m])) for tail latency.

Dashboard 2 — Active Sessions

Gauge panel showing current active Nimbus loader sessions. Add a bar gauge for sessions by region using the nimbus_sessions_active metric with region labels. Set alert thresholds at 80% of license cap.

Dashboard 3 — Loader Health

Monitor self-hash integrity failures and anti-debug triggers. Use a stat panel for nimbus_integrity_failures_total and a time-series for tamper events over time. Red threshold at any non-zero value.

JSON Import

Download the pre-built dashboard JSON from the Nimbus admin panel under Telemetry → Export. Import via Grafana's "Import dashboard" dialog. All panels are templated with $datasource for easy Prometheus selection.

Need help wiring Prometheus? See the Telemetry Sidecar recipe.