https://github.com/greptimeteam/greptimedb

Open-source, cloud-native, unified observability database for metrics, logs and traces, supporting SQL/PromQL/Streaming. Available on GreptimeCloud.

Science Score: 36.0%

This score indicates how likely this project is to be science-related based on various indicators:

○
CITATION.cff file
✓
codemeta.json file
Found codemeta.json file
✓
.zenodo.json file
Found .zenodo.json file
○
DOI references
○
Academic publication links
✓
Committers with academic emails
2 of 110 committers (1.8%) from academic institutions
○
Institutional organization owner
○
JOSS paper metadata
○
Scientific vocabulary similarity
Low similarity (11.5%) to scientific vocabulary

Keywords

analytics cloud-native database distributed greptimedb logs metrics monitoring observability observability-database observability-datalake promql rust rust-database sql time-series traces tsdb

Keywords from Contributors

azblob gcs embedded olap self-hosted clickhouse dbms lakehouse mpp transformer

Last synced: 5 months ago · JSON representation

Repository

Open-source, cloud-native, unified observability database for metrics, logs and traces, supporting SQL/PromQL/Streaming. Available on GreptimeCloud.

Basic Info

Host: GitHub
Owner: GreptimeTeam
License: apache-2.0
Language: Rust
Default Branch: main
Homepage: https://greptime.com/
Size: 67.1 MB

Statistics

Stars: 5,513
Watchers: 56
Forks: 409
Open Issues: 202
Releases: 0

Topics

analytics cloud-native database distributed greptimedb logs metrics monitoring observability observability-database observability-datalake promql rust rust-database sql time-series traces tsdb

Created almost 4 years ago · Last pushed 6 months ago

Metadata Files

Readme Contributing License Codeowners Security

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

Delivers sub-second querying at PB scale and exceptional cost efficiency from edge to cloud.

GreptimeCloud | User Guide | API Docs | Roadmap 2025

Introduction
⭐ Key Features
Quick Comparison
Architecture
Try GreptimeDB
Getting Started
Build From Source
Tools & Extensions
Project Status
Community
License
Commercial Support
Contributing
Acknowledgement

Introduction

GreptimeDB is an open-source, cloud-native database purpose-built for the unified collection and analysis of observability data (metrics, logs, and traces). Whether you’re operating on the edge, in the cloud, or across hybrid environments, GreptimeDB empowers real-time insights at massive scale — all in one system.

Features

| Feature | Description | | --------- | ----------- | | Unified Observability Data | Store metrics, logs, and traces as timestamped, contextual wide events. Query via SQL, PromQL, and streaming. | | High Performance & Cost Effective | Written in Rust, with a distributed query engine, rich indexing, and optimized columnar storage, delivering sub-second responses at PB scale. | | Cloud-Native Architecture | Designed for Kubernetes, with compute/storage separation, native object storage (AWS S3, Azure Blob, etc.) and seamless cross-cloud access. | | Developer-Friendly | Access via SQL/PromQL interfaces, REST API, MySQL/PostgreSQL protocols, and popular ingestion protocols. | | Flexible Deployment | Deploy anywhere: edge (including ARM/Android) or cloud, with unified APIs and efficient data sync. |

Learn more in Why GreptimeDB and Observability 2.0 and the Database for It.

Quick Comparison

| Feature | GreptimeDB | Traditional TSDB | Log Stores | |----------------------------------|-----------------------|--------------------|-----------------| | Data Types | Metrics, Logs, Traces | Metrics only | Logs only | | Query Language | SQL, PromQL, Streaming| Custom/PromQL | Custom/DSL | | Deployment | Edge + Cloud | Cloud/On-prem | Mostly central | | Indexing & Performance | PB-Scale, Sub-second | Varies | Varies | | Integration | REST, SQL, Common protocols | Varies | Varies |

Performance: * GreptimeDB tops JSONBench's billion-record cold run test! * TSBS Benchmark

Architecture

Read the architecture document.
DeepWiki provides an in-depth look at GreptimeDB:

Try GreptimeDB

1. Live Demo

Experience GreptimeDB directly in your browser.

2. GreptimeCloud

