21.3. 日志中的 trace
启用追踪后,追踪信息会包含在所有启用的日志处理程序的日志消息中(请参阅 配置日志记录)。它可用于将日志事件关联到请求执行,这可能会提供更好的可追溯性和调试。所有来自同一请求的日志行将在日志中具有相同的 traceId
。
日志消息还包含 sampled
标志,它与下面描述的抽样相关,并指示 span 是否被抽样 - 发送到收集器。
日志记录的格式可能如下所示:
2024-08-05 15:27:07,144 traceId=b636ac4c665ceb901f7fdc3fc7e80154, parentId=d59cea113d0c2549, spanId=d59cea113d0c2549, sampled=true WARN [org.keycloak.events] ...
21.3.1. 在日志中隐藏 trace info
您可以通过指定与 Keycloak 选项 log-<handler-name>-include-trace 的相关红帽构建,其中 <
; handler-name>
是日志处理程序的名称来隐藏追踪信息。例如,要在控制台日志中禁用 trace 信息,您可以将其关闭,如下所示:
bin/kc.[sh|bat] start --tracing-enabled=true --features=opentelemetry --log=console --log-console-include-trace=false
注意
当您明确覆盖特定日志处理程序的日志格式时,*-include-trace
选项没有任何效果,且不会包含追踪。