Integrate ClickHouse with Prometheus Operator

ClickHouse clusters managed by KubeBlocks expose Prometheus metrics on port 8001 (http-metrics) via the built-in HTTP metrics endpoint.

Prerequisites

• A functional Kubernetes cluster (v1.21+ recommended)
• kubectl v1.21+ installed and configured with cluster access
• KubeBlocks installed (installation guide)
• ClickHouse Add-on enabled
• A demo namespace: kubectl create ns demo

• Prometheus Operator installed in your cluster
• Prometheus configured with podMonitorSelector matching label release: prometheus

Create a PodMonitor

kubectl apply -f - <<EOF
apiVersion: monitoring.coreos.com/v1
kind: PodMonitor
metadata:
  name: clickhouse-pod-monitor
  namespace: demo
  labels:
    release: prometheus
spec:
  jobLabel: app.kubernetes.io/managed-by
  podTargetLabels:
    - app.kubernetes.io/instance
    - app.kubernetes.io/managed-by
    - apps.kubeblocks.io/component-name
    - apps.kubeblocks.io/pod-name
  podMetricsEndpoints:
    - path: /metrics
      port: http-metrics
      scheme: http
  namespaceSelector:
    matchNames:
      - demo
  selector:
    matchLabels:
      app.kubernetes.io/instance: clickhouse-cluster
EOF

Verify the PodMonitor is created:

kubectl get podmonitor clickhouse-pod-monitor -n demo

NAME                      AGE
clickhouse-pod-monitor    10s

Key Metrics

Cleanup

kubectl delete podmonitor clickhouse-pod-monitor -n demo --ignore-not-found