Start instantly with a free cluster.

3. Docker (Local Quickstart)

shell docker pull greptime/greptimedb

shell 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 Dashboard: http://localhost:4000/dashboard Full Install Guide

Troubleshooting: * Cannot connect to the database? Ensure that ports 4000, 4001, 4002, and 4003 are not blocked by a firewall or used by other services. * Failed to start? Check the container logs with docker logs greptime for further details.

Getting Started

Build From Source

Prerequisites: * 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 and Run: bash make cargo run -- standalone start

Tools & Extensions

Kubernetes: GreptimeDB Operator
Helm Charts: Greptime Helm Charts
Dashboard: Web UI
SDKs/Ingester: Go, Java, C++, Erlang, Rust, JS
Grafana: Official Dashboard

Project Status

Status: Beta. GA (v1.0): Targeted for mid 2025.

Being used in production by early adopters
Stable, actively maintained, with regular releases (version info)
Suitable for evaluation and pilot deployments

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

If you find this project useful, a ⭐ would mean a lot to us!

Community

We invite you to engage and contribute!

License

GreptimeDB is licensed under the Apache License 2.0.

Commercial Support

Running GreptimeDB in your organization? We offer enterprise add-ons, services, training, and consulting. Contact us for details.

Contributing

Read our Contribution Guidelines.
Explore Internal Concepts and DeepWiki.
Pick up a good first issue and join the #contributors Slack channel.

Acknowledgement

Special thanks to all contributors! See AUTHORS.md.

Uses Apache Arrow™ (memory model)
Apache Parquet™ (file storage)
Apache Arrow DataFusion™ (query engine)
Apache OpenDAL™ (data access abstraction)

Owner

Name: Greptime
Login: GreptimeTeam
Kind: organization
Email: info@greptime.com

Website: https://greptime.com
Twitter: greptime
Repositories: 11
Profile: https://github.com/GreptimeTeam

Time-series database, for the cloud era

Committers

Last synced: 9 months ago

All Time

Total Commits: 4,154
Total Committers: 110
Avg Commits per committer: 37.764
Development Distribution Score (DDS): 0.865

Past Year

Commits: 1,413
Committers: 49
Avg Commits per committer: 28.837
Development Distribution Score (DDS): 0.842

Top Committers

Name	Email	Commits
Weny Xu	w**a@g**m	560
Ruihang Xia	w**a@g**m	539
Yingwen	r**g@g**m	440
Lei, HUANG	6****r	293
Ning Sun	s**g@p**m	225
LFC	9****d	220
dennis zhuang	k**8@g**m	203
JeremyHi	j**g@p**e	189
discord9	5****9	182
zyy17	z**m@g**m	158
shuiyisong	1****g	145
Zhenchi	z**h@o**m	144
tison	w**6@g**m	104
Yohan Wal	p**b@g**m	59
fys	4****3	58
ZonaHe	z**e@q**m	45
Wei	1**5@1**m	45
localhost	x**n@g**m	44
yihong	z**8@g**m	43
liyang	l**2@1**m	37
Eugene Tolbakov	e**v@g**m	36
WU Jingdi	t**e@q**m	30
Niwaka	6****v	25
niebayes	n**s@g**m	21
fys	4****6	19
Lanqing Yang	l**y@u**u	15
yuanbohan	y**n@g**m	13
Lei, Huang	R****g	13
taobo	r**o@o**m	12
Vanish	d**h@1**m	12
and 80 more...

Committer Domains (Top 20 + Academic)

qq.com: 6 163.com: 3 foxmail.com: 2 yccd.cc: 1 bupt.edu.cn: 1 francisdu.com: 1 yinheli.com: 1 apache.org: 1 xuanwo.io: 1 126.com: 1 usc.edu: 1 proton.me: 1

Issues and Pull Requests

Last synced: 6 months ago

All Time

Total issues: 1,090
Total pull requests: 3,698
Average time to close issues: 3 months
Average time to close pull requests: 4 days
Total issue authors: 113
Total pull request authors: 96
Average comments per issue: 1.81
Average comments per pull request: 1.66
Merged pull requests: 2,933
Bot issues: 121
Bot pull requests: 16

