Searching...
Try using Grot AI Grot AI for this query ->
Grafana Labs is a Leader in the 2026 Gartner® Magic Quadrant™ for Observability Platforms.
Learn more
DownloadsContact Us
Logo
  • Pricing
  • Docs
Sign inSign up
Documentation for automated readers
A curated documentation index is available at: https://grafana.com/llms.txt

A complete documentation index is available at: https://grafana.com/llms-full.txt
These indexes can help with page discovery before fetching individual documents.

This page is also available in Markdown, which may be easier for automated readers and AI tools to parse than HTML. The Markdown version is available at https://grafana.com/docs/tempo/v2.8.x/operations.md, or by sending Accept: text/markdown to https://grafana.com/docs/tempo/v2.8.x/operations/. For broader documentation discovery, the curated index is available at https://grafana.com/llms.txt and the complete index is available at https://grafana.com/llms-full.txt.

Menu

Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Documentationbreadcrumb arrow Grafana Tempobreadcrumb arrow Manage
Open source

Manage Tempo

This section provides resources for managing and tuning Tempo.

  • Tempo architecture
  • Monitor Tempo
  • Configure TraceQL metrics
  • Dedicated attribute columns
  • Tune search performance
  • Improve performance with caching
  • Manage advanced systems
  • Tempo CLI
  • Apache Parquet schema

In addition, the Tempo runbooks can help with remediating operational issues.

Was this page helpful?

Suggest an edit in GitHub
Create a GitHub issue
Email docs@grafana.com
Help and support
Community

Related resources from Grafana Labs

Additional helpful documentation, links, and articles:
video icon
Video
Getting started with tracing and Grafana Tempo
Getting started with tracing and Grafana Tempo
In this webinar, we'll show you how to get started setting up Grafana Tempo, our open source, easy-to-use and high-volume distributed tracing backend.
video icon
Video
Scaling your distributed tracing with Grafana Tempo
Scaling your distributed tracing with Grafana Tempo
In this demo, we’ll show how Grafana Tempo allows you to scale tracing as far as possible with less operational cost and complexity than ever before.
video icon
Video
How Grafana and Tempo 2.0 make it easier to explore distributed traces
How Grafana and Tempo 2.0 make it easier to explore distributed traces
Learn best practices for operating Grafana Tempo and tips and tricks to find and visualize "needle in the haystack" traces with TraceQL.
Technical documentation Plugin catalog
Choose a product
Viewing: v2.8.x Find another version
  • Grafana Tempo
  • Release notes
    • V2.8
    • V2.7
    • V2.6
    • V2.5
    • V2.4
    • V2.3
    • V2.2
    • V2.1
    • V2.0
    • V1.5
    • V1.4
    • V1.3
    • V1.2
  • Introduction
    • Trace structure
    • Traces and telemetry
    • Solutions with traces
      • Identify bottlenecks and establish SLOs
      • Diagnose errors with traces
    • Glossary
  • Get started
    • Best practices
    • Instrument for tracing
    • Example setups
    • Tracing in Grafana
    • Quick start for Tempo
    • Metrics from traces
  • Set up
    • Plan your deployment
    • Size the cluster
    • Upgrade
    • Deploy with Helm
    • Deploy with operator
      • Quickstart
      • Object storage
      • Enable multi-tenancy
      • Monitor
      • Grafana data source
      • Monolithic deployment
      • Reference
    • Deploy on Linux
    • Deploy on Kubernetes with Tanka
    • Set up a test application for a Tempo cluster
    • Command line flags
  • Configure
    • Manifest
    • Compression and encoding
    • Apache Parquet
    • Hosted storage
      • Amazon S3
      • Azure blob storage
      • Google Cloud Storage
    • Network options
      • Configure IPv6
      • Configure TLS
      • Configure sidecar proxies
    • Grafana Alloy
      • Migrate to Alloy
      • Automatic logging
      • Enable service graphs
      • Generate metrics from spans
      • Sampling
        • Tail sampling policies and strategies
        • Enable tail sampling
    • Grafana Agent
      • Automatic logging
      • Enable service graphs
      • Generate metrics from spans
      • Tail-based sampling
    • Polling
    • Usage tracker
    • Use tracing data in Grafana
    • Anonymous usage reporting
  • Manage
    • Tempo architecture
    • Monitor Tempo
      • Set up monitoring
      • Use polling to monitor backend status
    • Configure TraceQL metrics
    • Dedicated attribute columns
    • Tune search performance
    • Improve performance with caching
    • Manage advanced systems
      • Enable multi-tenancy
      • Cross-tenant query
      • Configure Tempo overrides through the user-configurable overrides API
      • Generic forwarding
      • Tune the consistent hash rings
      • Zone-aware ingesters
    • Tempo CLI
    • Parquet schema
  • Metrics-generator
    • Active series
    • Cardinality
    • Span metrics
    • Service graphs
      • Enable service graphs
      • Create custom service graphs
      • Estimate cardinality
      • Metrics queries
    • Service graph view
    • Multitenancy support
  • TraceQL
    • Construct a query
    • Write TraceQL queries in Grafana
    • TraceQL metrics queries
      • Use cases
      • TraceQL metrics functions
    • Trace structure and TraceQL
  • Troubleshoot
    • Sending traces
      • Distributor refusing spans
      • Grafana Alloy
    • Querying
      • Unable to find traces
      • Too many jobs in the queue
      • Bad blocks
      • Tag search
      • Response larger than the max
      • Long-running traces
    • Metrics-generator
    • Out-of-memory errors
  • API
    • Metrics summary API
    • Push spans with HTTP
  • Community
Scroll for more
Read this in Grafana Cloud

Is this page helpful?

Still have questions?

Ask your questions. Let AI do the heavy lifting.

Ask AI icon
Newsletter icon

Get every update

Subscribe to our newsletter

By submitting, you agree to our Privacy policy

Grafana Cloud

  • Overview
  • Pricing
  • What's in the free tier?
  • AI Assistant
  • Agent Observability
  • Application Observability
  • Kubernetes Monitoring
  • Dashboards & Visualization
  • Database Observability
  • Frontend Observability
  • Synthetic Monitoring
  • Performance & Load Testing
  • Incident Response & Management
  • AI Investigations
  • What’s New
  • Grafana Cloud Status

Solutions

  • AI Observability
  • Full-Stack Observability
  • Infrastructure & Cloud Observability
  • Cloud Provider Observability
  • Digital Experience Monitoring
  • Scaled Prometheus
  • Cost Management & Optimization
  • Site Reliability
  • Log Management
  • Migrate to OpenTelemetry

Integrations

  • All Integrations
  • All Plugins
  • AWS
  • Google Cloud
  • Microsoft Azure
  • Kubernetes
  • Datadog
  • New Relic

Open Source

  • Our Projects
  • GitHub
  • Downloads
  • Dashboard Templates

Learn

  • Documentation
  • Blog
  • Community
  • Events
  • Observability Survey & Reports

Company

  • About Grafana Labs
  • Careers
  • Partnerships
  • Newsroom
  • Success Stories
  • Contact Us
  • Getting Help
  • Professional Services
  • Hey AI

Compare

  • Datadog vs. Grafana Cloud
  • Dynatrace vs. Grafana Cloud
  • Elasticsearch vs. Grafana Cloud
  • New Relic vs. Grafana Cloud
  • PagerDuty vs. Grafana Cloud
  • Splunk vs. Grafana Cloud
Grafana Labs x unique logomark

Donut take our word for it. Try Grafana Cloud today.

Grafana Cloud StatusLegal & SecurityTerms of ServicePrivacy PolicyTrademark Policy

Copyright 2026 © Grafana Labs

Grafana Labs uses cookies for the normal operation of this website. Learn more.