From 30bae09fd333e642f2f5ec800865210a58cd3246 Mon Sep 17 00:00:00 2001 From: Kelly Date: Wed, 15 Jul 2020 14:43:34 -0700 Subject: [PATCH] monitor windows --- .../templates/infrastructure/windows.md | 52 +++++++++++++++++++ 1 file changed, 52 insertions(+) create mode 100644 content/v2.0/monitor-alert/templates/infrastructure/windows.md diff --git a/content/v2.0/monitor-alert/templates/infrastructure/windows.md b/content/v2.0/monitor-alert/templates/infrastructure/windows.md new file mode 100644 index 000000000..39420b12e --- /dev/null +++ b/content/v2.0/monitor-alert/templates/infrastructure/windows.md @@ -0,0 +1,52 @@ +--- +title: Monitor Windows +description: > + Use the [Windows System Monitoring template](https://github.com/influxdata/community-templates/tree/master/windows_system) to monitor your Windows system. +menu: + v2_0: + parent: Monitor infrastructure + name: Windows +weight: 207 +--- + +Use the [Windows System Monitoring template](https://github.com/influxdata/community-templates/tree/master/windows_system) to monitor your Windows system. First, [apply the template](#apply-the-template), and then [view incoming data](#view-incoming-data). + +The Windows System Monitoring template includes the following: + +- one [dashboard](/v2.0/reference/glossary/#dashboard): **Windows System** +- one [bucket](/v2.0/reference/glossary/#bucket): `telegraf`, 7d retention +- label: `Windows System Template`, Telegraf plugin labels: `outputs.influxdb_v2` +- one [Telegraf configuration](/v2.0/write-data/no-code/use-telegraf/auto-config/view-telegraf-config/): InfluxDB v2 output plugin, Windows Performance Counters input plugin +- two variables: `bucket`, `windows_host` + +## Apply the template + +1. Use the [`influx` CLI](/v2.0/reference/cli/influx/) to run the following command: + + ```sh + influx apply -f https://raw.githubusercontent.com/influxdata/community-templates/master/windows_system/windows_system.yml + ``` + For more information, see [influx apply](/v2.0/reference/cli/influx/apply/). + + > **Note:** Ensure your `influx` CLI is configured with your account credentials and that configuration is active. For more information, see [influx config](https://v2.docs.influxdata.com/v2.0/reference/cli/influx/config/). + +2. [Install Telegraf](/telegraf/latest/introduction/installation/) on a server with network access to both the Windows system and [InfluxDB v2 API](/v2.0/reference/api/). +3. In your [Telegraf configuration file (`telegraf.conf`)](/v2.0/write-data/no-code/use-telegraf/auto-config/view-telegraf-config/), do the following: + - Set the following environment variables: + - INFLUX_TOKEN: Token must have permissions to read Telegraf configurations and write data to the `telegraf` bucket. See how to [view tokens](/v2.0/security/tokens/view-tokens/). + - INFLUX_ORG: Name of your organization. See how to [view your organization](/v2.0/organizations/view-orgs/). + - INFLUX_URL: Your InfluxDB host URL, for example, localhost, a remote instance, or InfluxDB Cloud. + +4. [Start Telegraf](/v2.0/write-data/no-code/use-telegraf/auto-config/#start-telegraf). +5. To monitor multiple Windows systems, repeat steps 1-4 for each system. + +## View incoming data + +1. In the InfluxDB user interface (UI), select **Boards** (**Dashboards**). + + {{< nav-icon "dashboards" >}} +2. Open the **Windows System** dashboard to start monitoring. + + {{% note %}} + If you're monitoring multiple Windows machines, switch between them using the `windows_host` filter at the top of the dashboard. + {{% /note %}}