# greptimedb | Greptime | Knowledge Base | Instagit

One database for metrics, logs, and traces. The unified OpenTelemetry  backend that replaces Prometheus, Loki, and ES — with SQL + PromQL  on object storage.

GitHub Stars: 6k

Repository: https://github.com/greptimeteam/greptimedb

---

## Articles

### [How the GreptimeDB Client Module Enables External Application Integration](/greptimeteam/greptimedb/how-does-the-client-module-interact-with-greptimedb-from-external-applications)

Discover how the GreptimeDB client module integrates external apps. Learn about its Rust API for seamless communication via gRPC and Arrow Flight.

- Tags: how-to-guide
- Published: 2026-03-02

### [How GreptimeDB's Procedure Framework Manages Distributed Operations Like Region Migration](/greptimeteam/greptimedb/how-does-the-procedure-framework-manage-distributed-operations-like-region-migration)

Learn how GreptimeDBs procedure framework manages distributed operations like region migration. This fault tolerant state machine ensures operations resume after node crashes.

- Tags: internals
- Published: 2026-03-02

### [How GreptimeDB's Pipeline ETL System Transforms Data During Ingestion](/greptimeteam/greptimedb/how-does-the-pipeline-etl-system-transform-data-during-ingestion)

GreptimeDB's pipeline ETL system transforms data during ingestion using VRL processors and dispatcher rules. Learn how to map fields to typed columns with schemas or inference.

- Tags: deep-dive
- Published: 2026-03-02

### [How the GreptimeDB Index Module Provides Full-Text and Vector Search Capabilities](/greptimeteam/greptimedb/how-does-the-index-module-provide-full-text-and-vector-search-capabilities)

Explore how the GreptimeDB index module delivers powerful full-text and vector search using Tantivy and USearch. Discover unified index storage with Puffin blobs and standardized metadata.

- Tags: deep-dive
- Published: 2026-03-02

### [How GreptimeDB Enables Edge Deployments on ARM Devices Using a Single Codebase](/greptimeteam/greptimedb/how-do-edge-deployments-work-on-arm-devices-with-the-same-codebase)

Discover how GreptimeDB achieves seamless edge deployments on ARM devices. Learn how its single codebase and multi-platform Docker builds enable ARM64 installations with zero code changes.

- Tags: how-to-guide
- Published: 2026-03-02

### [How the Metric Engine Works for Observability Data in GreptimeDB](/greptimeteam/greptimedb/how-does-the-metric-engine-work-for-observability-data-processing)

Discover how GreptimeDB's Metric Engine processes observability data. Learn how it handles high-cardinality workloads using the Mito storage backbone for efficient metric storage and retrieval.

- Tags: internals
- Published: 2026-03-02

### [How GreptimeDB Manages Database Metadata Across Distributed Nodes](/greptimeteam/greptimedb/how-does-the-catalog-manage-database-metadata-across-distributed-nodes)

Discover how GreptimeDB manages distributed database metadata using etcd and its KvBackendCatalogManager for efficient, low-latency catalog operations.

- Tags: internals
- Published: 2026-03-02

### [How GreptimeDB Handles Protocol Compatibility with MySQL and PostgreSQL Clients](/greptimeteam/greptimedb/how-does-greptimedb-handle-protocol-compatibility-with-mysql-and-postgresql-clients)

GreptimeDB achieves MySQL and PostgreSQL protocol compatibility using independent wire-protocol servers, allowing native clients to connect directly without special drivers. Discover how.

- Tags: deep-dive
- Published: 2026-03-02

### [How Flow Computation Enables Real-Time Stream Processing in GreptimeDB](/greptimeteam/greptimedb/how-does-flow-computation-enable-real-time-stream-processing)

Discover how GreptimeDB's flow computation delivers real-time stream processing with sub-second latency for continuous aggregation using incremental state and delta reads.

- Tags: internals
- Published: 2026-03-02

### [How GreptimeDB WAL Ensures Data Durability: A Deep Dive into the Write-Ahead Log Implementation](/greptimeteam/greptimedb/how-does-the-wal-write-ahead-log-ensure-data-durability-in-greptimedb)

Discover how GreptimeDB WAL ensures data durability. Learn about its pluggable implementation and atomic persistence for reliable data protection.

- Tags: deep-dive
- Published: 2026-03-02

### [GreptimeDB Storage Engine Configuration Options for Compaction, Flush, and GC](/greptimeteam/greptimedb/what-configuration-options-control-compaction-flush-and-gc-in-the-storage-engine)

Tune GreptimeDB storage engine performance with compaction, flush, and GC configuration options. Optimize background workers and scheduling using TOML keys.

- Tags: internals
- Published: 2026-03-02

### [How the RegionServer Handles Read and Write Requests in the GreptimeDB Datanode](/greptimeteam/greptimedb/how-does-the-region-server-handle-read-and-write-requests-in-the-datanode)

