Merge pull request #1206 from influxdata/monitor-vshpere

monitor vsphere
2020-08-18 09:37:03 -07:00 · 2020-08-18 09:37:03 -07:00 · ca00a58ee4
parent a690fbf38c 1b6d222007
commit ca00a58ee4
1 changed files with 55 additions and 0 deletions
--- a/content/v2.0/monitor-alert/templates/infrastructure/vshpere.md
+++ b/content/v2.0/monitor-alert/templates/infrastructure/vshpere.md
@ -0,0 +1,55 @@
+---
+title: Monitor vSphere
+description: >
+  Use the [vSphere Dashboard for InfluxDB v2 template](https://github.com/influxdata/community-templates/tree/master/vsphere) to monitor your vSphere host.
+menu:
+  v2_0:
+    parent: Monitor infrastructure
+    name: vSphere
+weight: 206
+---
+
+Use the [vSphere Dashboard for InfluxDB v2 template](https://github.com/influxdata/community-templates/tree/master/vsphere) to monitor your vSphere host. First, [apply the template](#apply-the-template), and then [view incoming data](#view-incoming-data).
+This template uses the [Docker input plugin](/v2.0/reference/telegraf-plugins/#docker) to collect metrics stored in InfluxDB and display these metrics in a dashboard.
+
+The Docker Monitoring template includes the following:
+
+- one [dashboard](/v2.0/reference/glossary/#dashboard): **vsphere**
+- one [bucket](/v2.0/reference/glossary/#bucket): `vsphere`
+- label: vsphere
+- one [Telegraf configuration](/v2.0/write-data/no-code/use-telegraf/auto-config/view-telegraf-config/): InfluxDB v2 output plugin, vSphere input plugin
+- one variable: `bucket`
+
+## 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/vsphere/vsphere.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 vSphere host 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_HOST: Your InfluxDB host URL, for example, localhost, a remote instance, or InfluxDB Cloud.
+      - INFLUX_BUCKET: Bucket to store data in. To use the bucket included, you must export the variable: `export INFLUX_BUCKET=vsphere`
+4.    - Set the host address to the vSphere and provide the `username` and `password` as variables:
+        ```sh
+        vcenters = [ "https://$VSPHERE_HOST/sdk" ]
+        username = "$vsphere-user"
+        password = "$vsphere-password"
+        ```
+
+4. [Start Telegraf](/v2.0/write-data/no-code/use-telegraf/auto-config/#start-telegraf).
+
+## View incoming data
+
+1. In the InfluxDB user interface (UI), select **Boards** (**Dashboards**).
+
+    {{< nav-icon "dashboards" >}}
+2. Open the **vsphere** dashboard to start monitoring.