greptimedb/config/config.md

Configurations

• Configurations
  • Standalone Mode
  • Distributed Mode
    • Frontend
    • Metasrv
    • Datanode
    • Flownode

Standalone Mode

Key	Type	Default	Descriptions
default_timezone	String	Unset	The default timezone of the server.
default_column_prefix	String	Unset	The default column prefix for auto-created time index, value, and native histogram columns. Legacy OTLP summary columns keep their historical greptime_ prefix.
auto_create_table	Bool	true	Server-side global switch for auto table creation on write. When false, a missing table is never auto-created even if the request sets the auto_create_table hint to true. Default: true.
experimental_metric_export	Bool	false	Enables experimental Parquet COPY DATABASE using shared Metric physical scans. Resume requires the previous export and storage writes to have ended; HTTP timeout is not confirmation.
user_provider	String	Unset	The user provider for authentication. Examples: "static_user_provider:file:/path/to/users", "static_user_provider:cmd:greptime_user=greptime_pwd" Password verifier formats: "plain:", "pbkdf2_sha256::<hex_salt>:<hex_hash>", "mysql_native_password:<hex_sha1_sha1_password>", "pg_scram_sha256::<hex_salt>:<hex_stored_key>:<hex_server_key>" "pbkdf2_sha256" and "pg_scram_sha256" protect passwords at rest, but such users cannot log in over MySQL: static_user_provider and watch_file_user_provider only negotiate mysql_native_password, which cannot verify these formats. "mysql_native_password" is MySQL-specific and cannot authenticate over PostgreSQL at all. PostgreSQL SCRAM only covers "plain" and "pg_scram_sha256" users; if any user is "pbkdf2_sha256" or "mysql_native_password", PostgreSQL falls back to cleartext password auth for every user. For "pg_scram_sha256" users, keep the default iteration count (4096) and salt length (16): both are observable in the SCRAM server-first message, and non-default values weaken resistance to username enumeration.
max_in_flight_write_bytes	String	0	Maximum total memory for all concurrent write request bodies and messages (HTTP, gRPC, Flight). Set to 0 to disable the limit. Default: "0" (unlimited)
write_bytes_exhausted_policy	String	wait	Policy when write bytes quota is exhausted. Options: "wait" (default, 10s timeout), "wait()" (e.g., "wait(30s)"), "fail"
init_regions_in_background	Bool	false	Initialize all regions in the background during the startup. By default, it provides services after all regions have been initialized.
init_regions_parallelism	Integer	16	Parallelism of initializing regions.
enable_telemetry	Bool	true	Enable telemetry to collect anonymous usage data. Enabled by default.
runtime	--	--	The runtime options.
runtime.global_rt_size	Integer	Auto	The number of threads to execute the runtime for global read operations. Defaults to max(num_cpus, 2).
runtime.compact_rt_size	Integer	Auto	The number of threads to execute compact operations. Defaults to max(num_cpus / 2, 2).
runtime.compact_rt_max_blocking_threads	Integer	Auto	The maximum number of blocking threads for compact operations. Defaults to max(num_cpus / 2, 2).
runtime.experimental_workload_scheduler	--	--	Experimental weighted, work-conserving query/write task scheduler.
runtime.experimental_workload_scheduler.enable	Bool	false	Enable when concurrent queries and writes interfere with each other—for example, when long-running queries increase ingestion latency. The weights set their relative runtime shares while both are backlogged. Disabled by default.
runtime.experimental_workload_scheduler.query_weight	Integer	2	Relative query share while both query and write workloads are backlogged.
runtime.experimental_workload_scheduler.write_weight	Integer	8	Relative write share while both query and write workloads are backlogged.
runtime.experimental_workload_scheduler.sample_every_polls	Integer	16	Number of polls between scheduler fairness samples. Must be greater than zero.
http	--	--	The HTTP server options.
http.addr	String	127.0.0.1:4000	The address to bind the HTTP server.
http.timeout	String	0s	HTTP request timeout. Set to 0 to disable timeout. When synchronous Prometheus, OTLP metrics, or ordinary-table batching is enabled, a nonzero timeout is raised to at least the largest active flush interval plus 1 second. The intervals come from pending_rows_batcher.logical_table.pending_rows_flush_interval and pending_rows_batcher.pending_rows_flush_interval.
http.body_limit	String	64MB	HTTP request body limit. The following units are supported: B, KB, KiB, MB, MiB, GB, GiB, TB, TiB, PB, PiB. Set to 0 to disable limit.
http.enable_cors	Bool	true	HTTP CORS support, it's turned on by default This allows browser to access http APIs without CORS restrictions
http.cors_allowed_origins	Array	Unset	Customize allowed origins for HTTP CORS.
http.enable_api_server	Bool	false	Whether to start the dedicated public HTTP API server. This server serves only the v1 interfaces plus the dashboard, and shares every other [http] option with the main server. It is disabled by default; set to true to enable.
http.api_server_addr	String	127.0.0.1:4006	The address to bind the dedicated HTTP API server, in the same form as addr. Defaults to 127.0.0.1:4006.
grpc	--	--	The gRPC server options.
grpc.bind_addr	String	127.0.0.1:4001	The address to bind the gRPC server.
grpc.runtime_size	Integer	8	The number of server worker threads.
grpc.max_connection_age	String	Unset	The maximum connection age for gRPC connection. The value can be a human-readable time string. For example: 10m for ten minutes or 1h for one hour. Refer to https://grpc.io/docs/guides/keepalive/ for more details.
grpc.tls	--	--	gRPC server TLS options, see mysql.tls section.
grpc.tls.mode	String	disable	TLS mode.
grpc.tls.cert_path	String	Unset	Certificate file path.
grpc.tls.key_path	String	Unset	Private key file path.
grpc.tls.watch	Bool	false	Watch for Certificate and key file change and auto reload. For now, gRPC tls config does not support auto reload.
mysql	--	--	MySQL server options.
mysql.enable	Bool	true	Whether to enable.
mysql.addr	String	127.0.0.1:4002	The addr to bind the MySQL server.
mysql.runtime_size	Integer	2	The number of server worker threads.
mysql.keep_alive	String	0s	Server-side keep-alive time. Set to 0 (default) to disable.
mysql.prepared_stmt_cache_size	Integer	10000	Maximum entries in the MySQL prepared statement cache; default is 10,000.
mysql.tls	--	--	--
mysql.tls.mode	String	disable	TLS mode, refer to https://www.postgresql.org/docs/current/libpq-ssl.html - disable (default value) - prefer - require - verify-ca - verify-full
mysql.tls.cert_path	String	Unset	Certificate file path.
mysql.tls.key_path	String	Unset	Private key file path.
mysql.tls.watch	Bool	false	Watch for Certificate and key file change and auto reload
postgres	--	--	PostgresSQL server options.
postgres.enable	Bool	true	Whether to enable
postgres.addr	String	127.0.0.1:4003	The addr to bind the PostgresSQL server.
postgres.runtime_size	Integer	2	The number of server worker threads.
postgres.keep_alive	String	0s	Server-side keep-alive time. Set to 0 (default) to disable.
postgres.tls	--	--	PostgresSQL server TLS options, see mysql.tls section.
postgres.tls.mode	String	disable	TLS mode.
postgres.tls.cert_path	String	Unset	Certificate file path.
postgres.tls.key_path	String	Unset	Private key file path.
postgres.tls.watch	Bool	false	Watch for Certificate and key file change and auto reload
opentsdb	--	--	OpenTSDB protocol options.
opentsdb.enable	Bool	true	Whether to enable OpenTSDB put in HTTP API.
influxdb	--	--	InfluxDB protocol options.
influxdb.enable	Bool	true	Whether to enable InfluxDB protocol in HTTP API.
influxdb.default_merge_mode	String	last_non_null	Default merge mode for tables automatically created by InfluxDB protocol. Available values: "last_non_null", "last_row".
pending_rows_batcher	--	--	Ordinary-table batching for opted-in ingestion protocols. PENDING_ROWS_BATCH_SYNC defaults to true for both batchers. Set it to false to acknowledge queue admission without waiting for storage; later failures cannot be returned to the client. Omitted or empty protocols disables batching. Prom without metric engine uses this batcher. OTLP logs, traces and ordinary metrics use this batcher. MySQL and PostgreSQL use the same acknowledgement policy. Protocol timeouts are unchanged. Single-connection writes and INSERT SELECT may incur additional flush waits.
pending_rows_batcher.pending_rows_flush_interval	String	0s	Flush interval measured from the first pending submission. Zero disables batching.
pending_rows_batcher.max_batch_rows	Integer	100000	Flush after a complete submission reaches this row threshold.
pending_rows_batcher.max_concurrent_flushes	Integer	256	Maximum concurrent flushes shared by the frontend batcher.
pending_rows_batcher.worker_channel_capacity	Integer	65536	Maximum queued submissions per table worker.
pending_rows_batcher.max_inflight_requests	Integer	3000	Maximum admitted original requests awaiting completion.
pending_rows_batcher.flow_notification_queue_capacity	Integer	1024	Maximum number of queued table Flow notifications.
pending_rows_batcher.logical_table	--	--	Metric-engine logical-table batching for Prom remote write and non-legacy OTLP metrics. Requires prom_store.with_metric_engine. Logs, traces and legacy metrics are not eligible. Enable independently with protocols and a nonzero flush interval. Omitted fields use independent defaults, not parent settings. Empty protocols or a zero interval disables logical batching without fallback. Omitting this entire section preserves legacy Prom batching; it does not enable OTLP batching.
pending_rows_batcher.logical_table.pending_rows_flush_interval	String	0s	Flush interval measured from the first pending submission. Zero disables batching.
pending_rows_batcher.logical_table.max_batch_rows	Integer	100000	Flush after a complete submission reaches this row threshold.
pending_rows_batcher.logical_table.max_concurrent_flushes	Integer	256	Maximum concurrent flushes shared by Prom and OTLP metrics.
pending_rows_batcher.logical_table.worker_channel_capacity	Integer	65536	Maximum queued submissions per physical-table worker.
pending_rows_batcher.logical_table.max_inflight_requests	Integer	3000	Maximum admitted original requests awaiting completion.
pending_rows_batcher.logical_table.flow_notification_queue_capacity	Integer	1024	Maximum number of queued logical-table Flow notifications.
jaeger	--	--	Jaeger protocol options.
jaeger.enable	Bool	true	Whether to enable Jaeger protocol in HTTP API.
otlp	--	--	OpenTelemetry protocol options.
otlp.enable	Bool	true	Whether to enable OpenTelemetry protocol in HTTP API.
otlp.trace_ingest_chunk_size	Integer	512	Maximum spans per trace ingest chunk. Set to 0 to disable splitting.
otlp.experimental_enable_resource_info	Bool	false	Whether to synthesize the greptime_otel_resource_info table from OTLP metric resource attributes, so metrics-only services reach the semantic graph.
prom_store	--	--	Prometheus remote storage options
prom_store.enable	Bool	true	Whether to enable Prometheus remote write and read in HTTP API.
prom_store.with_metric_engine	Bool	true	Whether to store the data from Prometheus remote write in metric engine.
prom_store.prom_validation_mode	String	strict	Whether to enable validation for Prometheus remote write requests. Available options: - strict: deny invalid UTF-8 strings (default). - lossy: allow invalid UTF-8 strings, replace invalid characters with REPLACEMENT_CHARACTER(U+FFFD). - unchecked: do not valid strings.
wal	--	--	The WAL options.
wal.provider	String	raft_engine	The provider of the WAL. - raft_engine: the wal is stored in the local file system by raft-engine. - kafka: it's remote wal that data is stored in Kafka. - experimental_object_store: the wal is stored as objects in an object store. Notes: experimental and not supported yet.
wal.dir	String	Unset	The directory to store the WAL files. It's only used when the provider is raft_engine.
wal.file_size	String	128MB	The size of the WAL segment file. It's only used when the provider is raft_engine.
wal.purge_threshold	String	1GB	The threshold of the WAL size to trigger a purge. It's only used when the provider is raft_engine.
wal.purge_interval	String	1m	The interval to trigger a purge. It's only used when the provider is raft_engine.
wal.read_batch_size	Integer	128	The read batch size. It's only used when the provider is raft_engine.
wal.sync_write	Bool	false	Whether to use sync write. It's only used when the provider is raft_engine.
wal.enable_log_recycle	Bool	true	Whether to reuse logically truncated log files. It's only used when the provider is raft_engine.
wal.prefill_log_files	Bool	false	Whether to pre-create log files on start up. It's only used when the provider is raft_engine.
wal.sync_period	String	5s	Duration for fsyncing log files. It's only used when the provider is raft_engine.
wal.recovery_parallelism	Integer	Auto	Parallelism during WAL recovery. Defaults to the number of CPU cores; this example sets it to 2.
wal.broker_endpoints	Array	--	The Kafka broker endpoints. It's only used when the provider is kafka.
wal.connect_timeout	String	3s	The connect timeout for kafka client. It's only used when the provider is kafka.
wal.timeout	String	5s	The total request timeout for kafka client. It's only used when the provider is kafka.
wal.auto_create_topics	Bool	true	Automatically create topics for WAL. Set to true to automatically create topics for WAL. Otherwise, use topics named topic_name_prefix_[0..num_topics)
wal.num_topics	Integer	64	Number of topics. It's only used when the provider is kafka.
wal.selector_type	String	round_robin	Topic selector type. Available selector types: - round_robin (default) It's only used when the provider is kafka.
wal.topic_name_prefix	String	greptimedb_wal_topic	A Kafka topic is constructed by concatenating topic_name_prefix and topic_id. i.g., greptimedb_wal_topic_0, greptimedb_wal_topic_1. It's only used when the provider is kafka.
wal.replication_factor	Integer	1	Expected number of replicas of each partition. It's only used when the provider is kafka.
wal.create_topic_timeout	String	30s	Above which a topic creation operation will be cancelled. It's only used when the provider is kafka.
wal.max_batch_bytes	String	1MB	The max size of a single producer batch. Warning: Kafka has a default limit of 1MB per message in a topic. Defaults to 8MB when the provider is experimental_object_store. It's only used when the provider is kafka or experimental_object_store.
wal.consumer_wait_timeout	String	100ms	The consumer wait timeout. It's only used when the provider is kafka.
wal.overwrite_entry_start_id	Bool	false	Ignore missing entries during read WAL. It's only used when the provider is kafka. This option ensures that when Kafka messages are deleted, the system can still successfully replay memtable data without throwing an out-of-range error. However, enabling this option might lead to unexpected data loss, as the system will skip over missing entries instead of treating them as critical errors.
wal.storage_provider	String	""	The name of the storage provider that holds the WAL objects, an empty name selects the default object store. It's only used when the provider is experimental_object_store.
wal.prefix	String	wal	The path prefix of the WAL objects inside the storage provider. The objects are written under <prefix>/datanodes/<node_id>/epochs/<generation>, which is derived from this prefix. It's only used when the provider is experimental_object_store.
wal.flush_interval	String	100ms	The interval of flushing buffered entries to the object store, at least 10ms, defaults to 100ms. Each non-empty timer-triggered flush creates one object, and a batch that reaches max_batch_bytes is flushed immediately, so under sustained load the batch seals on size and the interval no longer matters. When writes are sparse, a shorter interval lowers the acknowledgement latency of durable appends and raises the number of object requests: timer-triggered sealing creates at most one object per interval per node, and in enqueued mode the backlog thresholds can seal earlier. An enqueued append does not wait for its batch to seal once it is admitted, but the backlog thresholds can delay admission. It's only used when the provider is experimental_object_store.
wal.ack_mode	String	durable	When an append to the object store WAL returns. - durable: an append returns after the object holding its entries is durable (the default). - enqueued: an append returns once its entries are admitted and their ids are assigned, and the object is created in the background. A crash loses the unpersisted backlog. It's only used when the provider is experimental_object_store.
wal.max_unpersisted_bytes	String	64MB	The size of the unpersisted backlog at which new appends stall until an upload completes, in enqueued mode. Nothing is dropped and nothing is rejected; the threshold does not bound what a crash during an outage can lose. It's only used when the provider is experimental_object_store and ack_mode is enqueued.
wal.max_unpersisted_age	String	8s	The age of the oldest unpersisted entry at which new appends stall until an upload completes, in enqueued mode. It's only used when the provider is experimental_object_store and ack_mode is enqueued.
wal.on_corrupted_segment	String	skip	What a read does with a segment that still does not decode after a second fetch, because its checksum does not match or its content disagrees with its footer entry. - skip: the segment is skipped and recorded as a WAL hole of its region, a metric is incremented and a warning is logged; the other regions of the object are unaffected (the default). - fail: the read fails, so the region does not open. It's only used when the provider is experimental_object_store.
metadata_store	--	--	Metadata storage options.
metadata_store.file_size	String	64MB	The size of the metadata store log file.
metadata_store.purge_threshold	String	256MB	The threshold of the metadata store size to trigger a purge.
metadata_store.purge_interval	String	1m	The interval of the metadata store to trigger a purge.
procedure	--	--	Procedure storage options.
procedure.max_retry_times	Integer	3	Procedure max retry time.
procedure.retry_delay	String	500ms	Initial retry delay of procedures, increases exponentially
procedure.max_running_procedures	Integer	128	Max running procedures. The maximum number of procedures that can be running at the same time. If the number of running procedures exceeds this limit, the procedure will be rejected.
query	--	--	The query engine options.
query.parallelism	Integer	0	Parallelism of the query engine. Default to 0, which means the number of CPU cores.
query.memory_pool_size	String	0	Memory pool size for query execution operators (aggregation, sorting, join). Supports absolute size (e.g., "2GB", "4GB") or percentage of system memory (e.g., "20%"). Setting it to 0 disables the limit. Defaults to 0 (unlimited); this example sets it to 50%. When this limit is reached, queries will fail with ResourceExhausted error. NOTE: This does NOT limit memory used by table scans.
query.experimental_memory_pool_policy	String	greedy	Experimental memory pool allocation policy: - "greedy" (default): first-come-first-served allocation; preserves current behavior. - "fair": divides available memory among spillable operators and may spill earlier. Only effective when memory_pool_size is bounded (>0).
query.experimental_spill_mode	String	default	Spill mode: - "default": preserve DataFusion built-in OS temp directory (default). - "custom": explicitly configure spill path, quota, and compression. - "disabled": explicitly disable disk spilling. Set this to "custom" before using the path/quota/compression keys below.
query.experimental_spill_path	String	Unset	Spill directory path. Ignored unless mode is "custom".
query.experimental_spill_max_temp_directory_size	String	1GiB	Maximum total size of spill directory (default: "1GiB"). Ignored unless mode is "custom".
query.experimental_spill_compression	String	uncompressed	Compression for spilled data files: "uncompressed" (default), "lz4_frame", "zstd". Ignored unless mode is "custom".
storage	--	--	The data storage options.
storage.data_home	String	./greptimedb_data	The working home directory.
storage.copy_root	String	./greptimedb_data/copy	Root directory for standalone SQL access to local files. Relative SQL paths are resolved below this directory. Absolute paths are accepted only when they are inside this directory. Defaults to <data_home>/copy. Distributed deployments always reject SQL access to local files. Upgrade note: COPY commands and existing external tables that reference paths outside this directory will fail. Move those files below the copy root, set this option to a dedicated directory containing them, or migrate the files to object storage before upgrading.
storage.type	String	File	The storage type used to store the data. - File: the data is stored in the local file system. - S3: the data is stored in the S3 object storage. - Gcs: the data is stored in the Google Cloud Storage. - Azblob: the data is stored in the Azure Blob Storage. - Oss: the data is stored in the Aliyun OSS. - Hdfs: the data is stored in the Hadoop Distributed File System.
storage.bucket	String	Unset	The S3 bucket name. It's only used when the storage type is S3, Oss and Gcs.
storage.root	String	Unset	The directory or object prefix under which data is stored. It's only used when the storage type is S3, Oss, Gcs, Azblob and Hdfs.
storage.name_node	String	Unset	The HDFS NameNode URI, for example, hdfs://127.0.0.1:9000. It's only used when the storage type is Hdfs.
storage.options	InlineTable	Unset	Additional options passed to the native HDFS client. It's only used when the storage type is Hdfs.
storage.access_key_id	String	Unset	The access key id of the aws account. It's highly recommended to use AWS IAM roles instead of hardcoding the access key id and secret key. It's only used when the storage type is S3 and Oss.
storage.secret_access_key	String	Unset	The secret access key of the aws account. It's highly recommended to use AWS IAM roles instead of hardcoding the access key id and secret key. It's only used when the storage type is S3.
storage.access_key_secret	String	Unset	The secret access key of the aliyun account. It's only used when the storage type is Oss.
storage.account_name	String	Unset	The account key of the azure account. It's only used when the storage type is Azblob.
storage.account_key	String	Unset	The account key of the azure account. It's only used when the storage type is Azblob.
storage.scope	String	Unset	The scope of the google cloud storage. It's only used when the storage type is Gcs.
storage.credential_path	String	Unset	The credential path of the google cloud storage. It's only used when the storage type is Gcs.
storage.credential	String	Unset	The credential of the google cloud storage. It's only used when the storage type is Gcs.
storage.container	String	Unset	The container of the azure account. It's only used when the storage type is Azblob.
storage.sas_token	String	Unset	The sas token of the azure account. It's only used when the storage type is Azblob.
storage.endpoint	String	Unset	The endpoint of the S3 service. It's only used when the storage type is S3, Oss, Gcs and Azblob.
storage.region	String	Unset	The region of the S3 service. It's only used when the storage type is S3, Oss, Gcs and Azblob.
storage.http_client	--	--	The http client options to the storage. It's only used when the storage type is S3, Oss, Gcs and Azblob.
storage.http_client.pool_max_idle_per_host	Integer	1024	The maximum idle connection per host allowed in the pool.
storage.http_client.connect_timeout	String	30s	The timeout for only the connect phase of a http client.
storage.http_client.timeout	String	30s	The total request timeout, applied from when the request starts connecting until the response body has finished. Also considered a total deadline.
storage.http_client.pool_idle_timeout	String	90s	The timeout for idle sockets being kept-alive.
storage.http_client.skip_ssl_validation	Bool	false	To skip the ssl verification Security Notice: Setting skip_ssl_validation = true disables certificate verification, making connections vulnerable to man-in-the-middle attacks. Only use this in development or trusted private networks.
[[region_engine]]	--	--	The region engine options. You can configure multiple region engines. Each engine type (mito, file, metric) may appear only once; duplicates cause startup to fail.
region_engine.mito	--	--	The Mito engine options.
region_engine.mito.num_workers	Integer	Auto	Number of region workers. Defaults to half of the available CPU cores, rounded up.
region_engine.mito.worker_channel_size	Integer	128	Request channel size of each worker.
region_engine.mito.worker_request_batch_size	Integer	64	Max batch size for a worker to handle requests.
region_engine.mito.manifest_checkpoint_distance	Integer	10	Number of meta action updated to trigger a new checkpoint for the manifest.
region_engine.mito.compress_manifest	Bool	false	Whether to compress manifest and checkpoint file by gzip (default false).
region_engine.mito.experimental_enable_series_index	Bool	false	Under development; do not enable. Whether to enable series indexes. Indexes are stored on the local filesystem under {data_home}/series_index.
region_engine.mito.experimental_series_index_max_size	String	5GiB	Approximate series and range index size limit in open regions, shared across workers. Workers periodically refresh usage and skip maintenance when full. In-flight reconciliation can exceed the limit. Closed-region files, temporary output, catalogs, and old snapshots retained by readers are not counted. Minimum: 1KiB. Takes effect on restart.
region_engine.mito.experimental_enable_range_index	Bool	false	Whether to build and query range indexes when series indexes are enabled. Obsolete range-index metadata and files are still cleaned up when disabled.
region_engine.mito.experimental_series_index_maintenance_interval	String	5m	Interval between series-index maintenance runs. Zero uses the default of 5 min.
region_engine.mito.experimental_series_index_bucket_width	String	5days	Requested minimum series-index bucket width (default: 5 days), rounded up to an exact multiple of each region's compaction time window.
region_engine.mito.max_background_flushes	Integer	Auto	Max number of running background flush jobs (default: 1/2 of cpu cores).
region_engine.mito.max_background_compactions	Integer	Auto	Max number of running background compaction jobs (default: 1/4 of cpu cores).
region_engine.mito.max_background_purges	Integer	Auto	Max number of running background purge jobs (default: number of cpu cores).
region_engine.mito.experimental_compaction_memory_limit	String	0	Memory budget for compaction tasks. Supports absolute size (e.g., "2GiB", "512MB") or percentage of system memory (e.g., "50%"). Setting it to 0 or "unlimited" disables the limit.
region_engine.mito.experimental_compaction_on_exhausted	String	wait	Behavior when compaction cannot acquire memory from the budget. Options: "wait" (default, 10s), "wait()", "fail"
region_engine.mito.auto_flush_interval	String	10m	Interval to auto flush a region if it has not flushed yet.
region_engine.mito.global_write_buffer_size	String	Auto	Global write buffer size for all regions. If not set, it's default to 1/8 of OS memory with a max limitation of 1GB.
region_engine.mito.global_write_buffer_reject_size	String	Auto	Global write buffer size threshold to reject write requests. If not set, it's default to 2 times of global_write_buffer_size.
region_engine.mito.default_region_write_buffer_size	String	0	Default write buffer size for each region. Regions stall at this size and reject writes at twice this size. Setting it to 0 disables both limits unless the table specifies write_buffer_size.
region_engine.mito.sst_meta_cache_size	String	Auto	Cache size for SST metadata. Setting it to 0 to disable the cache. If not set, it's default to 1/8 of OS memory with a max limitation of 512MB.
region_engine.mito.vector_cache_size	String	Auto	Cache size for vectors and arrow arrays. Setting it to 0 to disable the cache. If not set, it's default to 1/16 of OS memory with a max limitation of 512MB.
region_engine.mito.page_cache_size	String	Auto	Cache size for pages of SST row groups. Setting it to 0 to disable the cache. If not set, it's default to 1/8 of OS memory.
region_engine.mito.selector_result_cache_size	String	Auto	Cache size for time series selector (e.g. last_value()). Setting it to 0 to disable the cache. If not set, it's default to 1/16 of OS memory with a max limitation of 512MB.
region_engine.mito.range_result_cache_size	String	Auto	Cache size for flat range scan results. Setting it to 0 to disable the cache. If not set, it's default to 1/16 of OS memory with a max limitation of 512MB.
region_engine.mito.prefilter_result_cache_size	String	Auto	Cache size for prefilter results. Setting it to 0 to disable the cache. If not set, it's default to 1/32 of OS memory with a max limitation of 128MB.
region_engine.mito.enable_write_cache	Bool	false	Whether to enable the write cache, it's enabled by default when using object storage. It is recommended to enable it when using object storage for better performance.
region_engine.mito.write_cache_path	String	""	File system path for write cache, defaults to {data_home}.
region_engine.mito.write_cache_size	String	5GiB	Capacity for write cache. If your disk space is sufficient, it is recommended to set it larger.
region_engine.mito.write_cache_ttl	String	Unset	TTL for write cache.
region_engine.mito.preload_index_cache	Bool	true	Preload index (puffin) files into cache on region open (default: true). When enabled, index files are loaded into the write cache during region initialization, which can improve query performance at the cost of longer startup times.
region_engine.mito.index_cache_percent	Integer	20	Percentage of write cache capacity allocated for index (puffin) files (default: 20). The remaining capacity is used for data (parquet) files. Must be between 0 and 100 (exclusive). For example, with a 5GiB write cache and 20% allocation, 1GiB is reserved for index files and 4GiB for data files.
region_engine.mito.enable_refill_cache_on_read	Bool	true	Enable refilling cache on read operations (default: true). When disabled, cache refilling on read won't happen.
region_engine.mito.manifest_cache_size	String	256MB	Capacity for manifest cache (default: 256MB).
region_engine.mito.sst_write_buffer_size	String	8MB	Buffer size for SST writing.
region_engine.mito.max_concurrent_scan_files	Integer	384	Maximum number of SST files to scan concurrently.
region_engine.mito.allow_stale_entries	Bool	false	Whether to allow stale WAL entries read during replay.
region_engine.mito.scan_memory_limit	String	unlimited	Memory limit for table scans across all queries. Supports absolute size (e.g., "2GB") or percentage of system memory (e.g., "20%"). Setting it to 0 or "unlimited" disables the limit.
region_engine.mito.scan_memory_on_exhausted	String	fail	Controls what happens when a scan cannot get memory immediately. "fail" (default) fails fast and is the recommended option for most users. "wait" / "wait()" waits for memory to become available. This is mainly for advanced tuning in bursty workloads where temporary contention is common and higher latency is acceptable. "wait" means "wait(10s)", not unlimited waiting.
region_engine.mito.min_compaction_interval	String	0m	Minimum time interval between two compactions. To align with the old behavior, the default value is 0 (no restrictions).
region_engine.mito.schedule_compaction_after_edit	Bool	true	Whether to allow to schedule a compaction after a successful region edit. Setting this to "true" is a necessary but not sufficient condition for scheduling compaction after a region edit. Other constraints, such as "min_compaction_interval", may still prevent compaction from being scheduled. Setting this to "false", however, guarantees that compaction will not be scheduled after a region edit.
region_engine.mito.default_flat_format	Bool	true	Whether to enable flat format as the default SST format.
region_engine.mito.experimental_series_scan_v2	Bool	false	Whether to enable the experimental two-phase mode for eligible metric series scans.
region_engine.mito.index	--	--	The options for index in Mito engine.
region_engine.mito.index.aux_path	String	""	Auxiliary directory path for the index in filesystem, used to store intermediate files for creating the index and staging files for searching the index, defaults to {data_home}/index_intermediate. The default name for this directory is index_intermediate for backward compatibility. This path contains two subdirectories: - __intm: for storing intermediate files used during creating index. - staging: for storing staging files used during searching index.
region_engine.mito.index.staging_size	String	2GB	The max capacity of the staging directory.
region_engine.mito.index.staging_ttl	String	7d	The TTL of the staging directory. Defaults to 7 days. Setting it to "0s" to disable TTL.
region_engine.mito.index.metadata_cache_size	String	64MiB	Cache size for inverted index metadata.
region_engine.mito.index.content_cache_size	String	128MiB	Cache size for inverted index content.
region_engine.mito.index.content_cache_page_size	String	64KiB	Page size for inverted index content cache.
region_engine.mito.index.result_cache_size	String	128MiB	Cache size for index result.
region_engine.mito.inverted_index	--	--	The options for inverted index in Mito engine.
region_engine.mito.inverted_index.create_on_flush	String	auto	Whether to create the index on flush. - auto: automatically (default) - disable: never
region_engine.mito.inverted_index.create_on_compaction	String	auto	Whether to create the index on compaction. - auto: automatically (default) - disable: never
region_engine.mito.inverted_index.apply_on_query	String	auto	Whether to apply the index on query - auto: automatically (default) - disable: never
region_engine.mito.inverted_index.mem_threshold_on_create	String	auto	Memory threshold for performing an external sort during index creation. - auto: automatically determine the threshold based on the system memory size (default) - unlimited: no memory limit - [size] e.g. 64MB: fixed memory threshold
region_engine.mito.inverted_index.intermediate_path	String	""	Deprecated, use region_engine.mito.index.aux_path instead.
region_engine.mito.fulltext_index	--	--	The options for full-text index in Mito engine.
region_engine.mito.fulltext_index.create_on_flush	String	auto	Whether to create the index on flush. - auto: automatically (default) - disable: never
region_engine.mito.fulltext_index.create_on_compaction	String	auto	Whether to create the index on compaction. - auto: automatically (default) - disable: never
region_engine.mito.fulltext_index.apply_on_query	String	auto	Whether to apply the index on query - auto: automatically (default) - disable: never
region_engine.mito.fulltext_index.mem_threshold_on_create	String	auto	Memory threshold for index creation. - auto: automatically determine the threshold based on the system memory size (default) - unlimited: no memory limit - [size] e.g. 64MB: fixed memory threshold
region_engine.mito.bloom_filter_index	--	--	The options for bloom filter in Mito engine.
region_engine.mito.bloom_filter_index.create_on_flush	String	auto	Whether to create the bloom filter on flush. - auto: automatically (default) - disable: never
region_engine.mito.bloom_filter_index.create_on_compaction	String	auto	Whether to create the bloom filter on compaction. - auto: automatically (default) - disable: never
region_engine.mito.bloom_filter_index.apply_on_query	String	auto	Whether to apply the bloom filter on query - auto: automatically (default) - disable: never
region_engine.mito.bloom_filter_index.mem_threshold_on_create	String	auto	Memory threshold for bloom filter creation. - auto: automatically determine the threshold based on the system memory size (default) - unlimited: no memory limit - [size] e.g. 64MB: fixed memory threshold
region_engine.file	--	--	Enable the file engine.
region_engine.metric	--	--	Metric engine options.
logging	--	--	The logging options.
logging.dir	String	./greptimedb_data/logs	The directory to store the log files. If set to empty, logs will not be written to files.
logging.level	String	Unset	The log level. Can be info/debug/warn/error.
logging.enable_otlp_tracing	Bool	false	Enable OTLP tracing.
logging.otlp_endpoint	String	http://localhost:4318/v1/traces	The OTLP tracing endpoint.
logging.append_stdout	Bool	true	Whether to append logs to stdout.
logging.enable_file_logging	Bool	true	Whether to write logs to files in dir.
logging.log_format	String	text	The log format. Can be text/json.
logging.max_log_files	Integer	720	The maximum amount of log files.
logging.max_log_dir_size	String	0B	The maximum total size of managed log files in dir. Old closed log files are removed before writing when necessary. Active files may exceed it. Set to 0B to disable.
logging.enable_per_region_metrics	Bool	false	Whether to enable per-region metrics. Default to false.
logging.otlp_export_protocol	String	http	The OTLP tracing export protocol. Can be grpc/http.
logging.otlp_headers	--	--	Additional OTLP headers, only valid when using OTLP http
logging.tracing_sample_ratio	--	Unset	The percentage of tracing will be sampled and exported. Valid range [0, 1], 1 means all traces are sampled, 0 means all traces are not sampled, the default value is 1. ratio > 1 are treated as 1. Fractions < 0 are treated as 0
logging.tracing_sample_ratio.default_ratio	Float	1.0	--
slow_query	--	--	The slow query log options.
slow_query.enable	Bool	true	Whether to enable slow query log.
slow_query.record_type	String	system_table	The record type of slow queries. It can be system_table or log. If system_table is selected, the slow queries will be recorded in a system table greptime_private.slow_queries. If log is selected, the slow queries will be logged in a log file greptimedb-slow-queries.*.
slow_query.threshold	String	30s	The threshold of slow query. It can be human readable time string, for example: 10s, 100ms, 1s.
slow_query.sample_ratio	Float	1.0	The sampling ratio of slow query log. The value should be in the range of (0, 1]. For example, 0.1 means 10% of the slow queries will be logged and 1.0 means all slow queries will be logged.
slow_query.ttl	String	90d	The TTL of the slow_queries system table. Default is 90d when record_type is system_table.
tracing	--	--	The tracing options. Only effect when compiled with tokio-console feature.
tracing.tokio_console_addr	String	Unset	The tokio console address.
pipeline	--	--	The pipeline options.
pipeline.cache_ttl	String	10s	Time to live of the local pipeline cache. Default is 10s.
event_recorder	--	--	Configuration options for the event recorder.
event_recorder.ttl	String	90d	TTL for the events table that will be used to store the events. Default is 90d.
event_recorder.event_types	Array	All	Event types to record. Current available event types: create_database, alter_database, drop_database, create_flow, drop_flow, create_table, create_logical_tables, alter_table, alter_logical_tables, drop_table, undrop_table, purge_dropped_table, truncate_table, create_view, drop_view, admin_function, reconcile_catalog, reconcile_database, reconcile_table, reconcile_logical_tables. When omitted, all current and future event types are recorded. Set to an empty array to disable event recording.
memory	--	--	The memory options.
memory.enable_heap_profiling	Bool	true	Whether to enable heap profiling activation during startup. When enabled, heap profiling will be activated if the MALLOC_CONF environment variable is set to "prof:true,prof_active:false". The official image adds this env variable. Default is true.

