Grafana Tempo

Grafana Tempo is an open-source, high-scale distributed tracing backend that requires only object storage to operate, making it cost-effective and easy to run. It integrates deeply with Grafana, Prometheus, and Loki for seamless observability across metrics, logs, and traces.

1 APIs 0 Features

Distributed TracingGrafanaMicroservicesObservabilityOpen Source

APIs

Grafana Tempo HTTP API

Grafana Tempo HTTP API for querying traces, searching with TraceQL, retrieving tag names and values, and computing metrics summaries from distributed trace data.

Collections

Grafana Tempo HTTP API

OPEN

Pricing Plans

Grafana Tempo Plans Pricing

3 plans

PLANS

Rate Limits

Grafana Tempo Rate Limits

5 limits

RATE LIMITS

FinOps

Grafana Tempo Finops

FINOPS

Resources

Sources

opencollection: 1.0.0
info:
  name: Grafana Tempo HTTP API
  version: 2.0.0
items:
- info:
    name: Get trace by ID
    type: http
  http:
    method: GET
    url: http://localhost:3200/api/traces/:traceID
    params:
    - name: traceID
      value: ''
      type: path
      description: Trace ID in hex format
    - name: start
      value: ''
      type: query
      description: Start of time range in Unix epoch seconds
    - name: end
      value: ''
      type: query
      description: End of time range in Unix epoch seconds
  docs: Returns a complete trace by its trace ID. The response format depends on the Accept header.
- info:
    name: Search for traces
    type: http
  http:
    method: GET
    url: http://localhost:3200/api/search
    params:
    - name: q
      value: ''
      type: query
      description: TraceQL query string
    - name: tags
      value: ''
      type: query
      description: Tag-based search in logfmt format, e.g. "service.name=myservice error=true"
    - name: minDuration
      value: ''
      type: query
      description: Minimum trace duration, e.g. "1.5s" or "500ms"
    - name: maxDuration
      value: ''
      type: query
      description: Maximum trace duration
    - name: limit
      value: ''
      type: query
      description: Maximum number of traces to return
    - name: start
      value: ''
      type: query
      description: Start of time range in Unix epoch seconds
    - name: end
      value: ''
      type: query
      description: End of time range in Unix epoch seconds
    - name: spss
      value: ''
      type: query
      description: Spans per span set, limits spans returned per set
  docs: Searches for traces matching the given parameters. Supports tag-based search and TraceQL queries.
- info:
    name: Get search tag names
    type: http
  http:
    method: GET
    url: http://localhost:3200/api/search/tags
    params:
    - name: scope
      value: ''
      type: query
      description: Scope of tags to return (resource, span, or intrinsic)
    - name: start
      value: ''
      type: query
      description: Start of time range in Unix epoch seconds
    - name: end
      value: ''
      type: query
      description: End of time range in Unix epoch seconds
  docs: Returns a list of tag names that can be used for search.
- info:
    name: Get values for a tag
    type: http
  http:
    method: GET
    url: http://localhost:3200/api/search/tag/:tagName/values
    params:
    - name: tagName
      value: ''
      type: path
      description: The tag name to lookup values for
    - name: q
      value: ''
      type: query
      description: TraceQL query to filter values by
    - name: start
      value: ''
      type: query
      description: Start of time range in Unix epoch seconds
    - name: end
      value: ''
      type: query
      description: End of time range in Unix epoch seconds
  docs: Returns a list of values for a given tag name.
- info:
    name: Get search tag names (v2)
    type: http
  http:
    method: GET
    url: http://localhost:3200/api/v2/search/tags
    params:
    - name: scope
      value: ''
      type: query
      description: Scope of tags to return
    - name: start
      value: ''
      type: query
    - name: end
      value: ''
      type: query
  docs: Returns tag names with their scopes. V2 endpoint provides scope information alongside tag names.
- info:
    name: Get values for a tag (v2)
    type: http
  http:
    method: GET
    url: http://localhost:3200/api/v2/search/tag/:tagName/values
    params:
    - name: tagName
      value: ''
      type: path
    - name: q
      value: ''
      type: query
      description: TraceQL query to filter values
    - name: start
      value: ''
      type: query
    - name: end
      value: ''
      type: query
  docs: Returns tag values with their types.
- info:
    name: Echo endpoint
    type: http
  http:
    method: GET
    url: http://localhost:3200/api/echo
  docs: Health check endpoint that returns a simple response.
- info:
    name: Readiness check
    type: http
  http:
    method: GET
    url: http://localhost:3200/ready
  docs: Returns 200 when Tempo is ready to serve traffic.
- info:
    name: Get build information
    type: http
  http:
    method: GET
    url: http://localhost:3200/status/buildinfo
  docs: Returns build information about the Tempo instance.
- info:
    name: Get metrics summary
    type: http
  http:
    method: GET
    url: http://localhost:3200/api/metrics/summary
    params:
    - name: q
      value: ''
      type: query
      description: TraceQL query to compute metrics from
    - name: groupBy
      value: ''
      type: query
      description: Attribute to group metrics by
    - name: start
      value: ''
      type: query
    - name: end
      value: ''
      type: query
  docs: Returns RED metrics (rate, error, duration) computed from traces matching the given TraceQL query.
bundled: true