Skip to content

Commit a3f6557

Browse files
jstirnamanjstirnaman
committed
chore(influxdb3): Update serve options
- Closes #5915 - Move cli/influxdb3/_index.md from shared due to diverging options
1 parent 14be1f9 commit a3f6557

File tree

6 files changed

+295
-143
lines changed

6 files changed

+295
-143
lines changed

‎content/influxdb3/core/reference/cli/influxdb3/_index.md

Lines changed: 115 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,9 +8,120 @@ menu:
88
parent: CLIs
99
name: influxdb3
1010
weight: 200
11-
source: /shared/influxdb3-cli/_index.md
1211
---
1312

14-
<!--
15-
The content of this file is at content/shared/influxdb3-cli/_index.md
16-
-->
13+
The `influxdb3` CLI runs and interacts with the {{< product-name >}} server.
14+
15+
## Usage
16+
17+
<!--pytest.mark.skip-->
18+
19+
```bash
20+
influxdb3 [GLOBAL-OPTIONS] [COMMAND]
21+
```
22+
23+
## Commands
24+
25+
| Command | Description |
26+
| :--------------------------------------------------------------| :---------------------------------- |
27+
| [create](/influxdb3/core/reference/cli/influxdb3/create/) | Create resources |
28+
| [delete](/influxdb3/core/reference/cli/influxdb3/delete/) | Delete resources |
29+
| [disable](/influxdb3/core/reference/cli/influxdb3/disable/) | Disable resources |
30+
| [enable](/influxdb3/core/reference/cli/influxdb3/enable/) | Enable resources |
31+
| [query](/influxdb3/core/reference/cli/influxdb3/query/) | Query {{% product-name %}} |
32+
| [serve](/influxdb3/core/reference/cli/influxdb3/serve/) | Run the {{% product-name %}} server |
33+
| [show](/influxdb3/core/reference/cli/influxdb3/show/) | List resources |
34+
| [test](/influxdb3/core/reference/cli/influxdb3/test/) | Test plugins |
35+
| [write](/influxdb3/core/reference/cli/influxdb3/write/) | Write to {{% product-name %}} |
36+
37+
## Global options
38+
39+
| Option | | Description |
40+
| :----- | :------------------------------------ | :------------------------------------------------------------------------------------------------ |
41+
| | `--num-threads` | Maximum number of IO runtime threads to use |
42+
| | `--io-runtime-type` | IO tokio runtime type (`current-thread`, `multi-thread` _(default)_, or `multi-thread-alt`) |
43+
| | `--io-runtime-disable-lifo-slot` | Disable LIFO slot of IO runtime |
44+
| | `--io-runtime-event-interval` | Number of scheduler ticks after which the IOtokio runtime scheduler will poll for external events |
45+
| | `--io-runtime-global-queue-interval` | Number of scheduler ticks after which the IO runtime scheduler will poll the global task queue |
46+
| | `--io-runtime-max-blocking-threads` | Limit for additional threads spawned by the IO runtime |
47+
| | `--io-runtime-max-io-events-per-tick` | Maximum number of events to be processed per tick by the tokio IO runtime |
48+
| | `--io-runtime-thread-keep-alive` | Custom timeout for a thread in the blocking pool of the tokio IO runtime |
49+
| | `--io-runtime-thread-priority` | Set thread priority tokio IO runtime workers |
50+
| `-h` | `--help` | Print help information |
51+
| `-V` | `--version` | Print version |
52+
53+
### Option environment variables
54+
55+
You can use the following environment variables to set `influxdb3` global options:
56+
57+
| Environment Variable | Option |
58+
| :-------------------------------------------- | :------------------------------------ |
59+
| `INFLUXDB3_NUM_THREADS` | `--num-threads` |
60+
| `INFLUXDB3_IO_RUNTIME_TYPE` | `--io-runtime-type` |
61+
| `INFLUXDB3_IO_RUNTIME_DISABLE_LIFO_SLOT` | `--io-runtime-disable-lifo-slot` |
62+
| `INFLUXDB3_IO_RUNTIME_EVENT_INTERVAL` | `--io-runtime-event-interval` |
63+
| `INFLUXDB3_IO_RUNTIME_GLOBAL_QUEUE_INTERVAL` | `--io-runtime-global-queue-interval` |
64+
| `INFLUXDB3_IO_RUNTIME_MAX_BLOCKING_THREADS` | `--io-runtime-max-blocking-threads` |
65+
| `INFLUXDB3_IO_RUNTIME_MAX_IO_EVENTS_PER_TICK` | `--io-runtime-max-io-events-per-tick` |
66+
| `INFLUXDB3_IO_RUNTIME_THREAD_KEEP_ALIVE` | `--io-runtime-thread-keep-alive` |
67+
| `INFLUXDB3_IO_RUNTIME_THREAD_PRIORITY` | `--io-runtime-thread-priority` |
68+
69+
70+
## Examples
71+
72+
In the examples below, replace
73+
{{% code-placeholder-key %}}`my-host-01`{{% /code-placeholder-key %}}:
74+
with a unique identifier for your {{< product-name >}} server.
75+
76+
{{% code-placeholders "my-host-01" %}}
77+
78+
### Run the InfluxDB 3 server
79+
80+
<!--pytest.mark.skip-->
81+
82+
```bash
83+
influxdb3 serve \
84+
--object-store file \
85+
--data-dir ~/.influxdb3 \
86+
--node-id my-host-01
87+
```
88+
89+
### Display short-form help for all commands
90+
91+
<!--pytest.mark.skip-->
92+
93+
```bash
94+
influxdb3 -h
95+
```
96+
97+
### Display long-form help for all commands
98+
99+
<!--pytest.mark.skip-->
100+
101+
```bash
102+
influxdb3 --help
103+
```
104+
105+
### Run the {{< product-name >}} server with extra verbose logging
106+
107+
<!--pytest.mark.skip-->
108+
109+
```bash
110+
influxdb3 serve -v \
111+
--object-store file \
112+
--data-dir ~/.influxdb3 \
113+
--node-id my-host-01
114+
```
115+
116+
### Run {{< product-name >}} with debug logging using LOG_FILTER
117+
118+
<!--pytest.mark.skip-->
119+
120+
```bash
121+
LOG_FILTER=debug influxdb3 serve \
122+
--object-store file \
123+
--data-dir ~/.influxdb3 \
124+
--node-id my-host-01
125+
```
126+
127+
{{% /code-placeholders %}}

