Skip to main content

Module telemetry

Module telemetry 

Source
Expand description

Lock-free per-core telemetry buffer.

Data Plane cores MUST NOT serve HTTP endpoints or accept Prometheus scrapes. Instead, each core writes metric samples into a lock-free ring buffer. The Control Plane (Tokio) reads these buffers and serves aggregated metrics.

This ensures observability never introduces jitter on the Data Plane.

§Design

  • One TelemetryRing per Data Plane core.
  • Producer: the Data Plane core (single writer, no contention).
  • Consumer: the Control Plane metrics exporter (periodic drain).
  • Overflow policy: drop oldest samples (metrics are ephemeral).

Structs§

MetricSample
A single metric sample written by a Data Plane core.
TelemetryRing
Fixed-capacity ring buffer for metric samples from a single Data Plane core.

Enums§

MetricValue
Metric value types.