Past Year

Issues: 534
Pull requests: 2,286
Average time to close issues: 14 days
Average time to close pull requests: 3 days
Issue authors: 73
Pull request authors: 58
Average comments per issue: 1.22
Average comments per pull request: 1.51
Merged pull requests: 1,790
Bot issues: 88
Bot pull requests: 4

View more stats

Top Authors

Issue Authors

WenyXu (133)
github-actions[bot] (120)
killme2008 (116)
evenyag (90)
waynexia (74)
MichaelScofield (68)
v0y4g3r (66)
sunng87 (62)
tisonkun (24)
zyy17 (23)
zhongzc (22)
shuiyisong (20)
discord9 (19)
0neSe7en (17)
vbmithr (14)

Pull Request Authors

WenyXu (579)
waynexia (389)
discord9 (301)
evenyag (300)
sunng87 (214)
v0y4g3r (208)
zhongzc (178)
zyy17 (155)
fengjiachun (142)
killme2008 (136)
shuiyisong (130)
MichaelScofield (127)
CookiePieWw (111)
yihong0618 (100)
tisonkun (82)

Top Labels

Issue Labels

C-enhancement (303) C-bug (226) O-ci-failure (120) C-feature (87) good first issue (69) Good first issue (42) help wanted (31) Enhancement (31) enhancement (24) Feature request (21) Bug (18) Help wanted (16) feature request (16) docs-not-required (15) C-performance (15) tracking-issue (13) bug (11) Tracking issue (10) A-storage (8) Difficulty: Easy (8) Size: M (8) Difficulty: Mid (7) A-frontend (7) A-metasrv (7) A-query (6) Storage (6) C-user-experience (6) User-Experience (5) performance (5) tracking issue (5)

Pull Request Labels

docs-not-required (2,354) Doc not needed (520) docs-required (173) size/XS (78) Size: M (61) Size: S (56) size/S (51) breaking-change (48) size/M (47) Doc update required (32) Size: L (26) size/xs (20) backport (17) Breaking change (13) Size: XL (11) Dependencies (10) size/L (9) A-flow (9) ci (9) A-storage (8) C-performance (7) documentation (6) release-blocker (6) good first issue (5) size/XL (5) performance (4) doc update required (4) breaking change (4) cloud followup required (4) C-bug (4)

Packages

Total packages: 2
Total downloads: unknown

Total dependent packages: 0
(may contain duplicates)
Total dependent repositories: 0
(may contain duplicates)
Total versions: 403

proxy.golang.org: github.com/greptimeteam/greptimedb

Documentation: https://pkg.go.dev/github.com/greptimeteam/greptimedb#section-documentation
License: apache-2.0
Latest release: v0.17.0
published 6 months ago

Versions: 202
Dependent Packages: 0
Dependent Repositories: 0

Rankings

Stargazers count: 1.3%

Forks count: 1.7%

Average: 4.8%

Dependent packages count: 7.0%

Dependent repos count: 9.3%

Last synced: 6 months ago

proxy.golang.org: github.com/GreptimeTeam/greptimedb

Documentation: https://pkg.go.dev/github.com/GreptimeTeam/greptimedb#section-documentation
License: apache-2.0
Latest release: v0.17.0
published 6 months ago

Versions: 201
Dependent Packages: 0
Dependent Repositories: 0

Rankings

Stargazers count: 1.3%

Forks count: 1.7%

Average: 4.8%

Dependent packages count: 7.0%

Dependent repos count: 9.3%

Last synced: 6 months ago

Dependencies

Cargo.lock cargo

565 dependencies

src/catalog/Cargo.toml cargo

chrono 0.4 development
opendal 0.17 development
tempdir 0.3 development
tokio 1.0 development
arc-swap 1.0
async-stream 0.3
async-trait 0.1
backoff 0.4
futures 0.3
futures-util 0.3
lazy_static 1.4
opendal 0.17
regex 1.6
serde 1.0
serde_json 1.0
snafu 0.7
tokio 1.18

src/client/Cargo.toml cargo

