Skip to content

Update metrics-from-traces docs for v3.0#6644

Merged
mapno merged 4 commits intografana:3.0-docsfrom
mapno:3.0-metrics-from-traces
Mar 11, 2026
Merged

Update metrics-from-traces docs for v3.0#6644
mapno merged 4 commits intografana:3.0-docsfrom
mapno:3.0-metrics-from-traces

Conversation

@mapno
Copy link
Contributor

@mapno mapno commented Mar 10, 2026

What this PR does:

Update metrics-from-traces docs for v3.0

Which issue(s) this PR fixes:
Fixes https://github.com/grafana/tempo-squad/issues/1082

Checklist

  • Tests updated
  • Documentation added
  • CHANGELOG.md updated - the order of entries should be [CHANGE], [FEATURE], [ENHANCEMENT], [BUGFIX]

Copy link
Contributor

@javiermolinar javiermolinar left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There are more localblocks references:

[//]: # "Shared content for localblocks and metrics-generator in Azure blob storage"

The local-blocks processor must be enabled to start using metrics queries like `{ } | rate()`. If not enabled metrics queries fail with the error `localblocks processor not found`. Enabling the local-blocks processor can be done either per tenant or in all tenants.

@knylander-grafana knylander-grafana added the type/docs Improvements or additions to documentation label Mar 10, 2026
- Span metrics
- Local blocks

<p align="center"><img src="tempo-metrics-gen-overview.svg" alt="Service metrics architecture"></p>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we need to update the diagram?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's very high level, nothing changes.


<!-- Using a custom admonition because no feature flag is required. -->

{{< docs/shared source="tempo" lookup="traceql-metrics-admonition.md" version="<TEMPO_VERSION>" >}}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh! Remove this because TraceQL metrics goes GA? If so, we should search through all of the docs for this line and make sure it's deleted. We'll have to do the same for cloud docs when the time is right.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks like you did that. We'll just have to do clean up in the Cloud docs at the appropriate time.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Once we have the docs/shared line removed from the Cloud docs, we can delete the shared file (docs/sources/tempo/shared/traceql-metrics-admonition.md).

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yup!

- Configure a Tempo data source in Grafana or Grafana Cloud ([documentation](/docs/grafana/<GRAFANA_VERSION>/datasources/tempo/configure-tempo-data-source/))
- Access Grafana Cloud or Grafana version 10.4 or later

Refer to the [Metrics-generator configuration](http://grafana.com/docs/tempo/<TEMPO_VERSION>/configuration/#metrics-generator) documentation for more information about the `metrics-generator` configuration.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does this mean we won't have to have local block processor set up any where for TraceQL metrics? if so, we'll need to do a check through all of the docs for any place local blocks is mentioned.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Again, this is one of the things we'll have to check in Grafana Cloud Traces docs.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, local-blocks is completely gone. Poof!

Copy link
Contributor

@knylander-grafana knylander-grafana left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good job! Thank you for updating this!

@mapno
Copy link
Contributor Author

mapno commented Mar 11, 2026

There are more localblocks references

These are updated in 3.0-docs or reference upgrading from previous versions. I think it's correct.

@mapno mapno merged commit 4f2ae06 into grafana:3.0-docs Mar 11, 2026
22 checks passed
@mapno mapno deleted the 3.0-metrics-from-traces branch March 11, 2026 14:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

type/docs Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants