第 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
Copy to Clipboard Toggle word wrap

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

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

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

注意

只有在启用 opentelemetry 功能时(默认)才能启用追踪。

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

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat