Monitoring

Prometheus Metrics

curl http://localhost:6480/metrics

70+ system metrics: per-engine, per-core, connection, query, replication, and storage. Latency histogram with 13 buckets.

PromQL Engine

Full Prometheus query engine at /obsv/api. Point Grafana at this URL as a Prometheus data source. Supports all Tier 1+2+3 functions (rate, irate, delta, histogram_quantile, holt_winters, etc.).

Prometheus Remote Write/Read

Use NodeDB as a long-term Prometheus storage backend:

remote_write:
  - url: "http://nodedb:6480/obsv/api/v1/write"
remote_read:
  - url: "http://nodedb:6480/obsv/api/v1/read"

OpenTelemetry

• OTLP ingest — Metrics, traces, and logs via HTTP (4318) and gRPC (4317)
• OTLP export — Push NodeDB's own traces/metrics to any OTLP collector

Feature-gated: --features otel, --features promql, --features monitoring.

Health Checks

curl http://localhost:6480/health        # basic health
curl http://localhost:6480/health/ready   # WAL recovered, ready for queries

Key Metrics