在 Grafana 中使用追踪
使用追踪，您可以搜索追踪、从 Span 生成指标，并将您的追踪数据与日志、指标和分析关联起来。
本页概述了如何在 Grafana 中使用追踪数据。
有关在 Grafana 中查询数据源的一般文档，请参阅查询和转换数据。
查询您的数据
使用 Grafana 和 Grafana Cloud Traces 中的追踪数据，您可以搜索追踪、从 Span 生成指标，并将您的追踪数据与日志、指标和分析关联起来。
使用追踪下钻调查追踪数据
注意
追踪下钻目前处于公开预览阶段。Grafana Labs 提供的支持有限，且在该功能正式发布前可能发生破坏性变更。
Grafana 追踪下钻帮助您可视化 Tempo 追踪数据中的洞察。使用该应用，您可以
- 使用从追踪派生的速率（Rate）、错误（Errors）和延迟（Duration）（RED）指标来调查问题
- 发现相关问题并监控随时间的变化
- 根据数据特性浏览其自动可视化
- 无需编写 TraceQL 查询即可完成所有这些操作
扩展您的可观测性之旅，了解下钻应用套件。
搜索追踪
使用常用维度（例如时间范围、持续时间、Span 标签、服务名称等）搜索追踪。使用 Explore 追踪视图快速诊断系统中的错误和高延迟事件。
将追踪搜索结果用作仪表盘中的面板
您可以在仪表盘中嵌入追踪面板和可视化。您还可以将查询保存为面板。更多信息，请参阅追踪可视化文档。
有关示例仪表盘，请访问play.grafana.org。
使用 TraceQL 查询数据并生成指标
受 PromQL 和 LogQL 启发，TraceQL 是专为选择追踪而设计的查询语言。
使用 Grafana Explore，您可以搜索追踪。默认的追踪搜索会查看整个追踪。TraceQL 提供了一种构建精确查询的方法，以便您可以放大查看所需的数据。查询结果返回更快，因为查询限制了搜索范围。
您可以使用TraceQL 查询编辑器构建查询，或使用搜索查询类型。
有关构建查询的详细信息，请参阅TraceQL 文档。
TraceQL 指标查询
注意
TraceQL 指标是一项实验性功能。不提供工程和值班支持。文档要么有限，要么仅在代码注释中提供。不提供 SLA。在 Grafana 中启用功能开关即可使用此功能。联系 Grafana 支持团队可在 Grafana Cloud 中启用此功能。
TraceQL 语言提供指标查询作为实验性功能。指标查询通过对追踪查询结果应用聚合函数来扩展追踪查询。例如：{ span:name = "foo" } | rate() by (span:status) 此强大功能可从追踪创建指标，其方式与 LogQL 指标查询从日志创建指标的方式类似。
Grafana 追踪下钻由指标查询提供支持。
有关可用查询的更多信息，请参阅TraceQL 指标查询。
从 Span 生成指标
RED 指标可以驱动服务图和其他现成的 Span 数据可视化。RED 指标表示：
- 速率（Rate），每秒请求数
- 错误（Errors），失败的请求数
- 延迟（Duration），请求所需时间
有关 RED 方法的更多信息，请参阅RED 方法：如何为您的服务插桩。
若要在 Grafana Cloud 中启用 metrics-generator，请参阅启用 metrics-generator。
若要为 Tempo 启用 metrics-generator，请参阅配置 metrics-generator。
这些指标存在于您的 Hosted Metrics 实例中，也可以轻松用于生成强大的自定义仪表盘。
指标也会自动生成范例，从而轻松实现指标到追踪的关联。
服务图视图
服务图视图显示一个表格，其中包含根据您的传入 Span 计算的请求速率、错误率和延迟（RED）指标。它还包括一个根据您的 Span 构建的节点图视图。
要使用服务图视图，您需要启用服务图和Span 指标。启用后，此预配置视图立即在 Explore > Service Graphs 中可用。
有关更多信息，请参阅服务图视图文档。
集成其他遥测信号
关联追踪和日志
如果您已经使用追踪 ID 进行请求/响应日志记录，则可以轻松地从日志中提取它们，以便直接跳转到您的追踪。
另一方面，您可以配置 Grafana 和 Grafana Cloud，以创建从单个 Span 到 Loki 日志的链接。如果您看到一个长时间运行的 Span 或带有错误的 Span，您可以立即跳转到导致错误的进程的日志。
注意
Cloud Traces 仅支持 Grafana 支持团队添加的自定义标签。Cloud Traces 支持以下默认标签：
cluster、hostname、namespace和pod。请联系支持团队添加自定义标签。
关联追踪和指标
Grafana 可以通过添加在追踪和指标之间链接的功能来关联不同的信号。追踪到指标功能允许您从追踪 Span 导航到选定的数据源。使用追踪到指标，您可以快速查看与每个 Span 相关的趋势或聚合数据。
例如，您可以使用 $__tags 关键字将 Span 属性转换为指标标签，从而将 Span 属性用作指标标签。
要为您的数据源设置追踪到指标，请参阅追踪到指标配置。
关联追踪和分析
使用追踪到分析，您可以通过添加在追踪和分析之间链接的功能来关联不同的信号。
追踪到分析允许您将Grafana Pyroscope数据源链接到 Grafana 或 Grafana Cloud 中的追踪数据。配置后，此连接允许您从追踪 Span 查询分析数据。
更多信息，请参阅追踪到分析文档和Grafana Pyroscope 数据源文档。
对于 Cloud Traces，请参阅追踪到分析文档了解配置说明。
