本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
跟踪
本文档主题专为支持 Grafana 版本 10.x 的 Grafana 工作空间而设计。
有关支持 Grafana 9.x 版本的 Grafana 工作空间,请参阅。在 Grafana 版本 9 中工作
有关支持 Grafana 8.x 版本的 Grafana 工作空间,请参阅。在 Grafana 版本 8 中工作
通过追踪可视化,您可以在请求遍历基础架构中的服务时对其进行跟踪。轨迹可视化以图表形式显示轨迹数据,便于您对其进行解释。
有关跟踪及其使用方法的更多信息,请参阅以下文档:
-
在 Grafana Labs 的 Tempo 文档中开始使用
Tempo。
添加带有追踪可视化效果的面板
在 Grafana 堆栈中有可用的跟踪数据后,就可以向 Grafana 仪表板添加跟踪面板。
使用仪表板变量traceID
,可以创建查询以显示给定跟踪 ID 的特定跟踪。有关仪表板变量的更多信息,请参阅变量文档。
先决条件
在开始之前,您需要:
-
亚马逊托管 Grafana 工作空间。
-
连接到工作空间的 Tempo 数据源。
要在仪表板中查看和分析轨迹数据,您需要将轨迹可视化添加到仪表板中,并使用面板编辑器定义查询。该查询决定了可视化中显示的数据。有关面板编辑器的更多信息,请参阅面板编辑器文档。
此过程使用仪表板变量和模板来允许您输入跟踪 ID,然后可以将其可视化。您将使用名为的变量traceId
并将其添加为模板查询。
添加追踪可视化查询
-
在您的工作区中,创建一个新的仪表板或前往您想要添加跟踪可视化效果的现有仪表板。
-
选择从新仪表板添加可视化效果或在现有仪表板上选择添加面板。
-
选择相应的跟踪数据源。
-
在面板编辑器的右上角,选择可视化选项卡,然后选择轨迹。
-
在 “面板” 选项下,输入跟踪面板的标题。有关面板编辑器的更多信息,请参阅配置面板选项。
-
在查询编辑器中,选择 TraceQL 查询类型选项卡。
-
在 TraceQL 查询字段
${traceId}
中输入以创建仪表板变量。此变量用作模板查询。 -
在面板编辑器中选择 “应用”,将面板添加到仪表板。
-
转到仪表板设置并添加一个名为
traceId
“自定义” 的新变量,变量类型为其添加标签(如果需要)。选择 A pply 将变量添加到仪表板。 -
通过使用用于跟踪面板的数据源的有效跟踪 ID 并在仪表板变量中编辑 ID 来验证面板是否正常工作。
添加带有表格可视化效果的 TraceQL
虽然您可以向仪表板添加跟踪可视化,但必须手动添加跟踪 ID 作为仪表板变量很麻烦。相反,能够使用 TraceQL 查询来搜索特定类型的跟踪,然后从匹配结果中选择适当的跟踪,这会更有用。
先决条件
此过程假设您已经完成了前面的过程。
添加带有表格可视化效果的 TraceQL
-
在添加轨迹可视化的同一个仪表板中,选择添加面板以添加新的可视化面板。
-
选择您在上一节中使用的相同跟踪数据源。
-
在面板编辑器的右上角,选择 “可视化” 选项卡,然后选择 “表格”。
-
在查询编辑器中,选择 TraceQL 选项卡。
-
在 “面板” 选项下,输入跟踪面板的标题。
-
添加适当的 TraceQL 查询以搜索您想要在仪表板中可视化的跟踪。例如,这是一个来自名为
my-
server 的服务器的简单静态查询。{ .service.name = "
my-server
" && .http.status_code=500 }您可以将 TraceQL 查询编写为模板查询,以利用其他仪表板变量(如果存在)。这使您可以基于这些变量创建动态查询。
当查询返回结果时,结果将呈现在面板的表格中。
追踪可视化中的结果包括指向呈现追踪的 “浏览” 页面的链接。您可以向表格中的跟踪添加其他链接,这些链接在选中后会填充traceId
仪表板变量,以便在同一个仪表板中显示跟踪记录。
要在面板中创建一组数据链接,请按以下步骤操作。
使用变量向轨迹添加其他链接
-
在右侧菜单中的数据链接下,选择添加链接。
-
为数据链接添加标题。
-
呈现完整仪表板时,在浏览器的地址栏中查看,即可找到仪表板的路径。由于这是指向同一 Grafana 堆栈中仪表板的链接,因此只需要仪表板的路径。
例如,如果你的路径是:
https://g-example.grafana-workspace.us-east-1.amazonaws.com
/d/1234abcd5/my-dashboard?orgId=1
然后仪表板的路径是:
/d/1234abcd5/my-dashboard?orgId=1
-
在 URL 字段中,对包含两个面板的仪表板进行自引用。此自引用使用表格中选定跟踪的值来填充仪表板变量。使用上一步中的仪表板路径,然后
traceId
使用从 TraceQL 表中选择的结果填写值。使用返回结果中的traceID
数据字段显示跟踪 ID,因此请将其用作仪表板变量的值。例如:/d/1234abcd5/my-dashboard?orgId=1&var-traceId=${__data.fields["traceID"]}
-
选择 “保存” 以保存数据链接。
-
从面板编辑器中选择 “应用”,将面板应用于仪表板。
-
保存控制面板。
现在,您应该会在表格可视化中看到匹配轨迹的列表。选择 TraceID 或 SpanID 字段时,您可以选择打开 “浏览” 页面以可视化跟踪或跟踪数据链接,选择任何其他字段(例如Start time
Name
、或Duration
)会自动跟随数据链接,填写traceId
仪表板变量,然后在跟踪面板中显示相关追踪。