Learn about the Wavefront Windows Host Integration.

Windows Host Integration

Monitoring Windows hosts is easy with Wavefront. This integration installs and configures Telegraf to send host metrics into Wavefront. Telegraf is a light-weight server process capable of collecting, processing, aggregating, and sending metrics to a Wavefront proxy.

In addition to setting up the metrics flow, this integration also installs a dashboard. Here’s the CPU section of a dashboard displaying Windows host metrics.

images/db_windows_cpu.png

Windows Host Setup

This integration uses various Telegraf input plugins. You can install the Wavefront proxy and Telegraf agent on the same host or on separate hosts. For proxy installation prerequisites, see the Proxy Host Requirements.

Supported Version(s): Windows 8 and up

Install the Wavefront Proxy

  1. Download wavefront-proxy-setup.exe.

  2. In a cmd.exe shell, go to the directory you downloaded the installer to and run:

    .\wavefront-proxy-setup.exe /server=https://YOUR_CLUSTER.wavefront.com/api /token=<YOUR_API_TOKEN> /SILENT

  3. The proxy is started automatically. Check Program Files (x86)\Wavefront\wavefront.log to verify the installation.

  4. You can manage the proxy service using the Windows Services Management Console.

    Warning: If you want to edit the wavefront.conf file under Program Files (x86)\Wavefront, use an editor that supports Unix style line endings, such as Notepad++ or EditPlus. Do not use notepad to modify the file.

Install the Telegraf Agent

  1. Download wavefront-telegraf-64-setup.exe. Only 64-bit Windows is supported.

  2. Double click the wavefront-telegraf-64-setup.exe file and follow the instructions in the setup dialog to install Telegraf.

    Note: Steps 3-5 are only required if the Wavefront proxy is installed on a different host.

  3. Edit the telegraf.conf file located in Program Files\Telegraf.

    Warning: Do not use notepad to modify the file. Use an editor that supports Unix style line endings, such as Notepad++ or EditPlus.

  4. Configure the outputs section to communicate with your Wavefront proxy: 
    [[outputs.wavefront]]
   host = "WAVEFRONT_PROXY_HOSTNAME"
   port = 2878

    Note: In the default telegraf.conf, the host property is set to localhost.

  5. Restart the Telegraf service using the Windows Services Management Console or from the command prompt: 
    net stop telegraf
net start telegraf
  6. Check Program Files\Telegraf\telegraf.log to verify the installation.

Uninstall the Wavefront Proxy and Telegraf Agent

  1. Click Start, and then click Control Panel.
  2. Under Programs, click Uninstall a program.
  3. Select Telegraf and click Uninstall at the top.
  4. Select Wavefront Proxy and click Uninstall at the top.
integrations list