Documentation

influxdb3 CLI

InfluxDB 3 Enterprise is in Public Alpha

InfluxDB 3 Enterprise is in public alpha and available for testing and feedback, but is not meant for production use. Both the product and this documentation are works in progress. We welcome and encourage your input about your experience with the alpha. Get started in minutes and join our public channels for updates and to share feedback.

Alpha expectations and recommendations

The influxdb3 CLI runs and interacts with the InfluxDB 3 Enterprise server.

Usage

influxdb3 [GLOBAL-OPTIONS] [COMMAND]

Commands

Command Description
create Create resources
delete Delete resources
disable Disable resources
enable Enable resources
query Query InfluxDB 3 Enterprise
serve Run the InfluxDB 3 Enterprise server
show List resources
test Test plugins
write Write to InfluxDB 3 Enterprise

Global options

Option Description
--num-threads Maximum number of IO runtime threads to use
--io-runtime-type IO tokio runtime type (current-thread, multi-thread (default), or multi-thread-alt)
--io-runtime-disable-lifo-slot Disable LIFO slot of IO runtime
--io-runtime-event-interval Number of scheduler ticks after which the IOtokio runtime scheduler will poll for external events
--io-runtime-global-queue-interval Number of scheduler ticks after which the IO runtime scheduler will poll the global task queue
--io-runtime-max-blocking-threads Limit for additional threads spawned by the IO runtime
--io-runtime-max-io-events-per-tick Maximum number of events to be processed per tick by the tokio IO runtime
--io-runtime-thread-keep-alive Custom timeout for a thread in the blocking pool of the tokio IO runtime
--io-runtime-thread-priority Set thread priority tokio IO runtime workers
-h --help Print help information
-V --version Print version

Option environment variables

You can use the following environment variables to set influxdb3 global options:

Environment Variable Option
INFLUXDB3_NUM_THREADS --num-threads
INFLUXDB3_IO_RUNTIME_TYPE --io-runtime-type
INFLUXDB3_IO_RUNTIME_DISABLE_LIFO_SLOT --io-runtime-disable-lifo-slot
INFLUXDB3_IO_RUNTIME_EVENT_INTERVAL --io-runtime-event-interval
INFLUXDB3_IO_RUNTIME_GLOBAL_QUEUE_INTERVAL --io-runtime-global-queue-interval
INFLUXDB3_IO_RUNTIME_MAX_BLOCKING_THREADS --io-runtime-max-blocking-threads
INFLUXDB3_IO_RUNTIME_MAX_IO_EVENTS_PER_TICK --io-runtime-max-io-events-per-tick
INFLUXDB3_IO_RUNTIME_THREAD_KEEP_ALIVE --io-runtime-thread-keep-alive
INFLUXDB3_IO_RUNTIME_THREAD_PRIORITY --io-runtime-thread-priority

Examples

Run the InfluxDB 3 server

influxdb3 serve \
  --object-store file \
  --data-dir ~/.influxdb3 \
  --writer-id MY_HOST_NAME

Display short-form help for all commands

influxdb3 -h

Display long-form help for all commands

influxdb3 --help

Run the InfluxDB 3 Enterprise server with extra verbose logging

influxdb3 serve -v \
  --object-store file \
  --data-dir ~/.influxdb3 \
  --writer-id MY_HOST_NAME

Run InfluxDB 3 Enterprise with debug logging using LOG_FILTER

LOG_FILTER=debug influxdb3 serve \
  --object-store file \
  --data-dir ~/.influxdb3 \
  --writer-id MY_HOST_NAME

Was this page helpful?

Thank you for your feedback!


The future of Flux

Flux is going into maintenance mode. You can continue using it as you currently are without any changes to your code.

Read more

InfluxDB 3 Open Source Now in Public Alpha

InfluxDB 3 Open Source is now available for alpha testing, licensed under MIT or Apache 2 licensing.

We are releasing two products as part of the alpha.

InfluxDB 3 Core, is our new open source product. It is a recent-data engine for time series and event data. InfluxDB 3 Enterprise is a commercial version that builds on Core’s foundation, adding historical query capability, read replicas, high availability, scalability, and fine-grained security.

For more information on how to get started, check out: