您可以在Java應用的業務日志中關聯調用鏈的TraceId信息,從而在應用出現問題時,能夠通過調用鏈的TraceId快速關聯到業務日志,及時定位、分析并解決問題。
前提條件
應用監控基礎版不支持該功能。
您已將Agent版本升級至2.6.1.2及以上版本,具體操作,請參見更新Java探針版本。
已通過日志服務SLS完成日志采集,具體操作,請參見數據采集概述。
背景信息
ARMS在業務日志中關聯調用鏈TraceId的功能基于MDC(Mapped Diagnostic Context)機制實現,支持主流的Log4j、Log4j2和Logback日志框架。
開啟關聯業務日志與TraceId開關
登錄ARMS控制臺,在左側導航欄選擇 。
在應用列表頁面頂部選擇目標地域,然后單擊目標應用名稱。
說明語言列的圖標含義如下:
:接入應用監控的Java應用。
:接入應用監控的Golang應用。
:接入應用監控的Python應用。
-:接入可觀測鏈路 OpenTelemetry 版的應用。
在上方導航欄選擇
。在自定義配置頁簽的應用日志關聯配置區域,選擇日志源為日志服務SLS,打開關聯業務日志與TraceId開關,選擇日志服務所在地域,然后綁定Project和Logstore。
您還可以根據需求打開日志自動填充traceId和日志自動填充spanId開關。
說明開啟此開關后,業務日志中將會自動生成調用鏈的TraceId,此時無需執行步驟5手動關聯Span ID。
如果您還需要實現精準定位業務異常問題,請參見通過調用鏈路和日志分析定位業務異常問題。
(可選)在您業務日志的Layout的Pattern屬性中添加
%X{EagleEye-TraceID}
配置。您還可以通過添加
%X{span_id}
配置關聯Span ID。重要關聯Span ID功能僅支持4.x及以上探針版本。
如何在業務代碼中獲取
{EagleEye-TraceID}
,請參見ARMS Java SDK使用說明。
下面分別展示Log4j、Log4j2和Logback組件的示例配置文件:
Log4j配置文件log4j.properties的修改示例:
log4j.appender.warn.layout=org.apache.log4j.PatternLayout log4j.appender.warn.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss}-[%p]-(%C:%L) - traceId:%X{EagleEye-TraceID} - spanId:%X{span_id} - %m%n
Log4j2配置文件log4j2.xml的修改示例:
PatternLayout
<console name="Console" target="SYSTEM_OUT"> <ThresholdFilter level="INFO" onMatch="ACCEPT" onMismatch="DENY"/> <PatternLayout pattern="[%d{HH:mm:ss:SSS}] [%p] - %l - traceId:%X{EagleEye-TraceID} - spanId:%X{span_id} - %m%n"/> </console>
JsonLayout
<JsonLayout complete="false" compact="true" eventEol="true" properties="false" locationInfo="true" includeStacktrace="true" stacktraceAsString="true" objectMessageAsJsonObject="true" > <KeyValuePair key="EagleEye-TraceID" value="${ctx:EagleEye-TraceID}" /> <KeyValuePair key="span_id" value="${ctx:span_id}" /> </JsonLayout>
Logback配置文件logback.xml的修改示例:
PatternLayout
<encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder"> <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - traceId:%X{EagleEye-TraceID} - spanId:%X{span_id} - %msg%n</pattern> </encoder>
JsonLayout
<encoder class="net.logstash.logback.encoder.LoggingEventCompositeJsonEncoder"> <providers> <timestamp/> <threadName/> <logLevel/> <loggerName/> <message/> <callerData/> <stackTrace/> <pattern> <pattern> { "EagleEye-TraceID": "%X{EagleEye-TraceID}", "span_id": "%X{span_id}" } </pattern> </pattern> </providers> </encoder>
重啟應用。
在應用的業務日志中成功打印出TraceId信息,則說明業務日志關聯調用鏈的TraceId關聯成功,如下圖所示。
(可選)配置SLS日志采集接入,將應用日志上傳至上述步驟綁定的Project和Logstore中。
ARMS默認不會采集應用日志。