本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
Explore 中的跟踪
本文档主题专为支持 Grafana 10.x 版本的 Grafana 工作区而设计。
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅使用 Grafana 版本 9。
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅使用 Grafana 版本 8。
您可以通过 Explore 可视化来自数据来源的跟踪。
支持以下数据源。
有关如何为上述数据来源配置查询的信息，请参阅特定数据来源的文档。
查询编辑器
您可以使用数据来源的查询编辑器来查询和搜索跟踪数据。
每个数据来源可以有自己的查询编辑器。Tempo 数据来源的查询编辑器与 Jaeger 数据来源的查询编辑器略有不同。
有关查询每个数据来源的信息，请参阅其文档。
跟踪视图说明
本节介绍了跟踪视图控制面板的元素。
标题
跟踪视图的标题包含以下元素
-
标题：显示根跨度的名称和跟踪 ID。
-
搜索：突出显示包含搜索文本的跨度。
-
元数据：关于跟踪的各种元数据。
缩微贴图
显示精简视图或跟踪时间线。将鼠标指针拖到锁位贴图上方可缩小时间范围。缩放还会更新主时间线，所以容易看到较短的时间跨度。将鼠标悬停在缩微贴图上，缩放时将显示重置选择按钮，以重置缩放。
跨度筛选条件
使用跨度筛选条件，您可以在跟踪时间轴查看器中筛选跨度。添加的筛选条件越多，筛选的跨度就越具体。
您可以添加以下一个或多个筛选条件：
-
资源服务名称
-
跨度名称
-
持续时间
-
标签（包括标签、流程标签和日志字段）
要仅显示已匹配的跨度，请选择仅显示匹配项开关。
时间表
显示跟踪中的跨度列表。每个跨度行由以下组件组成：
-
展开子项按钮：展开或折叠所选跨度的所有子跨度。
-
服务名称：记录跨度的服务的名称。
-
操作名称：跨度代表的操作名称。
-
跨度持续时间条：跟踪中操作持续时间的直观表示。
跨度详细信息
选择跨度行可显示跨度详细信息，包括以下内容。
操作名称
跨度元数据
标签：与此跨度关联的任何标签。
流程元数据：记录此跨度的进程的元数据。
日志：此跨度记录的日志列表和相关键值。如果是 Zipkin，则日志部分显示 Zipkin 注释。
日志跟踪
您可以从跟踪视图中的跨度直接导航到与该跨度相关的日志。这适用于 Tempo、Jaeger 和 Zipkin 数据来源。有关如何配置每个数据来源的说明，请参阅相关文档。
选择文档图标，在 Explore 中打开一个包含已配置数据来源的拆分视图，并查询该跨度的相关日志。
跟踪指标
注意
此功能目前为测试版。
您可以从跟踪视图中的跨度直接导航到与该跨度相关的指标。此功能适用于 Tempo、Jaeger 和 Zipkin 数据来源。有关配置的详细信息，请参阅相关文档。
跟踪配置文件
使用跟踪配置文件，您可以通过添加跟踪和配置文件之间的链接功能，利用 Grafana 来关联不同的信号。
节点图
您可以选择展开显示的跟踪的节点图。根据数据来源的不同，可以将跟踪的跨度显示为图中的节点，也可以添加一些额外的上下文，包括基于当前跟踪的服务图。
服务图视图
服务图视图能够可视化跨度指标（速率、错误率和持续时间（RED）的跟踪数据）和服务图。设置要求后，此预配置的视图将立即可用。
有关更多信息，请参阅 Tempo 数据来源页面。您还可以在服务图视图页面中查看 Grafana Labs Tempo 文档
数据 API
这种可视化需要从数据来源返回特定形状的数据，以便正确显示。
数据来源需要返回数据框并设置 frame.meta.preferredVisualisationType = 'trace'。
数据帧结构
必填字段：
| 字段名称 | 类型 | 描述 |
|---|---|---|
| traceID | 字符串 | 整个跟踪的标识符。数据帧中应只有一个跟踪。 |
| spanID | 字符串 | 当前跨度的标识符。每条轨迹的跨度IDs 应该是唯一的。 |
| parentSpanID | 字符串 | 父跨度的 SpanID，用于在跟踪视图中创建子跨度与父跨度的关系。对于没有父级的根跨度，可以是 undefined。 |
| serviceName | 字符串 | 此跨度所属服务的名称。 |
| serviceTags | TraceKeyValuePair[] | 与服务相关的标签列表。 |
| startTime | 数字 | 跨度的开始时间（毫秒纪元时间）。 |
| duration | 数字 | 跨度的持续时间（毫秒）。 |
可选字段：
| 字段名称 | 类型 | 描述 |
|---|---|---|
| 日志 | TraceLog[] | 与当前跨度关联的日志列表。 |
| tags | TraceKeyValuePair[] | 与当前跨度关联的标签列表。 |
| warnings | string[] | 与当前跨度关联的警告列表。 |
| stackTraces | string[] | 与当前跨度关联的堆栈跟踪列表。 |
| errorIconColor | 字符串 | 如果跨度标记为 error:
true，则表示错误图标的颜色。 |
有关这些类型的详细信息 TraceSpanRow
