{"id":13353731,"url":"https://github.com/grepTimeTeam/greptimedb","last_synced_at":"2025-03-12T11:30:51.941Z","repository":{"id":63247624,"uuid":"480217156","full_name":"GreptimeTeam/greptimedb","owner":"GreptimeTeam","description":"An open-source, cloud-native, unified time series database for metrics, logs and events, supporting SQL/PromQL/Streaming. Available on GreptimeCloud.","archived":false,"fork":false,"pushed_at":"2025-03-10T13:44:23.000Z","size":52570,"stargazers_count":4720,"open_issues_count":218,"forks_count":349,"subscribers_count":51,"default_branch":"main","last_synced_at":"2025-03-10T13:46:04.355Z","etag":null,"topics":["analytics","cloud-native","database","distributed","event","events","eventstore","iot","logging","logs","logstore","metrics","monitoring","rust","sql","time-series","timeseries","tsdb"],"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}},"created_at":"2022-04-11T03:46:48.000Z","updated_at":"2025-03-10T13:41:16.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":162,"template":false,"template_full_name":null,"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","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243208777,"owners_count":20254103,"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":["analytics","cloud-native","database","distributed","event","events","eventstore","iot","logging","logs","logstore","metrics","monitoring","rust","sql","time-series","timeseries","tsdb"],"created_at":"2024-07-29T21:01:46.645Z","updated_at":"2025-03-12T11:30:51.929Z","avatar_url":"https://github.com/GreptimeTeam.png","language":"Rust","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\"\u003eUnified \u0026 Cost-Effective Time Series Database for Metrics, Logs, and Events\u003c/h2\u003e\n\n\u003cdiv align=\"center\"\u003e\n\u003ch3 align=\"center\"\u003e\n  \u003ca href=\"https://greptime.com/product/cloud\"\u003eGreptimeCloud\u003c/a\u003e |\n  \u003ca href=\"https://docs.greptime.com/\"\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/5446\"\u003eRoadmap 2025\u003c/a\u003e\n\u003c/h4\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- [**Features: Why GreptimeDB**](#why-greptimedb)\n- [Architecture](https://docs.greptime.com/contributor-guide/overview/#architecture)\n- [Try it for free](#try-greptimedb)\n- [Getting Started](#getting-started)\n- [Project Status](#project-status)\n- [Join the community](#community)\n  - [Contributing](#contributing)\n- [Tools \u0026 Extensions](#tools--extensions)\n- [License](#license)\n- [Acknowledgement](#acknowledgement)\n\n## Introduction\n\n**GreptimeDB** is an open-source unified \u0026 cost-effective time-series database for **Metrics**, **Logs**, and **Events** (also **Traces** in plan). You can gain real-time insights from Edge to Cloud at Any Scale.\n\n## Why GreptimeDB\n\nOur core developers have been building time-series data platforms for years. Based on our best practices, GreptimeDB was born to give you:\n\n* **Unified Processing of Metrics, Logs, and Events**\n\n  GreptimeDB unifies time series data processing by treating all data - whether metrics, logs, or events - as timestamped events with context. Users can analyze this data using either [SQL](https://docs.greptime.com/user-guide/query-data/sql) or [PromQL](https://docs.greptime.com/user-guide/query-data/promql) and leverage stream processing ([Flow](https://docs.greptime.com/user-guide/flow-computation/overview)) to enable continuous aggregation. [Read more](https://docs.greptime.com/user-guide/concepts/data-model).\n\n* **Cloud-native Distributed Database**\n\n  Built for [Kubernetes](https://docs.greptime.com/user-guide/deployments/deploy-on-kubernetes/greptimedb-operator-management). GreptimeDB achieves seamless scalability with its [cloud-native architecture](https://docs.greptime.com/user-guide/concepts/architecture) of separated compute and storage, built on object storage (AWS S3, Azure Blob Storage, etc.) while enabling cross-cloud deployment through a unified data access layer.\n\n* **Performance and Cost-effective**\n\n  Written in pure Rust for superior performance and reliability. GreptimeDB features a distributed query engine with intelligent indexing to handle high cardinality data efficiently. Its optimized columnar storage achieves 50x cost efficiency on cloud object storage through advanced compression. [Benchmark reports](https://www.greptime.com/blogs/2024-09-09-report-summary).\n\n* **Cloud-Edge Collaboration**\n\n  GreptimeDB seamlessly operates across cloud and edge (ARM/Android/Linux), providing consistent APIs and control plane for unified data management and efficient synchronization. [Learn how to run on Android](https://docs.greptime.com/user-guide/deployments/run-on-android/).\n\n* **Multi-protocol Ingestion, SQL \u0026 PromQL Ready**\n\n  Widely adopted database protocols and APIs, including MySQL, PostgreSQL, InfluxDB, OpenTelemetry, Loki and Prometheus, etc.  Effortless Adoption \u0026 Seamless Migration. [Supported Protocols Overview](https://docs.greptime.com/user-guide/protocols/overview).\n\nFor more detailed info please read  [Why GreptimeDB](https://docs.greptime.com/user-guide/concepts/why-greptimedb).\n\n## Try GreptimeDB\n\n### 1. [Live Demo](https://greptime.com/playground)\n\nTry out the features of GreptimeDB right from your browser.\n\n### 2. [GreptimeCloud](https://console.greptime.cloud/)\n\nStart instantly with a free cluster.\n\n### 3. Docker Image\n\nTo install GreptimeDB locally, the recommended way is via Docker:\n\n```shell\ndocker pull greptime/greptimedb\n```\n\nStart a GreptimeDB container with:\n\n```shell\ndocker run -p 127.0.0.1:4000-4003:4000-4003 \\\n  -v \"$(pwd)/greptimedb:/tmp/greptimedb\" \\\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```\n\nAccess the dashboard via `http://localhost:4000/dashboard`.\n\nRead more about [Installation](https://docs.greptime.com/getting-started/installation/overview) on docs.\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* [Demos](https://github.com/GreptimeTeam/demo-scene)\n* [FAQ](https://docs.greptime.com/faq-and-others/faq)\n\n## Build\n\nCheck the prerequisite:\n\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\nBuild GreptimeDB binary:\n\n```shell\nmake\n```\n\nRun a standalone server:\n\n```shell\ncargo run -- standalone start\n```\n\n## Tools \u0026 Extensions\n\n### Kubernetes\n\n- [GreptimeDB Operator](https://github.com/GrepTimeTeam/greptimedb-operator)\n\n### Dashboard\n\n- [The dashboard UI for GreptimeDB](https://github.com/GreptimeTeam/dashboard)\n\n### SDK\n\n- [GreptimeDB Go Ingester](https://github.com/GreptimeTeam/greptimedb-ingester-go)\n- [GreptimeDB Java Ingester](https://github.com/GreptimeTeam/greptimedb-ingester-java)\n- [GreptimeDB C++ Ingester](https://github.com/GreptimeTeam/greptimedb-ingester-cpp)\n- [GreptimeDB Erlang Ingester](https://github.com/GreptimeTeam/greptimedb-ingester-erl)\n- [GreptimeDB Rust Ingester](https://github.com/GreptimeTeam/greptimedb-ingester-rust)\n- [GreptimeDB JavaScript Ingester](https://github.com/GreptimeTeam/greptimedb-ingester-js)\n\n### Grafana Dashboard\n\nOur official Grafana dashboard for monitoring GreptimeDB is available at [grafana](grafana/README.md) directory.\n\n## Project Status\n\nGreptimeDB is currently in Beta. We are targeting GA (General Availability) with v1.0 release by Early 2025.\n\nWhile in Beta, GreptimeDB is already:\n\n* Being used in production by early adopters\n* Actively maintained with regular releases, [about version number](https://docs.greptime.com/nightly/reference/about-greptimedb-version)\n* Suitable for testing and evaluation\n\nFor production use, we recommend using the latest stable release.\n\n## Community\n\nOur core team is thrilled to see you participate in any ways you like. When you are stuck, try to\nask for help by filling an issue with a detailed description of what you were trying to do\nand what went wrong. If you have any questions or if you would like to get involved in our\ncommunity, please check out:\n\n- GreptimeDB Community on [Slack](https://greptime.com/slack)\n- GreptimeDB [GitHub Discussions forum](https://github.com/GreptimeTeam/greptimedb/discussions)\n- Greptime official [website](https://greptime.com)\n\nIn addition, you may:\n\n- View our official [Blog](https://greptime.com/blogs/)\n- Connect us with [Linkedin](https://www.linkedin.com/company/greptime/)\n- Follow us on [Twitter](https://twitter.com/greptime)\n\n## Commercial Support\n\nIf you are running GreptimeDB OSS in your organization, we offer additional\nenterprise add-ons, installation services, training, and consulting. [Contact\nus](https://greptime.com/contactus) and we will reach out to you with more\ndetail of our commercial license.\n\n## License\n\nGreptimeDB uses the [Apache License 2.0](https://apache.org/licenses/LICENSE-2.0.txt) to strike a balance between\nopen contributions and allowing you to use the software however you want.\n\n## Contributing\n\nPlease refer to [contribution guidelines](CONTRIBUTING.md) and [internal concepts docs](https://docs.greptime.com/contributor-guide/overview.html) for more information.\n\n## Acknowledgement\n\nSpecial thanks to all the contributors who have propelled GreptimeDB forward. For a complete list of contributors, please refer to [AUTHOR.md](AUTHOR.md).\n\n- GreptimeDB uses [Apache Arrow™](https://arrow.apache.org/) as the memory model and [Apache Parquet™](https://parquet.apache.org/) as the persistent file format.\n- GreptimeDB's query engine is powered by [Apache Arrow DataFusion™](https://arrow.apache.org/datafusion/).\n- [Apache OpenDAL™](https://opendal.apache.org) gives GreptimeDB a very general and elegant data access abstraction layer.\n- GreptimeDB's meta service is based on [etcd](https://etcd.io/).\n","funding_links":[],"categories":["Applications"],"sub_categories":["Database"],"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"}