首页 帮助中心 听云Server 日志追溯

日志追溯

1、 启用日志追溯

在听云Server控制台的设置功能模块中,选中启用日志追溯功能,如果应用首次初次使用日志的追溯的功能,需要配置监控应用的日志配置文件,在agent配置文件中开启以下设置:

Agent默认禁用log4j logback各版本探针插件,根据实际使用的log4j或logback组件开启相应配置,如果无法识别组件类型可以选择全部开启,	

nbs.class_transformer.tingyun-log4j-plugin-2.0.0.enabled=true
nbs.class_transformer.tingyun-log4j-plugin-2.3.enabled=true
nbs.class_transformer.tingyun-log4j-plugin-1.2.enabled=true
nbs.class_transformer.tingyun-logback-plugin-1.2.enabled=true

2、被监控应用的日志配置文件配置方式

参考如下配置:

(1)log4j配置

log4j.appender.order-file-appender.layout.ConversionPattern=[%d] [%-5p] [%t] [%c] [%R][%A]%m%n 

(2)log4j2配置

<Console name="Console" target="SYSTEM_OUT">
  <PatternLayout pattern="%d{HH:mm:ss.SSS} [log4j2]  %-5level %logger{36} - %msg%n[%A][%R]"/>
</Console>

(3)logback配置

 <encoder>
        <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n[%A][%R]</pattern>
 </encoder>

日志输出结果如下:

[2017-10-29T16:30:27,730-07:00][DEBUG][com.tingyun.Log-0][com.tingyun.Test][NBS_REQUEST_GUID:167d328d-b82a-4b8c-8049-7a3a13af158f][NBS_APPID:0017]  
Test Log Message

[%R] 负责输出请求的NBS_REQUEST_GUID,每次请求的唯一标识,配置后日志会增加NBS_REQUEST_GUID 信息。

[%A] 负责输出应用的NBS_APPID,听云平台为每一个监控应用生成的id,配置后会生成NBS_APPID 信息。

3、跨应用分析对日志追溯的影响

日志追溯在启用和禁用跨应用分析不同状态下结果会有所不同。当前一次请求访问会经过多个服务器节点的时候,如果开启跨应用分析的情况下,一次访问在每一个服务器节点上生成日志的NBS_REQUEST_GUID都是相同的,在关闭跨应用分析的情况下,一次访问在每个服务器节点上都会使用单独的NBS_REQUEST_GUID,日志中的NBS_REQUEST_GUID只能保证每个服务器节点上是相同的。

4、日志追溯的组件支持

当前支持Java编程语言,支持 Log4j和Logback组件。