feat(tempo): add host.name resource dimension to span metrics (HOMELAB-1103) #227

Merged

aaron merged 2 commits from plane/HOMELAB-1103-tempo-host-filtering into live

2026-06-12 02:38:19 +00:00

aaron commented

2026-06-12 02:21:21 +00:00

Owner

What

Adds host.name as a Prometheus metric dimension and Grafana dashboard filter:

Phase 2: Tempo config

Overrides the chart's default config template to inject metrics_generator.processor.span_metrics.resource_dimensions: [host.name]
The override is needed because chart 1.14.0 doesn't expose processor config natively
Can be removed if upgrading to chart >= 1.24.2 (which supports metricsGenerator.processor natively)

Phase 3: Grafana dashboards

Adds host_name query variable to all 4 pi-telemetry dashboards
Updates all PromQL panel queries to include host_name=~"$host_name" filter
Default is "All" (backward-compatible via includeAll)

Dashboards updated

pi-sessions — 8 queries updated
pi-tools — 6 queries updated
pi-llm-performance — 6 queries updated
agent-telemetry — 6 queries updated

Verify

After merge and ArgoCD sync:

Tempo pods restart and pick up new config
traces_spanmetrics_calls_total{host_name="MacBook-Pro.local"} appears in Prometheus
traces_spanmetrics_calls_total{host_name="mgmt"} appears in Prometheus
Grafana dashboards load correctly with "Host" variable populated
Selecting "All" shows traces from both machines
Selecting a specific host filters panels to that machine

Closes HOMELAB-1103

## What Adds `host.name` as a Prometheus metric dimension and Grafana dashboard filter: ### Phase 2: Tempo config - Overrides the chart's default `config` template to inject `metrics_generator.processor.span_metrics.resource_dimensions: [host.name]` - The override is needed because chart 1.14.0 doesn't expose `processor` config natively - Can be removed if upgrading to chart >= 1.24.2 (which supports `metricsGenerator.processor` natively) ### Phase 3: Grafana dashboards - Adds `host_name` query variable to all 4 pi-telemetry dashboards - Updates all PromQL panel queries to include `host_name=~"$host_name"` filter - Default is "All" (backward-compatible via `includeAll`) ### Dashboards updated - `pi-sessions` — 8 queries updated - `pi-tools` — 6 queries updated - `pi-llm-performance` — 6 queries updated - `agent-telemetry` — 6 queries updated ## Verify After merge and ArgoCD sync: - [ ] Tempo pods restart and pick up new config - [ ] `traces_spanmetrics_calls_total{host_name="MacBook-Pro.local"}` appears in Prometheus - [ ] `traces_spanmetrics_calls_total{host_name="mgmt"}` appears in Prometheus - [ ] Grafana dashboards load correctly with "Host" variable populated - [ ] Selecting "All" shows traces from both machines - [ ] Selecting a specific host filters panels to that machine Closes HOMELAB-1103

aaron added 1 commit

2026-06-12 02:21:21 +00:00

feat(tempo): add host.name resource dimension to span metrics (HOMELAB-1103)

CI Review / pr-title (pull_request) Waiting to run

Details

CI Review / helm-validate (pull_request) Waiting to run

Details

CI Review / ai-review (pull_request) Waiting to run

Details

Lint & Validate / terraform-validate (pull_request) Waiting to run

Details

Lint & Validate / yaml-lint (pull_request) Waiting to run

Details

Lint & Validate / shellcheck (pull_request) Waiting to run

Details

0/0 projects applied successfully.

ac7251acb4

Phase 2: Override Tempo chart config template to add
metrics_generator.processor.span_metrics.resource_dimensions: [host.name]
so Prometheus metrics include host_name labels.

Phase 3: Add host_name dashboard variable and filter to all pi-telemetry
Grafana dashboards (pi-sessions, pi-tools, pi-llm-performance,
agent-telemetry). All PromQL panel queries now include
host_name=~"\" filter, backward-compatible with "All" default.

aaron added 1 commit

2026-06-12 02:38:07 +00:00

Merge branch 'live' into plane/HOMELAB-1103-tempo-host-filtering

Lint & Validate / shellcheck (pull_request) Has been cancelled

Details

CI Review / pr-title (pull_request) Has been cancelled

Details

CI Review / helm-validate (pull_request) Has been cancelled

Details

CI Review / ai-review (pull_request) Has been cancelled

Details

Lint & Validate / terraform-validate (pull_request) Has been cancelled