GreptimeDB

Real-Time & Cloud-Native Observability Database
for metrics, logs, and traces

• Introduction
• Features: Why GreptimeDB
• Architecture
• Try it for free
• Getting Started
• Project Status
• Join the community
  • Contributing
• Tools & Extensions
• License
• Acknowledgement

Introduction

GreptimeDB is an open-source, cloud-native, unified & cost-effective observability database for Metrics, Logs, and Traces. You can gain real-time insights from Edge to Cloud at Any Scale.

News

GreptimeDB tops JSONBench's billion-record cold run test!

Why GreptimeDB

Our core developers have been building observability data platforms for years. Based on our best practices, GreptimeDB was born to give you:

• Unified Processing of Observability Data

  A unified database that treats metrics, logs, and traces as timestamped wide events with context, supporting SQL/PromQL queries and stream processing to simplify complex data stacks.

• High Performance and Cost-effective

  Written in Rust, combines a distributed query engine with rich indexing (inverted, fulltext, skip data, and vector) and optimized columnar storage to deliver sub-second responses on petabyte-scale data and high-cost efficiency.

• Cloud-native Distributed Database

  Built for Kubernetes. GreptimeDB achieves seamless scalability with its cloud-native 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.

• Developer-Friendly

  Access standardized SQL/PromQL interfaces through built-in web dashboard, REST API, and MySQL/PostgreSQL protocols. Supports widely adopted data ingestion protocols for seamless migration and integration.

• Flexible Deployment Options

  Deploy GreptimeDB anywhere from ARM-based edge devices to cloud environments with unified APIs and bandwidth-efficient data synchronization. Query edge and cloud data seamlessly through identical APIs. Learn how to run on Android.

For more detailed info please read Why GreptimeDB.

Try GreptimeDB

1. Live Demo

Try out the features of GreptimeDB right from your browser.

2. GreptimeCloud

Start instantly with a free cluster.

3. Docker Image

To install GreptimeDB locally, the recommended way is via Docker:

docker pull greptime/greptimedb

Start a GreptimeDB container with:

docker run -p 127.0.0.1:4000-4003:4000-4003 \
  -v "$(pwd)/greptimedb:./greptimedb_data" \
  --name greptime --rm \
  greptime/greptimedb:latest standalone start \
  --http-addr 0.0.0.0:4000 \
  --rpc-bind-addr 0.0.0.0:4001 \
  --mysql-addr 0.0.0.0:4002 \
  --postgres-addr 0.0.0.0:4003

Access the dashboard via http://localhost:4000/dashboard.

Read more about Installation on docs.

Getting Started

• Quickstart
• User Guide
• Demos
• FAQ

Build

Check the prerequisite:

• Rust toolchain (nightly)
• Protobuf compiler (>= 3.15)
• C/C++ building essentials, including gcc/g++/autoconf and glibc library (eg. libc6-dev on Ubuntu and glibc-devel on Fedora)
• Python toolchain (optional): Required only if using some test scripts.

Build GreptimeDB binary:

make

Run a standalone server:

cargo run -- standalone start

Tools & Extensions

Kubernetes

• GreptimeDB Operator

Dashboard

• The dashboard UI for GreptimeDB

SDK

• GreptimeDB Go Ingester
• GreptimeDB Java Ingester
• GreptimeDB C++ Ingester
• GreptimeDB Erlang Ingester
• GreptimeDB Rust Ingester
• GreptimeDB JavaScript Ingester

Grafana Dashboard

Our official Grafana dashboard for monitoring GreptimeDB is available at grafana directory.

Project Status

GreptimeDB is currently in Beta. We are targeting GA (General Availability) with v1.0 release by Early 2025.

While in Beta, GreptimeDB is already:

• Being used in production by early adopters
• Actively maintained with regular releases, about version number
• Suitable for testing and evaluation

For production use, we recommend using the latest stable release.

Community

Our core team is thrilled to see you participate in any ways you like. When you are stuck, try to ask for help by filling an issue with a detailed description of what you were trying to do and what went wrong. If you have any questions or if you would like to get involved in our community, please check out:

• GreptimeDB Community on Slack
• GreptimeDB GitHub Discussions forum
• Greptime official website

In addition, you may:

• View our official Blog
• Connect us with Linkedin
• Follow us on Twitter

Commercial Support

If you are running GreptimeDB OSS in your organization, we offer additional enterprise add-ons, installation services, training, and consulting. Contact us and we will reach out to you with more detail of our commercial license.

License

GreptimeDB uses the Apache License 2.0 to strike a balance between open contributions and allowing you to use the software however you want.

Contributing

Please refer to contribution guidelines and internal concepts docs for more information.

Acknowledgement

Special thanks to all the contributors who have propelled GreptimeDB forward. For a complete list of contributors, please refer to AUTHOR.md.

• GreptimeDB uses Apache Arrow™ as the memory model and Apache Parquet™ as the persistent file format.
• GreptimeDB's query engine is powered by Apache Arrow DataFusion™.
• Apache OpenDAL™ gives GreptimeDB a very general and elegant data access abstraction layer.
• GreptimeDB's meta service is based on etcd.