Skip to content

Commit 7232b1c

Browse files
authored
Correct default value of ZO_GRPC_ORG_HEADER_KEY (#254)
1 parent 5b6ccd2 commit 7232b1c

File tree

1 file changed

+15
-15
lines changed

1 file changed

+15
-15
lines changed

docs/environment-variables.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -3,11 +3,11 @@ description: >-
33
Configure OpenObserve with flexible environment variables for roles, storage,
44
performance, and scaling across open source and enterprise deployments.
55
---
6-
> Applicable to both Open Source and Enterprise editions.
6+
> Applicable to both Open Source and Enterprise editions.
77
88
OpenObserve is configured using the following environment variables.
99

10-
## Basic Configuration
10+
## Basic Configuration
1111
| Environment Variable | Default Value | Description |
1212
|---------------------|---------------|-------------|
1313
| ZO_ROOT_USER_EMAIL | - | Email ID of the root user. |
@@ -35,7 +35,7 @@ In high-load environments, alerts or reports might run large, resource-intensive
3535
| ZO_HTTP_WORKER_MAX_BLOCKING | 1024 | Maximum number of blocking connections allowed per HTTP thread. |
3636
| ZO_GRPC_PORT | 5081 | Port number on which the OpenObserve server listens for gRPC requests. |
3737
| ZO_GRPC_ADDR | | IP address on which the OpenObserve server listens for gRPC requests. |
38-
| ZO_GRPC_ORG_HEADER_KEY | openobserve-org-id | Header key for sending organization information in traces using OTLP over gRPC. |
38+
| ZO_GRPC_ORG_HEADER_KEY | organization | Header key for sending organization information in traces using OTLP over gRPC. |
3939
| ZO_GRPC_STREAM_HEADER_KEY | stream-name | Header key for sending stream name information in traces using OTLP over gRPC. |
4040
| ZO_GRPC_MAX_MESSAGE_SIZE | 16 | Maximum gRPC message size in MB. Default is 16 MB. |
4141
| ZO_GRPC_CONNECT_TIMEOUT | 5 | Timeout in seconds for connecting to the gRPC server. |
@@ -88,7 +88,7 @@ In high-load environments, alerts or reports might run large, resource-intensive
8888
| ZO_MEM_TABLE_MAX_SIZE | 0 | Total size limit of all memtables. Multiple memtables exist for different organizations and stream types. Each memtable cannot exceed ZO_MAX_FILE_SIZE_IN_MEMORY, and the combined size cannot exceed this limit. If exceeded, the system returns a MemoryTableOverflowError to prevent out-of-memory conditions. Default is 50 percent of total memory. |
8989
| ZO_MEM_PERSIST_INTERVAL | 5 | Interval in seconds at which immutable memtables are persisted from memory to disk. Default is 5 seconds. |
9090
| ZO_FEATURE_SHARED_MEMTABLE_ENABLED | false | When set to true, it turns on the shared memtable feature and several organizations can use the same in-memory table instead of each organization creating its own. This helps reduce memory use when many organizations send data at the same time. It also works with older non-shared write-ahead log (WAL) files. |
91-
| ZO_MEM_TABLE_BUCKET_NUM | 1 | This setting controls how many in-memory tables OpenObserve creates, and works differently depending on whether shared memtable is enabled or disabled. <br>
91+
| ZO_MEM_TABLE_BUCKET_NUM | 1 | This setting controls how many in-memory tables OpenObserve creates, and works differently depending on whether shared memtable is enabled or disabled. <br>
9292
**When ZO_FEATURE_SHARED_MEMTABLE_ENABLED is true (shared memtable enabled)**:
9393
<br>
9494
OpenObserve creates the specified number of shared in-memory tables that all organizations use together. <br> **If the number is higher**: OpenObserve creates more shared tables. Each table holds data from fewer organizations. This can make data writing faster because each table handles less data. However, it also uses more memory. <br>
@@ -135,7 +135,7 @@ This is particularly useful when you have only one organization, as creating mul
135135
| ZO_COMPACT_PENDING_JOBS_METRIC_INTERVAL | 300 | Interval to publish pending job metrics in seconds. |
136136
| ZO_COMPACT_MAX_GROUP_FILES | 10000 | Maximum number of files allowed in a compaction group. |
137137

138-
## UI and Web
138+
## UI and Web
139139
| Environment Variable | Default Value | Description |
140140
|---------------------|---------------|-------------|
141141
| ZO_UI_SQL_BASE64_ENABLED | false | Enable base64 encoding for SQL in UI. |
@@ -156,7 +156,7 @@ This is particularly useful when you have only one organization, as creating mul
156156
| ZO_JSON_LIMIT | 209715200 | The max payload size of JSON. |
157157
| ZO_PAYLOAD_LIMIT | 209715200 | The max payload size of http request body. |
158158

159-
## Actix Server
159+
## Actix Server
160160
| Environment Variable | Default Value | Description |
161161
|---------------------|---------------|-------------|
162162
| ZO_ACTIX_REQ_TIMEOUT | 30 | Sets actix server client timeout in seconds for first request. |
@@ -185,7 +185,7 @@ This is particularly useful when you have only one organization, as creating mul
185185
| ZO_TRACES_FILE_RETENTION | hourly | Default time partition level for trace streams. Supported values are hourly and daily. |
186186
| ZO_METRICS_FILE_RETENTION | daily | Default time partition level for metric streams. Supported values are hourly and daily. |
187187

188-
## Metrics
188+
## Metrics
189189
| Environment Variable | Default Value | Description |
190190
|---------------------|---------------|-------------|
191191
| ZO_METRICS_DEDUP_ENABLED | true | Enable de-duplication for metrics |
@@ -196,13 +196,13 @@ This is particularly useful when you have only one organization, as creating mul
196196
| ZO_SELF_METRIC_CONSUMPTION_ACCEPTLIST | - | Comma-separated list of metrics to self-consume. |
197197

198198

199-
## Distinct Values
199+
## Distinct Values
200200
| Environment Variable | Default Value | Description |
201201
|---------------------|---------------|-------------|
202202
| ZO_DISTINCT_VALUES_INTERVAL | 10s | Controls how often distinct values for a stream are written from memory to disk. Distinct values are automatically collected when data is ingested. Instead of writing every value to disk immediately, the system waits for this interval. This prevents the system from frequently writing very small chunks of data to disk. Example: If the interval is 10 seconds, distinct values ingested within that 10-second window are combined and written once. |
203203
| ZO_DISTINCT_VALUES_HOURLY | false | Enables additional deduplication at an hourly level. When enabled, distinct values that repeat within the same hour are merged again, and the system logs a count instead of storing duplicate entries. The collected distinct values are stored in a special stream named distinct_values. Example: Suppose request IDs 123 appear multiple times in one hour. Instead of separate entries, they are merged into one record like: request_id: 123, count: 3 |
204204

205-
## Alerts and Reports
205+
## Alerts and Reports
206206
| Environment Variable | Default Value | Description |
207207
|---------------------|---------------|-------------|
208208
| ZO_ALERT_SCHEDULE_INTERVAL | 10s | Defines how often the alert manager checks for scheduled jobs such as alerts, reports, or scheduled pipelines. The default value is 10 seconds. This means the alert manager fetches and processes alerts, reports, and pipelines every 10 seconds. |
@@ -244,7 +244,7 @@ This is particularly useful when you have only one organization, as creating mul
244244
| ZO_FILE_LIST_DUMP_MIN_HOUR | 2 | Minimum hour of day to run file list dump. |
245245
| ZO_FILE_LIST_DUMP_DEBUG_CHECK | true | Enables debug checks during file list dump. |
246246

247-
## Queue
247+
## Queue
248248
| Environment Variable | Default Value | Description |
249249
|---------------------|---------------|-------------|
250250
| ZO_QUEUE_STORE | | Set to "nats" to enable internal queuing through NATS for coordinating rate limiting. |
@@ -553,7 +553,7 @@ This is particularly useful when you have only one organization, as creating mul
553553
| ZO_USAGE_REPORTING_MODE | local | Local mode means the usage will be reported only in the internal cluster of ZO_USAGE_ORG. remote mode means that the usage reporting will be ingested to the remote target. both ingests the usage reports both to internal and remote target. |
554554
| ZO_USAGE_REPORTING_URL | [http://localhost:5080/api/_meta/usage/_json](http://localhost:5080/api/_meta/usage/_json) | In case of remote or both value of ZO_USAGE_REPORTING_MODE, this URL is used to post the usage reports to remote target. |
555555
| ZO_USAGE_REPORTING_CREDS | - | The credentials required to send along with the post request to the ZO_USAGE_REPORTING_URL. E.g. - Basic cm9vdEBleGFtcGxlLmNvbTpDb21wbGV4UGFzcyMxMjM=. |
556-
| ZO_USAGE_PUBLISH_INTERVAL | 600 | Duration in seconds after the last reporting usage will be published. |
556+
| ZO_USAGE_PUBLISH_INTERVAL | 600 | Duration in seconds after the last reporting usage will be published. |
557557

558558
## SMTP
559559

@@ -594,7 +594,7 @@ This is particularly useful when you have only one organization, as creating mul
594594
| ZO_QUICK_MODE_FORCE_ENABLED | true | Enables automatic activation of Quick Mode from the backend. When set to true, OpenObserve applies Quick Mode automatically if the number of fields in a stream exceeds the limit defined by `ZO_QUICK_MODE_NUM_FIELDS`, even when the Quick Mode toggle in the UI is turned off.|
595595
| ZO_QUICK_MODE_NUM_FIELDS | 500 | This defines the number of fields beyond which the quick mode will be force enabled. |
596596

597-
## Miscellaneous
597+
## Miscellaneous
598598
| Environment Variable | Default Value | Description |
599599
|---------------------|---------------|-------------|
600600
| ZO_STARTING_EXPECT_QUERIER_NUM | 0 | The number of queriers expected to be running while caching enrichment tables. |
@@ -698,7 +698,7 @@ This is particularly useful when you have only one organization, as creating mul
698698
<!--
699699
700700
| Environment Variable | Default Value | Mandatory | Description |
701-
| ------------------------------------ | -------------------------- | ------------ | --------------------------------------------------------------------------------- |
701+
| ------------------------------------ | -------------------------- | ------------ | --------------------------------------------------------------------------------- |
702702
| ZO_ROOT_USER_EMAIL | - | On first run | Email of first/root user |
703703
| ZO_ROOT_USER_PASSWORD | - | On first run | Password for first/root user |
704704
| ZO_LOCAL_MODE | true | No | If local mode is set to true ,OpenObserve becomes single node deployment, false indicates cluster mode deployment which supports multiple nodes with different roles. For local mode one needs to configure `sqlite db`, for cluster mode one needs to config `etcd`. |
@@ -712,7 +712,7 @@ This is particularly useful when you have only one organization, as creating mul
712712
| ZO_HTTP_WORKER_MAX_BLOCKING | 1024 | No | number of per http thread blocking connection in queue |
713713
| ZO_GRPC_PORT | 5081 | No | openobserve server listen gRPC port |
714714
| ZO_GRPC_ADDR | | No | openobserve server listen gRPC ip address |
715-
| ZO_GRPC_ORG_HEADER_KEY | openobserve-org-id | No | header key for sending organization information for `traces` using OTLP over grpc |
715+
| ZO_GRPC_ORG_HEADER_KEY | organization | No | header key for sending organization information for `traces` using OTLP over grpc |
716716
| ZO_GRPC_STREAM_HEADER_KEY | stream-name | No | header key for sending stream-name information for `traces` using OTLP over grpc |
717717
| ZO_GRPC_MAX_MESSAGE_SIZE | 16 | No | Max grpc message size in MB, default is 16 MB. |
718718
| ZO_GRPC_CONNECT_TIMEOUT | 5 (seconds) | No | The timeout in seconds to connect to the grpc server. |
@@ -1112,4 +1112,4 @@ Below are the Environment variables only available in the enterprise edition.
11121112
| O2_DEX_NATIVE_LOGIN_ENABLED | true | No | Indicates if native dex login is enabled. |
11131113
11141114
1115-
-->
1115+
-->

0 commit comments

Comments
 (0)