Menu

This is documentation for the next version of Tempo. For the latest stable release, go to the latest version.

Documentationbreadcrumb arrow Grafana Tempo
Open source
Grafana Tempo

Grafana Tempo

Grafana Tempo is an open-source, easy-to-use, and high-scale distributed tracing backend. Tempo lets you search for traces, generate metrics from spans, and link your tracing data with logs and metrics.

Overview

Distributed tracing visualizes the lifecycle of a request as it passes through a set of applications.

Tempo is cost-efficient and only requires an object storage to operate. Tempo is deeply integrated with Grafana, Mimir, Prometheus, and Loki. You can use Tempo with open source tracing protocols, including Jaeger, Zipkin, or OpenTelemetry.

Trace visualization in Grafana

Tempo integrates well with a number of open source tools:

  • Grafana ships with native support using the built-in Tempo data source.
  • Grafana Loki, with its powerful query language LogQL v2 lets you filter requests that you care about, and jump to traces using the Derived fields support in Grafana.
  • Prometheus exemplars let you jump from Prometheus metrics to Tempo traces by clicking on recorded exemplars.

Explore

Learn about tracing
What is distributed tracing? Learn about traces and how you can use them, how you can instrument your app for tracing, and how you can visualize tracing data in Grafana.
Set up Tempo
Plan your deployment to meet your needs, deploy Tempo, test your installation, and configure Tempo services.
Manage Tempo
Learn about Tempo architecture, best practices, Parquet backend, dedicated attribute columns, metrics from traces, and more.
Metrics and tracing
Use metrics-generator to derive metrics from ingested traces. The metrics-generator processes spans and writes metrics to a Prometheus data source using the Prometheus remote write protocol.
Query with TraceQL
Inspired by PromQL and LogQL, TraceQL is a query language designed for selecting traces in Tempo. This query language lets you precisely and easily select spans and jump directly to the spans fulfilling the specified conditions.