4.4. 指标


Keycloak 后端插件支持 OpenTelemetry 指标,用于监控获取操作并诊断潜在的问题。

4.4.1. 可用的计数器

Expand
表 4.1. Keycloak 指标
指标名称描述

backend_keycloak_fetch_task_failure_count_total

计算获取任务失败,因为错误而没有返回数据。

backend_keycloak_fetch_data_batch_failure_count_total

计算部分数据批处理失败。即使某些批处理失败,插件也会继续获取其他程序。

4.4.2. 标签

所有计数器都包含 taskInstanceId 标签,该标签唯一标识每个调度的 fetch 任务。您可以使用此标签将故障追踪回单个任务执行。

用户可以在 Prometheus UI 或 Grafana 中输入查询,以探索和操作指标数据。

在以下示例中,Prometheus Query Language (PromQL)表达式返回后端失败的数量。

获取与 taskInstanceId关联的后端失败数量示例

backend_keycloak_fetch_data_batch_failure_count_total{taskInstanceId="df040f82-2e80-44bd-83b0-06a984ca05ba"} 1
Copy to Clipboard Toggle word wrap

在上一小时内获取后端失败的数量的示例

sum(backend_keycloak_fetch_data_batch_failure_count_total) - sum(backend_keycloak_fetch_data_batch_failure_count_total offset 1h)
Copy to Clipboard Toggle word wrap

注意

PromQL 支持算术操作、比较运算符、逻辑/设置操作、聚合和各种功能。用户可以组合这些功能来有效地分析时间序列数据。

另外,可以使用 Grafana 视觉化结果。

4.4.3. 导出指标

您可以使用任何 OpenTelemetry 兼容的后端导出指标,如 Prometheus

有关集成说明,请参阅 Backstage OpenTelemetry 设置指南

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat