链路追踪
最后更新时间：2025-03-25 16:20:54
链路追踪是应用性能监控（APM）的重要能力，可以实现跨应用的多维度调用链检索与分析。在链路追踪主页面，您可以根据多种过滤条件组合进行调用查询，查询结果中的每一条记录代表对一次调用的记录，等同于一个 Span。您可以单击对应的 TraceID 进入链路详情视图，进一步分析链路中的每个环节。
操作步骤
1. 登录 腾讯云可观测平台。
2. 在左侧菜单栏中选择应用性能监控 > 链路追踪。
3. 在链路追踪页面，选择合适的地域以及业务系统。
4. 通过右上方的时间选择器指定查询时间跨度，通过查询对话框指定更多查询条件。
字段名 | 说明 |
调用角色 | 调用角色等同于 Span 类型，表示这条 Span 在链路中被哪一种身份记录，包括 Server、Client、Consumer、Producer、Internal 5种类型，分别代表服务端、客户端、消费者、生产者，以及内部调用。 假设应用 A 向应用 B 发起了一次 HTTP 调用，应用 A 会记录一个调用角色为 Client 的 Span，应用 B 会记录一个调用角色为 Server 的 Span。关于 Span 类型的更多详情，请参见 OpenTelemetry 对 Span 类型的定义。 |
是否为链路入口 | 链路入口代表一条链路中的第一个 Span，通常情况下，Trace ID 由这个 Span 生成。 |
应用名称 | 应用名称通常和服务名保持一致。应用名称在应用接入 APM 时指定，多个使用相同应用名称接入的进程，在 APM 中会表现为相同应用下的多个实例。 |
实例 | 实例名称是每个接入 APM 的进程的唯一标识。通常情况下，实例名称是进程运行环境的 IP 地址。部分接入方案可以自动设置实例名称，也可以在接入 APM 时指定，具体的设置方式请参考接入文档。 |
对端服务 | 用于标识该调用的对端服务，例如，当一个 Span 的调用角色为 Server 的时候，通常会对应另一个调用角色为 Client 的 Span，那个 Span 所在的应用，就是对端服务 。如果使用腾讯云增强版 Java 探针接入，APM 会在 Span 中自动注入对端服务。如果使用其他 OpenTelemetry 方案接入，APM 也会根据调用关系尽可能的在 Span 中注入对端服务。如果对端服务未能自动注入，您可以在上报到 APM 的 Span 中通过 peer.service属性手动指定对端服务。 |
接口 | 接口名称等同于 Span 名称。 |
埋点组件 | 埋点组件用来标识上报该 Span 的框架或组件。腾讯云增强版 Java 探针和部分开源 OpenTelemetry 探针能够自动注入埋点组件。如果埋点组件未能自动注入，您可以在上报到 APM 的 Span 中通过 component属性手动指定埋点组件。 |
状态 | 表示该调用是否正确。 |
错误类型 | 如果一个调用的状态为错误，错误类型用于对不同种类的错误进行区分。 |
包含方法栈快照的调用 | 如果某个接口调用耗时频繁超过慢调用监听阈值，该接口产生的调用将有机会自动生成方法栈快照。对于包含了方法栈快照的调用，可以在链路详情中查看本地方法栈的执行详情。 说明： 腾讯云增强版 Java 探针1.16-2023102808及以上版本支持该功能。 |
存在 SQL 注入风险的调用 | 在开启应用安全后，系统可以识别存在 SQL 注入风险的数据库调用。 说明： 腾讯云增强版 Java 探针2.3-20241130及以上版本支持该功能。 |
Span 属性 | 表示在 Span 中附加的其他信息，用键值对的方式表达，除了探针自动注入的 Span 属性外，用户也可以在代码中手动添加 Span 属性。 |
在列表中添加自定义展示列
在链路追踪列表中，可以根据实际业务需求，针对 Span 的任何属性，增加自定义列，在链路追踪结果中展示。请先前往 应用性能监控 > 系统配置 > 业务系统配置 页面，在自定义配置中添加需要展示的 Span 属性，这样就能通过单击 链路追踪 页面右侧的设置图标，勾选需要在列表中展示的字段。
视图功能
可以将常用的查询条件保存到视图中，方便后续使用。
1. 在查询对话框指定查询条件，然后单击确认。
2. 单击页面右侧的保存视图，可以将当前的查询条件保存到新的视图或者已有的视图中。在下次进入链路追踪页面时，保存视图左侧将展示时钟图标，单击此图标，可选择并进入任意一个已经有的视图中，将载入之前保存过的查询条件。
文档反馈