DEV.co
Open-Source Observability · thanos-io

thanos

Thanos extends Prometheus with high availability, unlimited metric retention via object storage, and global query views across multiple Prometheus instances. It adds long-term storage and deduplication capabilities without replacing existing Prometheus deployments.

Source: GitHub — github.com/thanos-io/thanos
14.1k
GitHub stars
2.3k
Forks
Go
Primary language
Apache-2.0
License (OSI-approved)

Key facts

Objective fields from the source. Values we can't verify are shown as “Unknown” rather than guessed.

FieldValue
Repositorythanos-io/thanos
Ownerthanos-io
Primary languageGo
LicenseApache-2.0 — OSI-approved
Stars14.1k
Forks2.3k
Open issues881
Latest releasev0.41.0 (2026-02-12)
Last updated2026-07-08
Sourcehttps://github.com/thanos-io/thanos

What thanos is

Go-based CNCF Incubating project that integrates with Prometheus 2.0 storage format. Provides modular components (Sidecar, Query, Store, Receive, Compact) for HA metric systems, object storage backends (S3, GCS), and cross-cluster federation via gRPC Store API.

Quickstart

Get the thanos source

Clone the repository and explore it locally.

terminalbash
git clone https://github.com/thanos-io/thanos.gitcd thanos# follow the project's README for install & configuration

Need it deployed, integrated, or customized instead? DEV.co ships production installs.

Best use cases

Multi-cluster observability at scale

Unified query interface across geographically distributed Prometheus deployments with automatic HA pair deduplication and cost-efficient long-term retention.

Cost-optimized metric retention

Seamless integration with existing Prometheus to offload historical metrics to cheap object storage while maintaining query performance via downsampling and block-based architecture.

High-availability Prometheus infrastructure

Replace single-node Prometheus bottlenecks with distributed components that tolerate node failures, support horizontal scaling via Receive, and enable failover routing.

Implementation considerations

  • Object storage backend (S3, GCS, Azure Blob, etc.) must be chosen and configured for reliability and cost; versioning and retention policies affect disk and query performance.
  • Deployment topology (Sidecar vs. Receive) depends on data sources; Sidecar works with existing Prometheus, Receive scales ingestion but adds cardinality coordination.
  • Compaction and downsampling jobs require dedicated resources and careful scheduling to avoid query latency during large block merges.
  • Query routing and service discovery must integrate with your load balancer and networking; gRPC Store API requires network policies and potentially custom service mesh config.
  • Data retention and TTL policies interact with object storage costs and query SLA; older blocks are downsampled, affecting query accuracy for long historical ranges.

When to avoid it — and what to weigh

  • Single-cluster, low-volume metrics — If you need <10M series/day and single-region deployment, native Prometheus with standard storage is simpler and lower operational overhead.
  • Real-time alerting as primary requirement — Thanos adds query routing complexity; alerting typically works better directly against Prometheus. Thanos is optimized for historical analysis, not alert latency.
  • Proprietary or non-standard metrics sources — Thanos requires Prometheus-compatible remote write or sidecar model. Custom metric ingestion requires custom Store API implementation.
  • Minimal DevOps/SRE resources — Multi-component deployment (Query, Sidecar, Store, Compactor, Receiver) across object storage backends requires experienced infrastructure team.

License & commercial use

Apache License 2.0 (Apache-2.0): permissive OSI-approved license allowing commercial use, modification, and redistribution with liability disclaimer and license reproduction requirements.

Apache-2.0 is a permissive license that explicitly permits commercial use. You may use, modify, and sell software built on Thanos, provided you include a copy of the license and preserve copyright notices. No warranty or indemnification is provided; consult legal counsel for production use cases.

DEV.co evaluation signals

Editorial assessment — not user reviews. Directional, with an explicit confidence level.

SignalAssessment
MaintenanceActive
DocumentationStrong
License clarityClear
Deployment complexityHigh
DEV.co fitGood
Assessment confidenceHigh
Security considerations

Project reports CII Best Practices badge and multi-workflow CI/CD (GitHub Actions, CircleCI). Object storage credentials must be managed securely (avoid embedding in configs; use IAM roles, secrets). gRPC Store API should enforce TLS and authentication to prevent unauthorized metric access. Data at rest in object storage is not inherently encrypted; encryption must be configured per backend. Thanos does not claim built-in encryption or compliance certifications.

Alternatives to consider

Cortex / Loki

Multi-tenant SaaS-style metric system with built-in clustering and HA. Use if you need managed, horizontally-scalable metrics with less operational overhead; trade-off: higher latency and cost per metric vs. Thanos' cost efficiency.

VictoriaMetrics

Single-binary or clustered time-series database with native HA and long-term storage. Use if you prefer unified binary over modular components; offers better compression and lower memory; requires migration off Prometheus.

InfluxDB Enterprise / Cloud

Managed time-series platform with unlimited retention and multi-cluster federation. Use if you want fully managed service; trade-off: not Prometheus-native, higher recurring cost, vendor lock-in.

Software development agency

Build on thanos with DEV.co software developers

Thanos integrates seamlessly with existing Prometheus deployments to add HA, long-term retention, and global querying. Start with the Getting Started guide, evaluate for your cluster size and region count, and assess DevOps readiness for multi-component orchestration.

Talk to DEV.co

Related open-source tools

Surfaced by semantic similarity across the DEV.co open-source index.

Related on DEV.co

Explore the category and the services that help you build with it.

thanos FAQ

Does Thanos replace Prometheus?
No. Thanos extends Prometheus (via Sidecar or Receive) without replacing it. Prometheus continues scraping and local retention; Thanos adds HA, global querying, and long-term storage.
What object storage backends are supported?
AWS S3, Google Cloud Storage, Azure Blob Storage, OpenStack Swift, Alibaba OSS, Ceph S3-compatible, and in-memory filesystem. See integrations docs for feature matrix.
How long does retention typically take to configure?
Depends on topology. Sidecar integration: days to weeks (standard Prometheus deployment). Multi-cluster with Receive: weeks to months (requires service discovery, load balancing, compaction tuning). Start with Sidecar for PoC.
Can I use Thanos without Kubernetes?
Yes, but not recommended. Thanos components are stateless query servers and stateful stores; Kubernetes simplifies service discovery, volumes, and orchestration. Manual deployment requires careful networking, persistent storage, and health monitoring.

Software developers & web developers for hire

Need help beyond evaluating thanos? DEV.co is a software development agency offering software development services and web development for teams of every size. Our software developers and web developers build custom software, web applications, APIs, and open-source observability integrations — and maintain them long-term.

Ready to scale Prometheus across clusters?

Thanos integrates seamlessly with existing Prometheus deployments to add HA, long-term retention, and global querying. Start with the Getting Started guide, evaluate for your cluster size and region count, and assess DevOps readiness for multi-component orchestration.