# influxdata/influxdb architecture

> Architecture diagram of the GitHub repository influxdata/influxdb, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/influxdata/influxdb
- Repository: https://github.com/influxdata/influxdb

## Overview

InfluxDB 3 Core is a time-series database for ingesting, transforming, storing, and querying event data. Its principal workflow accepts HTTP writes, buffers and persists data as Parquet, then serves SQL, InfluxQL, and FlightSQL queries. The README documents these product capabilities; the sampled excerpts and source index establish several internal modules and references, but do not expose the full write/query wiring. Dashed edges mark those unverified connections rather than asserting a call sequence.

Main entry points: [`influxdb3_internal_api/src/query_executor.rs`](https://github.com/influxdata/influxdb/blob/main/influxdb3_internal_api/src/query_executor.rs) (Query Executor), [`influxdb3_write/src/write_buffer/queryable_buffer.rs`](https://github.com/influxdata/influxdb/blob/main/influxdb3_write/src/write_buffer/queryable_buffer.rs) (Queryable Write Buffer), [`influxdb3_server/src/http.rs`](https://github.com/influxdata/influxdb/blob/main/influxdb3_server/src/http.rs) (HTTP Server), [`core/iox_http/src/write`](https://github.com/influxdata/influxdb/tree/main/core/iox_http/src/write) (Write APIs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Client APIs"]
  node_http["HTTP Server<br/>[http.rs]"]
  node_write_api["Write APIs"]
  node_query_api["Query APIs<br/>[handler.rs]"]
  node_flight_sql["FlightSQL<br/>[lib.rs]"]
end

subgraph group_ingest["Write and Storage"]
  node_line_protocol["Line Protocol<br/>[lib.rs]"]
  node_write_buffer["Queryable Write Buffer"]
  node_table_buffer["Table Buffer<br/>[table_buffer.rs]"]
  node_wal["Write-Ahead Log<br/>[lib.rs]"]
  node_persister["Parquet Persister<br/>[persister.rs]"]
  node_parquet_storage["Parquet Storage<br/>[storage.rs]"]
  node_object_store[("Object Storage")]
end

subgraph group_query["Query Engine"]
  node_query_executor["Query Executor<br/>[query_executor.rs]"]
  node_query_planner["Query Planner<br/>[query_planner.rs]"]
  node_influxql["InfluxQL Planner<br/>[planner.rs]"]
  node_query_execution["Query Execution<br/>[exec.rs]"]
  node_physical_optimizer["Physical Optimizers<br/>[mod.rs]"]
  node_deduplicate["Chunk Deduplication<br/>[deduplicate.rs]"]
end

subgraph group_catalog["Catalog and State"]
  node_catalog[("Catalog<br/>[storage.rs]")]
  node_catalog_cache["Catalog Cache API<br/>[server.rs]"]
end

subgraph group_plugins["Plugins and Operations"]
  node_processing_engine["Python Processing Engine<br/>[manager.rs]"]
  node_system_tables["System Tables<br/>[lib.rs]"]
  node_query_log["Query Log<br/>[query_log.rs]"]
end

node_client(("Client"))

node_client -->|"sends requests"| node_http
node_http -.->|"routes writes"| node_write_api
node_write_api -->|"accepts line protocol"| node_line_protocol
node_write_api -.->|"submits writes"| node_write_buffer
node_write_buffer -->|"uses buffers"| node_table_buffer
node_write_buffer -->|"persists chunks"| node_persister
node_write_buffer -.->|"records writes"| node_wal
node_persister -.->|"uploads Parquet"| node_parquet_storage
node_parquet_storage -->|"reads and writes"| node_object_store
node_client -->|"queries over HTTP"| node_query_api
node_http -.->|"routes queries"| node_query_api
node_query_api -.->|"dispatches queries"| node_query_executor
node_query_executor -.->|"plans queries"| node_query_planner
node_query_executor -.->|"handles InfluxQL"| node_influxql
node_query_executor -.->|"executes plans"| node_query_execution
node_query_execution -->|"optimizes plans"| node_physical_optimizer
node_query_execution -.->|"uses providers"| node_deduplicate
node_client -->|"queries with FlightSQL"| node_flight_sql
node_query_executor -->|"tracks queries"| node_query_log
node_client -.->|"uses cache API"| node_catalog_cache
node_processing_engine -.->|"uses catalog state"| node_catalog
node_client -.->|"invokes plugins"| node_processing_engine
node_client -.->|"queries system tables"| node_system_tables

click node_http "https://github.com/influxdata/influxdb/blob/main/influxdb3_server/src/http.rs"
click node_write_api "https://github.com/influxdata/influxdb/tree/main/core/iox_http/src/write"
click node_line_protocol "https://github.com/influxdata/influxdb/blob/main/core/influxdb_line_protocol/src/lib.rs"
click node_write_buffer "https://github.com/influxdata/influxdb/blob/main/influxdb3_write/src/write_buffer/queryable_buffer.rs"
click node_table_buffer "https://github.com/influxdata/influxdb/blob/main/influxdb3_write/src/write_buffer/table_buffer.rs"
click node_wal "https://github.com/influxdata/influxdb/blob/main/influxdb3_wal/src/lib.rs"
click node_persister "https://github.com/influxdata/influxdb/blob/main/influxdb3_write/src/persister.rs"
click node_parquet_storage "https://github.com/influxdata/influxdb/blob/main/core/parquet_file/src/storage.rs"
click node_query_executor "https://github.com/influxdata/influxdb/blob/main/influxdb3_internal_api/src/query_executor.rs"
click node_query_planner "https://github.com/influxdata/influxdb/blob/main/influxdb3_query_executor/src/query_planner.rs"
click node_influxql "https://github.com/influxdata/influxdb/blob/main/core/iox_query_influxql/src/frontend/planner.rs"
click node_query_execution "https://github.com/influxdata/influxdb/blob/main/core/iox_query/src/exec.rs"
click node_physical_optimizer "https://github.com/influxdata/influxdb/blob/main/core/iox_query/src/physical_optimizer/mod.rs"
click node_deduplicate "https://github.com/influxdata/influxdb/blob/main/core/iox_query/src/provider/deduplicate.rs"
click node_query_api "https://github.com/influxdata/influxdb/blob/main/core/iox_v1_query_api/src/handler.rs"
click node_flight_sql "https://github.com/influxdata/influxdb/blob/main/core/flightsql/src/lib.rs"
click node_catalog "https://github.com/influxdata/influxdb/blob/main/influxdb3_catalog/src/catalog/versions/v3/schema/storage.rs"
click node_catalog_cache "https://github.com/influxdata/influxdb/blob/main/core/catalog_cache/src/api/server.rs"
click node_processing_engine "https://github.com/influxdata/influxdb/blob/main/influxdb3_processing_engine/src/manager.rs"
click node_system_tables "https://github.com/influxdata/influxdb/blob/main/influxdb3_system_tables/src/lib.rs"
click node_query_log "https://github.com/influxdata/influxdb/blob/main/core/iox_query/src/query_log.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_http,node_write_api,node_query_api,node_flight_sql,node_client toneBlue
class node_line_protocol,node_write_buffer,node_table_buffer,node_wal,node_persister,node_parquet_storage,node_object_store toneAmber
class node_query_executor,node_query_planner,node_influxql,node_query_execution,node_physical_optimizer,node_deduplicate toneMint
class node_catalog,node_catalog_cache toneRose
class node_processing_engine,node_system_tables,node_query_log toneIndigo
```

## Components

### Client APIs

- [HTTP Server](https://github.com/influxdata/influxdb/blob/main/influxdb3_server/src/http.rs): `influxdb3_server/src/http.rs`
- [Write APIs](https://github.com/influxdata/influxdb/tree/main/core/iox_http/src/write): `core/iox_http/src/write`
- [Query APIs](https://github.com/influxdata/influxdb/blob/main/core/iox_v1_query_api/src/handler.rs): `core/iox_v1_query_api/src/handler.rs`
- [FlightSQL](https://github.com/influxdata/influxdb/blob/main/core/flightsql/src/lib.rs): `core/flightsql/src/lib.rs`

### Write and Storage

- [Line Protocol](https://github.com/influxdata/influxdb/blob/main/core/influxdb_line_protocol/src/lib.rs): `core/influxdb_line_protocol/src/lib.rs`
- [Queryable Write Buffer](https://github.com/influxdata/influxdb/blob/main/influxdb3_write/src/write_buffer/queryable_buffer.rs): `influxdb3_write/src/write_buffer/queryable_buffer.rs`
- [Table Buffer](https://github.com/influxdata/influxdb/blob/main/influxdb3_write/src/write_buffer/table_buffer.rs): `influxdb3_write/src/write_buffer/table_buffer.rs`
- [Write-Ahead Log](https://github.com/influxdata/influxdb/blob/main/influxdb3_wal/src/lib.rs): `influxdb3_wal/src/lib.rs`
- [Parquet Persister](https://github.com/influxdata/influxdb/blob/main/influxdb3_write/src/persister.rs): `influxdb3_write/src/persister.rs`
- [Parquet Storage](https://github.com/influxdata/influxdb/blob/main/core/parquet_file/src/storage.rs): `core/parquet_file/src/storage.rs`
- **Object Storage**

### Query Engine

- [Query Executor](https://github.com/influxdata/influxdb/blob/main/influxdb3_internal_api/src/query_executor.rs): `influxdb3_internal_api/src/query_executor.rs`
- [Query Planner](https://github.com/influxdata/influxdb/blob/main/influxdb3_query_executor/src/query_planner.rs): `influxdb3_query_executor/src/query_planner.rs`
- [InfluxQL Planner](https://github.com/influxdata/influxdb/blob/main/core/iox_query_influxql/src/frontend/planner.rs): `core/iox_query_influxql/src/frontend/planner.rs`
- [Query Execution](https://github.com/influxdata/influxdb/blob/main/core/iox_query/src/exec.rs): `core/iox_query/src/exec.rs`
- [Physical Optimizers](https://github.com/influxdata/influxdb/blob/main/core/iox_query/src/physical_optimizer/mod.rs): `core/iox_query/src/physical_optimizer/mod.rs`
- [Chunk Deduplication](https://github.com/influxdata/influxdb/blob/main/core/iox_query/src/provider/deduplicate.rs): `core/iox_query/src/provider/deduplicate.rs`

### Catalog and State

- [Catalog](https://github.com/influxdata/influxdb/blob/main/influxdb3_catalog/src/catalog/versions/v3/schema/storage.rs): `influxdb3_catalog/src/catalog/versions/v3/schema/storage.rs`
- [Catalog Cache API](https://github.com/influxdata/influxdb/blob/main/core/catalog_cache/src/api/server.rs): `core/catalog_cache/src/api/server.rs`

### Plugins and Operations

- [Python Processing Engine](https://github.com/influxdata/influxdb/blob/main/influxdb3_processing_engine/src/manager.rs): `influxdb3_processing_engine/src/manager.rs`
- [System Tables](https://github.com/influxdata/influxdb/blob/main/influxdb3_system_tables/src/lib.rs): `influxdb3_system_tables/src/lib.rs`
- [Query Log](https://github.com/influxdata/influxdb/blob/main/core/iox_query/src/query_log.rs): `core/iox_query/src/query_log.rs`

### Other components

- **Client**

## Connections

- Client → HTTP Server: sends requests (evidence: `README.md`)
- HTTP Server → Write APIs: routes writes
- Write APIs → Line Protocol: accepts line protocol (evidence: `README.md`)
- Write APIs → Queryable Write Buffer: submits writes
- Queryable Write Buffer → Table Buffer: uses buffers (evidence: `influxdb3_write/src/write_buffer/queryable_buffer.rs`)
- Queryable Write Buffer → Parquet Persister: persists chunks (evidence: `influxdb3_write/src/write_buffer/queryable_buffer.rs`)
- Queryable Write Buffer → Write-Ahead Log: records writes
- Parquet Persister → Parquet Storage: uploads Parquet
- Parquet Storage → Object Storage: reads and writes (evidence: `core/parquet_file/src/storage.rs`)
- Client → Query APIs: queries over HTTP (evidence: `README.md`)
- HTTP Server → Query APIs: routes queries
- Query APIs → Query Executor: dispatches queries
- Query Executor → Query Planner: plans queries
- Query Executor → InfluxQL Planner: handles InfluxQL
- Query Executor → Query Execution: executes plans
- Query Execution → Physical Optimizers: optimizes plans (evidence: `core/iox_query/src/exec.rs`)
- Query Execution → Chunk Deduplication: uses providers
- Client → FlightSQL: queries with FlightSQL (evidence: `README.md`)
- Query Executor → Query Log: tracks queries (evidence: `core/iox_query/src/query_log.rs`)
- Client → Catalog Cache API: uses cache API
- Python Processing Engine → Catalog: uses catalog state
- Client → Python Processing Engine: invokes plugins (evidence: `README.md`)
- Client → System Tables: queries system tables
