DocsSelf-hostingMonitoring

Kvasyr exposes Prometheus metrics at /metrics.

For a full ready-to-import monitoring setup, use the files in the repository:

  • monitoring/prometheus/prometheus.yml
  • monitoring/prometheus/kvasyr-scrape.job.yml
  • monitoring/grafana/kvasyr-dashboard.json

Metrics Access

Recommended runtime env:

METRICS_PUBLIC=false
METRICS_ALLOW_IPS=127.0.0.1/32
METRICS_BEARER_TOKEN=<strong-random-token>
METRICS_HIGH_CARDINALITY=true

Use METRICS_HIGH_CARDINALITY=true when you want per-user and per-contract panels.

Prometheus

Use monitoring/prometheus/prometheus.yml directly, or merge monitoring/prometheus/kvasyr-scrape.job.yml into your existing Prometheus config.

Grafana

Import monitoring/grafana/kvasyr-dashboard.json and select your Prometheus datasource when prompted.

The dashboard includes all kvasyr_* metrics:

  • Chain progress, indexed/finalized lag, finality depth.
  • RPC health, throughput, latency, and endpoint status.
  • Webhook queue/attempt/sent performance and latency.
  • Delivery pressure, skips, and getLogs diagnostics.
  • Credits, events, matches, and high-cardinality breakdowns.
APIChangelog