add doc for config Telegraf w Windows #493

pull/495/head
Kelly 2019-09-25 17:21:33 -07:00
parent f62acb66fc
commit 013a4f92e7
2 changed files with 78 additions and 5 deletions

View File

@ -50,22 +50,63 @@ for using Telegraf with InfluxDB v2.0._
11. Once Telegraf is running, click **Listen for Data** to confirm Telegraf is successfully
sending data to InfluxDB.
Once confirmed, a **Connection Found!** message appears.
12. Click **Finish**. Your configuration name and the associated bucket name appears
in the list of Telegraf connections.
12. Click **Finish**. Your Telegraf configuration name and the associated bucket name appears
in the list of Telegraf configurations.
### Monitor a Windows machine
If you're using Telegraf to monitor a Windows machine, you must complete the following steps.
1. In the list of Telegraf configurations, double-click your Telegraf configuration, and then click **Download Config**.
2. Open the downloaded Telegraf configuration file and replace `[[inputs.processes]]` with
`[[inputs.win_perf_counters]]` or `[inputs.win_services]]`, depending on your Windows configuration.
3. Save the file and place it in a directory where **Telegraf.exe** can access.
## Start Telegraf
### Configure your API token as an environment variable
Requests to the [InfluxDB v2 API](/v2.0/reference/api/) must include an authentication token.
A token identifies specific permissions to the InfluxDB instance.
Define the `INFLUX_TOKEN` environment variable using your token.
_For information about viewing tokens, see [View tokens](/v2.0/security/tokens/view-tokens/)._
### Configure your token as an environment variable
1. Find your authentication token. _For information about viewing tokens, see [View tokens](/v2.0/security/tokens/view-tokens/)._
2. To configure your token as the `INFLUX_TOKEN` environment variable, run the command appropriate for your operating system and command-line tool:
{{< tabs-wrapper >}}
{{% tabs %}}
[macOS or Linux](#)
[Windows PowerShell](#)
[Windows CMD](#)
{{% /tabs %}}
{{% tab-content %}}
```sh
export INFLUX_TOKEN=YourAuthenticationToken
```
{{% /tab-content %}}
{{% tab-content %}}
```sh
$env:INFLUX_TOKEN = “YourAuthenticationToken"
```
{{% /tab-content %}}
{{% tab-content %}}
```sh
set INFLUX_TOKEN=YourAuthenticationToken
# Make sure to include a space character at the end of this command.
```
{{% /tab-content %}}
{{< /tabs-wrapper >}}
### Start the Telegraf service
Start the Telegraf service using the `-config` flag to specify the URL of your generated configuration file.
Telegraf starts using the Telegraf configuration pulled from InfluxDB API.

View File

@ -29,6 +29,7 @@ Input plugins collect metrics. Output plugins define destinations where metrics
_See [Telegraf plugins](/v2.0/reference/telegraf-plugins/) for a complete list of available plugins._
## Enable and configure the InfluxDB v2 output plugin
To send data to an InfluxDB v2.0 instance, enable in the
[`influxdb_v2` output plugin](https://github.com/influxdata/telegraf/blob/master/plugins/outputs/influxdb_v2/README.md)
in the `telegraf.conf`.
@ -58,10 +59,41 @@ InfluxData does not recommend storing authentication tokens in plain text in the
A secure alternative is to set the `INFLUX_TOKEN` environment variable and include
it into your configuration file.
{{< tabs-wrapper >}}
{{% tabs %}}
[macOS or Linux](#)
[Windows PowerShell](#)
[Windows CMD](#)
{{% /tabs %}}
{{% tab-content %}}
```sh
export INFLUX_TOKEN=YourAuthenticationToken
```
{{% /tab-content %}}
{{% tab-content %}}
```sh
$env:INFLUX_TOKEN = “YourAuthenticationToken"
```
{{% /tab-content %}}
{{% tab-content %}}
```sh
set INFLUX_TOKEN=YourAuthenticationToken
# Make sure to include a space character at the end of this command.
```
{{% /tab-content %}}
{{< /tabs-wrapper >}}
_See the [example `telegraf.conf` below](#example-influxdb-v2-configuration)._
{{% /note %}}