配置日志空间

前提条件

• 业务日志支持打印NUWA Trace的TraceId。

  需要根据不同的日志类型在配置文件logback.xml中增加不同的key，如表1所示，其中x-nuwa-sample-type用于记录调用链的采样类型，为了提示调用链是否会上报。

  表1 日志key信息说明

  日志类型	MDC key/context key	日志Pattern	含义	agent版本要求
  通用日志框架（logback、log4j、log4j2）	x-nuwa-trace-id	%X{x-nuwa-trace-id}	调用链的TraceId	>=1.0.6.201
  	x-nuwa-sample-type	%X{x-nuwa-sample-type}	调用链的采样类型	>=1.0.9.101
  CSE access/request日志	x-nuwa-trace-id	%{x-nuwa-trace-id}SCB-ctx	调用链的TraceId	>=1.0.9.101
  	x-nuwa-sample-type	%{x-nuwa-sample-type}nuwa-trace	调用链的采样类型	>=1.0.12.101

  以logback为例，设置配置文件logback.xml中的日志pattern如下：

  <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%X{x-nuwa-trace-id}] [%X{x-nuwa-sample-type}] %-5level - %msg%n%xEx</pattern>

  记录的某条日志效果如下：

  2021-09-27 16:50:41.785 [c0a8d49b065900d16327326414781001] [PS] INFO - call method=getScenarios, cost=305

  其中c0a8d49b065900d16327326414781001为NUWA Tracer响应请求生成的TraceId，可在调用链页面搜索到完整链路，PS为x-nuwa-sample-type的值，表示该调用链在限流范围内采集，会进行上报，且链路是完整的。

  x-nuwa-sample-type不同值的意义如下：

  • PS：planned sampling， 表示该调用链在限流范围内采集，会进行上报，且链路是完整的。
  • AS：abnormal sampling，表示该调用链超过了限流值，但由于检测到链路有异常（包括为慢链）而采集上报，该情况下链路可能会有部分节点未上报。
  • WS：whitelist sampling，表示该调用链超过了限流值，但由于链路符合配置的白名单规则而采集上报，该情况下链路可能会有部分节点未上报。
  • -：无确定上报状态，调用链可能未上报（也可能会上报，取决于检测到链路异常的时机）。
• 业务日志已经正常推送至ServiceInsight。
• 已获取服务运维岗位权限或运维管理员权限，权限申请操作请参见申请权限。

关联日志空间

1. 进入AppStage运维中心。
2. 在顶部导航栏选择服务。
3. 单击，选择“运维 > 调用链服务（NUWA Trace）”。
4. 在左侧导航栏选择“配置管理 > 日志空间配置”。
5. 单击“新增”，在弹出的窗口中配置关联日志空间相关参数，参数说明如表2所示，然后单击“确定”。

   列表显示该新增配置信息。

   可以单击配置“操作”列的“修改”或“删除”，修改或删除配置信息。

   表2 关联日志空间参数说明

   参数名称	参数说明
   微服务	选择微服务。
   日志空间	选择serviceInsight中创建的日志空间。
   搜索字段名	业务日志中将NUWA Trace的TraceId绑定的字段名称。 TraceId可能映射日志字段名称，请在ServiceInsight中的日志空间确认，关联不正确会导致跳转失败。
   描述	日志空间的描述信息。