Learn how GreptimeDB's RegionServer processes read and write requests. Discover efficient data handling for reads via Arrow Flight and high-throughput writes via gRPC.

- Tags: internals
- Published: 2026-03-02

### [How GreptimeDB OpenTelemetry Integration Supports Metrics, Logs, and Traces Ingestion](/greptimeteam/greptimedb/how-does-the-opentelemetry-integration-support-metrics-logs-and-traces-ingestion)

GreptimeDB's OpenTelemetry integration unifies metrics, logs, and traces ingestion via HTTP protobuf. Optimize your data pipeline with this powerful feature.

- Tags: how-to-guide
- Published: 2026-03-02

### [High Availability and Failover in GreptimeDB: A Technical Deep Dive](/greptimeteam/greptimedb/what-are-the-mechanisms-for-high-availability-and-failover-in-greptimedb)

Explore GreptimeDBs high availability and failover. Discover how its region-level HA subsystem ensures service continuity with advanced failure detection and automated orchestration.

- Tags: deep-dive
- Published: 2026-03-02

### [How Data Distribution Works in GreptimeDB Distributed Mode with Partition Expressions](/greptimeteam/greptimedb/how-does-data-distribution-work-in-distributed-mode-with-partition-expressions)

Learn how GreptimeDB distributes data in distributed mode using partition expressions for efficient writes and reads. Understand PartitionRuleManager, RowSplitter, and ConstraintPruner.

- Tags: internals
- Published: 2026-03-02

### [How Different Index Types (Inverted, Fulltext, Skipping, Vector) Improve Query Performance in GreptimeDB](/greptimeteam/greptimedb/how-do-different-index-types-inverted-fulltext-skipping-vector-improve-query-performance)

Learn how GreptimeDB's inverted, fulltext, skipping, and vector index types boost query performance by reducing I/O and optimizing data access. Discover the power of targeted reads over full table scans.

- Tags: performance
- Published: 2026-03-02

### [How PromQL Integration Works Alongside SQL in GreptimeDB: Architecture Deep Dive](/greptimeteam/greptimedb/how-does-promql-integration-work-alongside-sql-in-greptimedb)

Discover how GreptimeDB seamlessly integrates PromQL with SQL. Learn about its architecture for unified query execution on a single vectorized engine.

- Tags: architecture
- Published: 2026-03-02

### [How GreptimeDB's SQL Parser Handles Partition Routing for Query Execution](/greptimeteam/greptimedb/how-does-the-sql-parser-handle-query-execution-with-partition-routing)

GreptimeDB routes SQL queries to partitions using its SQL parser. Learn how ordering patterns and distribution hints optimize query execution by targeting relevant regions.

- Tags: internals
- Published: 2026-03-02

### [How Garbage Collection Works in GreptimeDB to Clean Up Obsolete Data](/greptimeteam/greptimedb/how-does-garbage-collection-work-in-greptimedb-to-clean-up-obsolete-data)

Discover how GreptimeDB garbage collection cleans obsolete data. Learn about its two-phase pipeline, meta-service scheduling, datanode execution, and safe file deletion strategies.

- Tags: internals
- Published: 2026-03-02

### [How the Mito2 Compaction Scheduler Manages SST Files in GreptimeDB](/greptimeteam/greptimedb/how-does-the-compaction-scheduler-work-in-mito2-to-manage-sst-files)

Discover how the Mito2 compaction scheduler expertly manages SST files in GreptimeDB. Learn about its strategy selection, request deduplication, and execution process to optimize performance.

- Tags: internals
- Published: 2026-03-02

### [How Region Partitioning Works in GreptimeDB for Horizontal Scaling](/greptimeteam/greptimedb/how-does-region-partitioning-work-in-greptimedb-for-horizontal-scaling)

Discover how GreptimeDB achieves horizontal scaling with region partitioning and pluggable rules to distribute data efficiently across datanodes for better performance.

- Tags: internals
- Published: 2026-03-02

### [How the Mito2 Storage Engine Handles Time-Series Data with Region Workers and Memtables](/greptimeteam/greptimedb/how-does-the-mito2-storage-engine-handle-time-series-data-with-region-workers-and-memtables)

Discover how the Mito2 storage engine efficiently processes time-series data using region workers and memtables. Learn about its optimized write operations and fast data buffering.

- Tags: internals
- Published: 2026-03-02

### [How GreptimeDB's Distributed Architecture Distributes Data Across Frontend, Datanode, and Metasrv Components](/greptimeteam/greptimedb/how-does-greptimedbs-distributed-architecture-distribute-data-across-frontend-datanode-and-metasrv-components)

Discover how GreptimeDB's distributed architecture efficiently distributes data. Learn about frontend, datanode, and metasrv roles in managing and routing time-series data for optimal performance.

- Tags: architecture
- Published: 2026-03-02

