第 21 章启用跟踪

警告

本章介绍了当前处于预览状态的功能。在我们继续工作时，请提供您的反馈意见。

本章解释了如何使用 OpenTelemetry (OTel)在 Red Hat build of Keycloak (OTel)中启用和配置分布式追踪。追踪允许对每个请求的生命周期进行详细监控，这有助于快速识别和诊断问题，从而更有效地调试和维护。

它还提供对性能瓶颈的宝贵见解，并有助于优化系统的整体效率。Red Hat build of Keycloak 使用受支持的 Quarkus OTel 扩展，它提供平稳集成和公开应用程序 trace。

21.1. 启用追踪

可以使用构建时间选项 追踪启用公开 trace，并启用 opentelemetry 功能，如下所示：

bin/kc.[sh|bat] start --tracing-enabled=true --features=opentelemetry

默认情况下，trace exporters 使用 gRPC 协议和端点 http://localhost:4317 在批处理中发送数据。

默认服务名称是 keycloak，它通过 tracing-service-name 属性指定，它优先于 tracing-resource-attributes 属性中定义的 service.name。

有关可通过 tracing-resource-attributes 属性提供的资源属性的更多信息，请参阅 Quarkus OpenTelemetry 资源指南。

有关更多追踪设置，请参阅以下的所有可能配置。