Traces

Query distributed traces, labels, and label values.

List Labels

**Required role:** Viewer, Editor, or Admin

Get Value

**Required role:** Viewer, Editor, or Admin

Run a TraceQL metrics query

Runs a [TraceQL](https://grafana.com/docs/tempo/latest/traceql/) metrics query over a time range. The response is in the Tempo metrics format: one time series for each group.

Search traces with TraceQL

Searches traces with a [TraceQL](https://grafana.com/docs/tempo/latest/traceql/) query. The response is in the Tempo search format: each trace has its root span data and the span sets that matched.

List TraceQL tag names

Lists the attribute names that you can use in a TraceQL query, grouped by scope (`resource`, `span` and `intrinsic`). The response is in the Tempo tags format.

List TraceQL tag values

Lists the values of one attribute. The response is in the Tempo tag values format. Use the scope-qualified name, for example `resource.service.name`, `span.http.route` or the intrinsic `name`. Percent-encode the name in the path.

List Traces

**Required role:** Viewer, Editor, or Admin

Get Trace

**Required role:** Viewer, Editor, or Admin