discover · compare · collections · requirements · contribute · feed · watching · stats · help with your tokens
thanos-io/thanos · source
Snapshot 0 · 2026-11-04T12:47:25Z · Go · Apache-2.0
Content fingerprint
869c20385ec53e454d1e56441b5690e9cb74a262289d3c6b29b1cf2e4cfeeac1GitHub description at capture
Highly available Prometheus setup with long term storage capabilities. A CNCF Incubating project.
README at capture
<p align="center"><img src="docs/img/Thanos-logo_fullmedium.png" alt="Thanos Logo"></p> [](https://github.com/thanos-io/thanos/releases/latest) [](https://pkg.go.dev/github.com/thanos-io/thanos?tab=subdirectories) [](https://slack.cncf.io/) [](https://app.netlify.com/sites/thanos-io/deploys) [](https://bestpractices.coreinfrastructure.org/projects/3048) [](https://github.com/thanos-io/thanos/actions?query=workflow%3ACI) [](https://circleci.com/gh/thanos-io/thanos) [](https://github.com/thanos-io/thanos/actions?query=workflow%3Ago) [](https://github.com/thanos-io/thanos/actions?query=workflow%3Areact) [](https://github.com/thanos-io/thanos/actions?query=workflow%3Adocs) [](https://gitpod.io/#https://github.com/thanos-io/thanos) [](https://github.com/codespaces/new?hide_repo_select=true&ref=main&repo=109162639) > 📢 [ThanosCon](https://events.linuxfoundation.org/kubecon-cloudnativecon-europe/co-located-events/thanoscon/) happened on 19th March 2024 as a co-located half-day on KubeCon EU in Paris. ## Overview Thanos is a set of components that can be composed into a highly available metric system with unlimited storage capacity, which can be added seamlessly on top of existing Prometheus deployments. Thanos is a [CNCF](https://www.cncf.io/) Incubating project. Thanos leverages the Prometheus 2.0 storage format to cost-efficiently store historical metric data in any object storage while retaining fast query latencies. Additionally, it provides a global query view across all Prometheus installations and can merge data from Prometheus HA pairs on the fly. Concretely the aims of the project are: 1. Global query view of metrics. 2. Unlimited retention of metrics. 3. High availability of components, including Prometheus. ## Getting Started * **[Getting Started](https://thanos.io/tip/thanos/getting-started.md/)** * [Design](https://thanos.io/tip/thanos/design.md/) * [Blog posts](docs/getting-started.md#blog-posts) * [Talks](docs/getting-started.md#talks) * [Proposals](docs/proposals-done) * [Integrations](docs/integrations.md) ## Features * Global querying view across all connected Prometheus servers * Deduplication and merging of metrics collected from Prometheus HA pairs * Seamless integration with existing Prometheus setups * Any object storage as its only, optional dependency * Downsampling historical data for massive query speedup * Cross-cluster federation * Fault-tolerant query routing * Simple gRPC "Store API" for unified data access across all metric data * Easy integration points for custom metric providers ## Architecture Overview Deployment with Sidecar for Kubernetes: <!--- Source file to copy and edit: https://docs.google.com/drawings/d/1AiMc1qAjASMbtqL6PNs0r9-ynGoZ9LIAtf0b9PjILxw/edit?usp=sharing -->  Deployment with Receive in order to scale out or implement with other remote write compatible sources: <!--- Source file to copy and edit: https://docs.google.com/drawings/d/1iimTbcicKXqz0FYtSfz04JmmVFLVO9BjAjEzBm5538w/edit?usp=sharing -->  ## Thanos Philosophy The philosophy of Thanos and our community is borrowing much from UNIX philosophy and the golang programming language. * Each subcommand should do one thing and do it well * e.g. thanos query proxies incoming calls to known store API endpoints merging the result * Write components that work together * e.g. blocks should be stored in native prometheus format * Make it easy to read, write, and, run components * e.g. reduce complexity in system design and implementation ## Releases Main branch should be stable and usable. Every commit to main builds docker image named `main-<date>-<sha>` in [quay.io/thanos/thanos](https://quay.io/repository/thanos/thanos) and [thanosio/thanos dockerhub (mirror)](https://hub.docker.com/r/thanosio/thanos) We also perform minor releases every 6 weeks. During that, we build tarballs for major platforms and release docker images. See [release process docs](docs/release-process.md) for details. ## Contributing Contributions are very welcome! See our [CONTRIBUTING.md](CONTRIBUTING.md) for more information. ## Community Thanos is an open source project and we value and welcome new contributors and members of the community. Here are ways to get in touch with the community: * Slack: [#thanos](https://slack.cncf.io/) * Issue Tracker: [GitHub Issues](https://github.com/thanos-io/thanos/issues) ## Adopters See [`Adopters List`](website/data/adopters.yml). ## Maintainers See [MAINTAINERS.md](MAINTAINERS.md)