{"id":13461588,"url":"https://github.com/thanos-io/thanos","last_synced_at":"2025-05-12T16:11:04.520Z","repository":{"id":37271478,"uuid":"109162639","full_name":"thanos-io/thanos","owner":"thanos-io","description":"Highly available Prometheus setup with long term storage capabilities. A CNCF Incubating project.","archived":false,"fork":false,"pushed_at":"2025-04-28T15:07:04.000Z","size":228177,"stargazers_count":13480,"open_issues_count":774,"forks_count":2149,"subscribers_count":240,"default_branch":"main","last_synced_at":"2025-05-05T14:09:35.094Z","etag":null,"topics":["cncf","go","google-cloud-storage","hacktoberfest","high-availability","metrics","monitoring","observability","prometheus","prometheus-ha-pairs","prometheus-setup","s3","storage","thanos"],"latest_commit_sha":null,"homepage":"https://thanos.io","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thanos-io.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":"docs/support/welcome.md","governance":"docs/governance.md","roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-11-01T17:38:03.000Z","updated_at":"2025-05-04T21:16:56.000Z","dependencies_parsed_at":"2023-07-14T02:52:17.036Z","dependency_job_id":"fb12fda2-f570-4011-94d2-7cba7dc62470","html_url":"https://github.com/thanos-io/thanos","commit_stats":{"total_commits":3710,"total_committers":690,"mean_commits":"5.3768115942028984","dds":0.8463611859838275,"last_synced_commit":"f19b8c61610f8ca5faca217e198d1a9952d43f7e"},"previous_names":["improbable-eng/thanos"],"tags_count":127,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thanos-io%2Fthanos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thanos-io%2Fthanos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thanos-io%2Fthanos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thanos-io%2Fthanos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thanos-io","download_url":"https://codeload.github.com/thanos-io/thanos/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253774003,"owners_count":21962197,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cncf","go","google-cloud-storage","hacktoberfest","high-availability","metrics","monitoring","observability","prometheus","prometheus-ha-pairs","prometheus-setup","s3","storage","thanos"],"created_at":"2024-07-31T11:00:46.084Z","updated_at":"2025-05-12T16:11:04.486Z","avatar_url":"https://github.com/thanos-io.png","language":"Go","funding_links":[],"categories":["Go","开源类库","Observability","Open source library","Tools and Libraries","HarmonyOS","其他__大数据","go","Monitoring","prometheus","monitoring","时序数据库","📊 Observability","Tools","High Availability","Repositories","Serverless Platforms"],"sub_categories":["数据库","Metrics Collection \u0026 Time-Series Storage","Monitoring","Regex","Database","Monitoring, Alerts, and Visualization","Windows Manager","网络服务_其他","📈 Metrics \u0026 Telemetry","Miscellaneous"],"readme":"\u003cp align=\"center\"\u003e\u003cimg src=\"docs/img/Thanos-logo_fullmedium.png\" alt=\"Thanos Logo\"\u003e\u003c/p\u003e\n\n[![Latest Release](https://img.shields.io/github/release/thanos-io/thanos.svg?style=flat-square)](https://github.com/thanos-io/thanos/releases/latest) [![Go Report Card](https://goreportcard.com/badge/github.com/thanos-io/thanos)](https://goreportcard.com/report/github.com/thanos-io/thanos) [![Go Code reference](https://img.shields.io/badge/code%20reference-go.dev-darkblue.svg)](https://pkg.go.dev/github.com/thanos-io/thanos?tab=subdirectories) [![Slack](https://img.shields.io/badge/join%20slack-%23thanos-brightgreen.svg)](https://slack.cncf.io/) [![Netlify Status](https://api.netlify.com/api/v1/badges/664a5091-934c-4b0e-a7b6-bc12f822a590/deploy-status)](https://app.netlify.com/sites/thanos-io/deploys) [![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/3048/badge)](https://bestpractices.coreinfrastructure.org/projects/3048)\n\n[![CI](https://github.com/thanos-io/thanos/workflows/CI/badge.svg)](https://github.com/thanos-io/thanos/actions?query=workflow%3ACI) [![CI](https://circleci.com/gh/thanos-io/thanos.svg?style=svg)](https://circleci.com/gh/thanos-io/thanos) [![go](https://github.com/thanos-io/thanos/workflows/go/badge.svg)](https://github.com/thanos-io/thanos/actions?query=workflow%3Ago) [![react](https://github.com/thanos-io/thanos/workflows/react/badge.svg)](https://github.com/thanos-io/thanos/actions?query=workflow%3Areact) [![docs](https://github.com/thanos-io/thanos/workflows/docs/badge.svg)](https://github.com/thanos-io/thanos/actions?query=workflow%3Adocs) [![Gitpod ready-to-code](https://img.shields.io/badge/Gitpod-ready--to--code-blue?logo=gitpod)](https://gitpod.io/#https://github.com/thanos-io/thanos) [![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://github.com/codespaces/new?hide_repo_select=true\u0026ref=main\u0026repo=109162639)\n\n\u003e 📢 [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.\n\n## Overview\n\nThanos 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.\n\nThanos is a [CNCF](https://www.cncf.io/) Incubating project.\n\nThanos 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.\n\nConcretely the aims of the project are:\n\n1. Global query view of metrics.\n2. Unlimited retention of metrics.\n3. High availability of components, including Prometheus.\n\n## Getting Started\n\n* **[Getting Started](https://thanos.io/tip/thanos/getting-started.md/)**\n* [Design](https://thanos.io/tip/thanos/design.md/)\n* [Blog posts](docs/getting-started.md#blog-posts)\n* [Talks](docs/getting-started.md#talks)\n* [Proposals](docs/proposals-done)\n* [Integrations](docs/integrations.md)\n\n## Features\n\n* Global querying view across all connected Prometheus servers\n* Deduplication and merging of metrics collected from Prometheus HA pairs\n* Seamless integration with existing Prometheus setups\n* Any object storage as its only, optional dependency\n* Downsampling historical data for massive query speedup\n* Cross-cluster federation\n* Fault-tolerant query routing\n* Simple gRPC \"Store API\" for unified data access across all metric data\n* Easy integration points for custom metric providers\n\n## Architecture Overview\n\nDeployment with Sidecar for Kubernetes:\n\n\u003c!---\nSource file to copy and edit: https://docs.google.com/drawings/d/1AiMc1qAjASMbtqL6PNs0r9-ynGoZ9LIAtf0b9PjILxw/edit?usp=sharing\n--\u003e\n\n![Sidecar](https://docs.google.com/drawings/d/e/2PACX-1vSJd32gPh8-MC5Ko0-P-v1KQ0Xnxa0qmsVXowtkwVGlczGfVW-Vd415Y6F129zvh3y0vHLBZcJeZEoz/pub?w=960\u0026h=720)\n\nDeployment with Receive in order to scale out or implement with other remote write compatible sources:\n\n\u003c!---\nSource file to copy and edit: https://docs.google.com/drawings/d/1iimTbcicKXqz0FYtSfz04JmmVFLVO9BjAjEzBm5538w/edit?usp=sharing\n--\u003e\n\n![Receive](https://docs.google.com/drawings/d/e/2PACX-1vRdYP__uDuygGR5ym1dxBzU6LEx5v7Rs1cAUKPsl5BZrRGVl5YIj5lsD_FOljeIVOGWatdAI9pazbCP/pub?w=960\u0026h=720)\n\n## Thanos Philosophy\n\nThe philosophy of Thanos and our community is borrowing much from UNIX philosophy and the golang programming language.\n\n* Each subcommand should do one thing and do it well\n  * e.g. thanos query proxies incoming calls to known store API endpoints merging the result\n* Write components that work together\n  * e.g. blocks should be stored in native prometheus format\n* Make it easy to read, write, and, run components\n  * e.g. reduce complexity in system design and implementation\n\n## Releases\n\nMain branch should be stable and usable. Every commit to main builds docker image named `main-\u003cdate\u003e-\u003csha\u003e` in [quay.io/thanos/thanos](https://quay.io/repository/thanos/thanos) and [thanosio/thanos dockerhub (mirror)](https://hub.docker.com/r/thanosio/thanos)\n\nWe also perform minor releases every 6 weeks.\n\nDuring that, we build tarballs for major platforms and release docker images.\n\nSee [release process docs](docs/release-process.md) for details.\n\n## Contributing\n\nContributions are very welcome! See our [CONTRIBUTING.md](CONTRIBUTING.md) for more information.\n\n## Community\n\nThanos 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:\n\n* Slack: [#thanos](https://slack.cncf.io/)\n* Issue Tracker: [GitHub Issues](https://github.com/thanos-io/thanos/issues)\n\n## Adopters\n\nSee [`Adopters List`](website/data/adopters.yml).\n\n## Maintainers\n\nSee [MAINTAINERS.md](MAINTAINERS.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthanos-io%2Fthanos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthanos-io%2Fthanos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthanos-io%2Fthanos/lists"}