telegraf secrets set
The telegraf secrets set command creates or modify a secret in a specified secret store.
This command requires your configuration file that contains the secret store
definitions you want to access. If the --config or --config-directory flags
are not included in the command, Telegraf checks the
default configuration file location.
Use telegraf secrets list to get the
IDs of available secret stores and the available secret keys.
If you haven’t configured a secret store, use
telegraf plugins secretstores
to list available secret store plugins.
View secret store plugin configuration documentation in the
Telegraf GitHub repository.
Usage
telegraf [global-flags] secrets set [flags] <SECRET_STORE_ID> <SECRET_KEY> <SECRET_VALUE>
Arguments
| Argument | Description |
|---|---|
| SECRET_STORE_ID | ID of the secret store to set the secret in |
| SECRET_KEY | Key of the secret to set |
| SECRET_VALUE | Value of the secret to set |
Flags
| Flag | Description | |
|---|---|---|
-h | --help | Show command help |
Also see Telegraf global flags.
Examples
- Set a secret using the default configuration location
- Set a secret using a non-default configuration location
In the examples below, replace the following:
SECRET_STORE_ID: The ID of the secret store to store the secret in.SECRET_KEY: The key of the secret to set.SECRET_VALUE: The value of the secret to set.CUSTOM_CONFIG_PATH: The non-default filepath to your Telegraf configuration file containing your secret store definitions.
Set a secret using the default configuration location
The following example assumes the Telegraf configuration file that contains the secret store definition is at the default location.
telegraf secrets set SECRET_STORE_ID SECRET_KEY SECRET_VALUE
Set a secret using a non-default configuration location
telegraf \
--config CUSTOM_CONFIG_PATH \
secrets set \
SECRET_STORE_ID \
SECRET_KEY \
SECRET_VALUE
Was this page helpful?
Thank you for your feedback!
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for Telegraf and this documentation. To find support, use the following resources:
Customers with an annual or support contract can contact InfluxData Support.