{"id":13461737,"url":"https://github.com/GreptimeTeam/greptimedb","last_synced_at":"2025-03-24T22:34:58.176Z","repository":{"id":63247624,"uuid":"480217156","full_name":"GreptimeTeam/greptimedb","owner":"GreptimeTeam","description":"An open-source, cloud-native, unified observerability database for metrics, logs and events, supporting SQL/PromQL/Streaming. Available on GreptimeCloud.","archived":false,"fork":false,"pushed_at":"2025-03-19T13:24:25.000Z","size":51729,"stargazers_count":4753,"open_issues_count":224,"forks_count":351,"subscribers_count":51,"default_branch":"main","last_synced_at":"2025-03-19T18:40:35.113Z","etag":null,"topics":["analytics","cloud-native","database","distributed","event","events","eventstore","iot","logging","logs","logstore","metrics","monitoring","observerability","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-19T18:30:22.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":167,"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":245366204,"owners_count":20603438,"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","observerability","rust","sql","time-series","timeseries","tsdb"],"created_at":"2024-07-31T11:00:55.460Z","updated_at":"2025-03-24T22:34:53.158Z","avatar_url":"https://github.com/GreptimeTeam.png","language":"Rust","funding_links":[],"categories":["Rust","Databases","Table of Contents","Cloud Services","analytics","时序数据库","7. Storage","Components"],"sub_categories":["Time-Series \u0026 Metrics","Databases","Time Series Database","Storage"],"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 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/3412\"\u003eRoadmap 2024\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\n\n**GreptimeDB** is an open-source unified 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 is born to give you:\n\n* **Unified all kinds of time series**\n\n  GreptimeDB treats all time series as contextual events with timestamp, and thus unifies the processing of metrics, logs, and events. It supports analyzing metrics, logs, and events with SQL and PromQL, and doing streaming with continuous aggregation.\n\n* **Cloud-Edge collaboration**\n\n  GreptimeDB can be deployed on ARM architecture-compatible Android/Linux systems as well as cloud environments from various vendors. Both sides run the same software, providing identical APIs and control planes, so your application can run at the edge or on the cloud without modification, and data synchronization also becomes extremely easy and efficient.\n\n* **Cloud-native distributed database**\n\n  By leveraging object storage (S3 and others), separating compute and storage, scaling stateless compute nodes arbitrarily, GreptimeDB implements seamless scalability. It also supports cross-cloud deployment with a built-in unified data access layer over different object storages.\n\n* **Performance and Cost-effective**\n\n  Flexible indexing capabilities and distributed, parallel-processing query engine, tackling high cardinality issues down. Optimized columnar layout for handling time-series data; compacted, compressed, and stored on various storage backends, particularly cloud object storage with 50x cost efficiency.\n\n* **Compatible with InfluxDB, Prometheus and more protocols**\n\n  Widely adopted database protocols and APIs, including MySQL, PostgreSQL, and Prometheus Remote Storage, etc. [Read more](https://docs.greptime.com/user-guide/protocols/overview).\n\n## Try GreptimeDB\n\n### 1. [GreptimePlay](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 --rm --name greptime --net=host greptime/greptimedb standalone start\n```\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* Python toolchain (optional): Required only if built with PyO3 backend. More detail for compiling with PyO3 can be found in its [documentation](https://pyo3.rs/v0.18.1/building_and_distribution#configuring-the-python-version).\n\nBuild GreptimeDB binary:\n\n```shell\nmake\n```\n\nRun a standalone server:\n\n```shell\ncargo run -- standalone start\n```\n\n## Extension\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 is available at [grafana](grafana/README.md) directory.\n\n## Project Status\n\nThe current version has not yet reached the standards for General Availability.\nAccording to our Greptime 2024 Roadmap, we aim to achieve a production-level version with the release of v1.0 by the end of 2024. [Join Us](https://github.com/GreptimeTeam/greptimedb/issues/3412)\n\nWe welcome you to test and use GreptimeDB. Some users have already adopted it in their production environments. If you're interested in trying it out, please use the latest stable release available.\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## Commerial Support\n\nIf you are running GreptimeDB OSS in your organization, we offer additional\nenterprise addons, installation service, training and consulting. [Contact\nus](https://greptime.com/contactus) and we will reach out to you with more\ndetail of our commerial 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- GreptimeDB uses [RustPython](https://github.com/RustPython/RustPython) for experimental embedded python scripting.\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"}