您可以在应用的业务日志中关联调用链的TraceId信息,从而在应用出现问题时,能够通过调用链的TraceId快速关联到业务日志,及时定位分析、解决问题。

前提条件

您已将Agent版本升级至2.6.1.2及以上版本,详情请参见更新Java探针版本

背景信息

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

业务日志关联调用链的TraceId信息

  1. 登录 ARMS 控制台
  2. 在左侧导航栏中选择应用监控 > 应用列表,在应用列表页面单击目标应用的名称。
  3. 在左侧导航栏中单击应用设置,并在右侧单击自定义配置页签。
  4. 自定义配置页签的业务日志关联设置区域,打开业务日志关联开关
    sc_am_log_correlation
    说明 开启此开关后,会在业务日志中自动生成调用链的TraceId。
  5. 在您业务日志的Layout的Pattern属性中添加%X{EagleEye-TraceID}配置。以Logback组件添加此配置为例,如下图所示。
    dg_am__layout_pattern
  6. 重启应用。
    在应用的业务日志中成功打印出TraceId信息,则说明业务日志关联调用链的TraceId关联成功,如下图所示。dg_am_log_traceid