# 配置日志空间 支持根据NUWA Trace生成的TraceId作为查询条件，跳转至监控服务ServiceInsight的日志检索界面，直接查询出对应的日志。 #### 前提条件 - 业务日志支持打印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 | | 通用日志框架（logback、log4j、log4j2） | 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 | | CSE access/request日志 | x-nuwa-sample-type | %{x-nuwa-sample-type}nuwa-trace | 调用链的采样类型 | \>=1.0.12.101 | 以logback为例，设置配置文件logback.xml中的日志pattern如下： ``` %d{yyyy-MM-dd HH:mm:ss.SSS} [%X{x-nuwa-trace-id}] [%X{x-nuwa-sample-type}] %-5level - %msg%n%xEx ``` 记录的某条日志效果如下： ``` 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。 - 已获取服务运维岗位权限或运维管理员权限，权限申请操作请参见[申请权限](https://support.huaweicloud.com/usermanual-appstage/appstage_04_0009.html)。 #### 关联日志空间 1. [进入AppStage运维中心](https://support.huaweicloud.com/usermanual-wiseeye/appstage_04_0089.html)。 2. 在顶部导航栏选择服务。 3. 单击![](https://support.huaweicloud.com/usermanual-wiseeye/zh-cn_image_0000002332804108.png)，选择"运维 \> 调用链服务（NUWA Trace）"。 4. 在左侧导航栏选择"配置管理 \> 日志空间配置"。 5. 单击"新增"，在弹出的窗口中配置关联日志空间相关参数，参数说明如[表2]所示，然后单击"确定"。 列表显示该新增配置信息。 可以单击配置"操作"列的"修改"或"删除"，修改或删除配置信息。 表2关联日志空间参数说明 | **参数名称** | **参数说明** | |:---|:---| | 微服务 | 选择微服务。 | | 日志空间 | 选择serviceInsight中创建的日志空间。 | | 搜索字段名 | 业务日志中将NUWA Trace的TraceId绑定的字段名称。 TraceId可能映射日志字段名称，请在ServiceInsight中的日志空间确认，关联不正确会导致跳转失败。 | | 描述 | 日志空间的描述信息。 |