Use Azure Blob Storage for object storage

Use Azure Blob Storage as the object store for your InfluxDB 3 Enterprise instance.

Object store requirements

InfluxDB 3 Enterprise depends on strict object store consistency semantics— strong read-after-write and list-after-write consistency, and conditional PUT (PUT-if-not-exists) support. Your Azure Blob Storage container must provide these semantics. See Object store requirements for the full list of semantics InfluxDB 3 Enterprise depends on and how to verify your object store meets them.

Create a storage container

InfluxDB 3 Enterprise stores data in a container within an existing Azure Storage account. If you don’t already have a storage account, create one first.

  1. Sign in to the Azure portal and go to your storage account.
  2. Under Data storage, click Containers, and then click + Container.
  3. Enter a container name–for example, influxdb3–and click Create.

Alternatively, use the Azure CLI to create a container:

az storage container create \
  --name influxdb3 \
  --account-name 
AZURE_STORAGE_ACCOUNT

Get your storage account access key

InfluxDB 3 Enterprise authenticates to Azure Blob Storage with your storage account name and one of its access keys.

  1. In the Azure portal, go to your storage account.
  2. Under Security + networking, click Access keys.
  3. Copy the storage account name and one of the Key values–you provide both to configure InfluxDB 3 Enterprise.

In production, prefer Azure Workload Identity over a static access key where your deployment environment supports it.

Configure InfluxDB to connect to Azure Blob Storage

To use your Azure container as the object store for your InfluxDB 3 Enterprise instance, provide the following options or environment variables with the influxdb3 serve command. The --bucket option specifies your Azure container name.

Command options Environment variables

  • --cluster-id: Your InfluxDB 3 Enterprise cluster ID (INFLUXDB_CLUSTER_ID)
  • --node-id: Your InfluxDB 3 Enterprise node ID (INFLUXDB_NODE_ID)
  • --object-store: azure
  • --bucket: influxdb3 (your container name)
  • --azure-storage-account: Your storage account name (AZURE_STORAGE_ACCOUNT)
  • --azure-storage-access-key: One of your storage account’s access keys (AZURE_STORAGE_ACCESS_KEY)
influxdb3 serve \
  --cluster-id 
INFLUXDB_CLUSTER_ID
 \
  
--node-id 
INFLUXDB_NODE_ID
 \
  --object-store azure \
  --bucket influxdb3 \
  --azure-storage-account 
AZURE_STORAGE_ACCOUNT
 \
  --azure-storage-access-key 
AZURE_STORAGE_ACCESS_KEY
  • INFLUXDB3_CLUSTER_ID: Your InfluxDB 3 Enterprise cluster ID (INFLUXDB_CLUSTER_ID)
  • INFLUXDB3_NODE_ID: Your InfluxDB 3 Enterprise node ID (INFLUXDB_NODE_ID)
  • INFLUXDB3_OBJECT_STORE: azure
  • INFLUXDB3_BUCKET: influxdb3 (your container name)
  • AZURE_STORAGE_ACCOUNT: Your storage account name
  • AZURE_STORAGE_ACCESS_KEY: One of your storage account’s access keys
export INFLUXDB3_CLUSTER_ID=
INFLUXDB_CLUSTER_ID


export INFLUXDB3_NODE_ID=
INFLUXDB_NODE_ID

export INFLUXDB3_OBJECT_STORE=azure
export INFLUXDB3_BUCKET=influxdb3
export 
AZURE_STORAGE_ACCOUNT
=
AZURE_STORAGE_ACCOUNT

export 
AZURE_STORAGE_ACCESS_KEY
=
AZURE_STORAGE_ACCESS_KEY


influxdb3 serve

Confirm the object store is working

When InfluxDB 3 Enterprise starts, it seeds your Azure container with the necessary directory structure and begins storing data there. Confirm the object store is functioning properly:

  1. View the influxdb3 serve log output to confirm that the server is running correctly.

  2. Inspect the contents of your container to confirm the necessary directory structure is created–for example, using the Azure CLI:

    az storage blob list \
  --container-name influxdb3 \
  --account-name 
    AZURE_STORAGE_ACCOUNT
     \
      --output table
object storage Azure

Was this page helpful?

Thank you for your feedback!