Distributed Mode

Frontend

Key	Type	Default	Descriptions
default_timezone	String	Unset	The default timezone of the server.
default_column_prefix	String	Unset	The default column prefix for auto-created time index, value, and native histogram columns. Legacy OTLP summary columns keep their historical greptime_ prefix.
auto_create_table	Bool	true	Server-side global switch for auto table creation on write. When false, a missing table is never auto-created even if the request sets the auto_create_table hint to true. Default: true.
experimental_metric_export	Bool	false	Enables experimental Parquet COPY DATABASE using shared Metric physical scans. Resume requires the previous export and storage writes to have ended; HTTP timeout is not confirmation.
user_provider	String	Unset	The user provider for authentication. Examples: "static_user_provider:file:/path/to/users", "static_user_provider:cmd:greptime_user=greptime_pwd" Password verifier formats: "plain:", "pbkdf2_sha256::<hex_salt>:<hex_hash>", "mysql_native_password:<hex_sha1_sha1_password>", "pg_scram_sha256::<hex_salt>:<hex_stored_key>:<hex_server_key>" "pbkdf2_sha256" and "pg_scram_sha256" protect passwords at rest, but such users cannot log in over MySQL: static_user_provider and watch_file_user_provider only negotiate mysql_native_password, which cannot verify these formats. "mysql_native_password" is MySQL-specific and cannot authenticate over PostgreSQL at all. PostgreSQL SCRAM only covers "plain" and "pg_scram_sha256" users; if any user is "pbkdf2_sha256" or "mysql_native_password", PostgreSQL falls back to cleartext password auth for every user. For "pg_scram_sha256" users, keep the default iteration count (4096) and salt length (16): both are observable in the SCRAM server-first message, and non-default values weaken resistance to username enumeration.
max_in_flight_write_bytes	String	0	Maximum total memory for all concurrent write request bodies and messages (HTTP, gRPC, Flight). Set to 0 to disable the limit. Default: "0" (unlimited)
write_bytes_exhausted_policy	String	wait	Policy when write bytes quota is exhausted. Options: "wait" (default, 10s timeout), "wait()" (e.g., "wait(30s)"), "fail"
runtime	--	--	The runtime options.
runtime.global_rt_size	Integer	Auto	The number of threads to execute the runtime for global read operations. Defaults to max(num_cpus, 2).
runtime.compact_rt_size	Integer	Auto	The number of threads to execute compact operations. Defaults to max(num_cpus / 2, 2).
runtime.compact_rt_max_blocking_threads	Integer	Auto	The maximum number of blocking threads for compact operations. Defaults to max(num_cpus / 2, 2).
http	--	--	The HTTP server options.
http.addr	String	127.0.0.1:4000	The address to bind the HTTP server.
http.timeout	String	0s	HTTP request timeout. Set to 0 to disable timeout. When synchronous Prometheus, OTLP metrics, or ordinary-table batching is enabled, a nonzero timeout is raised to at least the largest active flush interval plus 1 second. The intervals come from pending_rows_batcher.logical_table.pending_rows_flush_interval and pending_rows_batcher.pending_rows_flush_interval.
http.body_limit	String	64MB	HTTP request body limit. The following units are supported: B, KB, KiB, MB, MiB, GB, GiB, TB, TiB, PB, PiB. Set to 0 to disable limit.
http.enable_cors	Bool	true	HTTP CORS support, it's turned on by default This allows browser to access http APIs without CORS restrictions
http.cors_allowed_origins	Array	Unset	Customize allowed origins for HTTP CORS.
http.enable_api_server	Bool	false	Whether to start the dedicated public HTTP API server. This server serves only the v1 interfaces plus the dashboard, and shares every other [http] option with the main server. It is disabled by default; set to true to enable.
http.api_server_addr	String	127.0.0.1:4006	The address to bind the dedicated HTTP API server, in the same form as addr. Defaults to 127.0.0.1:4006.
grpc	--	--	The gRPC server options.
grpc.bind_addr	String	127.0.0.1:4001	The address to bind the gRPC server.
grpc.server_addr	String	Unset	The address advertised to the metasrv, and used for connections from outside the host. If left empty or unset, the server will automatically use the IP address of the first network interface on the host, with the same port number as the one specified in grpc.bind_addr.
grpc.runtime_size	Integer	8	The number of server worker threads.
grpc.flight_compression	String	arrow_ipc	Compression mode for frontend side Arrow IPC service. Available options: - none: disable all compression - transport: only enable gRPC transport compression (zstd) - arrow_ipc: only enable Arrow IPC compression (lz4) - all: enable all compression. Default to arrow_ipc.
grpc.max_connection_age	String	Unset	The maximum connection age for gRPC connection. The value can be a human-readable time string. For example: 10m for ten minutes or 1h for one hour. Refer to https://grpc.io/docs/guides/keepalive/ for more details.
grpc.tls	--	--	gRPC server TLS options, see mysql.tls section.
grpc.tls.mode	String	disable	TLS mode.
grpc.tls.cert_path	String	Unset	Certificate file path.
grpc.tls.key_path	String	Unset	Private key file path.
grpc.tls.watch	Bool	false	Watch for Certificate and key file change and auto reload. For now, gRPC tls config does not support auto reload.
internal_grpc	--	--	The internal gRPC server options. Internal gRPC port for nodes inside cluster to access frontend. The internal gRPC server starts only when this section is set.
internal_grpc.bind_addr	String	Unset	The address to bind the gRPC server. If unset, it falls back to 127.0.0.1:4001, the same address as grpc.bind_addr.
internal_grpc.server_addr	String	Unset	The address advertised to the metasrv, and used for connections from outside the host. Unlike grpc.server_addr, it is not detected automatically; set it explicitly.
internal_grpc.runtime_size	Integer	8	The number of server worker threads.
internal_grpc.flight_compression	String	arrow_ipc	Compression mode for frontend side Arrow IPC service. Available options: - none: disable all compression - transport: only enable gRPC transport compression (zstd) - arrow_ipc: only enable Arrow IPC compression (lz4) - all: enable all compression. Default to arrow_ipc.
internal_grpc.tls	--	--	internal gRPC server TLS options, see mysql.tls section.
internal_grpc.tls.mode	String	disable	TLS mode.
internal_grpc.tls.cert_path	String	Unset	Certificate file path.
internal_grpc.tls.key_path	String	Unset	Private key file path.
internal_grpc.tls.watch	Bool	false	Watch for Certificate and key file change and auto reload. For now, gRPC tls config does not support auto reload.
mysql	--	--	MySQL server options.
mysql.enable	Bool	true	Whether to enable.
mysql.addr	String	127.0.0.1:4002	The addr to bind the MySQL server.
mysql.runtime_size	Integer	2	The number of server worker threads.
mysql.keep_alive	String	0s	Server-side keep-alive time. Set to 0 (default) to disable.
mysql.prepared_stmt_cache_size	Integer	10000	Maximum entries in the MySQL prepared statement cache; default is 10,000.
mysql.tls	--	--	--
mysql.tls.mode	String	disable	TLS mode, refer to https://www.postgresql.org/docs/current/libpq-ssl.html - disable (default value) - prefer - require - verify-ca - verify-full
mysql.tls.cert_path	String	Unset	Certificate file path.
mysql.tls.key_path	String	Unset	Private key file path.
mysql.tls.watch	Bool	false	Watch for Certificate and key file change and auto reload
postgres	--	--	PostgresSQL server options.
postgres.enable	Bool	true	Whether to enable
postgres.addr	String	127.0.0.1:4003	The addr to bind the PostgresSQL server.
postgres.runtime_size	Integer	2	The number of server worker threads.
postgres.keep_alive	String	0s	Server-side keep-alive time. Set to 0 (default) to disable.
postgres.tls	--	--	PostgresSQL server TLS options, see mysql.tls section.
postgres.tls.mode	String	disable	TLS mode.
postgres.tls.cert_path	String	Unset	Certificate file path.
postgres.tls.key_path	String	Unset	Private key file path.
postgres.tls.watch	Bool	false	Watch for Certificate and key file change and auto reload
opentsdb	--	--	OpenTSDB protocol options.
opentsdb.enable	Bool	true	Whether to enable OpenTSDB put in HTTP API.
influxdb	--	--	InfluxDB protocol options.
influxdb.enable	Bool	true	Whether to enable InfluxDB protocol in HTTP API.
influxdb.default_merge_mode	String	last_non_null	Default merge mode for tables automatically created by InfluxDB protocol. Available values: "last_non_null", "last_row".
pending_rows_batcher	--	--	Ordinary-table batching for opted-in ingestion protocols. PENDING_ROWS_BATCH_SYNC defaults to true for both batchers. Set it to false to acknowledge queue admission without waiting for storage; later failures cannot be returned to the client. Omitted or empty protocols disables batching. Prom without metric engine uses this batcher. OTLP logs, traces and ordinary metrics use this batcher. MySQL and PostgreSQL use the same acknowledgement policy. Protocol timeouts are unchanged. Single-connection writes and INSERT SELECT may incur additional flush waits.
pending_rows_batcher.pending_rows_flush_interval	String	0s	Flush interval measured from the first pending submission. Zero disables batching.
pending_rows_batcher.max_batch_rows	Integer	100000	Flush after a complete submission reaches this row threshold.
pending_rows_batcher.max_concurrent_flushes	Integer	256	Maximum concurrent flushes shared by the frontend batcher.
pending_rows_batcher.worker_channel_capacity	Integer	65536	Maximum queued submissions per table worker.
pending_rows_batcher.max_inflight_requests	Integer	3000	Maximum admitted original requests awaiting completion.
pending_rows_batcher.flow_notification_queue_capacity	Integer	1024	Maximum number of queued table Flow notifications.
pending_rows_batcher.logical_table	--	--	Metric-engine logical-table batching for Prom remote write and non-legacy OTLP metrics. Requires prom_store.with_metric_engine. Logs, traces and legacy metrics are not eligible. Enable independently with protocols and a nonzero flush interval. Omitted fields use independent defaults, not parent settings. Empty protocols or a zero interval disables logical batching without fallback. Omitting this entire section preserves legacy Prom batching; it does not enable OTLP batching.
pending_rows_batcher.logical_table.pending_rows_flush_interval	String	0s	Flush interval measured from the first pending submission. Zero disables batching.
pending_rows_batcher.logical_table.max_batch_rows	Integer	100000	Flush after a complete submission reaches this row threshold.
pending_rows_batcher.logical_table.max_concurrent_flushes	Integer	256	Maximum concurrent flushes shared by Prom and OTLP metrics.
pending_rows_batcher.logical_table.worker_channel_capacity	Integer	65536	Maximum queued submissions per physical-table worker.
pending_rows_batcher.logical_table.max_inflight_requests	Integer	3000	Maximum admitted original requests awaiting completion.
pending_rows_batcher.logical_table.flow_notification_queue_capacity	Integer	1024	Maximum number of queued logical-table Flow notifications.
jaeger	--	--	Jaeger protocol options.
jaeger.enable	Bool	true	Whether to enable Jaeger protocol in HTTP API.
otlp	--	--	OpenTelemetry protocol options.
otlp.enable	Bool	true	Whether to enable OpenTelemetry protocol in HTTP API.
otlp.trace_ingest_chunk_size	Integer	512	Maximum spans per trace ingest chunk. Set to 0 to disable splitting.
otlp.experimental_enable_resource_info	Bool	false	Whether to synthesize the greptime_otel_resource_info table from OTLP metric resource attributes, so metrics-only services reach the semantic graph.
prom_store	--	--	Prometheus remote storage options
prom_store.enable	Bool	true	Whether to enable Prometheus remote write and read in HTTP API.
prom_store.with_metric_engine	Bool	true	Whether to store the data from Prometheus remote write in metric engine.
prom_store.prom_validation_mode	String	strict	Whether to enable validation for Prometheus remote write requests. Available options: - strict: deny invalid UTF-8 strings (default). - lossy: allow invalid UTF-8 strings, replace invalid characters with REPLACEMENT_CHARACTER(U+FFFD). - unchecked: do not valid strings.
meta_client	--	--	The metasrv client options.
meta_client.metasrv_addrs	Array	--	The addresses of the metasrv.
meta_client.timeout	String	3s	Operation timeout.
meta_client.ddl_timeout	String	10s	DDL timeout.
meta_client.connect_timeout	String	1s	Connect server timeout.
meta_client.tcp_nodelay	Bool	true	TCP_NODELAY option for accepted connections.
meta_client.metadata_cache_max_capacity	Integer	100000	The configuration about the cache of the metadata.
meta_client.metadata_cache_ttl	String	10m	TTL of the metadata cache.
meta_client.metadata_cache_tti	String	5m	--
query	--	--	The query engine options.
query.parallelism	Integer	0	Parallelism of the query engine. Default to 0, which means the number of CPU cores.
query.allow_query_fallback	Bool	false	Whether to allow query fallback when push down optimize fails. Default to false, meaning when push down optimize failed, return error msg
query.memory_pool_size	String	0	Memory pool size for query execution operators (aggregation, sorting, join). Supports absolute size (e.g., "4GB", "8GB") or percentage of system memory (e.g., "30%"). Setting it to 0 disables the limit. Defaults to 0 (unlimited); this example sets it to 50%. When this limit is reached, queries will fail with ResourceExhausted error. NOTE: This does NOT limit memory used by table scans (only applies to datanodes).
query.experimental_memory_pool_policy	String	greedy	Experimental memory pool allocation policy: - "greedy" (default): first-come-first-served allocation; preserves current behavior. - "fair": divides available memory among spillable operators and may spill earlier. Only effective when memory_pool_size is bounded (>0).
query.experimental_spill_mode	String	default	Spill mode: - "default": preserve DataFusion built-in OS temp directory (default). - "custom": explicitly configure spill path, quota, and compression. - "disabled": explicitly disable disk spilling. Set this to "custom" before using the path/quota/compression keys below.
query.experimental_spill_path	String	Unset	Spill directory path. Ignored unless mode is "custom".
query.experimental_spill_max_temp_directory_size	String	1GiB	Maximum total size of spill directory (default: "1GiB"). Ignored unless mode is "custom".
query.experimental_spill_compression	String	uncompressed	Compression for spilled data files: "uncompressed" (default), "lz4_frame", "zstd". Ignored unless mode is "custom".
write_retry	--	--	Retry retryable distributed write failures. Backoff grows exponentially, with jitter to spread concurrent retries.
write_retry.max_retries	Integer	3	Maximum retries after the initial write attempt. Set to 0 to disable retries.
write_retry.initial_backoff	String	1500ms	Initial backoff before jitter is applied. Must be positive.
write_retry.max_backoff	String	10s	Maximum backoff before jitter is applied. Must be at least initial_backoff.
write_retry.backoff_multiplier	Float	2.0	Backoff multiplier. Must be finite and at least 1.
datanode	--	--	Datanode options.
datanode.client	--	--	Datanode client options.
datanode.client.connect_timeout	String	1s	Connect server timeout. Defaults to 1s; this example sets it to 10s.
datanode.client.tcp_nodelay	Bool	true	--
datanode.client.max_recv_message_size	String	512MB	The maximum receive message size for the gRPC client.
datanode.client.max_send_message_size	String	512MB	The maximum send message size for the gRPC client.
logging	--	--	The logging options.
logging.dir	String	./greptimedb_data/logs	The directory to store the log files. If set to empty, logs will not be written to files.
logging.level	String	Unset	The log level. Can be info/debug/warn/error.
logging.enable_otlp_tracing	Bool	false	Enable OTLP tracing.
logging.otlp_endpoint	String	http://localhost:4318/v1/traces	The OTLP tracing endpoint.
logging.append_stdout	Bool	true	Whether to append logs to stdout.
logging.enable_file_logging	Bool	true	Whether to write logs to files in dir.
logging.log_format	String	text	The log format. Can be text/json.
logging.max_log_files	Integer	720	The maximum amount of log files.
logging.max_log_dir_size	String	0B	The maximum total size of managed log files in dir. Old closed log files are removed before writing when necessary. Active files may exceed it. Set to 0B to disable.
logging.enable_per_region_metrics	Bool	false	Whether to enable per-region metrics. Default to false.
logging.otlp_export_protocol	String	http	The OTLP tracing export protocol. Can be grpc/http.
logging.otlp_headers	--	--	Additional OTLP headers, only valid when using OTLP http
logging.tracing_sample_ratio	--	Unset	The percentage of tracing will be sampled and exported. Valid range [0, 1], 1 means all traces are sampled, 0 means all traces are not sampled, the default value is 1. ratio > 1 are treated as 1. Fractions < 0 are treated as 0
logging.tracing_sample_ratio.default_ratio	Float	1.0	--
slow_query	--	--	The slow query log options.
slow_query.enable	Bool	true	Whether to enable slow query log.
slow_query.record_type	String	system_table	The record type of slow queries. It can be system_table or log. If system_table is selected, the slow queries will be recorded in a system table greptime_private.slow_queries. If log is selected, the slow queries will be logged in a log file greptimedb-slow-queries.*.
slow_query.threshold	String	30s	The threshold of slow query. It can be human readable time string, for example: 10s, 100ms, 1s.
slow_query.sample_ratio	Float	1.0	The sampling ratio of slow query log. The value should be in the range of (0, 1]. For example, 0.1 means 10% of the slow queries will be logged and 1.0 means all slow queries will be logged.
slow_query.ttl	String	90d	The TTL of the slow_queries system table. Default is 90d when record_type is system_table.
tracing	--	--	The tracing options. Only effect when compiled with tokio-console feature.
tracing.tokio_console_addr	String	Unset	The tokio console address.
memory	--	--	The memory options.
memory.enable_heap_profiling	Bool	true	Whether to enable heap profiling activation during startup. When enabled, heap profiling will be activated if the MALLOC_CONF environment variable is set to "prof:true,prof_active:false". The official image adds this env variable. Default is true.
pipeline	--	--	The pipeline options.
pipeline.cache_ttl	String	10s	Time to live of the frontend-local pipeline cache. A pipeline created or deleted on another frontend takes effect on this one after at most this duration.
event_recorder	--	--	Configuration options for the event recorder.
event_recorder.ttl	String	90d	TTL for the events table that will be used to store the events. Default is 90d.
event_recorder.event_types	Array	All	Event types to record. Current available event type: admin_function. When omitted, all current and future event types are recorded. Set to an empty array to disable event recording.

