4.4. 指标
Keycloak 后端插件支持 OpenTelemetry 指标,用于监控获取操作并诊断潜在的问题。
4.4.1. 可用的计数器 复制链接链接已复制到粘贴板!
指标名称 | 描述 |
---|---|
| 计算获取任务失败,因为错误而没有返回数据。 |
| 计算部分数据批处理失败。即使某些批处理失败,插件也会继续获取其他程序。 |
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
backend_keycloak_fetch_data_batch_failure_count_total{taskInstanceId="df040f82-2e80-44bd-83b0-06a984ca05ba"} 1
在上一小时内获取后端失败的数量的示例
sum(backend_keycloak_fetch_data_batch_failure_count_total) - sum(backend_keycloak_fetch_data_batch_failure_count_total offset 1h)
sum(backend_keycloak_fetch_data_batch_failure_count_total) - sum(backend_keycloak_fetch_data_batch_failure_count_total offset 1h)
PromQL 支持算术操作、比较运算符、逻辑/设置操作、聚合和各种功能。用户可以组合这些功能来有效地分析时间序列数据。
另外,可以使用 Grafana 视觉化结果。
4.4.3. 导出指标 复制链接链接已复制到粘贴板!
您可以使用任何 OpenTelemetry 兼容的后端导出指标,如 Prometheus。
有关集成说明,请参阅 Backstage OpenTelemetry 设置指南。