Skip to content
Highly available Prometheus setup with long term storage capabilities.
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Fixed promu release process. (#1202) May 31, 2019
.github Added extra docs about updating Golang version. (#1209) May 31, 2019
benchmark Updated goimports; did make format; go mod tidy. (#1143) May 15, 2019
cmd/thanos receive: Replication (#1270) Jun 24, 2019
docs docs: add integration docs (#1277) Jun 25, 2019
examples Change y-axis unit to rps for rps graph (#950) Mar 20, 2019
pkg store/cache: remove iteration limit and reset on internal inconsisten… Jun 25, 2019
scripts feat: added thanos check rules command (#1097) Jun 14, 2019
test receive: Replication (#1270) Jun 24, 2019
tutorials Fix typo (#1232) Jun 6, 2019
website Add Adobe logo (#1236) Jun 7, 2019
.dep-finished Azure maturity level (#936) Mar 19, 2019
.errcheck_excludes.txt Switch to Go 1.12 & replace dep by go mod (#868) Mar 7, 2019
.gitignore rule & querier: Upgrade UI to Prometheus 2.9.1 version (#1066) May 15, 2019
.promu.yml Falling tmp to VERSION file, pinning to proper Golang version in prom… May 31, 2019 Add Support for retries when using Azure Blob Storage (#1253) Jun 20, 2019 Added website for Thanos' docs using Hugo. (#807) Apr 15, 2019 Remove references to 'bzr' (#1137) May 10, 2019
Dockerfile Added Kube manifests for GCS-enabled setup + store. Added small tutor… Nov 16, 2017
Dockerfile.multi-stage Moved CI to build Thanos with golang 1.12.5 (#1156) May 17, 2019
LICENSE Initial commit Nov 1, 2017 Added a new maintainer to the list: @povilasv welcome! (#975) Mar 26, 2019
Makefile Use prometheus v2.9.2, common v0.4.0 & tsdb v0.8.0 (#1133) May 31, 2019 docs: add integration docs (#1277) Jun 25, 2019
VERSION Cut release v0.5.0. (#1225) Jun 6, 2019
doc.go Add doc.go and Improve goDocs experience (#714) Jan 18, 2019
go.mod pkg/receive: enable forwarding metrics (#1243) Jun 20, 2019
go.sum pkg/receive: enable forwarding metrics (#1243) Jun 20, 2019
netlify.toml website: Fixing netlify. (#1080) Apr 25, 2019

Thanos Logo

CircleCI Go Report Card GoDoc Slack Docker Pulls Netlify Status


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 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.

Architecture Overview


Getting Started


  • 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

Thanos Philosophy

The philosophy of Thanos and our community is borrowing much from UNIX philosophy and the golang programming language.

  • Each sub command should do one thing and do it well
    • eg. 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


Master should be stable and usable. Every commit to master builds docker image named master-<data>-<sha>.

We also perform minor releases every 6 weeks. During that, we build tarballs for major platforms and docker image.

See this for details.


Contributions are very welcome! See our for more information.


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:



You can’t perform that action at this time.