本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Explore 中的跟踪
<a name="v10-explore-tracing"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

您可以通过 Explore 可视化来自数据来源的跟踪。

支持以下数据来源。
+ [Tempo](tempo-data-source.md)（支持的摄取格式： OpenTelemetry、Jaeger 和 Zipkin）
+ [Jaeger](jaeger-data-source.md)
+ [AWS X-Ray](x-ray-data-source.md)
+ [Zipkin](zipkin-data-source.md)

有关如何为上述数据来源配置查询的信息，请参阅特定数据来源的文档。

## 查询编辑器
<a name="v10-explore-trace-queryeditor"></a>

您可以使用数据来源的查询编辑器来查询和搜索跟踪数据。

每个数据来源可以有自己的查询编辑器。Tempo 数据来源的查询编辑器与 Jaeger 数据来源的查询编辑器略有不同。

有关查询每个数据来源的信息，请参阅其文档。
+ [Tempo](tempo-data-source.md)
+ [Jaeger](jaeger-data-source.md)
+ [AWS X-Ray](x-ray-data-source.md)
+ [Zipkin](zipkin-data-source.md)

## 跟踪视图说明
<a name="v10-explore-trace-view"></a>

本节介绍了跟踪视图控制面板的元素。

**标题**

跟踪视图的标题包含以下元素
+ 标题：显示根跨度的名称和跟踪 ID。
+ 搜索：突出显示包含搜索文本的跨度。
+ 元数据：关于跟踪的各种元数据。

**缩微贴图**

显示精简视图或跟踪时间线。将鼠标指针拖到锁位贴图上方可缩小时间范围。缩放还会更新主时间线，所以容易看到较短的时间跨度。将鼠标悬停在缩微贴图上，缩放时将显示**重置选择**按钮，以重置缩放。

**跨度筛选条件**

使用跨度筛选条件，您可以在跟踪时间轴查看器中筛选跨度。添加的筛选条件越多，筛选的跨度就越具体。

您可以添加以下一个或多个筛选条件：
+ 资源服务名称
+ 跨度名称
+ Duration
+ 标签（包括标签、流程标签和日志字段）

要仅显示已匹配的跨度，请选择**仅显示匹配项**开关。

**时间表**

显示跟踪中的跨度列表。每个跨度行由以下组件组成：
+ 展开子项按钮：展开或折叠所选跨度的所有子跨度。
+ 服务名称：记录跨度的服务的名称。
+ 操作名称：跨度代表的操作名称。
+ 跨度持续时间条：跟踪中操作持续时间的直观表示。

**跨度详细信息**

选择跨度行可显示跨度详细信息，包括以下内容。
+ 操作名称
+ 跨度元数据
+ 标签：与此跨度关联的任何标签。
+ 流程元数据：记录此跨度的进程的元数据。
+ 日志：此跨度记录的日志列表和相关键值。如果是 Zipkin，则日志部分显示 Zipkin 注释。

**日志跟踪**

您可以从跟踪视图中的跨度直接导航到与该跨度相关的日志。这适用于 Tempo、Jaeger 和 Zipkin 数据来源。有关如何配置每个数据来源的说明，请参阅相关文档。

选择文档图标，在 Explore 中打开一个包含已配置数据来源的拆分视图，并查询该跨度的相关日志。

**跟踪指标**

**注意**  
此功能目前为测试版。

您可以从跟踪视图中的跨度直接导航到与该跨度相关的指标。此功能适用于 Tempo、Jaeger 和 Zipkin 数据来源。有关配置的详细信息，请参阅相关文档。

**跟踪配置文件**

使用跟踪配置文件，您可以通过添加跟踪和配置文件之间的链接功能，利用 Grafana 来关联不同的信号。

## 节点图
<a name="v10-explore-trace-node-graph"></a>

您可以选择展开显示的跟踪的节点图。根据数据来源的不同，可以将跟踪的跨度显示为图中的节点，也可以添加一些额外的上下文，包括基于当前跟踪的服务图。

## 服务图视图
<a name="v10-explore-trace-graph"></a>

服务图视图能够可视化跨度指标（速率、错误率和持续时间（RED）的跟踪数据）和服务图。设置要求后，此预配置的视图将立即可用。

有关更多信息，请参阅 [Tempo](tempo-data-source.md) 数据来源页面。您还可以在*服务图视图页面*中查看 [Grafana Labs Tempo 文档](https://grafana.com/docs/tempo/latest/metrics-generator/service-graph-view/)。

## 数据 API
<a name="v10-explore-trace-dataapi"></a>

这种可视化需要从数据来源返回特定形状的数据，以便正确显示。

数据来源需要返回数据框并设置 `frame.meta.preferredVisualisationType = 'trace'`。

**数据帧结构**

必填字段：


| 字段名称 | Type | 说明 | 
| --- | --- | --- | 
| traceID | 字符串 | 整个跟踪的标识符。数据帧中应只有一个跟踪。 | 
| spanID | 字符串 | 当前跨度的标识符。每条轨迹的跨度IDs 应该是唯一的。 | 
| parentSpanID | 字符串 | 父跨度的 SpanID，用于在跟踪视图中创建子跨度与父跨度的关系。对于没有父级的根跨度，可以是 undefined。 | 
| serviceName | 字符串 | 此跨度所属服务的名称。 | 
| serviceTags | TraceKeyValuePair[] | 与服务相关的标签列表。 | 
| startTime | 数字 | 跨度的开始时间（毫秒纪元时间）。 | 
| duration | 数字 | 跨度的持续时间（毫秒）。 | 

 可选字段：


| 字段名称 | Type | 说明 | 
| --- | --- | --- | 
| logs | TraceLog[] | 与当前跨度关联的日志列表。 | 
| 标签 | TraceKeyValuePair[] | 与当前跨度关联的标签列表。 | 
| warnings | string[] | 与当前跨度关联的警告列表。 | 
| stackTraces | string[] | 与当前跨度关联的堆栈跟踪列表。 | 
| errorIconColor | 字符串 | 如果跨度标记为 error: true，则表示错误图标的颜色。 | 

有关这些类型的详细信息 [TraceSpanRow](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L28)，请参阅[TraceKeyValuePair[TraceLog](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L12)](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L4)和 GitHub。