Manage environment variables in your InfluxDB Cluster

Use environment variables to define settings for individual components in your InfluxDB cluster and adjust your cluster’s running configuration. Define environment variables for each component in your AppInstance resource.

InfluxDB Clustered components support various environment variables. While many of these variables have default settings, you can customize them by setting your own values.

AppInstance component schema

In your AppInstance resource, configure individual component settings in the spec.package.spec.components property. This property supports the following InfluxDB Clustered component keys:

• ingester
• querier
• router
• compactor
• garbage-collector

apiVersion: kubecfg.dev/v1alpha1
kind: AppInstance
metadata:
  name: influxdb
  namespace: influxdb
spec:
  package:
    # ...
    spec:
      components:
        ingester:
          # Ingester settings ...
        querier:
          # Querier settings ...
        router:
          # Router settings. ...
        compactor:
          # Compactor settings ...
        garbage-collector:
          # Garbage collector settings ...

For more information about components in the InfluxDB v3 storage engine, see the InfluxDB v3 storage engine architecture.

Set environment variables for a component

1. Under the specific component property, use the <component>.template.containers.iox.env property to define environment variables.

2. In the env property, structure each environment variable as a key-value pair. For example, to configure environment variables for the Garbage collector:

   apiVersion: kubecfg.dev/v1alpha1
   kind: AppInstance
   metadata:
     name: influxdb
     namespace: influxdb
   spec:
     package:
       # ...
       spec:
         components:
           garbage-collector:
             template:
               containers:
                 iox:
                   env:
                     INFLUXDB_IOX_GC_OBJECTSTORE_CUTOFF: '6h'
                     INFLUXDB_IOX_GC_PARQUETFILE_CUTOFF: '6h'
   

3. Use kubectl apply to apply the configuration changes to your cluster and add or update environment variables in each component.

   kubectl apply \
     --filename myinfluxdb.yml \
     --namespace influxdb
   

apiVersion: kubecfg.dev/v1alpha1
kind: AppInstance
metadata:
  name: influxdb
  namespace: influxdb
spec:
  package:
    # ...
    spec:
      components:
       ingester:
         template:
           containers:
             iox:
               env:
                 INFLUXDB_IOX_WAL_ROTATION_PERIOD_SECONDS: '360'
       querier:
         template:
           containers:
             iox:
               env:
                 INFLUXDB_IOX_EXEC_MEM_POOL_BYTES: '10737418240' # 10GiB
       router:
         template:
           containers:
             iox:
               env:
                 INFLUXDB_IOX_MAX_HTTP_REQUESTS: '5000'
       compactor:
         template:
           containers:
             iox:
               env:
                 INFLUXDB_IOX_EXEC_MEM_POOL_PERCENT: '80'
       garbage-collector:
         template:
           containers:
             iox:
               env:
                 INFLUXDB_IOX_GC_OBJECTSTORE_CUTOFF: '6h'
                 INFLUXDB_IOX_GC_PARQUETFILE_CUTOFF: '6h'