Influxdata
/
docs-v2
mirror of https://github.com/influxdata/docs-v2.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
docs-v2/content/telegraf/v1/commands/secrets/set.md

3.3 KiB
Raw Permalink Blame History

title description menu weight
telegraf secrets set The `telegraf secrets set` command creates or modify a secret in a specified secret store.
telegraf_v1_ref
parent
telegraf secrets
301

The telegraf secrets set command creates or modify a secret in a specified secret store.

{{% note %}} 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. {{% /note %}}

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

{{% caption %}} Also see Telegraf global flags. {{% /caption %}}

Examples

In the examples below, replace the following:

  • {{% code-placeholder-key %}}SECRET_STORE_ID{{% /code-placeholder-key %}}: The ID of the secret store to store the secret in.
  • {{% code-placeholder-key %}}SECRET_KEY{{% /code-placeholder-key %}}: The key of the secret to set.
  • {{% code-placeholder-key %}}SECRET_VALUE{{% /code-placeholder-key %}}: The value of the secret to set.
  • {{% code-placeholder-key %}}CUSTOM_CONFIG_PATH{{% /code-placeholder-key %}}: 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.

{{% code-placeholders "SECRET_(STORE_ID|KEY|VALUE)" %}}

telegraf secrets set SECRET_STORE_ID SECRET_KEY SECRET_VALUE

{{% /code-placeholders %}}

Set a secret using a non-default configuration location

{{% code-placeholders "CUSTOM_CONFIG_PATH|SECRET_(STORE_ID|KEY|VALUE)" %}}

telegraf \
  --config CUSTOM_CONFIG_PATH \
  secrets set \
  SECRET_STORE_ID \
  SECRET_KEY \
  SECRET_VALUE

{{% /code-placeholders %}}