应用性能监控支持在Java应用的业务日志中关联调用链的TraceId信息，当应用出现问题时，可通过调用链的TraceId快速关联业务日志，及时定位、分析并解决问题。

背景信息

在业务日志中关联调用链TraceId的功能基于MDC（Mapped Diagnostic Context）机制实现，支持主流的Log4j、Log4j2和Logback日志框架。

前提条件

1、应用已接入Java探针

2、已开通云日志服务并创建了对应的日志项目和单元，详情请参考管理日志项目与管理日志单元。

操作步骤

1. 开启关联业务日志与TraceId
   登录应用性能监控控制台，在应用列表页面点击具体应用进入应用详情，点击导航栏应用设置进入应用设置页面，在左侧tab栏选择日志开启设置即可看到开启按钮。开启后选择指定的日志项目与日志单元。
   

2. 在日志中打印TraceId

• Log4j配置文件log4j.properties的修改示例：

  log4j.appender.FILE.layout.ConversionPattern=traceId:%X{trace_id} spanId:%X{span_id} [%d] %t %c %L %-5p  - %m%n

• Log4j2配置文件log4j2.xml的修改示例：

  <Properties>
      <property name="log_pattern">%d{yyyy-MM-dd HH:mm:ss.SSS} [%mdc{trace_id}] [%mdc{span_id}] [%thread] %-5level %logger{1.} %m%n</property>
  </Properties>

• Logback配置文件logback.xml的修改示例：

  <property name="pattern" value="%d{yyyy-MM-dd HH:mm:ss.SSS} [%mdc{trace_id}] [%mdc{span_id}] [%thread] %-5level %logger{36} - %msg%n"/>