#监控

Alauda Build of Keycloak 提供与 Prometheus 兼容的内置指标。启用指标后，您可以在可观测性技术栈中监控 Keycloak 的健康状况、性能和使用情况。

#启用指标

通过在 Keycloak CR 中设置 metrics-enabled 选项来启用指标：

spec:
  additionalOptions:
    - name: metrics-enabled
      value: "true"

启用后，Keycloak 会在管理端口上公开一个 metrics 端点（默认值：9000），可通过 spec.httpManagement.port 进行配置：

• 集群内：http://<keycloak-service-name>.<namespace>:9000/metrics
• 在 Pod 内：http://localhost:9000/metrics

管理端口与主 HTTP/HTTPS 端口是分离的。

#关键指标

可用的指标类别如下：

#配置 Prometheus 抓取

将以下 scrape 配置添加到您的 Prometheus 实例中，以收集 Keycloak 指标：

scrape_configs:
  - job_name: keycloak
    static_configs:
      - targets:
          - <keycloak-service>:9000
    metrics_path: /metrics

如果您正在使用 Prometheus Operator，请创建一个 ServiceMonitor：

apiVersion: monitoring.coreos.com/v1
kind: ServiceMonitor
metadata:
  name: keycloak-metrics
  namespace: <namespace>
spec:
  selector:
    matchLabels:
      app: keycloak
  endpoints:
    - port: management
      path: /metrics
      interval: 30s

#Liveness 和 Readiness 探针

Keycloak Operator 会自动配置 liveness 和 readiness 探针。您可以在 Keycloak CR 中自定义探针参数：

spec:
  livenessProbe:
    periodSeconds: 10
    failureThreshold: 3
  readinessProbe:
    periodSeconds: 10
    failureThreshold: 3

这些探针使用位于 http://<pod>:9000/health/live 和 http://<pod>:9000/health/ready 的管理端点。

#健康检查端点

Keycloak 会在管理端口上公开三个健康检查端点：