文档中心

应用性能监控全链路版

平台管理配置

Trace 关联配置

Trace 关联配置支持将 Span 字段与日志服务（TLS）中的日志建立映射关系。配置完成后，您可在 Span 详情页直接跳转至对应日志主题的检索分析页面，无需手动切换页面或填写查询条件，帮助您在排查链路异常时快速定位问题根因。本文介绍如何配置 Trace 关联日志。

前提条件

当前账号在相同地域内已有可访问的日志项目和日志主题，且目标业务日志已写入该主题，更多详细信息参见日志项目和日志主题。

当前账号具备查看 Trace 数据、管理关联规则及检索目标日志主题的权限。更多详细信息参见工作区级别的 IAM 权限控制和检索分析日志。

目标 Span 中存在可用于关联的字段，且该字段能够与日志内容存在对应关系。例如，Span 和日志中均记录了 Trace ID 或订单 ID。

确保应用性能监控的工作区与目标日志项目位于同一地域。

使用限制

Trace 关联配置仅提供跳转能力，不会创建日志主题或采集日志。

操作步骤

方式一：从 Trace 关联配置页配置

方式二：从 Trace 详情页配置

登录应用性能监控控制台。

在左侧导航栏选择平台管理配置 > Trace 关联配置。

单击新建规则，配置以下参数后单击保存。

参数参数	说明说明	图例图例
生效范围	设置规则适用的 Span 范围。全服务：对当前账号、当前地域下的全部 Span 生效。指定 Workspace：仅对所选 Workspace 下的全部 Span 生效，支持多选。指定服务：对指定 Workspace 下所选服务的 Span 生效，支持多选。
生效字段	指定触发关联入口的 Span 字段。说明只有当前 Span 中存在该字段时，查看关联日志入口才会显示；若 Span 中不包含该字段，入口将不可见。当生效字段配置为 trace_id 时，可通过日志页签或 Trace ID 字段值跳转至对应日志主题的检索分析页面；配置为其他字段时，日志页签跳转功能不生效。
事件名称	关联入口在 Span 详情页的显示名称，单击后将跳转至目标日志主题的检索分析页面。
事件类型	设置跳转的目标产品。关联日志时选择 TLS。
地域	目标日志项目所在地域。说明应用性能监控的工作区与目标日志项目须位于同一地域。
日志项目	选择目标日志项目。说明列表中仅展示当前账号有权访问的项目，如未找到目标项目，请检查账号权限。
日志主题	选择目标日志主题，支持以下两种方式：自定义：从下拉列表中选择已有的日志主题。正则匹配：输入正则表达式，系统将匹配所选日志项目下所有符合规则的日志主题。
检索语句	设置跳转至目标日志检索页后自动填入的查询语句，支持使用模板变量（格式：${{字段名}}）。点击跳转时，系统将自动从当前 Span 中读取实际值并替换占位符。例如：配置检索语句 trace_id:${{trace_id}} and ${{tags.apmplus.third_party_sdk}} ，跳转后将自动替换为当前 Span 的实际值 trace_id:abc123ef and custom_sdk。
时间范围	设置跳转后默认查询的日志时间范围。
打开方式	开启后，日志检索分析页将在新的浏览器标签页中打开；关闭则在当前页面内跳转。
状态	规则生效状态。默认开启，若关闭，规则将不再触发关联入口。

结果验证

登录应用性能监控控制台。

在左侧导航栏选择应用性能监控 > 服务监控 > Trace 分析。

单击目标 Span 的 Trace ID，在基本信息或属性页签中，确认当前 Span 包含规则配置的生效字段。

单击生效字段值上的链接，然后单击查看关联日志，可跳转至对应日志主题的检索分析页面。跳转后，系统将自动填入预设的检索语句与时间范围，您可以直接执行检索查看对应日志。更多详细信息参见检索分析日志。

说明

当生效字段配置为 trace_id 时，可通过日志页签或 Trace ID 字段值跳转至对应日志主题；配置为其他字段时，日志页签跳转功能不生效。

最近更新时间：2026.10.10 16:58:02

这个页面对您有帮助吗？

有用

无用