greptime/greptimedb repository overview

⁠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:latest

Start a GreptimeDB container with:

docker run -p 127.0.0.1:4000-4003:4000-4003 \
  -v "$(pwd)/greptimedb_data:/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⁠