2.0 KiB
| title | description | menu | weight | ||||
|---|---|---|---|---|---|---|---|
| telegraf config migrate | The `telegraf config migrate` migrates deprecated plugins in a Telegraf configuration file to supported plugins. |
|
301 |
The telegraf config migrate command reads the configuration files specified
in the --config or --config-directory and attempts to migrate plugins or
options that are currently deprecated to the recommended replacements.
If no configuration file is explicitly specified, the command reads the
default locations
and uses those configuration files.
Migrated files are stored with a .migrated suffix at the
location of the source configuration files.
If migrating remote configurations, the migrated configuration is stored in the
current directory using the URL as the filename with a .migrated suffix.
{{% warn %}}
Test migrated configuration files
We strongly recommend testing migrated configuration files before using them in production. {{% /warn %}}
Usage
telegraf [global-flags] config migrate [flags]
Flags
| Flag | Description | |
|---|---|---|
--force |
Forces overwriting of an existing migration file | |
-h |
--help |
Show command help |
{{% caption %}} Also see Telegraf global flags. {{% /caption %}}
Examples
Migrate a single configuration file
To migrate the file mysettings.conf, run the following command:
telegraf --config mysettings.conf config migrate
Migrate a configuration directory
To migrate all configurations files in the ~/telegraf/conf/ directory, use
the following command:
telegraf --config-directory ~/telegraf/conf/ config migrate