日志追溯

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组件。