docs: Dashboards, config migration, container image sign - #7784
Open
knylander-grafana wants to merge 1 commit into
Open
docs: Dashboards, config migration, container image sign#7784knylander-grafana wants to merge 1 commit into
knylander-grafana wants to merge 1 commit into
Conversation
knylander-grafana
requested review from
electron0zero,
mapno,
mdisibio,
yvrhdn and
zalegrala
as code owners
August 18, 2026 01:34
knylander-grafana
requested review from
carles-grafana,
ie-pham,
javiermolinar,
mattdurham,
ruslan-mikhailov and
stoewer
as code owners
August 18, 2026 01:34
Contributor
There was a problem hiding this comment.
Pull request overview
Updates Tempo’s operational documentation to reflect Tempo 3.1-era behavior and observability additions, covering query/frontend behavior, querier metrics, ring self-healing, dashboards, and container image verification.
Changes:
- Document distributor ring auto-forget behavior and updated operational guidance in the mixin runbook.
- Add/adjust docs for Trace-by-ID sharding behavior, TraceQL metrics “span-only fetch” defaults/overrides, and a key querier backend-processing metric.
- Add a new guide for verifying signed Tempo container images and update monitoring docs for new dashboards.
Reviewed changes
Copilot reviewed 7 out of 7 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| operations/tempo-mixin/runbook.md | Updates the TempoDistributorUnhealthy runbook to reflect auto-forget behavior and when manual “Forget” may still be needed. |
| docs/sources/tempo/set-up-for-tracing/setup-tempo/upgrade.md | Adds upgrade note describing Trace-by-ID sharding via blocks_per_shard and fallback behavior. |
| docs/sources/tempo/reference-tempo-architecture/components/querier.md | Documents the tempo_querier_backend_processing_duration_seconds metric and its intended use. |
| docs/sources/tempo/operations/verify-container-images.md | New page describing how to verify cosign signatures and SLSA provenance attestations for Tempo images. |
| docs/sources/tempo/operations/monitor/_index.md | Updates dashboard count and adds entries for Service Graph and Livestore dashboards. |
| docs/sources/tempo/metrics-from-traces/metrics-queries/_index.md | Updates TraceQL metrics query docs to describe the faster read path default and opt-out mechanisms. |
| docs/sources/tempo/configuration/_index.md | Updates override docs to reflect metrics_spanonly_fetch defaulting to enabled and how to opt out. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
…sign Signed-off-by: Kim Nylander <kim.nylander@grafana.com>
knylander-grafana
force-pushed
the
3.1-docs-ops-doc-updates
branch
from
August 18, 2026 01:40
e464fc5 to
9291782
Compare
Contributor
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 4 out of 4 changed files in this pull request and generated no new comments.
Suppressed comments (1)
docs/sources/tempo/operations/monitor/_index.md:55
- MEDIUM — The text/link here says the dashboards can be downloaded from
operations/tempo-mixin/dashboards, but that directory contains Jsonnet sources (*.libsonnet) and is missing some of the referenced JSON outputs (for exampletempo-livestore.json). The downloadable JSON dashboards live underoperations/tempo-mixin-compiled/dashboards/(10 files). Could we update this sentence/link to point at the compiled dashboards directory (or clarify thattempo-mixinis the source and the JSON comes from the compiled mixin)?
The [Tempo mixin](https://github.com/grafana/tempo/tree/main/operations/tempo-mixin) has ten Grafana dashboards in the `dashboards` folder that you can download and import into your Grafana UI.
These dashboards work well when you run Tempo in a Kubernetes (k8s) environment and metrics scraped have the
mattdurham
approved these changes
Aug 18, 2026
mattdurham
left a comment
Contributor
There was a problem hiding this comment.
The section on signing looks good
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this PR does:
Updates documentation for two new dashboards, a breaking config migration, an automated ring-cleanup behavior change, and container image signing/verification.
Original PRs documented:
Which issue(s) this PR fixes:
Fixes #
Checklist
.chloggen/(runmake chlog-new, ormake chlog-new FILENAME=<name>to override the default branch-name file; see.chloggen/README.md)