From 3eb1bb70a0a821e17b8fd582eb38a43adc60abfa Mon Sep 17 00:00:00 2001 From: Erich Blume Date: Thu, 5 Mar 2026 10:16:58 -0800 Subject: [PATCH] Document Tempo storage monitoring query Add PromQL query for checking Tempo storage utilization against PVC capacity using tempodb_backend_bytes_total. Co-Authored-By: Claude Opus 4.6 --- docs/reference/services/tempo.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/reference/services/tempo.md b/docs/reference/services/tempo.md index 0050714..567168a 100644 --- a/docs/reference/services/tempo.md +++ b/docs/reference/services/tempo.md @@ -46,6 +46,16 @@ Beyla auto-instruments HTTP services via eBPF kernel hooks — no code changes n **Future: SDK instrumentation** Services with OTel SDK support (e.g., Hermes) can send traces directly to the OTLP endpoint for deeper internal spans (DB queries, business logic) alongside eBPF envelope traces. +## Storage Monitoring + +Tempo exposes `tempodb_backend_bytes_total` via its `/metrics` endpoint (scraped by [[prometheus]]). To check storage utilization against the 10Gi PVC: + +```promql +tempodb_backend_bytes_total / 10737418240 * 100 +``` + +Full PVC-level monitoring (via kubelet volume stats) is not yet available — see backlog. + ## Grafana Integration - **Tempo datasource** with trace-to-log and trace-to-metrics correlation