ClickHouse is great for open-source Observability. This repository contains resources, recipes, and examples to help you work with ClickHouse-powered observability.
examples/- Docker and Kubernetes recipes for deploying ClickHouse-based observability tools. Each example is self-contained and runnable.demos/— demonstrations of specific workloads being monitored end-to-end (built on the examples or on Altinity.Cloud). Coming soon.
The examples are variations on ClickHouse-powered observability solutions with complete recipes for running them yourself.
| Example | What it is | Status |
|---|---|---|
| OpenTelemetry | An OpenTelemetry Collector accepting OTLP (logs, traces, metrics) into ClickHouse, with Grafana and containerized MCP servers. Ships a Docker Compose stack and a Kubernetes Helm umbrella chart (Altinity ClickHouse operator). | ✅ Available |
| ClickStack | 🔜 Planned | |
| Coroot | 🔜 Planned | |
| SigNoz | 🔜 Planned | |
| Jaeger (ClickHouse backend, Grafana frontend) | 🔜 Planned |
Demos show a real workload being observed through one of the examples. Deploy an example first then point a demo at it to see data flowing.
Current:
- OpenTelemetry cluster logs — a refresh of demo-opentelemetry-cluster-logs, later extended with metrics.
Planned:
- The OpenTelemetry Demo App (ClickHouse-only backend).
- Kubernetes cluster metrics
- Proxmox cluster metrics.
Contributions are welcome! Whether it's a new example, a fix, or an improvement to the docs, feel free to open an issue to discuss your idea or send a pull request. Please keep examples self-contained and runnable.
Altinity is a leading software and service provider for ClickHouse. Our slack community is a great place to get in touch with us and other clickhouse-powered observability enthusiasts:
- Official website - Get a high level overview of Altinity and our offerings.
- Slack - Talk directly with ClickHouse users and Altinity devs.
All code, unless specified otherwise, is licensed under the MIT license. Copyright (c) 2026 Altinity, Inc. Altinity®, Altinity.Cloud®, and Altinity Stable® are registered trademarks of Altinity, Inc. ClickHouse® is a registered trademark of ClickHouse, Inc. Altinity is not affiliated with or associated with ClickHouse, Inc.