mirror of
https://github.com/grafana/grafana.git
synced 2025-07-29 01:32:17 +08:00
60 lines
2.5 KiB
Markdown
60 lines
2.5 KiB
Markdown
---
|
|
description: Learn how to create TraceQL queries in Grafana using Explore > Search.
|
|
keywords:
|
|
- grafana
|
|
- tempo
|
|
- traces
|
|
- queries
|
|
labels:
|
|
products:
|
|
- cloud
|
|
- enterprise
|
|
- oss
|
|
menuTitle: Search traces
|
|
title: Investigate traces using Search query builder
|
|
weight: 300
|
|
refs:
|
|
explore:
|
|
- pattern: /docs/grafana/
|
|
destination: /docs/grafana/<GRAFANA_VERSION>/explore/
|
|
- pattern: /docs/grafana-cloud/
|
|
destination: /docs/grafana/<GRAFANA_VERSION>/explore/
|
|
service-graph:
|
|
- pattern: /docs/grafana/
|
|
destination: /docs/grafana/<GRAFANA_VERSION>/datasources/tempo/service-graph/
|
|
- pattern: /docs/grafana-cloud/
|
|
destination: /docs/grafana-cloud/connect-externally-hosted/data-sources/tempo/service-graph/
|
|
recorded-queries:
|
|
- pattern: /docs/grafana/
|
|
destination: /docs/grafana/<GRAFANA_VERSION>/administration/recorded-queries/
|
|
- pattern: /docs/grafana-cloud/
|
|
destination: /docs/grafana/<GRAFANA_VERSION>/administration/recorded-queries/
|
|
tempo-query-editor:
|
|
- pattern: /docs/grafana/
|
|
destination: /docs/grafana/<GRAFANA_VERSION>/datasources/tempo/query-editor/
|
|
- pattern: /docs/grafana-cloud/
|
|
destination: /docs/grafana-cloud/connect-externally-hosted/data-sources/tempo/query-editor/
|
|
---
|
|
|
|
# Investigate traces using Search query builder
|
|
|
|
Inspired by PromQL and LogQL, TraceQL is a query language designed for selecting traces.
|
|
TraceQL provides a method for formulating precise queries so you can zoom in to the data you need.
|
|
Query results are returned faster because the queries limit what is searched.
|
|
|
|
To learn more about how to query by TraceQL, refer to the [TraceQL documentation](/docs/tempo/latest/traceql).
|
|
|
|
The **Search** query builder, located on the **Explore** > **Query type** > **Search** in Grafana, provides drop-down lists and text fields to help you write a query.
|
|
|
|
|
|
|
|
## Enable Search with the query builder
|
|
|
|
This feature is automatically available in Grafana 10 (and newer) and Grafana Cloud.
|
|
|
|
To enable the TraceQL query builder in self-hosted Grafana through version 10.1, [enable the `traceqlSearch` feature toggle](/docs/grafana/latest/setup-grafana/configure-grafana/feature-toggles/).
|
|
|
|
[//]: # 'Shared content for the Search - TraceQL query builder'
|
|
|
|
{{< docs/shared source="grafana" lookup="datasources/tempo-search-traceql.md" leveloffset="+1" version="<GRAFANA_VERSION>" >}}
|