> For the complete documentation index, see [llms.txt](https://docs.pagerly.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pagerly.io/sre-ai-agent/data-sources/grafana-tempo.md).

# Grafana Tempo

## What the Agent Can Do

* Search traces using TraceQL — by service, operation, duration, status
* Get full trace details — all spans, durations, errors in a distributed trace

## Setup Instructions

1. Get your **Tempo endpoint URL**:
   * **Grafana Cloud:** Copy from My Account > Grafana Cloud > Tempo Details
   * **Self-hosted:** Your Tempo query frontend URL (default port 3200)
2. If authentication is required, provide a bearer token or API key
3. Enter your Tempo URL and credentials in the Pagerly dashboard

## Required Credentials

| Field                         | Description                  | Example                                 |
| ----------------------------- | ---------------------------- | --------------------------------------- |
| **Tempo URL**                 | Grafana Tempo query endpoint | `https://tempo-us-central1.grafana.net` |
| **Bearer Token** *(optional)* | Required for Grafana Cloud   | —                                       |

## Context Prompt Tips

> *"Key services: api-gateway, payment-service, user-service. Error traces have status=error. Look for spans > 500ms."*

## Docs

* [Grafana Tempo API Docs](https://grafana.com/docs/tempo/latest/api_docs/)