content/telegraf/v1/commands/config/migrate.md
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 %}}
We strongly recommend testing migrated configuration files before using them in production. {{% /warn %}}
telegraf [global-flags] config migrate [flags]
| Flag | Description | |
|---|---|---|
--force | Forces overwriting of an existing migration file | |
-h | --help | Show command help |
{{% caption %}} Also see Telegraf global flags. {{% /caption %}}
To migrate the file mysettings.conf, run the following command:
telegraf --config mysettings.conf config migrate
To migrate all configurations files in the ~/telegraf/conf/ directory, use
the following command:
telegraf --config-directory ~/telegraf/conf/ config migrate