菜单
开源 RSS
在 Grafana 中编写 TraceQL 查询
Tempo 数据源的查询编辑器可帮助你在 Explore 中查询和显示 Tempo 的追踪。查询使用专门为追踪设计的查询语言 TraceQL。
有关在 Grafana 中查询数据源的通用文档，请参阅查询和转换数据。
开始之前
你可以使用 Explore 和 Tempo 数据源在 Grafana 和 Grafana Cloud 中编写 TraceQL 查询。
选择查询编辑模式
查询编辑器有三种模式或称查询类型，你可以使用它们来探索你的追踪数据。你可以单独使用这些模式，或组合使用它们来创建构建块以生成自定义查询。
三种查询类型是：
- 搜索查询构建器提供了一个用户界面来构建 TraceQL 查询。
- TraceQL 查询编辑器允许你编写自己的 TraceQL 查询，并提供自动补全功能。
- 服务图视图显示服务之间的可视化关系。有关更多信息，请参阅服务图视图文档。
搜索查询构建器
搜索查询构建器提供下拉列表和文本字段来帮助你编写查询。查询构建器非常适合不熟悉或想学习 TraceQL 的用户。
有关使用方便的下拉菜单创建查询的更多信息，请参阅使用 TraceQL 查询构建器搜索文档。
TraceQL 查询编辑器
TraceQL 查询编辑器允许你按追踪 ID 进行搜索，并使用自动补全功能编写 TraceQL 查询。
有关使用类似代码编辑器的方式构建查询的更多信息，请参阅TraceQL 查询编辑器文档。
你也可以通过在查询字段中输入追踪 ID 来搜索追踪 ID。
服务图视图
Grafana 的服务图视图使用指标来显示 Span 请求速率、错误率和持续时间，以及服务图。设置好要求后，这个预配置视图就可以立即使用了。
使用服务图视图，你可以：
- 发现持续出错的 Span 以及它们发生的速率
- 了解整个服务中 Span 调用的总体速率
- 确定服务中最慢的查询完成所需的时间
- 检查所有包含基于速率、错误和持续时间值（RED 信号）的特别关注 Span 的追踪
有关服务图的更多信息，请参阅服务图视图。
在仪表盘中使用 TraceQL 面板
要将 TraceQL 面板添加到你的仪表盘，请参阅追踪面板文档。
要了解有关 Grafana 仪表盘的更多信息，请参阅使用仪表盘文档。
