clickhouse-operator-metrics-exporter

A Bitnami Secure Image of the metrics exporter component of the Altinity ClickHouse Kubernetes Operator, which exposes Prometheus metrics for the ClickHouse…

  • Infrastructure
  • Monitoring & Logging
  • Tools & Utilities
A Bitnami Secure Image of the metrics exporter component of the Altinity ClickHouse Kubernetes Operator, which exposes Prometheus metrics for the ClickHouse clusters it manages so you can monitor cluster health on Kubernetes.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

61/100 Good

Maintained
97last commit 58 days ago
Popular
682,585 GitHub stars
Easy to install
250 install platforms, install notes, Docker image
Light to run
No data
Security check
152 serious findings, 5 minor, CI, tests, OpenSSF Scorecard 4.5/10

Based on 4 of 5 factors.

GitHub stars
2,585
Open issues
86
Last commit
2026-09-24
Latest release
release-0.27.4
License
Apache-2.0
Activity
stale

Checked 3 days ago - source: GitHub (Altinity/clickhouse-operator)

Resources & Compatibility

Requirements not published yet.

Checked 23 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Load your .env settings before starting If your normal npm start runs a different app, use node --env-file=.env src/server.mts so the app reads your saved settings; without this, it may start with missing or wrong connection details. source
  • Start ClickHouse before the exporter If you are using your own self-managed ClickHouse, install and start the clickhouse-server first; otherwise the metrics exporter will have no database to read from and will likely fail. source
  • Confirm the container is running When starting with Docker Compose, look for the container status saying Started; if it is not started, the container may be crashing because it cannot reach its target service. source

Fetched 41 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How can I change which ClickHouseInstallation objects the metrics exporter watches?

The metrics exporter exposes a /chi REST API to manage the set of watched ClickHouseInstallation objects.

What monitoring signals does the operator provide besides ClickHouse metrics?

The operator exposes Prometheus-compatible metrics and Kubernetes health probes for reconciliation activity, stalled controllers, and failure alerts. The monitoring guide covers what is exposed, how to scrape it, and relevant queries.

Answers sourced from clickhouse.com, deepwiki.com

Community

Collected 48 days ago - public community threads