prost_09 0.9 development
substrait_proto 0.2 development
tokio 1.0 development
tracing 0.1 development
tracing-subscriber 0.3 development
async-stream 0.3
enum_dispatch 0.3
parking_lot 0.12
rand 0.8
snafu 0.7
tonic 0.8

src/cmd/Cargo.toml cargo

serde 1.0 development
tempdir 0.3 development
clap 3.1
futures 0.3
serde 1.0
snafu 0.7
tokio 1.18
toml 0.5

src/common/catalog/Cargo.toml cargo

chrono 0.4 development
tempdir 0.3 development
tokio 1.0 development
async-trait 0.1
lazy_static 1.4
regex 1.6
serde 1.0
serde_json 1.0
snafu 0.7

src/common/function/Cargo.toml cargo

ron 0.7 development
serde 1.0 development
arc-swap 1.0
arrow 0.10
chrono-tz 0.6
libc 0.2
num 0.4
num-traits 0.2
once_cell 1.10
paste 1.0
snafu 0.7
statrs 0.15

src/common/function-macro/Cargo.toml cargo

arc-swap 1.0 development
snafu 0.7 development
static_assertions 1.1.0 development
quote 1.0
syn 1.0

src/common/grpc/Cargo.toml cargo

criterion 0.4 development
rand 0.8 development
arrow 0.10
async-trait 0.1
dashmap 5.4
snafu 0.7
tokio 1.0
tonic 0.8
tower 0.4

src/common/query/Cargo.toml cargo

tokio 1.0 development
arrow 0.10
async-trait 0.1
snafu 0.7
statrs 0.15

src/common/recordbatch/Cargo.toml cargo

serde_json 1.0 development
tokio 1.18 development
futures 0.3
paste 1.0
serde 1.0
snafu 0.7

src/common/runtime/Cargo.toml cargo

tokio-test 0.4 development
metrics 0.20
once_cell 1.12
paste 1.0
snafu 0.7
tokio 1.18

src/common/substrait/Cargo.toml cargo

tokio 1.0 development
bytes 1.1
futures 0.3
prost 0.9
snafu 0.7
substrait_proto 0.2

src/datanode/Cargo.toml cargo

arrow 0.10 development
tempdir 0.3 development
arrow 0.10
async-trait 0.1
axum 0.6.0-rc.2
axum-macros 0.3.0-rc.1
futures 0.3
hyper 0.14
metrics 0.20
serde 1.0
serde_json 1.0
snafu 0.7
tokio 1.18
tokio-stream 0.1
tonic 0.8
tower 0.4
tower-http 0.3

src/frontend/Cargo.toml cargo

futures 0.3 development
tempdir 0.3 development
tonic 0.8 development
tower 0.4 development
arrow 0.10
async-stream 0.3
async-trait 0.1
chrono 0.4
futures 0.3
futures-util 0.3
itertools 0.10
moka 0.9
openmetrics-parser 0.4
prost 0.11
serde 1.0
serde_json 1.0
snafu 0.7
sqlparser 0.15
tokio 1.18

src/log-store/Cargo.toml cargo

rand 0.8 development
arc-swap 1.5
async-stream 0.3
async-trait 0.1
base64 0.13
byteorder 1.4
bytes 1.1
crc 3.0
futures 0.3
futures-util 0.3
hex 0.4
snafu 0.7
tempdir 0.3
tokio 1.18

src/meta-client/Cargo.toml cargo

futures 0.3 development
tower 0.4 development
tracing 0.1 development
tracing-subscriber 0.3 development
async-trait 0.1
etcd-client 0.10
rand 0.8
serde 1.0
snafu 0.7
tokio 1.18
tokio-stream 0.1
tonic 0.8

src/meta-srv/Cargo.toml cargo

tracing 0.1 development
tracing-subscriber 0.3 development
async-trait 0.1
etcd-client 0.10
futures 0.3
h2 0.3
http-body 0.4
lazy_static 1.4
parking_lot 0.12
prost 0.11
regex 1.6
serde 1.0
serde_json 1.0
snafu 0.7
tokio 1.0
tokio-stream 0.1
tonic 0.8
tower 0.4
url 2.3

src/object-store/Cargo.toml cargo

