{"id":15039160,"url":"https://github.com/greptimeteam/greptimedb","last_synced_at":"2026-04-20T05:01:41.336Z","repository":{"id":63247624,"uuid":"480217156","full_name":"GreptimeTeam/greptimedb","owner":"GreptimeTeam","description":"The open-source Observability 2.0 database. One engine for metrics, logs, and traces — replacing Prometheus, Loki \u0026 ES.","archived":false,"fork":false,"pushed_at":"2026-04-13T05:42:53.000Z","size":93294,"stargazers_count":6145,"open_issues_count":191,"forks_count":475,"subscribers_count":54,"default_branch":"main","last_synced_at":"2026-04-13T06:25:38.756Z","etag":null,"topics":["ai-observability","analytics","cloud-native","database","distributed","greptimedb","llm-monitoring","logs","metrics","monitoring","object-storage","observability","observability-database","observability-datalake","opentelemetry","prometheus","promql","rust","sql","traces"],"latest_commit_sha":null,"homepage":"https://greptime.com/","language":"Rust","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/GreptimeTeam.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-04-11T03:46:48.000Z","updated_at":"2026-04-13T05:31:39.000Z","dependencies_parsed_at":"2022-11-15T18:49:28.031Z","dependency_job_id":"1e4dab3c-6ca7-42b7-8095-1055f97144e7","html_url":"https://github.com/GreptimeTeam/greptimedb","commit_stats":{"total_commits":3379,"total_committers":113,"mean_commits":"29.902654867256636","dds":0.8665285587451909,"last_synced_commit":"57f31d14c8e9eeeb49363fa7d8df39bb92e88626"},"previous_names":[],"tags_count":247,"template":false,"template_full_name":null,"purl":"pkg:github/GreptimeTeam/greptimedb","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GreptimeTeam%2Fgreptimedb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GreptimeTeam%2Fgreptimedb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GreptimeTeam%2Fgreptimedb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GreptimeTeam%2Fgreptimedb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GreptimeTeam","download_url":"https://codeload.github.com/GreptimeTeam/greptimedb/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GreptimeTeam%2Fgreptimedb/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32033717,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T00:18:06.643Z","status":"online","status_checked_at":"2026-04-20T02:00:06.527Z","response_time":94,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["ai-observability","analytics","cloud-native","database","distributed","greptimedb","llm-monitoring","logs","metrics","monitoring","object-storage","observability","observability-database","observability-datalake","opentelemetry","prometheus","promql","rust","sql","traces"],"created_at":"2024-09-24T20:41:47.139Z","updated_at":"2026-04-20T05:01:41.326Z","avatar_url":"https://github.com/GreptimeTeam.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://cdn.jsdelivr.net/gh/GreptimeTeam/greptimedb@main/docs/logo-text-padding.png\"\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://cdn.jsdelivr.net/gh/GreptimeTeam/greptimedb@main/docs/logo-text-padding-dark.png\"\u003e\n    \u003cimg alt=\"GreptimeDB Logo\" src=\"https://cdn.jsdelivr.net/gh/GreptimeTeam/greptimedb@main/docs/logo-text-padding.png\" width=\"400px\"\u003e\n  \u003c/picture\u003e\n\u003c/p\u003e\n\n\u003ch2 align=\"center\"\u003eOne database for metrics, logs, and traces\u003cbr/\u003e\nreplacing Prometheus, Loki, and Elasticsearch\u003c/h2\u003e\n\n\u003e  The unified OpenTelemetry backend — with SQL + PromQL on object storage.\n\n\u003cdiv align=\"center\"\u003e\n\u003ch3 align=\"center\"\u003e\n  \u003ca href=\"https://docs.greptime.com/user-guide/overview/\"\u003eUser Guide\u003c/a\u003e |\n  \u003ca href=\"https://greptimedb.rs/\"\u003eAPI Docs\u003c/a\u003e |\n  \u003ca href=\"https://github.com/GreptimeTeam/greptimedb/issues/7685\"\u003eRoadmap 2026\u003c/a\u003e\n\u003c/h3\u003e\n\n\u003ca href=\"https://github.com/GreptimeTeam/greptimedb/releases/latest\"\u003e\n\u003cimg src=\"https://img.shields.io/github/v/release/GreptimeTeam/greptimedb.svg\" alt=\"Version\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://github.com/GreptimeTeam/greptimedb/releases/latest\"\u003e\n\u003cimg src=\"https://img.shields.io/github/release-date/GreptimeTeam/greptimedb.svg\" alt=\"Releases\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://hub.docker.com/r/greptime/greptimedb/\"\u003e\n\u003cimg src=\"https://img.shields.io/docker/pulls/greptime/greptimedb.svg\" alt=\"Docker Pulls\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://github.com/GreptimeTeam/greptimedb/actions/workflows/develop.yml\"\u003e\n\u003cimg src=\"https://github.com/GreptimeTeam/greptimedb/actions/workflows/develop.yml/badge.svg\" alt=\"GitHub Actions\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://codecov.io/gh/GrepTimeTeam/greptimedb\"\u003e\n\u003cimg src=\"https://codecov.io/gh/GrepTimeTeam/greptimedb/branch/main/graph/badge.svg?token=FITFDI3J3C\" alt=\"Codecov\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://github.com/greptimeTeam/greptimedb/blob/main/LICENSE\"\u003e\n\u003cimg src=\"https://img.shields.io/github/license/greptimeTeam/greptimedb\" alt=\"License\"/\u003e\n\u003c/a\u003e\n\n\u003cbr/\u003e\n\n\u003ca href=\"https://greptime.com/slack\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/slack-GreptimeDB-0abd59?logo=slack\u0026style=for-the-badge\" alt=\"Slack\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://twitter.com/greptime\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/twitter-follow_us-1d9bf0.svg?style=for-the-badge\" alt=\"Twitter\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://www.linkedin.com/company/greptime/\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/linkedin-connect_with_us-0a66c2.svg?style=for-the-badge\" alt=\"LinkedIn\"/\u003e\n\u003c/a\u003e\n\u003c/div\u003e\n\n- [Introduction](#introduction)\n- [⭐ Key Features](#features)\n- [How GreptimeDB Compares](#how-greptimedb-compares)\n- [Architecture](#architecture)\n- [Try GreptimeDB](#try-greptimedb)\n- [Getting Started](#getting-started)\n- [Build From Source](#build-from-source)\n- [Tools \u0026 Extensions](#tools--extensions)\n- [Project Status](#project-status)\n- [Community](#community)\n- [License](#license)\n- [Commercial Support](#commercial-support)\n- [Contributing](#contributing)\n- [Acknowledgement](#acknowledgement)\n\n## Introduction\n\n**GreptimeDB** is an open-source observability database built for [Observability 2.0](https://docs.greptime.com/user-guide/concepts/observability-2/) — treating metrics, logs, and traces as one unified data model (wide events) instead of three separate pillars.\n\nUse it as the single OpenTelemetry backend — replacing Prometheus, Loki, and Elasticsearch with one database built on object storage. Query with SQL and PromQL, scale without pain, cut costs up to 50x.\n\n## Features\n\n|   Feature  | Description |\n| --------- | ----------- |\n| Drop-in replacement | [PromQL](https://docs.greptime.com/user-guide/query-data/promql/), [Prometheus remote write](https://docs.greptime.com/user-guide/ingest-data/for-observability/prometheus/), [Jaeger](https://docs.greptime.com/user-guide/query-data/jaeger/), and [OpenTelemetry](https://docs.greptime.com/user-guide/ingest-data/for-observability/opentelemetry/) native. Use as your single backend for all three signals, or migrate one at a time.|\n| 50x lower cost | Object storage (S3, GCS, Azure Blob etc.) as [primary storage](https://docs.greptime.com/user-guide/deployments-administration/configuration/#storage-options). Compute-storage separation scales without pain.|\n| SQL + PromQL | Monitor with [PromQL](https://docs.greptime.com/user-guide/query-data/promql), analyze with [SQL](https://docs.greptime.com/user-guide/query-data/sql). One database replaces Prometheus + your data warehouse.|\n| Sub-second at PB-EB scale | Columnar engine with [fulltext, inverted, and skipping indexes](https://docs.greptime.com/user-guide/manage-data/data-index). Written in Rust.|\n\n  ✅ **Perfect for:**\n  * Replacing Prometheus + Loki + Elasticsearch with one database\n  * Scaling past Prometheus — high cardinality, long-term storage, no Thanos/Mimir overhead\n  * Cutting observability costs with object storage (up to 50x savings on traces, 30% on logs)\n  * AI/LLM observability — store and analyze high-volume conversation data, agent traces, and token metrics via [OpenTelemetry GenAI conventions](https://opentelemetry.io/docs/specs/semconv/gen-ai/)\n  * Edge-to-cloud observability with unified APIs on resource-constrained devices\n\n\u003e **Why Observability 2.0?** The three-pillar model (separate databases for metrics, logs, traces) creates data silos and operational complexity. GreptimeDB treats all observability data as timestamped wide events in a single columnar engine — enabling cross-signal SQL JOINs, eliminating redundant infrastructure, and naturally supporting emerging workloads like AI agent observability. Read more: [Observability 2.0 and the Database for It](https://greptime.com/blogs/2025-04-25-greptimedb-observability2-new-database).\n\nLearn more in [Why GreptimeDB](https://docs.greptime.com/user-guide/concepts/why-greptimedb).\n\n## How GreptimeDB Compares\n\n| Feature | GreptimeDB | Prometheus / Thanos / Mimir | Grafana Loki | Elasticsearch |\n|---|---|---|---|---|\n| Data types | Metrics, logs, traces | Metrics only | Logs only | Logs, traces |\n| Query language | SQL + PromQL | PromQL | LogQL | Query DSL |\n| Storage | Native object storage (S3, etc.) | Local disk + object storage (Thanos/Mimir) | Object storage (chunks) | Local disk |\n| Scaling | Compute-storage separation, stateless nodes | Federation / Thanos / Mimir — multi-component, ops heavy | Stateless + object storage | Shard-based, ops heavy |\n| Cost efficiency | Up to 50x lower storage | High at scale | Moderate | High (inverted index overhead) |\n| OpenTelemetry | Native (metrics + logs + traces) | Partial (metrics only) | Partial (logs only) | Via instrumentation |\n\n**Benchmarks:**\n* [GreptimeDB tops JSONBench's billion-record cold run test](https://greptime.com/blogs/2025-03-18-jsonbench-greptimedb-performance)\n* [TSBS Benchmark](https://github.com/GreptimeTeam/greptimedb/tree/main/docs/benchmarks/tsbs)\n* [More benchmark reports](https://docs.greptime.com/user-guide/concepts/features-that-you-concern#how-is-greptimedbs-performance-compared-to-other-solutions)\n\n## Architecture\n\nGreptimeDB can run in two modes:\n* **Standalone Mode** - Single binary for development and small deployments\n* **Distributed Mode** - Separate components for production scale:\n  - Frontend: Query processing and protocol handling\n  - Datanode: Data storage and retrieval\n  - Metasrv: Metadata management and coordination\n  \nRead the [architecture](https://docs.greptime.com/contributor-guide/overview/#architecture) document. [DeepWiki](https://deepwiki.com/GreptimeTeam/greptimedb/1-overview) provides an in-depth look at GreptimeDB:\n  \u003cimg alt=\"GreptimeDB System Overview\" src=\"docs/architecture.png\"\u003e\n\n## Try GreptimeDB\n\n```shell\ndocker pull greptime/greptimedb\n```\n\n```shell\ndocker run -p 127.0.0.1:4000-4003:4000-4003 \\\n  -v \"$(pwd)/greptimedb_data:/greptimedb_data\" \\\n  --name greptime --rm \\\n  greptime/greptimedb:latest standalone start \\\n  --http-addr 0.0.0.0:4000 \\\n  --rpc-bind-addr 0.0.0.0:4001 \\\n  --mysql-addr 0.0.0.0:4002 \\\n  --postgres-addr 0.0.0.0:4003\n```\nDashboard: [http://localhost:4000/dashboard](http://localhost:4000/dashboard)\n\nRead more in the [full Install Guide](https://docs.greptime.com/getting-started/installation/overview).\n\n**Troubleshooting:**\n* Cannot connect to the database? Ensure that ports `4000`, `4001`, `4002`, and `4003` are not blocked by a firewall or used by other services.\n* Failed to start? Check the container logs with `docker logs greptime` for further details.\n\n## Getting Started\n\n- [Quickstart](https://docs.greptime.com/getting-started/quick-start)\n- [User Guide](https://docs.greptime.com/user-guide/overview)\n- [Demo Scenes](https://github.com/GreptimeTeam/demo-scene)\n- [FAQ](https://docs.greptime.com/faq-and-others/faq)\n\n## Build From Source\n\n**Prerequisites:**\n* [Rust toolchain](https://www.rust-lang.org/tools/install) (nightly)\n* [Protobuf compiler](https://grpc.io/docs/protoc-installation/) (\u003e= 3.15)\n* C/C++ building essentials, including `gcc`/`g++`/`autoconf` and glibc library (eg. `libc6-dev` on Ubuntu and `glibc-devel` on Fedora)\n* Python toolchain (optional): Required only if using some test scripts.\n\n**Build and Run:**\n```bash\nmake\ncargo run -- standalone start\n```\n\n## Tools \u0026 Extensions\n\n- **Kubernetes**: [GreptimeDB Operator](https://github.com/GrepTimeTeam/greptimedb-operator)\n- **Helm Charts**: [Greptime Helm Charts](https://github.com/GreptimeTeam/helm-charts)\n- **Dashboard**: [Web UI](https://github.com/GreptimeTeam/dashboard)\n- **gRPC Ingester**: [Go](https://github.com/GreptimeTeam/greptimedb-ingester-go), [Java](https://github.com/GreptimeTeam/greptimedb-ingester-java), [C++](https://github.com/GreptimeTeam/greptimedb-ingester-cpp), [Erlang](https://github.com/GreptimeTeam/greptimedb-ingester-erl), [Rust](https://github.com/GreptimeTeam/greptimedb-ingester-rust), [.NET](https://github.com/GreptimeTeam/greptimedb-ingester-dotnet)\n- **Grafana Data Source**: [GreptimeDB Grafana data source plugin](https://github.com/GreptimeTeam/greptimedb-grafana-datasource)\n- **Grafana Dashboard**: [Official Dashboard for monitoring](https://github.com/GreptimeTeam/greptimedb/blob/main/grafana/README.md)\n\n## Project Status\n\n\u003e **Status:** [v1.0 GA](https://github.com/GreptimeTeam/greptimedb/releases/tag/v1.0.0) — generally available and production-ready! 🎉\n\n- Deployed in production handling billions of data points daily\n- Stable APIs, actively maintained, with regular releases ([version info](https://docs.greptime.com/nightly/reference/about-greptimedb-version))\n\nGreptimeDB v1.0 marks a major milestone — stable APIs, production readiness, and proven performance at scale.\n\n**Learn more:** [v1.0 highlights](https://greptime.com/blogs/2025-11-05-greptimedb-v1-highlights) and [2026 roadmap](https://greptime.com/blogs/2026-02-11-greptimedb-roadmap-2026).\n\nFor production use, we recommend v1.0 or later.\n\nIf you find this project useful, a ⭐ would mean a lot to us!\n\n[![Star History Chart](https://api.star-history.com/svg?repos=GreptimeTeam/GreptimeDB\u0026type=Date)](https://www.star-history.com/#GreptimeTeam/GreptimeDB\u0026Date)\n\n\u003cimg alt=\"Known Users\" src=\"https://greptime.com/logo/img/users.png\"/\u003e\n\n## Community\n\nWe invite you to engage and contribute!\n\n- [Slack](https://greptime.com/slack)\n- [Discussions](https://github.com/GreptimeTeam/greptimedb/discussions)\n- [Official Website](https://greptime.com/)\n- [Blog](https://greptime.com/blogs/)\n- [LinkedIn](https://www.linkedin.com/company/greptime/)\n- [X (Twitter)](https://X.com/greptime)\n- [YouTube](https://www.youtube.com/@greptime)\n\n## License\n\nGreptimeDB is licensed under the [Apache License 2.0](https://apache.org/licenses/LICENSE-2.0.txt).\n\n## Commercial Support\n\nRunning GreptimeDB in your organization?\nWe offer enterprise add-ons, services, training, and consulting.\n[Contact us](https://greptime.com/contactus) for details.\n\n## Contributing\n\n- Read our [Contribution Guidelines](https://github.com/GreptimeTeam/greptimedb/blob/main/CONTRIBUTING.md).\n- Explore [Internal Concepts](https://docs.greptime.com/contributor-guide/overview.html) and [DeepWiki](https://deepwiki.com/GreptimeTeam/greptimedb).\n- Pick up a [good first issue](https://github.com/GreptimeTeam/greptimedb/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) and join the #contributors [Slack](https://greptime.com/slack) channel.\n\n## Acknowledgement\n\nSpecial thanks to all contributors! See [AUTHORS.md](https://github.com/GreptimeTeam/greptimedb/blob/main/AUTHOR.md).\n\n- Uses [Apache Arrow™](https://arrow.apache.org/) (memory model)\n- [Apache Parquet™](https://parquet.apache.org/) (file storage)\n- [Apache DataFusion™](https://arrow.apache.org/datafusion/) (query engine)\n- [Apache OpenDAL™](https://opendal.apache.org/) (data access abstraction)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgreptimeteam%2Fgreptimedb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgreptimeteam%2Fgreptimedb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgreptimeteam%2Fgreptimedb/lists"}