influx telegrafs update
- influx CLI 2.0.0+
- InfluxDB 2.0.0+
The influx telegrafs update command updates a Telegraf configuration to match the specified parameters. If a name or description are not provided, they are set to an empty string.
Usage
1. influx telegrafs update [flags]
Flags
| Flag | Description | Input type | Maps to ? | |
|---|---|---|---|---|
-c |
—active-config |
CLI configuration to use for command | string | |
—configs-path |
Path to influx CLI configurations (default ~/.influxdbv2/configs) |
string | INFLUX_CONFIGS_PATH |
|
-d |
—description |
Telegraf configuration description | string | |
-f |
—file |
Path to Telegraf configuration | string | |
-h |
—help |
Help for the update command |
||
—hide-headers |
Hide table headers | INFLUX_HIDE_HEADERS |
||
—json |
Output data as JSON | INFLUX_OUTPUT_JSON |
||
-n |
—name |
Telegraf configuration name | string | |
-o |
—org |
Organization name (mutually exclusive with —org-id) |
string | INFLUX_ORG |
—org-id |
Organization ID (mutually exclusive with —org) |
string | INFLUX_ORG_ID |
|
—skip-verify |
Skip TLS certificate verification | INFLUX_SKIP_VERIFY |
||
-t |
—token |
API token | string | INFLUX_TOKEN |
Examples
Authentication credentials
The examples below assume your InfluxDB host, organization, and token are provided by either the active influx CLI configuration or by environment variables (INFLUX_HOST, INFLUX_ORG, and INFLUX_TOKEN). If you do not have a CLI configuration set up or the environment variables set, include these required credentials for each command with the following flags:
--host: InfluxDB host-o, --orgor--org-id: InfluxDB organization name or ID-t, --token: InfluxDB API token
Update a Telegraf configuration
1. influx telegrafs update \
2. --id 0Xx0oox00XXoxxoo1 \
3. --name "Example configuration name" \
4. --description "Example Telegraf configuration description" \
5. --file /path/to/telegraf.conf
Update a Telegraf configuration via stdin
1. cat /path/to/telegraf.conf | influx telegrafs update \
2. --id 0Xx0oox00XXoxxoo1 \
3. --name "Example configuration name" \
4. --description "Example Telegraf configuration description" \
Related
- Telegraf configurations
- influx CLI—Provide required authentication credentials
- influx CLI—Flag patterns and conventions