‎content/influxdb3/core/reference/cli/influxdb3/serve.md

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,7 @@ influxdb3 serve [OPTIONS] --node-id <HOST_IDENTIFIER_PREFIX>
2525

2626
| Option | | Description |
2727
| :--------------- | :--------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------ |
28+
| {{< req "\*" >}} | `--node-id` | _See [configuration options](/influxdb3/core/reference/config-options/#node-id)_ |
2829
| | `--object-store` | _See [configuration options](/influxdb3/core/reference/config-options/#object-store)_ |
2930
| | `--bucket` | _See [configuration options](/influxdb3/core/reference/config-options/#bucket)_ |
3031
| | `--data-dir` | _See [configuration options](/influxdb3/core/reference/config-options/#data-dir)_ |
@@ -80,9 +81,7 @@ influxdb3 serve [OPTIONS] --node-id <HOST_IDENTIFIER_PREFIX>
8081
| | `--wal-max-write-buffer-size` | _See [configuration options](/influxdb3/core/reference/config-options/#wal-max-write-buffer-size)_ |
8182
| | `--snapshotted-wal-files-to-keep` | _See [configuration options](/influxdb3/core/reference/config-options/#snapshotted-wal-files-to-keep)_ |
8283
| | `--query-log-size` | _See [configuration options](/influxdb3/core/reference/config-options/#query-log-size)_ |
83-
| | `--buffer-mem-limit-mb` | _See [configuration options](/influxdb3/core/reference/config-options/#buffer-mem-limit-mb)_ |
84-
| {{< req "\*" >}} | `--node-id` | _See [configuration options](/influxdb3/core/reference/config-options/#node-id)_ |
85-
| | `--parquet-mem-cache-size-mb` | _See [configuration options](/influxdb3/core/reference/config-options/#parquet-mem-cache-size-mb)_ |
84+
| | `--parquet-mem-cache-size` | _See [configuration options](/influxdb3/core/reference/config-options/#parquet-mem-cache-size)_ |
8685
| | `--parquet-mem-cache-prune-percentage` | _See [configuration options](/influxdb3/core/reference/config-options/#parquet-mem-cache-prune-percentage)_ |
8786
| | `--parquet-mem-cache-prune-interval` | _See [configuration options](/influxdb3/core/reference/config-options/#parquet-mem-cache-prune-interval)_ |
8887
| | `--disable-parquet-mem-cache` | _See [configuration options](/influxdb3/core/reference/config-options/#disable-parquet-mem-cache)_ |
@@ -111,10 +110,10 @@ For more information, see
111110
- [Run InfluxDB 3 with debug logging using LOG_FILTER](#run-influxdb-3-with-debug-logging-using-log_filter)
112111

113112
In the examples below, replace
114-
{{% code-placeholder-key %}}`MY_HOST_ID`{{% /code-placeholder-key %}}:
115-
with a unique identifier for your {{< product-name >}} server.
113+
{{% code-placeholder-key %}}`my-host-01`{{% /code-placeholder-key %}}:
114+
with a unique string that identifies your {{< product-name >}} server.
116115

117-
{{% code-placeholders "MY_HOST_ID" %}}
116+
{{% code-placeholders "my-host-01" %}}
118117

119118
### Run the InfluxDB 3 server
120119

@@ -124,7 +123,7 @@ with a unique identifier for your {{< product-name >}} server.
124123
influxdb3 serve \
125124
--object-store file \
126125
--data-dir ~/.influxdb3 \
127-
--node-id MY_HOST_ID
126+
--node-id my-host-01
128127
```
129128

130129
### Run the InfluxDB 3 server with extra verbose logging
@@ -136,7 +135,7 @@ influxdb3 serve \
136135
--verbose \
137136
--object-store file \
138137
--data-dir ~/.influxdb3 \
139-
--node-id MY_HOST_ID
138+
--node-id my-host-01
140139
```
141140

142141
### Run InfluxDB 3 with debug logging using LOG_FILTER
@@ -147,7 +146,7 @@ influxdb3 serve \
147146
LOG_FILTER=debug influxdb3 serve \
148147
--object-store file \
149148
--data-dir ~/.influxdb3 \
150-
--node-id MY_HOST_ID
149+
--node-id my-host-01
151150
```
152151

153152
{{% /code-placeholders %}}

‎content/influxdb3/enterprise/reference/cli/influxdb3/_index.md

Lines changed: 122 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,9 +8,127 @@ menu:
88
parent: CLIs
99
name: influxdb3
1010
weight: 200
11-
source: /shared/influxdb3-cli/_index.md
1211
---
1312

14-
<!--
15-
The content of this file is at content/shared/influxdb3-cli/_index.md
16-
-->
13+
The `influxdb3` CLI runs and interacts with the {{< product-name >}} server.
14+
15+
## Usage
16+
17+
<!--pytest.mark.skip-->
18+
19+
```bash
20+
influxdb3 [GLOBAL-OPTIONS] [COMMAND]
21+
```
22+
23+
## Commands
24+
25+
| Command | Description |
26+
| :--------------------------------------------------------------| :---------------------------------- |
27+
| [create](/influxdb3/enterprise/reference/cli/influxdb3/create/) | Create resources |
28+
| [delete](/influxdb3/enterprise/reference/cli/influxdb3/delete/) | Delete resources |
29+
| [disable](/influxdb3/enterprise/reference/cli/influxdb3/disable/) | Disable resources |
30+
| [enable](/influxdb3/enterprise/reference/cli/influxdb3/enable/) | Enable resources |
31+
| [query](/influxdb3/enterprise/reference/cli/influxdb3/query/) | Query {{% product-name %}} |
32+
| [serve](/influxdb3/enterprise/reference/cli/influxdb3/serve/) | Run the {{% product-name %}} server |
33+
| [show](/influxdb3/enterprise/reference/cli/influxdb3/show/) | List resources |
34+
| [test](/influxdb3/enterprise/reference/cli/influxdb3/test/) | Test plugins |
35+
| [write](/influxdb3/enterprise/reference/cli/influxdb3/write/) | Write to {{% product-name %}} |
36+
37+
## Global options
38+
39+
| Option | | Description |
40+
| :----- | :------------------------------------ | :------------------------------------------------------------------------------------------------ |
41+
| | `--num-threads` | Maximum number of IO runtime threads to use |
42+
| | `--io-runtime-type` | IO tokio runtime type (`current-thread`, `multi-thread` _(default)_, or `multi-thread-alt`) |
43+
| | `--io-runtime-disable-lifo-slot` | Disable LIFO slot of IO runtime |
44+
| | `--io-runtime-event-interval` | Number of scheduler ticks after which the IOtokio runtime scheduler will poll for external events |
45+
| | `--io-runtime-global-queue-interval` | Number of scheduler ticks after which the IO runtime scheduler will poll the global task queue |
46+
| | `--io-runtime-max-blocking-threads` | Limit for additional threads spawned by the IO runtime |
47+
| | `--io-runtime-max-io-events-per-tick` | Maximum number of events to be processed per tick by the tokio IO runtime |
48+
| | `--io-runtime-thread-keep-alive` | Custom timeout for a thread in the blocking pool of the tokio IO runtime |
49+
| | `--io-runtime-thread-priority` | Set thread priority tokio IO runtime workers |
50+
| `-h` | `--help` | Print help information |
51+
| `-V` | `--version` | Print version |
52+
53+
### Option environment variables
54+
55+
You can use the following environment variables to set `influxdb3` global options:
56+
57+
| Environment Variable | Option |
58+
| :-------------------------------------------- | :------------------------------------ |
59+
| `INFLUXDB3_NUM_THREADS` | `--num-threads` |
60+
| `INFLUXDB3_IO_RUNTIME_TYPE` | `--io-runtime-type` |
61+
| `INFLUXDB3_IO_RUNTIME_DISABLE_LIFO_SLOT` | `--io-runtime-disable-lifo-slot` |
62+
| `INFLUXDB3_IO_RUNTIME_EVENT_INTERVAL` | `--io-runtime-event-interval` |
63+
| `INFLUXDB3_IO_RUNTIME_GLOBAL_QUEUE_INTERVAL` | `--io-runtime-global-queue-interval` |
64+
| `INFLUXDB3_IO_RUNTIME_MAX_BLOCKING_THREADS` | `--io-runtime-max-blocking-threads` |
65+
| `INFLUXDB3_IO_RUNTIME_MAX_IO_EVENTS_PER_TICK` | `--io-runtime-max-io-events-per-tick` |
66+
| `INFLUXDB3_IO_RUNTIME_THREAD_KEEP_ALIVE` | `--io-runtime-thread-keep-alive` |
67+
| `INFLUXDB3_IO_RUNTIME_THREAD_PRIORITY` | `--io-runtime-thread-priority` |
68+
69+
70+
## Examples
71+
72+
In the examples below, replace the following:
73+
74+
- {{% code-placeholder-key %}}`my-host-01`{{% /code-placeholder-key %}}:
75+
a unique identifier for your {{< product-name >}} server.
76+
- {{% code-placeholder-key %}}`my-cluster-01`{{% /code-placeholder-key %}}:
77+
a unique identifier for your {{< product-name >}} cluster.
78+
The value you use must be different from `--node-id` values in the cluster.
79+
80+
{{% code-placeholders "my-host-01|my-cluster-01" %}}
81+
82+
### Run the InfluxDB 3 server
83+
84+
<!--pytest.mark.skip-->
85+
86+
```bash
87+
influxdb3 serve \
88+
--object-store file \
89+
--data-dir ~/.influxdb3 \
90+
--node-id my-host-01 \
91+
--cluster-id my-cluster-01
92+
```
93+
94+
### Display short-form help for all commands
95+
96+
<!--pytest.mark.skip-->
97+
98+
```bash
99+
influxdb3 -h
100+
```
101+
102+
### Display long-form help for all commands
103+
104+
<!--pytest.mark.skip-->
105+
106+
```bash
107+
influxdb3 --help
108+
```
109+
110+
### Run the {{< product-name >}} server with extra verbose logging
111+
112+
<!--pytest.mark.skip-->
113+
114+
```bash
115+
influxdb3 serve -v \
116+
--object-store file \
117+
--data-dir ~/.influxdb3 \
118+
--node-id my-host-01 \
119+
--cluster-id my-cluster-01
120+
```
121+
122+
### Run {{< product-name >}} with debug logging using LOG_FILTER
123+
124+
<!--pytest.mark.skip-->
125+
126+
```bash
127+
LOG_FILTER=debug influxdb3 serve \
128+
--object-store file \
129+
--data-dir ~/.influxdb3 \
130+
--node-id my-host-01 \
131+
--cluster-id my-cluster-01
132+
```
133+
134+
{{% /code-placeholders %}}

0 commit comments

Comments
 (0)