Trace 关联配置支持将 Span 字段与日志服务（TLS）中的日志建立映射关系。配置完成后，您可在 Span 详情页直接跳转至对应日志主题的检索分析页面，无需手动切换页面或填写查询条件，帮助您在排查链路异常时快速定位问题根因。本文介绍如何配置 Trace 关联日志。 ## 前提条件 * 当前账号在相同地域内已有可访问的日志项目和日志主题，且目标业务日志已写入该主题，更多详细信息参见 [日志项目](https://docs.volcengine.com/docs/TorchLogService/Logproject) 和 [日志主题](https://docs.volcengine.com/docs/TorchLogService/Logtopic)。 * 当前账号具备查看 Trace 数据、管理关联规则及检索目标日志主题的权限。更多详细信息参见 [工作区级别的 IAM 权限控制](https://docs.volcengine.com/docs/apmplus/IAMpermissioncontrolattheworkspacelevel) 和 [检索分析日志](https://docs.volcengine.com/docs/TorchLogService/Queryandanalyzelogs)。 * 目标 Span 中存在可用于关联的字段，且该字段能够与日志内容存在对应关系。例如，Span 和日志中均记录了 Trace ID 或订单 ID。 * 确保应用性能监控的工作区与目标日志项目位于同一地域。 ## 使用限制 Trace 关联配置仅提供跳转能力，不会创建日志主题或采集日志。 ## 操作步骤方式一：从 Trace 关联配置页配置 1. 登录 [应用性能监控控制台](https://console.volcengine.com/observe/apmplus-server)。 2. 在左侧导航栏选择 **平台管理配置** \> **Trace 关联配置**。 3. 单击 **新建规则**，配置以下参数后单击 **保存**。 |**参数**

**参数** |**说明**

**说明** |**图例**

**图例** | |---|---|---| |生效范围 |设置规则适用的 Span 范围。

* 全服务：对当前账号、当前地域下的全部 Span 生效。

* 指定 Workspace：仅对所选 Workspace 下的全部 Span 生效，支持多选。

* 指定服务：对指定 Workspace 下所选服务的 Span 生效，支持多选。 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_988fbf2e5ac90929fa33f99b84e17872.png)

| |生效字段 |指定触发关联入口的 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`。 || |时间范围 |设置跳转后默认查询的日志时间范围。 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_15e300d3e52eb7443e79a24ffca99c32.png)

| |打开方式 |开启后，日志检索分析页将在新的浏览器标签页中打开；关闭则在当前页面内跳转。 || |状态 |规则生效状态。默认开启，若关闭，规则将不再触发关联入口。 || 方式二：从 Trace 详情页配置 1. 登录 [应用性能监控控制台](https://console.volcengine.com/observe/apmplus-server)。 2. 在左侧导航栏选择 **应用性能监控** \> **服务监控** \> **Trace 分析**。 3. 根据实际情况筛选数据后，单击目标 Span 名称，跳转至 Span 详情。 4. 单击 **关联配置，** 跳转至 ** 服务关联配置 ** 页面。 5. 单击 **添加字段**，完成参数配置后，单击 **保存**。

说明

参数配置说明参见 方式一：从 Trace 关联配置页进入。

如需创建适用于多个 Workspace 或服务的规则，可单击 管理全部规则，进入全局配置页。

## 结果验证 1. 登录 [应用性能监控控制台](https://console.volcengine.com/observe/apmplus-server)。 2. 在左侧导航栏选择 **应用性能监控** \> **服务监控** \> **Trace 分析**。 3. 单击目标 Span 的 Trace ID，在 **基本信息** 或 **属性** 页签中，确认当前 Span 包含规则配置的生效字段。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ade9b845e0343e88be5ebacfedb7627d.png) 4. 单击生效字段值上的链接，然后单击 **查看关联日志**，可跳转至对应日志主题的检索分析页面。跳转后，系统将自动填入预设的检索语句与时间范围，您可以直接执行检索查看对应日志。更多详细信息参见 [检索分析日志](https://docs.volcengine.com/docs/TorchLogService/Queryandanalyzelogs)。

说明

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

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_a8eeb3bbc73c5372fb31496ccb9d11fa.png)

应用性能监控全链路版