菜单
文档breadcrumb arrow Grafana 文档breadcrumb arrow Explorebreadcrumb arrow 在 Explore 中追踪
Grafana Cloud Enterprise 开源

Explore 中的追踪

您可以使用 Explore 查询和可视化来自追踪数据源的追踪。支持的数据源包括:

以下是一些参考资料,可帮助您了解更多关于追踪及其用法的信息:

查询编辑器

您可以使用数据源的查询编辑器查询和搜索追踪数据。请注意,Grafana 中的数据源具有独特的查询编辑器。

有关如何使用查询编辑器为追踪数据源创建查询的信息,请参阅每个数据源的文档。

追踪视图

Grafana 的追踪视图提供了请求在其系统中传播时的概览。以下部分详细介绍了追踪视图的各个元素。

Trace view
追踪视图

追踪视图页眉包含以下内容:

  • 页眉标题 - 显示根 span 名称和追踪 ID。
  • 搜索 - 突出显示包含搜索文本的 span。
  • 元数据 - 关于追踪的各种元数据。
Trace view header
追踪视图页眉

缩略图

缩略图 显示追踪时间线的精简视图。将鼠标拖动到缩略图上可以放大到更小的时间范围。这也会更新主时间线,使查看更短的 span 更容易。放大后,将鼠标悬停在缩略图上会显示重置选择,用于重置缩放。

Trace view minimap example
追踪视图缩略图示例

时间线

时间线显示追踪中 span 的列表。每个 span 行由以下组件组成:

  • 展开子项 - 展开或折叠所选 span 的所有子 span。
  • 服务名称 - 记录该 span 的服务名称。
  • 操作名称 - 该 span 所代表的操作名称。
  • Span 持续时间条 - 操作在追踪中的持续时间的可视化表示。

点击 span 行中的任何位置以显示 span 详细信息。

Trace view timeline
追踪视图时间线

Span 详细信息

追踪由一个或多个 span 组成。span 是追踪中的一个工作单元,它相对于追踪的开始时间有一个开始时间、一个持续时间以及一个工作单元的操作名称。它通常引用一个父 span,除非它是追踪中的第一个 span,即根 span。它经常包含与 span 本身相关的键/值属性,例如请求中使用的 HTTP 方法,以及服务名称、子 span 事件或指向其他 span 的链接等其他元数据。

您可以展开追踪中的任何 span 并查看详细信息,包括 span 和资源属性。

有关 span 和追踪的更多信息,请参阅 Tempo 文档中的追踪简介

Span 详细信息包括 span 属性、资源属性、事件和链接。

Span 和资源属性

Span 属性是键值对,提供有关特定 span 的元数据。它们为正在执行的操作提供上下文,例如有关请求、响应或任何相关操作详细信息的信息。例如,如果 span 处理通过 HTTP 调用另一个服务,则属性可以包括 HTTP URL(可能作为 span 属性键 http.url)和返回的 HTTP 状态码(作为 span 属性 http.status_code)。

Trace view span attributes
追踪视图 span 属性

资源属性是键值对,描述生成追踪的环境或实体。它们捕获有关追踪来源的静态信息,例如应用程序名称或服务版本。

Trace view span resource attributes
追踪视图 span 资源属性

Span 属性特定于特定操作,而资源属性与整个追踪或整个发射 span 的服务相关联。有关详细信息,请参阅Span 和资源属性

活动

事件是附加到 span 的类似日志的记录,代表其执行期间的发生。它们记录 span 生命周期中值得注意的时刻或发生,例如错误、警告或检查点。如果在操作期间发生错误,可以将事件添加到 span 中以指示出了什么问题以及何时发生。事件包括时间戳、名称和提供有关事件的附加上下文或详细信息的键值对属性。

Trace view span events
追踪视图 span 事件

链接显示没有直接父子关系的 span 之间的关系。它们表示同时发生或跨独立追踪树的 span 之间的关联,链接来自独立来源但在逻辑上连接的追踪,例如由 Web 请求启动的后台作业处理。当追踪通过异步队列或关联来自不同服务的追踪时,您可以使用链接。

Span 过滤器

Span 过滤器允许您优化追踪时间线查看器中显示的 span。添加的过滤器越多,过滤的 span 越具体。点击追踪以访问 Span 过滤器。

Screenshot of span filtering

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

  • 服务名称 - 从下拉菜单中选择服务名称进行过滤。
  • Span 名称 - 从下拉菜单中选择 span 名称进行过滤。
  • 持续时间 - 按持续时间过滤。接受的单位包括 ns、us、ms、s、m、h。
  • 标签 - 按 span 中的标签、进程标签或日志字段进行过滤。

要仅显示已匹配的 span,请切换仅显示匹配项

有关更多详细信息,请参阅Span 过滤器

观看以下视频,了解更多关于在 Grafana 中过滤追踪 span 的信息:

追踪到日志

您可以直接从追踪视图中的 span 导航到与该 span 相关的日志。此功能适用于 Tempo、Jaeger 和 Zipkin 数据源。有关配置说明,请参阅各个数据源的文档。

点击文档图标,可在 Explore 中打开分屏视图,其中包含配置的数据源并查询与 span 相关的日志。

Trace to logs
追踪到日志

追踪到指标

您可以直接从追踪视图中的 span 导航到与该 span 相关的指标。此功能适用于 Tempo、Jaeger 和 Zipkin 数据源。

有关配置说明,请参阅各个数据源的文档。对于 Tempo,请参阅追踪到指标配置

追踪到 Profiling

使用追踪到 Profiling 功能,您可以利用 Grafana 关联不同信号的能力,通过添加追踪和 Profiling 之间的链接来实现。

对于 Tempo,请参阅追踪到 Profiling 获取配置说明。

Selecting a link in the span queries the profile data source

追踪关联

您还可以展开所显示的追踪的节点图。如果数据源支持,这将追踪的 span 显示为图中的节点,或提供附加上下文,例如基于当前追踪的服务图。

有关附加信息,请参阅追踪关联

Using correlations for a trace

节点图

您还可以展开所显示的追踪的节点图。如果数据源支持,这将追踪的 span 显示为图中的节点,或提供附加上下文,例如基于当前追踪的服务图。

有关附加信息,请参阅节点图

注意

节点图需要从数据源返回特定格式的数据才能正确显示。有关附加信息和配置说明,请参阅数据 API节点数据框结构节点图数据要求

Node graph
节点图

Service graph

Service graph 可视化率、错误率和持续时间 (RED),以及服务关系。配置好要求后,此预配置视图将立即可用。

有关附加信息,请参阅以下文档:

Service graph view
Service graph 视图