Altinity's official Prometheus metrics exporter that automatically discovers and monitors ClickHouse clusters managed by the ClickHouse Operator, providing comprehensive operational metrics through a standard `/metrics` endpoint for Prometheus scraping.
clickhouse-metrics-exporter is Altinity's official Prometheus metrics exporter for the ClickHouse Operator that
provides comprehensive monitoring and observability for ClickHouse clusters running on Kubernetes. It operates as a
companion service to the operator, automatically discovering managed ClickHouse clusters and exposing their operational
metrics through a Prometheus-compatible HTTP endpoint.
The system works by watching ClickHouse Installation (CHI) resources in the Kubernetes cluster, connecting directly to
ClickHouse nodes to collect metrics, and serving them at /metrics endpoint for Prometheus scraping. It supports
parallel metric collection across multiple clusters and hosts, handles both HTTP and HTTPS connections automatically
based on cluster configuration, and provides real-time visibility into ClickHouse performance, table statistics,
replication status, and system health.
This integration enables organizations to implement comprehensive monitoring strategies for their ClickHouse deployments while maintaining Kubernetes-native patterns, supporting use cases like performance optimization, capacity planning, alerting on replication lag, and tracking query patterns across development and production environments without requiring custom monitoring solutions or manual metric configuration.