Metasrv

Key	Type	Default	Descriptions
data_home	String	./greptimedb_data	The working home directory.
store_addrs	Array	--	Store server address(es). The format depends on the selected backend. For etcd: a list of "host:port" endpoints. e.g. ["192.168.1.1:2379", "192.168.1.2:2379"] For PostgreSQL: a connection string in libpq format or URI. e.g. - "host=localhost port=5432 user=postgres password= dbname=postgres" - "postgresql://user:password@localhost:5432/mydb?connect_timeout=10" The detail see: https://docs.rs/tokio-postgres/latest/tokio_postgres/config/struct.Config.html For mysql store, the format is a MySQL connection URL. e.g. "mysql://user:password@localhost:3306/greptime_meta?ssl-mode=VERIFY_CA&ssl-ca=/path/to/ca.pem"
store_key_prefix	String	""	If it's not empty, the metasrv will store all data with this key prefix.
backend	String	etcd_store	The datastore for meta server. Available values: - etcd_store (default value) - memory_store - postgres_store - mysql_store
meta_table_name	String	greptime_metakv	Table name in RDS to store metadata. Effect when using a RDS kvbackend. Only used when backend is postgres_store.
meta_schema_name	String	Unset	Optional PostgreSQL schema for metadata table and election table name qualification. When PostgreSQL public schema is not writable (e.g., PostgreSQL 15+ with restricted public), set this to a writable schema. GreptimeDB will use meta_schema_name.meta_table_name. Only used when backend is postgres_store. Unset by default; this example sets it to greptime_schema.
auto_create_schema	Bool	true	Automatically create PostgreSQL schema if it doesn't exist. When enabled, the system will execute CREATE SCHEMA IF NOT EXISTS <schema_name> before creating metadata tables. This is useful in production environments where manual schema creation may be restricted. Default is true. Note: The PostgreSQL user must have CREATE SCHEMA permission for this to work. Only used when backend is postgres_store.
meta_election_lock_id	Integer	1	Advisory lock id in PostgreSQL for election. Effect when using PostgreSQL as kvbackend Only used when backend is postgres_store.
selector	String	round_robin	Datanode selector type. - round_robin (default value) - lease_based - load_based For details, please see "https://docs.greptime.com/developer-guide/metasrv/selector".
enable_region_failover	Bool	false	Whether to enable region failover. This feature is only available on GreptimeDB running on cluster mode and - Using Remote WAL - Using shared storage (e.g., s3).
region_failure_detector_initialization_delay	String	10m	The delay before starting region failure detection. This delay helps prevent Metasrv from triggering unnecessary region failovers before all Datanodes are fully started. Especially useful when the cluster is not deployed with GreptimeDB Operator and maintenance mode is not enabled.
allow_region_failover_on_local_wal	Bool	false	Whether to allow region failover on local WAL. This option is not recommended to be set to true, because it may lead to data loss during failover.
node_max_idle_time	String	24hours	Max allowed idle time before removing node info from metasrv memory.
heartbeat_interval	String	3s	Base heartbeat interval for calculating distributed time constants. The frontend heartbeat interval is 6 times of the base heartbeat interval. The flownode/datanode heartbeat interval is 1 times of the base heartbeat interval. e.g., If the base heartbeat interval is 3s, the frontend heartbeat interval is 18s, the flownode/datanode heartbeat interval is 3s. Heartbeat intervals are negotiated from metasrv during handshake; local node configs do not override this.
enable_telemetry	Bool	true	Whether to enable greptimedb telemetry. Enabled by default.
runtime	--	--	The runtime options.
runtime.global_rt_size	Integer	Auto	The number of threads to execute the runtime for global read operations. Defaults to max(num_cpus, 2).
runtime.compact_rt_size	Integer	Auto	The number of threads to execute compact operations. Defaults to max(num_cpus / 2, 2).
runtime.compact_rt_max_blocking_threads	Integer	Auto	The maximum number of blocking threads for compact operations. Defaults to max(num_cpus / 2, 2).
backend_tls	--	--	TLS configuration for kv store backend (applicable for etcd, PostgreSQL, and MySQL backends) When using etcd, PostgreSQL, or MySQL as metadata store, you can configure TLS here Note: if TLS is configured in both this section and the store_addrs connection string, the settings here will override the TLS settings in store_addrs.
backend_tls.mode	String	prefer	TLS mode, refer to https://www.postgresql.org/docs/current/libpq-ssl.html - "disable" - No TLS - "prefer" (default) - Try TLS, fallback to plain - "require" - Require TLS - "verify_ca" - Require TLS and verify CA - "verify_full" - Require TLS and verify hostname
backend_tls.cert_path	String	""	Path to client certificate file (for client authentication) Like "/path/to/client.crt"
backend_tls.key_path	String	""	Path to client private key file (for client authentication) Like "/path/to/client.key"
backend_tls.ca_cert_path	String	""	Path to CA certificate file (for server certificate verification) Required when using custom CAs or self-signed certificates Leave empty to use system root certificates only Like "/path/to/ca.crt"
backend_client	--	--	The backend client options. Currently, only applicable when using etcd as the metadata store.
backend_client.keep_alive_timeout	String	3s	The keep alive timeout for backend client.
backend_client.keep_alive_interval	String	10s	The keep alive interval for backend client.
backend_client.connect_timeout	String	3s	The connect timeout for backend client.
grpc	--	--	The gRPC server options.
grpc.bind_addr	String	127.0.0.1:3002	The address to bind the gRPC server.
grpc.server_addr	String	Unset	The communication server address for the frontend and datanode to connect to metasrv. If left empty or unset, the server will automatically use the IP address of the first network interface on the host, with the same port number as the one specified in grpc.bind_addr.
grpc.runtime_size	Integer	8	The number of server worker threads.
grpc.max_recv_message_size	String	512MB	The maximum receive message size for gRPC server.
grpc.max_send_message_size	String	512MB	The maximum send message size for gRPC server.
grpc.http2_keep_alive_interval	String	10s	The server side HTTP/2 keep-alive interval
grpc.http2_keep_alive_timeout	String	3s	The server side HTTP/2 keep-alive timeout.
http	--	--	The HTTP server options.
http.addr	String	127.0.0.1:4000	The address to bind the HTTP server.
http.timeout	String	0s	HTTP request timeout. Set to 0 to disable timeout.
http.body_limit	String	64MB	HTTP request body limit. The following units are supported: B, KB, KiB, MB, MiB, GB, GiB, TB, TiB, PB, PiB. Set to 0 to disable limit.
procedure	--	--	Procedure storage options.
procedure.max_retry_times	Integer	12	Procedure max retry time.
procedure.retry_delay	String	500ms	Initial retry delay of procedures, increases exponentially
procedure.max_metadata_value_size	String	1500KiB	Auto split large value GreptimeDB procedure uses etcd as the default metadata storage backend. The etcd the maximum size of any request is 1.5 MiB 1500KiB = 1536KiB (1.5MiB) - 36KiB (reserved size of key) Comments out the max_metadata_value_size, for don't split large value (no limit).
procedure.max_running_procedures	Integer	128	Max running procedures. The maximum number of procedures that can be running at the same time. If the number of running procedures exceeds this limit, the procedure will be rejected.
failure_detector	--	--	--
failure_detector.threshold	Float	8.0	Maximum acceptable φ before the peer is treated as failed. Lower values react faster but yield more false positives.
failure_detector.min_std_deviation	String	100ms	The minimum standard deviation of the heartbeat intervals. So tiny variations don’t make φ explode. Prevents hypersensitivity when heartbeat intervals barely vary.
failure_detector.acceptable_heartbeat_pause	String	10000ms	The acceptable pause duration between heartbeats. Additional extra grace period to the learned mean interval before φ rises, absorbing temporary network hiccups or GC pauses.
datanode	--	--	Datanode options.
datanode.client	--	--	Datanode client options.
datanode.client.timeout	String	10s	Operation timeout.
datanode.client.connect_timeout	String	1s	Connect server timeout. Defaults to 1s; this example sets it to 10s.
datanode.client.tcp_nodelay	Bool	true	TCP_NODELAY option for accepted connections.
datanode.client.max_recv_message_size	String	512MB	The maximum receive message size for the gRPC client.
datanode.client.max_send_message_size	String	512MB	The maximum send message size for the gRPC client.
wal	--	--	--
wal.provider	String	raft_engine	--
wal.broker_endpoints	Array	--	The broker endpoints of the Kafka cluster. It's only used when the provider is kafka.
wal.connect_timeout	String	3s	The connect timeout for kafka client. It's only used when the provider is kafka.
wal.timeout	String	5s	The total request timeout for kafka client. It's only used when the provider is kafka.
wal.auto_create_topics	Bool	true	Automatically create topics for WAL. Set to true to automatically create topics for WAL. Otherwise, use topics named topic_name_prefix_[0..num_topics) It's only used when the provider is kafka.
wal.auto_prune_interval	String	30m	Interval of automatically WAL pruning. Set to 0s to disable automatically WAL pruning which delete unused remote WAL entries periodically. It's only used when the provider is kafka.
wal.auto_prune_logical_delete	Bool	false	Whether automatically WAL pruning only updates the metadata marker and skips Kafka DeleteRecords. Set to true for Kafka deployments that do not support DeleteRecords. It's only used when the provider is kafka.
wal.flush_trigger_size	String	512MB	Estimated size threshold to trigger a flush when using Kafka remote WAL. Since multiple regions may share a Kafka topic, the estimated size is calculated as: (latest_entry_id - flushed_entry_id) * avg_record_size MetaSrv triggers a flush for a region when this estimated size exceeds flush_trigger_size. - latest_entry_id: The latest entry ID in the topic. - flushed_entry_id: The last flushed entry ID for the region. Set to "0" to let the system decide the flush trigger size. It's only used when the provider is kafka.
wal.checkpoint_trigger_size	String	128MB	Estimated size threshold to trigger a checkpoint when using Kafka remote WAL. The estimated size is calculated as: (latest_entry_id - last_checkpoint_entry_id) * avg_record_size MetaSrv triggers a checkpoint for a region when this estimated size exceeds checkpoint_trigger_size. Set to "0" to let the system decide the checkpoint trigger size. It's only used when the provider is kafka.
wal.auto_prune_parallelism	Integer	10	Concurrent task limit for automatically WAL pruning. It's only used when the provider is kafka.
wal.num_topics	Integer	64	Number of topics used for remote WAL. It's only used when the provider is kafka.
wal.selector_type	String	round_robin	Topic selector type. Available selector types: - round_robin (default) It's only used when the provider is kafka.
wal.topic_name_prefix	String	greptimedb_wal_topic	A Kafka topic is constructed by concatenating topic_name_prefix and topic_id. Only accepts strings that match the following regular expression pattern: [a-zA-Z_:-][a-zA-Z0-9_:-.@#]* i.g., greptimedb_wal_topic_0, greptimedb_wal_topic_1. It's only used when the provider is kafka.
wal.replication_factor	Integer	1	Expected number of replicas of each partition. It's only used when the provider is kafka.
wal.create_topic_timeout	String	30s	The timeout for creating a Kafka topic. It's only used when the provider is kafka.
event_recorder	--	--	Configuration options for the event recorder.
event_recorder.ttl	String	90d	TTL for the events table that will be used to store the events. Default is 90d.
event_recorder.event_types	Array	All	Event types to record. Current available event types: region_migration, create_database, alter_database, drop_database, create_flow, drop_flow, create_table, create_logical_tables, alter_table, alter_logical_tables, drop_table, undrop_table, purge_dropped_table, truncate_table, create_view, drop_view, repartition, repartition_group, wal_prune, batch_gc, reconcile_catalog, reconcile_database, reconcile_table, reconcile_logical_tables. When omitted, all current and future event types are recorded. Set to an empty array to disable event recording.
stats_persistence	--	--	Configuration options for the stats persistence.
stats_persistence.ttl	String	0s	TTL for the stats table that will be used to store the stats. Set to 0s to disable stats persistence. Default is 0s. If you want to enable stats persistence, set the TTL to a value greater than 0. It is recommended to set a small value, e.g., 3h.
stats_persistence.interval	String	10m	The interval to persist the stats. Default is 10m. The minimum value is 10m, if the value is less than 10m, it will be overridden to 10m.
gc	--	--	--
gc.enable	Bool	false	Whether GC is enabled. Default to false. Need to be the same with datanode's mito.gc.enable If set to false, no GC will be performed
gc.gc_cooldown_period	String	5m	Cooldown period between GC operations on the same region.
logging	--	--	The logging options.
logging.dir	String	./greptimedb_data/logs	The directory to store the log files. If set to empty, logs will not be written to files.
logging.level	String	Unset	The log level. Can be info/debug/warn/error.
logging.enable_otlp_tracing	Bool	false	Enable OTLP tracing.
logging.otlp_endpoint	String	http://localhost:4318/v1/traces	The OTLP tracing endpoint.
logging.append_stdout	Bool	true	Whether to append logs to stdout.
logging.enable_file_logging	Bool	true	Whether to write logs to files in dir.
logging.log_format	String	text	The log format. Can be text/json.
logging.max_log_files	Integer	720	The maximum amount of log files.
logging.max_log_dir_size	String	0B	The maximum total size of managed log files in dir. Old closed log files are removed before writing when necessary. Active files may exceed it. Set to 0B to disable.
logging.otlp_export_protocol	String	http	The OTLP tracing export protocol. Can be grpc/http.
logging.otlp_headers	--	--	Additional OTLP headers, only valid when using OTLP http
logging.tracing_sample_ratio	--	Unset	The percentage of tracing will be sampled and exported. Valid range [0, 1], 1 means all traces are sampled, 0 means all traces are not sampled, the default value is 1. ratio > 1 are treated as 1. Fractions < 0 are treated as 0
logging.tracing_sample_ratio.default_ratio	Float	1.0	--
tracing	--	--	The tracing options. Only effect when compiled with tokio-console feature.
tracing.tokio_console_addr	String	Unset	The tokio console address.
memory	--	--	The memory options.
memory.enable_heap_profiling	Bool	true	Whether to enable heap profiling activation during startup. When enabled, heap profiling will be activated if the MALLOC_CONF environment variable is set to "prof:true,prof_active:false". The official image adds this env variable. Default is true.

Datanode

Key	Type	Default	Descriptions
node_id	Integer	Unset	The datanode identifier and should be unique in the cluster.
default_column_prefix	String	Unset	The default column prefix for auto-created time index, value, and native histogram columns. Legacy OTLP summary columns keep their historical greptime_ prefix.
require_lease_before_startup	Bool	false	Start services after regions have obtained leases. It will block the datanode start if it can't receive leases in the heartbeat from metasrv.
init_regions_in_background	Bool	false	Initialize all regions in the background during the startup. By default, it provides services after all regions have been initialized.
init_regions_parallelism	Integer	16	Parallelism of initializing regions.
max_concurrent_queries	Integer	0	The maximum concurrent queries allowed to be executed. Zero means unlimited.
concurrent_query_limiter_timeout	String	100ms	Timeout to acquire a permit from the concurrent query limiter when max_concurrent_queries is reached.
enable_telemetry	Bool	true	Enable telemetry to collect anonymous usage data. Enabled by default.
http	--	--	The HTTP server options.
http.addr	String	127.0.0.1:4000	The address to bind the HTTP server.
http.timeout	String	0s	HTTP request timeout. Set to 0 to disable timeout.
http.body_limit	String	64MB	HTTP request body limit. The following units are supported: B, KB, KiB, MB, MiB, GB, GiB, TB, TiB, PB, PiB. Set to 0 to disable limit.
grpc	--	--	The gRPC server options.
grpc.bind_addr	String	127.0.0.1:3001	The address to bind the gRPC server.
grpc.server_addr	String	Unset	The address advertised to the metasrv, and used for connections from outside the host. If left empty or unset, the server will automatically use the IP address of the first network interface on the host, with the same port number as the one specified in grpc.bind_addr.
grpc.runtime_size	Integer	8	The number of server worker threads.
grpc.max_recv_message_size	String	512MB	The maximum receive message size for gRPC server.
grpc.max_send_message_size	String	512MB	The maximum send message size for gRPC server.
grpc.flight_compression	String	arrow_ipc	Compression mode for datanode side Arrow IPC service. Available options: - none: disable all compression - transport: only enable gRPC transport compression (zstd) - arrow_ipc: only enable Arrow IPC compression (lz4) - all: enable all compression. Default to arrow_ipc.
grpc.tls	--	--	gRPC server TLS options, see mysql.tls section.
grpc.tls.mode	String	disable	TLS mode.
grpc.tls.cert_path	String	Unset	Certificate file path.
grpc.tls.key_path	String	Unset	Private key file path.
grpc.tls.watch	Bool	false	Watch for Certificate and key file change and auto reload. For now, gRPC tls config does not support auto reload.
runtime	--	--	The runtime options.
runtime.global_rt_size	Integer	Auto	The number of threads to execute the runtime for global read operations. Defaults to max(num_cpus, 2).
runtime.compact_rt_size	Integer	Auto	The number of threads to execute compact operations. Defaults to max(num_cpus / 2, 2).
runtime.compact_rt_max_blocking_threads	Integer	Auto	The maximum number of blocking threads for compact operations. Defaults to max(num_cpus / 2, 2).
runtime.query_rt_size	Integer	Auto	The number of threads to execute datanode query operations. Defaults to max(num_cpus - 1, 2).
runtime.ingest_rt_size	Integer	Auto	The number of threads to execute datanode ingestion operations. Defaults to max(num_cpus, 2).
runtime.experimental_workload_scheduler	--	--	Experimental weighted, work-conserving query/write task scheduler.
runtime.experimental_workload_scheduler.enable	Bool	false	Enable when concurrent queries and writes interfere with each other—for example, when long-running queries increase ingestion latency. The weights set their relative runtime shares while both are backlogged. Disabled by default.
runtime.experimental_workload_scheduler.query_weight	Integer	2	Relative query share while both query and write workloads are backlogged.
runtime.experimental_workload_scheduler.write_weight	Integer	8	Relative write share while both query and write workloads are backlogged.
runtime.experimental_workload_scheduler.sample_every_polls	Integer	16	Number of polls between scheduler fairness samples. Must be greater than zero.
meta_client	--	--	The metasrv client options.
meta_client.metasrv_addrs	Array	--	The addresses of the metasrv.
meta_client.timeout	String	3s	Operation timeout.
meta_client.ddl_timeout	String	10s	DDL timeout.
meta_client.connect_timeout	String	1s	Connect server timeout.
meta_client.tcp_nodelay	Bool	true	TCP_NODELAY option for accepted connections.
meta_client.metadata_cache_max_capacity	Integer	100000	The configuration about the cache of the metadata.
meta_client.metadata_cache_ttl	String	10m	TTL of the metadata cache.
meta_client.metadata_cache_tti	String	5m	--
wal	--	--	The WAL options.
wal.provider	String	raft_engine	The provider of the WAL. - raft_engine: the wal is stored in the local file system by raft-engine. - kafka: it's remote wal that data is stored in Kafka. - noop: it's a no-op WAL provider that does not store any WAL data. Notes: any unflushed data will be lost when the datanode is shutdown. - experimental_object_store: the wal is stored as objects in an object store. Notes: experimental and not supported yet.
wal.dir	String	Unset	The directory to store the WAL files. It's only used when the provider is raft_engine.
wal.file_size	String	128MB	The size of the WAL segment file. It's only used when the provider is raft_engine.
wal.purge_threshold	String	1GB	The threshold of the WAL size to trigger a purge. It's only used when the provider is raft_engine.
wal.purge_interval	String	1m	The interval to trigger a purge. It's only used when the provider is raft_engine.
wal.read_batch_size	Integer	128	The read batch size. It's only used when the provider is raft_engine.
wal.sync_write	Bool	false	Whether to use sync write. It's only used when the provider is raft_engine.
wal.enable_log_recycle	Bool	true	Whether to reuse logically truncated log files. It's only used when the provider is raft_engine.
wal.prefill_log_files	Bool	false	Whether to pre-create log files on start up. It's only used when the provider is raft_engine.
wal.sync_period	String	5s	Duration for fsyncing log files. It's only used when the provider is raft_engine.
wal.recovery_parallelism	Integer	Auto	Parallelism during WAL recovery. Defaults to the number of CPU cores; this example sets it to 2.
wal.broker_endpoints	Array	--	The Kafka broker endpoints. It's only used when the provider is kafka.
wal.connect_timeout	String	3s	The connect timeout for kafka client. It's only used when the provider is kafka.
wal.timeout	String	5s	The total request timeout for kafka client. It's only used when the provider is kafka.
wal.max_batch_bytes	String	1MB	The max size of a single producer batch. Warning: Kafka has a default limit of 1MB per message in a topic. Defaults to 8MB when the provider is experimental_object_store. It's only used when the provider is kafka or experimental_object_store.
wal.consumer_wait_timeout	String	100ms	The consumer wait timeout. It's only used when the provider is kafka.
wal.create_index	Bool	false	Whether to enable WAL index creation. It's only used when the provider is kafka.
wal.dump_index_interval	String	60s	The interval for dumping WAL indexes. It's only used when the provider is kafka.
wal.overwrite_entry_start_id	Bool	false	Ignore missing entries during read WAL. It's only used when the provider is kafka. This option ensures that when Kafka messages are deleted, the system can still successfully replay memtable data without throwing an out-of-range error. However, enabling this option might lead to unexpected data loss, as the system will skip over missing entries instead of treating them as critical errors.
wal.storage_provider	String	""	The name of the storage provider that holds the WAL objects, an empty name selects the default object store. It's only used when the provider is experimental_object_store.
wal.prefix	String	wal	The path prefix of the WAL objects inside the storage provider. The objects are written under <prefix>/datanodes/<node_id>/epochs/<generation>, which is derived from this prefix. It's only used when the provider is experimental_object_store.
wal.flush_interval	String	100ms	The interval of flushing buffered entries to the object store, at least 10ms, defaults to 100ms. Each non-empty timer-triggered flush creates one object, and a batch that reaches max_batch_bytes is flushed immediately, so under sustained load the batch seals on size and the interval no longer matters. When writes are sparse, a shorter interval lowers the acknowledgement latency of durable appends and raises the number of object requests: timer-triggered sealing creates at most one object per interval per node, and in enqueued mode the backlog thresholds can seal earlier. An enqueued append does not wait for its batch to seal once it is admitted, but the backlog thresholds can delay admission. It's only used when the provider is experimental_object_store.
wal.ack_mode	String	durable	When an append to the object store WAL returns. - durable: an append returns after the object holding its entries is durable (the default). - enqueued: an append returns once its entries are admitted and their ids are assigned, and the object is created in the background. A crash loses the unpersisted backlog. It's only used when the provider is experimental_object_store.
wal.max_unpersisted_bytes	String	64MB	The size of the unpersisted backlog at which new appends stall until an upload completes, in enqueued mode. Nothing is dropped and nothing is rejected; the threshold does not bound what a crash during an outage can lose. It's only used when the provider is experimental_object_store and ack_mode is enqueued.
wal.max_unpersisted_age	String	8s	The age of the oldest unpersisted entry at which new appends stall until an upload completes, in enqueued mode. It's only used when the provider is experimental_object_store and ack_mode is enqueued.
wal.on_corrupted_segment	String	skip	What a read does with a segment that still does not decode after a second fetch, because its checksum does not match or its content disagrees with its footer entry. - skip: the segment is skipped and recorded as a WAL hole of its region, a metric is incremented and a warning is logged; the other regions of the object are unaffected (the default). - fail: the read fails, so the region does not open. It's only used when the provider is experimental_object_store.
query	--	--	The query engine options.
query.parallelism	Integer	0	Parallelism of the query engine. Default to 0, which means the number of CPU cores.
query.memory_pool_size	String	0	Memory pool size for query execution operators (aggregation, sorting, join). Supports absolute size (e.g., "2GB", "4GB") or percentage of system memory (e.g., "20%"). Setting it to 0 disables the limit. Defaults to 0 (unlimited); this example sets it to 50%. When this limit is reached, queries will fail with ResourceExhausted error. NOTE: This does NOT limit memory used by table scans.
query.experimental_memory_pool_policy	String	greedy	Experimental memory pool allocation policy: - "greedy" (default): first-come-first-served allocation; preserves current behavior. - "fair": divides available memory among spillable operators and may spill earlier. Only effective when memory_pool_size is bounded (>0).
query.experimental_spill_mode	String	default	Spill mode: - "default": preserve DataFusion built-in OS temp directory (default). - "custom": explicitly configure spill path, quota, and compression. - "disabled": explicitly disable disk spilling. Set this to "custom" before using the path/quota/compression keys below.
query.experimental_spill_path	String	Unset	Spill directory path. Ignored unless mode is "custom".
query.experimental_spill_max_temp_directory_size	String	1GiB	Maximum total size of spill directory (default: "1GiB"). Ignored unless mode is "custom".
query.experimental_spill_compression	String	uncompressed	Compression for spilled data files: "uncompressed" (default), "lz4_frame", "zstd". Ignored unless mode is "custom".
storage	--	--	The data storage options.
storage.data_home	String	./greptimedb_data	The working home directory.
storage.type	String	File	The storage type used to store the data. - File: the data is stored in the local file system. - S3: the data is stored in the S3 object storage. - Gcs: the data is stored in the Google Cloud Storage. - Azblob: the data is stored in the Azure Blob Storage. - Oss: the data is stored in the Aliyun OSS. - Hdfs: the data is stored in the Hadoop Distributed File System.
storage.bucket	String	Unset	The S3 bucket name. It's only used when the storage type is S3, Oss and Gcs.
storage.root	String	Unset	The directory or object prefix under which data is stored. It's only used when the storage type is S3, Oss, Gcs, Azblob and Hdfs.
storage.name_node	String	Unset	The HDFS NameNode URI, for example, hdfs://127.0.0.1:9000. It's only used when the storage type is Hdfs.
storage.options	InlineTable	Unset	Additional options passed to the native HDFS client. It's only used when the storage type is Hdfs.
storage.access_key_id	String	Unset	The access key id of the aws account. It's highly recommended to use AWS IAM roles instead of hardcoding the access key id and secret key. It's only used when the storage type is S3 and Oss.
storage.secret_access_key	String	Unset	The secret access key of the aws account. It's highly recommended to use AWS IAM roles instead of hardcoding the access key id and secret key. It's only used when the storage type is S3.
storage.access_key_secret	String	Unset	The secret access key of the aliyun account. It's only used when the storage type is Oss.
storage.account_name	String	Unset	The account key of the azure account. It's only used when the storage type is Azblob.
storage.account_key	String	Unset	The account key of the azure account. It's only used when the storage type is Azblob.
storage.scope	String	Unset	The scope of the google cloud storage. It's only used when the storage type is Gcs.
storage.credential_path	String	Unset	The credential path of the google cloud storage. It's only used when the storage type is Gcs.
storage.credential	String	Unset	The credential of the google cloud storage. It's only used when the storage type is Gcs.
storage.container	String	Unset	The container of the azure account. It's only used when the storage type is Azblob.
storage.sas_token	String	Unset	The sas token of the azure account. It's only used when the storage type is Azblob.
storage.endpoint	String	Unset	The endpoint of the S3 service. It's only used when the storage type is S3, Oss, Gcs and Azblob.
storage.region	String	Unset	The region of the S3 service. It's only used when the storage type is S3, Oss, Gcs and Azblob.
storage.http_client	--	--	The http client options to the storage. It's only used when the storage type is S3, Oss, Gcs and Azblob.
storage.http_client.pool_max_idle_per_host	Integer	1024	The maximum idle connection per host allowed in the pool.
storage.http_client.connect_timeout	String	30s	The timeout for only the connect phase of a http client.
storage.http_client.timeout	String	30s	The total request timeout, applied from when the request starts connecting until the response body has finished. Also considered a total deadline.
storage.http_client.pool_idle_timeout	String	90s	The timeout for idle sockets being kept-alive.
storage.http_client.skip_ssl_validation	Bool	false	To skip the ssl verification Security Notice: Setting skip_ssl_validation = true disables certificate verification, making connections vulnerable to man-in-the-middle attacks. Only use this in development or trusted private networks.
[[region_engine]]	--	--	The region engine options. You can configure multiple region engines. Each engine type (mito, file, metric) may appear only once; duplicates cause startup to fail.
region_engine.mito	--	--	The Mito engine options.
region_engine.mito.num_workers	Integer	Auto	Number of region workers. Defaults to half of the available CPU cores, rounded up.
region_engine.mito.worker_channel_size	Integer	128	Request channel size of each worker.
region_engine.mito.worker_request_batch_size	Integer	64	Max batch size for a worker to handle requests.
region_engine.mito.manifest_checkpoint_distance	Integer	10	Number of meta action updated to trigger a new checkpoint for the manifest.
region_engine.mito.experimental_manifest_keep_removed_file_count	Integer	256	Number of removed files to keep in manifest's removed_files field before also remove them from removed_files. Mostly for debugging purpose. If set to 0, it will only use keep_removed_file_ttl to decide when to remove files from removed_files field.
region_engine.mito.experimental_manifest_keep_removed_file_ttl	String	1h	How long to keep removed files in the removed_files field of manifest after they are removed from manifest. files will only be removed from removed_files field if both keep_removed_file_count and keep_removed_file_ttl is reached.
region_engine.mito.compress_manifest	Bool	false	Whether to compress manifest and checkpoint file by gzip (default false).
region_engine.mito.experimental_enable_series_index	Bool	false	Under development; do not enable. Whether to enable series indexes. Indexes are stored on the local filesystem under {data_home}/series_index.
region_engine.mito.experimental_series_index_max_size	String	5GiB	Approximate series and range index size limit in open regions, shared across workers. Workers periodically refresh usage and skip maintenance when full. In-flight reconciliation can exceed the limit. Closed-region files, temporary output, catalogs, and old snapshots retained by readers are not counted. Minimum: 1KiB. Takes effect on restart.
region_engine.mito.experimental_enable_range_index	Bool	false	Whether to build and query range indexes when series indexes are enabled. Obsolete range-index metadata and files are still cleaned up when disabled.
region_engine.mito.experimental_series_index_maintenance_interval	String	5m	Interval between series-index maintenance runs. Zero uses the default of 5 min.
region_engine.mito.experimental_series_index_bucket_width	String	5days	Requested minimum series-index bucket width (default: 5 days), rounded up to an exact multiple of each region's compaction time window.
region_engine.mito.max_background_flushes	Integer	Auto	Max number of running background flush jobs (default: 1/2 of cpu cores).
region_engine.mito.max_background_compactions	Integer	Auto	Max number of running background compaction jobs (default: 1/4 of cpu cores).
region_engine.mito.max_background_purges	Integer	Auto	Max number of running background purge jobs (default: number of cpu cores).
region_engine.mito.experimental_compaction_memory_limit	String	0	Memory budget for compaction tasks. Supports absolute size (e.g., "2GiB", "512MB") or percentage of system memory (e.g., "50%"). Setting it to 0 or "unlimited" disables the limit.
region_engine.mito.experimental_compaction_on_exhausted	String	wait	Behavior when compaction cannot acquire memory from the budget. Options: "wait" (default, 10s), "wait()", "fail"
region_engine.mito.auto_flush_interval	String	10m	Interval to auto flush a region if it has not flushed yet.
region_engine.mito.global_write_buffer_size	String	Auto	Global write buffer size for all regions. If not set, it's default to 1/8 of OS memory with a max limitation of 1GB.
region_engine.mito.global_write_buffer_reject_size	String	Auto	Global write buffer size threshold to reject write requests. If not set, it's default to 2 times of global_write_buffer_size
region_engine.mito.default_region_write_buffer_size	String	0	Default write buffer size for each region. Regions stall at this size and reject writes at twice this size. Setting it to 0 disables both limits unless the table specifies write_buffer_size.
region_engine.mito.sst_meta_cache_size	String	Auto	Cache size for SST metadata. Setting it to 0 to disable the cache. If not set, it's default to 1/8 of OS memory with a max limitation of 512MB.
region_engine.mito.vector_cache_size	String	Auto	Cache size for vectors and arrow arrays. Setting it to 0 to disable the cache. If not set, it's default to 1/16 of OS memory with a max limitation of 512MB.
region_engine.mito.page_cache_size	String	Auto	Cache size for pages of SST row groups. Setting it to 0 to disable the cache. If not set, it's default to 1/8 of OS memory.
region_engine.mito.selector_result_cache_size	String	Auto	Cache size for time series selector (e.g. last_value()). Setting it to 0 to disable the cache. If not set, it's default to 1/16 of OS memory with a max limitation of 512MB.
region_engine.mito.range_result_cache_size	String	Auto	Cache size for flat range scan results. Setting it to 0 to disable the cache. If not set, it's default to 1/16 of OS memory with a max limitation of 512MB.
region_engine.mito.prefilter_result_cache_size	String	Auto	Cache size for prefilter results. Setting it to 0 to disable the cache. If not set, it's default to 1/32 of OS memory with a max limitation of 128MB.
region_engine.mito.enable_write_cache	Bool	false	Whether to enable the write cache, it's enabled by default when using object storage. It is recommended to enable it when using object storage for better performance.
region_engine.mito.write_cache_path	String	""	File system path for write cache, defaults to {data_home}.
region_engine.mito.write_cache_size	String	5GiB	Capacity for write cache. If your disk space is sufficient, it is recommended to set it larger.
region_engine.mito.write_cache_ttl	String	Unset	TTL for write cache.
region_engine.mito.preload_index_cache	Bool	true	Preload index (puffin) files into cache on region open (default: true). When enabled, index files are loaded into the write cache during region initialization, which can improve query performance at the cost of longer startup times.
region_engine.mito.index_cache_percent	Integer	20	Percentage of write cache capacity allocated for index (puffin) files (default: 20). The remaining capacity is used for data (parquet) files. Must be between 0 and 100 (exclusive). For example, with a 5GiB write cache and 20% allocation, 1GiB is reserved for index files and 4GiB for data files.
region_engine.mito.enable_refill_cache_on_read	Bool	true	Enable refilling cache on read operations (default: true). When disabled, cache refilling on read won't happen.
region_engine.mito.manifest_cache_size	String	256MB	Capacity for manifest cache (default: 256MB).
region_engine.mito.sst_write_buffer_size	String	8MB	Buffer size for SST writing.
region_engine.mito.max_concurrent_scan_files	Integer	384	Maximum number of SST files to scan concurrently.
region_engine.mito.allow_stale_entries	Bool	false	Whether to allow stale WAL entries read during replay.
region_engine.mito.scan_memory_limit	String	unlimited	Memory limit for table scans across all queries. Supports absolute size (e.g., "2GB") or percentage of system memory (e.g., "20%"). Setting it to 0 or "unlimited" disables the limit.
region_engine.mito.scan_memory_on_exhausted	String	fail	Controls what happens when a scan cannot get memory immediately. "fail" (default) fails fast and is the recommended option for most users. "wait" / "wait()" waits for memory to become available. This is mainly for advanced tuning in bursty workloads where temporary contention is common and higher latency is acceptable. "wait" means "wait(10s)", not unlimited waiting.
region_engine.mito.min_compaction_interval	String	0m	Minimum time interval between two compactions. To align with the old behavior, the default value is 0 (no restrictions).
region_engine.mito.schedule_compaction_after_edit	Bool	true	Whether to allow to schedule a compaction after a successful region edit. Setting this to "true" is a necessary but not sufficient condition for scheduling compaction after a region edit. Other constraints, such as "min_compaction_interval", may still prevent compaction from being scheduled. Setting this to "false", however, guarantees that compaction will not be scheduled after a region edit.
region_engine.mito.default_flat_format	Bool	true	Whether to enable flat format as the default SST format.
region_engine.mito.experimental_series_scan_v2	Bool	false	Whether to enable the experimental two-phase mode for eligible metric series scans.
region_engine.mito.index	--	--	The options for index in Mito engine.
region_engine.mito.index.aux_path	String	""	Auxiliary directory path for the index in filesystem, used to store intermediate files for creating the index and staging files for searching the index, defaults to {data_home}/index_intermediate. The default name for this directory is index_intermediate for backward compatibility. This path contains two subdirectories: - __intm: for storing intermediate files used during creating index. - staging: for storing staging files used during searching index.
region_engine.mito.index.staging_size	String	2GB	The max capacity of the staging directory.
region_engine.mito.index.staging_ttl	String	7d	The TTL of the staging directory. Defaults to 7 days. Setting it to "0s" to disable TTL.
region_engine.mito.index.metadata_cache_size	String	64MiB	Cache size for inverted index metadata.
region_engine.mito.index.content_cache_size	String	128MiB	Cache size for inverted index content.
region_engine.mito.index.content_cache_page_size	String	64KiB	Page size for inverted index content cache.
region_engine.mito.index.result_cache_size	String	128MiB	Cache size for index result.
region_engine.mito.inverted_index	--	--	The options for inverted index in Mito engine.
region_engine.mito.inverted_index.create_on_flush	String	auto	Whether to create the index on flush. - auto: automatically (default) - disable: never
region_engine.mito.inverted_index.create_on_compaction	String	auto	Whether to create the index on compaction. - auto: automatically (default) - disable: never
region_engine.mito.inverted_index.apply_on_query	String	auto	Whether to apply the index on query - auto: automatically (default) - disable: never
region_engine.mito.inverted_index.mem_threshold_on_create	String	auto	Memory threshold for performing an external sort during index creation. - auto: automatically determine the threshold based on the system memory size (default) - unlimited: no memory limit - [size] e.g. 64MB: fixed memory threshold
region_engine.mito.inverted_index.intermediate_path	String	""	Deprecated, use region_engine.mito.index.aux_path instead.
region_engine.mito.fulltext_index	--	--	The options for full-text index in Mito engine.
region_engine.mito.fulltext_index.create_on_flush	String	auto	Whether to create the index on flush. - auto: automatically (default) - disable: never
region_engine.mito.fulltext_index.create_on_compaction	String	auto	Whether to create the index on compaction. - auto: automatically (default) - disable: never
region_engine.mito.fulltext_index.apply_on_query	String	auto	Whether to apply the index on query - auto: automatically (default) - disable: never
region_engine.mito.fulltext_index.mem_threshold_on_create	String	auto	Memory threshold for index creation. - auto: automatically determine the threshold based on the system memory size (default) - unlimited: no memory limit - [size] e.g. 64MB: fixed memory threshold
region_engine.mito.bloom_filter_index	--	--	The options for bloom filter index in Mito engine.
region_engine.mito.bloom_filter_index.create_on_flush	String	auto	Whether to create the index on flush. - auto: automatically (default) - disable: never
region_engine.mito.bloom_filter_index.create_on_compaction	String	auto	Whether to create the index on compaction. - auto: automatically (default) - disable: never
region_engine.mito.bloom_filter_index.apply_on_query	String	auto	Whether to apply the index on query - auto: automatically (default) - disable: never
region_engine.mito.bloom_filter_index.mem_threshold_on_create	String	auto	Memory threshold for the index creation. - auto: automatically determine the threshold based on the system memory size (default) - unlimited: no memory limit - [size] e.g. 64MB: fixed memory threshold
region_engine.mito.gc	--	--	--
region_engine.mito.gc.enable	Bool	false	Whether GC is enabled. Need to be the same with metasrv's gc.enable or unexpected behavior will occur
region_engine.mito.gc.lingering_time	String	1h	Lingering time before deleting files. Should be long enough to allow long running queries to finish. If set to None, then unused files will be deleted immediately.
region_engine.mito.gc.unknown_file_lingering_time	String	1d	Lingering time before deleting unknown files (files with undetermined expel time). Only applies during full file listing GC. This uses the object's last-modified timestamp as a heuristic (strict less-than comparison); do not configure this value too small in production to avoid deleting pre-manifest files from in-progress compaction or flush. For active/open regions, an unknown file is deleted only if its object last-modified time exceeds this TTL. If the object store does not provide a last-modified timestamp, the file is conservatively kept. For dropped regions, unknown files are deleted immediately.
region_engine.file	--	--	Enable the file engine.
region_engine.metric	--	--	Metric engine options.
logging	--	--	The logging options.
logging.dir	String	./greptimedb_data/logs	The directory to store the log files. If set to empty, logs will not be written to files.
logging.level	String	Unset	The log level. Can be info/debug/warn/error.
logging.enable_otlp_tracing	Bool	false	Enable OTLP tracing.
logging.otlp_endpoint	String	http://localhost:4318/v1/traces	The OTLP tracing endpoint.
logging.append_stdout	Bool	true	Whether to append logs to stdout.
logging.enable_file_logging	Bool	true	Whether to write logs to files in dir.
logging.log_format	String	text	The log format. Can be text/json.
logging.max_log_files	Integer	720	The maximum amount of log files.
logging.max_log_dir_size	String	0B	The maximum total size of managed log files in dir. Old closed log files are removed before writing when necessary. Active files may exceed it. Set to 0B to disable.
logging.otlp_export_protocol	String	http	The OTLP tracing export protocol. Can be grpc/http.
logging.otlp_headers	--	--	Additional OTLP headers, only valid when using OTLP http
logging.tracing_sample_ratio	--	Unset	The percentage of tracing will be sampled and exported. Valid range [0, 1], 1 means all traces are sampled, 0 means all traces are not sampled, the default value is 1. ratio > 1 are treated as 1. Fractions < 0 are treated as 0
logging.tracing_sample_ratio.default_ratio	Float	1.0	--
tracing	--	--	The tracing options. Only effect when compiled with tokio-console feature.
tracing.tokio_console_addr	String	Unset	The tokio console address.
memory	--	--	The memory options.
memory.enable_heap_profiling	Bool	true	Whether to enable heap profiling activation during startup. When enabled, heap profiling will be activated if the MALLOC_CONF environment variable is set to "prof:true,prof_active:false". The official image adds this env variable. Default is true.

Flownode

Key	Type	Default	Descriptions
node_id	Integer	Unset	The flownode identifier and should be unique in the cluster.
flow	--	--	flow engine options.
flow.batching_mode	--	--	--
flow.batching_mode.query_timeout	String	600s	The default batching engine query timeout is 10 minutes.
flow.batching_mode.slow_query_threshold	String	60s	will output a warn log for any query that runs for more that this threshold
flow.batching_mode.experimental_min_refresh_duration	String	5s	The minimum duration between two queries execution by batching mode task
flow.batching_mode.grpc_conn_timeout	String	5s	The gRPC connection timeout
flow.batching_mode.experimental_grpc_max_retries	Integer	3	The gRPC max retry number
flow.batching_mode.experimental_frontend_scan_timeout	String	30s	Flow wait for available frontend timeout, if failed to find available frontend after frontend_scan_timeout elapsed, return error which prevent flownode from starting
flow.batching_mode.experimental_max_filter_num_per_query	Integer	20	Maximum number of filters allowed in a single query
flow.batching_mode.experimental_time_window_merge_threshold	Integer	3	Time window merge distance
flow.batching_mode.experimental_enable_incremental_read	Bool	false	Whether to enable experimental flow incremental source reads. When disabled, batching flows always execute full-snapshot queries. Can be overridden per flow with WITH (experimental_enable_incremental_read = 'true').
flow.batching_mode.read_preference	String	Leader	Read preference of the Frontend client.
flow.batching_mode.frontend_tls	--	--	--
flow.batching_mode.frontend_tls.enabled	Bool	false	Whether to enable TLS for client.
flow.batching_mode.frontend_tls.server_ca_cert_path	String	Unset	Server Certificate file path.
flow.batching_mode.frontend_tls.client_cert_path	String	Unset	Client Certificate file path.
flow.batching_mode.frontend_tls.client_key_path	String	Unset	Client Private key file path.
grpc	--	--	The gRPC server options.
grpc.bind_addr	String	127.0.0.1:3004	The address to bind the gRPC server. Defaults to 127.0.0.1:3004; this example sets it to 127.0.0.1:6800.
grpc.server_addr	String	Unset	The address advertised to the metasrv, and used for connections from outside the host. If left empty or unset, the server will automatically use the IP address of the first network interface on the host, with the same port number as the one specified in grpc.bind_addr.
grpc.runtime_size	Integer	8	The number of server worker threads. Defaults to 8; this example sets it to 2.
grpc.max_recv_message_size	String	512MB	The maximum receive message size for gRPC server.
grpc.max_send_message_size	String	512MB	The maximum send message size for gRPC server.
http	--	--	The HTTP server options.
http.addr	String	127.0.0.1:4000	The address to bind the HTTP server.
http.timeout	String	0s	HTTP request timeout. Set to 0 to disable timeout.
http.body_limit	String	64MB	HTTP request body limit. The following units are supported: B, KB, KiB, MB, MiB, GB, GiB, TB, TiB, PB, PiB. Set to 0 to disable limit.
meta_client	--	--	The metasrv client options.
meta_client.metasrv_addrs	Array	--	The addresses of the metasrv.
meta_client.timeout	String	3s	Operation timeout.
meta_client.ddl_timeout	String	10s	DDL timeout.
meta_client.connect_timeout	String	1s	Connect server timeout.
meta_client.tcp_nodelay	Bool	true	TCP_NODELAY option for accepted connections.
meta_client.metadata_cache_max_capacity	Integer	100000	The configuration about the cache of the metadata.
meta_client.metadata_cache_ttl	String	10m	TTL of the metadata cache.
meta_client.metadata_cache_tti	String	5m	--
logging	--	--	The logging options.
logging.dir	String	./greptimedb_data/logs	The directory to store the log files. If set to empty, logs will not be written to files.
logging.level	String	Unset	The log level. Can be info/debug/warn/error.
logging.enable_otlp_tracing	Bool	false	Enable OTLP tracing.
logging.otlp_endpoint	String	http://localhost:4318/v1/traces	The OTLP tracing endpoint.
logging.append_stdout	Bool	true	Whether to append logs to stdout.
logging.enable_file_logging	Bool	true	Whether to write logs to files in dir.
logging.log_format	String	text	The log format. Can be text/json.
logging.max_log_files	Integer	720	The maximum amount of log files.
logging.max_log_dir_size	String	0B	The maximum total size of managed log files in dir. Old closed log files are removed before writing when necessary. Active files may exceed it. Set to 0B to disable.
logging.otlp_export_protocol	String	http	The OTLP tracing export protocol. Can be grpc/http.
logging.otlp_headers	--	--	Additional OTLP headers, only valid when using OTLP http
logging.tracing_sample_ratio	--	Unset	The percentage of tracing will be sampled and exported. Valid range [0, 1], 1 means all traces are sampled, 0 means all traces are not sampled, the default value is 1. ratio > 1 are treated as 1. Fractions < 0 are treated as 0
logging.tracing_sample_ratio.default_ratio	Float	1.0	--
tracing	--	--	The tracing options. Only effect when compiled with tokio-console feature.
tracing.tokio_console_addr	String	Unset	The tokio console address.
query	--	--	--
query.parallelism	Integer	1	Parallelism of the query engine for query sent by flownode. Default to 1, so it won't use too much cpu or memory
query.memory_pool_size	String	0	Memory pool size for query execution operators (aggregation, sorting, join). Supports absolute size (e.g., "1GB", "2GB") or percentage of system memory (e.g., "20%"). Setting it to 0 disables the limit. Defaults to 0 (unlimited); this example sets it to 50%. When this limit is reached, queries will fail with ResourceExhausted error. NOTE: This does NOT limit memory used by table scans.
query.experimental_memory_pool_policy	String	greedy	Experimental memory pool allocation policy: - "greedy" (default): first-come-first-served allocation; preserves current behavior. - "fair": divides available memory among spillable operators and may spill earlier. Only effective when memory_pool_size is bounded (>0).
query.experimental_spill_mode	String	default	Spill mode: - "default": preserve DataFusion built-in OS temp directory (default). - "custom": explicitly configure spill path, quota, and compression. - "disabled": explicitly disable disk spilling. Set this to "custom" before using the path/quota/compression keys below.
query.experimental_spill_path	String	Unset	Spill directory path. Ignored unless mode is "custom".
query.experimental_spill_max_temp_directory_size	String	1GiB	Maximum total size of spill directory (default: "1GiB"). Ignored unless mode is "custom".
query.experimental_spill_compression	String	uncompressed	Compression for spilled data files: "uncompressed" (default), "lz4_frame", "zstd". Ignored unless mode is "custom".
memory	--	--	The memory options.
memory.enable_heap_profiling	Bool	true	Whether to enable heap profiling activation during startup. When enabled, heap profiling will be activated if the MALLOC_CONF environment variable is set to "prof:true,prof_active:false". The official image adds this env variable. Default is true.