Create an InfluxDB template

Use the InfluxDB user interface (UI) and the influx export command to create InfluxDB templates. Add resources (buckets, Telegraf configurations, tasks, and more) in the InfluxDB UI and export the resources as a template.

Export a template

Do one of the following to export a template:

• Export all resources in an organization
• Export specific resources in an organization
• Export a stack and its associated resources

Export all resources

To export all templatable resources within an organization to a template manifest, use the influx export all command. Provide the following:

• Organization name or ID
• API token with read access to the organization
• Destination path and filename for the template manifest. The filename extension determines the template format—both YAML (.yml) and JSON (.json) are supported.

Export all resources to a template

# Syntax
influx export all --org <INFLUX_ORG> --file <FILE_PATH> --token <INFLUX_TOKEN>

# Example
influx export all \
  --org $INFLUX_ORG \
  --file /path/to/templates/TEMPLATE_FILE.yml \
  --token $INFLUX_TOKEN

Export resources filtered by labelName or resourceKind

The influx export all command has an optional --filter flag that exports only resources that match specified label names or resource kinds. Provide multiple filters for both labelName and resourceKind

Export only dashboards and buckets with specific labels

The following example exports resources that match this predicate logic:

(resourceKind == "Bucket" or resourceKind == "Dashboard")
and
(labelName == "Example1" or labelName == "Example2")

influx export all \
  --org $INFLUX_ORG \
  --file /path/to/templates/TEMPLATE_FILE.yml \
  --token $INFLUX_TOKEN \
  --filter=resourceKind=Bucket \
  --filter=resourceKind=Dashboard \
  --filter=labelName=Example1 \
  --filter=labelName=Example2

For information about flags, see the influx export all documentation.

Export specific resources

To export specific resources within an organization to a template manifest, use the influx export with resource flags for each resource to include. The command uses the API token to filter resources for the organization.

Provide the following:

• API token with read access to the organization.
• Destination path and filename for the template manifest. The filename extension determines the template format—both YAML (.yml) and JSON (.json) are supported.
• Resource flags with corresponding lists of resource IDs to include in the template. For information about what resource flags are available, see the influx export documentation.

Export specific resources to a template

# Syntax
influx export --file <FILE_PATH> --token <INFLUX_TOKEN> [resource-flags]

# Example
influx export \
  --file /path/to/templates/TEMPLATE_FILE.yml \
  --token $INFLUX_TOKEN \
  --buckets=00x000ooo0xx0xx,o0xx0xx00x000oo \
  --dashboards=00000xX0x0X00x000 \
  --telegraf-configs=00000x0x000X0x0X0

Export a stack

To export a stack and all its associated resources as a template, use the influx export stack command. The command uses the API token to filter resources for the organization.

Provide the following:

• API token with read access to the organization
• Destination path and filename for the template manifest. The filename extension determines the template format—both YAML (.yml) and JSON (.json) are supported.
• Stack ID

Export a stack as a template

# Syntax
influx export stack \
  --token <INFLUX_TOKEN> \
  --file <FILE_PATH> \
  <STACK_ID>

# Example
influx export stack \
  -t $INFLUX_TOKEN \
  -f /path/to/templates/TEMPLATE_FILE.yml \
  05dbb791a4324000

Include user-definable resource names

Share your InfluxDB templates

Share your InfluxDB templates with the entire InfluxData community. Contribute your template to the InfluxDB Community Templates repository on GitHub.

View InfluxDB Community Templates