Skip to main content
Set up Prometheus scrape targets and alerting for ClickHouse Server, Keeper, and the operator.

Set Up Prometheus Scrape Targets for ClickHouse Server

ClickHouse server pods include prometheus.io/* annotations that expose basic metrics. For the full set of metrics (including ClickHouse_CustomMetrics_*), configure the :8123/metrics endpoint as a Prometheus scrape target on each server pod via a PodMonitor or equivalent. This endpoint requires authentication. Authenticate with a dedicated user that has read-only privileges.

Set Up PodMonitor for Keeper

Create a PodMonitor targeting the :8001/metrics endpoint on Keeper pods to capture Keeper metrics.

Alert Rules

For the full list of recommended alert definitions (Prometheus expressions, thresholds, and actions), see reference/metrics-and-alerts.md. Key alerts include:

Standard Kubernetes Alerts

In addition to ClickHouse-specific alerts, add standard Kubernetes alerts for:
  • Crashlooping pods
  • Unschedulable pods
  • Other infrastructure-related issues particular to your environment
Last modified on August 7, 2026