anyhow 1.0 development
tempdir 0.3 development
futures 0.3
opendal 0.17
tokio 1.0

src/query/Cargo.toml cargo

approx_eq 0.1 development
format_num 0.1 development
num 0.4 development
num-traits 0.2 development
paste 1.0 development
rand 0.8 development
statrs 0.15 development
stats-cli 3.0 development
streaming-stats 0.2 development
tokio 1.0 development
tokio-stream 0.1 development
arc-swap 1.0
arrow 0.10
async-trait 0.1
futures 0.3
futures-util 0.3
metrics 0.20
serde 1.0
serde_json 1.0
snafu 0.7
tokio 1.0

src/script/Cargo.toml cargo

ron 0.7 development
serde 1.0 development
tempdir 0.3 development
tokio 1.18 development
tokio-test 0.4 development
async-trait 0.1
console 0.15
futures 0.3
futures-util 0.3
paste 1.0
snafu 0.7
tokio 1.0

src/servers/Cargo.toml cargo

rand 0.8 development
tokio-postgres 0.7 development
tokio-test 0.4 development
aide 0.6
async-trait 0.1
axum 0.6.0-rc.2
axum-macros 0.3.0-rc.1
bytes 1.2
futures 0.3
hex 0.4
hyper 0.14
metrics 0.20
num_cpus 1.13
once_cell 1.16
openmetrics-parser 0.4
opensrv-mysql 0.1
pgwire 0.5
prost 0.11
rand 0.8
regex 1.6
schemars 0.8
serde 1.0
serde_json 1.0
snafu 0.7
snap 1
tokio 1.20
tokio-stream 0.1
tonic 0.8
tonic-reflection 0.5
tower 0.4
tower-http 0.3

src/storage/Cargo.toml cargo

atomic_float 0.1 development
criterion 0.3 development
rand 0.8 development
tempdir 0.3 development
arc-swap 1.0
arrow-format 0.4
async-stream 0.3
async-trait 0.1
bytes 1.1
futures 0.3
futures-util 0.3
lazy_static 1.4
paste 1.0
planus 0.2
prost 0.11
regex 1.5
serde 1.0
serde_json 1.0
sluice 0.5
snafu 0.7
tokio 1.18
tonic 0.8
uuid 1.1

src/store-api/Cargo.toml cargo

async-stream 0.3 development
serde_json 1.0 development
tokio 1.0 development
async-trait 0.1
bytes 1.1
derive_builder 0.11
futures 0.3
serde 1.0
snafu 0.7

src/table/Cargo.toml cargo

tempdir 0.3 development
tokio-util 0.7 development
async-trait 0.1
chrono 0.4
derive_builder 0.11
futures 0.3
parquet-format-async-temp 0.2
paste 1.0
serde 1.0.136
snafu 0.7
tokio 1.18

src/table-engine/Cargo.toml cargo

tempdir 0.3 development
tokio 1.18 development
arc-swap 1.0
async-stream 0.3
async-trait 0.1
chrono 0.4
futures 0.3
serde 1.0
serde_json 1.0
snafu 0.7
tempdir 0.3
tokio 1.0

https://github.com/greptimeteam/greptimedb

Science Score: 36.0%

Keywords

Keywords from Contributors

Repository

Basic Info

Statistics

Topics

Metadata Files

README.md

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

GreptimeCloud | User Guide | API Docs | Roadmap 2025

Introduction

Features

Quick Comparison

Architecture

Try GreptimeDB

1. Live Demo

2. GreptimeCloud

3. Docker (Local Quickstart)

Getting Started

Build From Source

Tools & Extensions

Project Status

Community

License

Commercial Support

Contributing

Acknowledgement

Owner

Committers

All Time

Past Year

Top Committers

Committer Domains (Top 20 + Academic)

Issues and Pull Requests

All Time

Past Year

Top Authors

Issue Authors

Pull Request Authors

Top Labels

Issue Labels

Pull Request Labels

Packages

proxy.golang.org: github.com/greptimeteam/greptimedb

Rankings

proxy.golang.org: github.com/GreptimeTeam/greptimedb

Rankings

Dependencies

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