在探索中追踪 - Amazon Managed Grafana
查询编辑器追踪视图说明节点图服务图表视图数据 API

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

在探索中追踪

本文档主题专为支持 Grafana 版本 10.x 的 Grafana 工作空间而设计。

有关支持 Grafana 9.x 版本的 Grafana 工作空间，请参阅。在 Grafana 版本 9 中工作

有关支持 Grafana 8.x 版本的 Grafana 工作空间，请参阅。在 Grafana 版本 8 中工作

您可以使用 “浏览” 来可视化来自追踪数据源的轨迹。

支持以下数据源。

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

查询编辑器

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

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

有关查询每个数据源的信息，请参阅其文档。

追踪视图说明

本节介绍了 Trace View 控制面板的元素。

标题

跟踪视图的标题包含以下元素：

  • 标题标题-显示根跨度的名称和跟踪 ID。

  • 搜索-突出显示包含搜索文本的跨度。

  • 元数据-有关跟踪的各种元数据。

迷你地图

显示精简视图或跟踪时间轴。将鼠标指针拖到小地图上方可放大到较小的时间范围。缩放还会更新主时间轴，因此很容易看到较短的跨度。将鼠标悬停在小地图上，缩放时将显示重置选择按钮，用于重置缩放。

跨度过滤器

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

您可以添加以下一个或多个过滤器：

  • 资源服务名称

  • 跨度名称

  • 持续时间

  • 标签（包括标签、流程标签和日志字段）

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

时间表

显示轨迹内的跨度列表。每个跨度行都由以下组件组成：

  • 展开子项按钮-展开或折叠所选跨度的所有子跨度。

  • 服务名称-记录跨度的服务的名称。

  • 操作名称-此跨度所代表的操作的名称。

  • 跨度持续时间栏-轨迹中操作持续时间的直观表示。

跨度详情

选择跨度行将显示跨度详细信息，包括以下内容。

  • 操作名称

  • 跨度元数据

  • 标签-与此跨度关联的任何标签。

  • 流程元数据-有关记录此跨度的进程的元数据。

  • 日志-按此跨度记录的日志列表和关联的键值。如果是 Zipkin 日志，则会显示 Zipkin 注释。

追踪日志

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

选择文档图标可在 “浏览” 中打开包含已配置数据源的拆分视图，并查询该跨度的相关日志。

追踪指标

注意

此功能目前处于测试阶段

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

追踪到个人资料

使用 Trace to profile，您可以使用 Grafana 的功能通过添加轨迹和配置文件之间链接的功能来关联不同的信号。

节点图

您可以选择为显示的轨迹展开节点图。根据数据源的不同，这可以将轨迹的跨度显示为图表中的节点，或者添加一些其他上下文，包括基于当前跟踪的服务图。

服务图表视图

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

有关更多信息，请参阅 Tempo 数据源页面。您还可以在 Grafana Labs T empo 文档中查看服务图表视图页面。

数据 API

此可视化需要从数据源返回数据的特定形状才能正确显示。

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

数据框结构

必填字段；

字段名称 类型 描述
traceID 字符串 整个跟踪的标识符。数据框中应该只有一条轨迹。
spanID 字符串 当前跨度的标识符。每条追踪的 SpanID 都应该是唯一的。
parentspanid 字符串 父跨度的 spanID，用于在跟踪视图中创建子父关系。可以undefined用于没有父项的根跨度。
serviceName 字符串 此跨度所属服务的名称。
服务标签 TraceKeyValuePair[] 与服务相关的标签列表。
startTime number 跨度的开始时间，以毫秒纪元时间为单位。
duration number 跨度的持续时间（以毫秒为单位）。

可选字段：

字段名称 类型 描述
日志 TraceLog[] 与当前跨度相关的日志列表。
标签 TraceKeyValuePair[] 与当前跨度关联的标签列表。
warnings 字符串 [] 与当前跨度相关的警告列表。
StackTraces 字符串 [] 与当前跨度相关的堆栈跟踪列表。
errorIconColor 字符串 如果标有 span，则错误图标的颜色error: true。

有关这些类型的详细信息 TraceSpanRow，请参阅TraceKeyValuePairTraceLog和 GitHub。