第 6 章 使用追踪进行根本原因分析
使用 OpenTelementry tracing 在请求生命周期内记录信息,以识别红帽构建的 Keycloak 和连接的系统的延迟和错误的根情况。
本章解释了如何使用 OpenTelemetry (OTel)在 Red Hat build of Keycloak (OTel)中启用和配置分布式追踪。追踪允许对每个请求的生命周期进行详细监控,这有助于快速识别和诊断问题,从而更有效地调试和维护。
它提供了对性能瓶颈的宝贵见解,有助于优化系统的整体效率和系统边界。Red Hat build of Keycloak 使用受支持的 Quarkus OTel 扩展,它提供平稳集成和公开应用程序 trace。
6.1. 启用追踪 复制链接链接已复制到粘贴板!
可以使用构建时间选项 tracing-enabled
启用公开的 trace,如下所示:
bin/kc.[sh|bat] start --tracing-enabled=true
bin/kc.[sh|bat] start --tracing-enabled=true
默认情况下,trace exporters 使用 gRPC
协议和端点 http://localhost:4317
在批处理中发送数据。
默认服务名称是 keycloak
,它通过 tracing-service-name
属性指定,它优先于 tracing-resource-attributes
属性中定义的 service.name
。
有关可通过 tracing-resource-attributes
属性提供的资源属性的更多信息,请参阅 Quarkus OpenTelemetry 资源 指南。
只有在启用 opentelemetry
功能时(默认)才能启用追踪。
有关更多追踪设置,请参阅以下的所有可能配置。