Wavefront Inntegration CLI

Learn how to use the Wavefront CLI to install Wavefront proxies and collector agents and configure integrations.

The Wavefront Command Line Interface (CLI) is a utility for installing and configuring the Wavefront proxy, Telegraf
collector agent, and integrations. The CLI uses native package managers to install packages (i.e. yum, apt-get) and therefore should be run as sudo.

Requirements

The Wavefront CLI is currently supported on Linux environments only and has been tested on the following Linux versions:

Amazon Linux AMI 2016.09.0

CentOS 6.7, 7.2

Debian Jesse, Wheezy

RedHat 6.6, 7.3

Ubuntu 14.04, 16.04

The lowest version of Python the CLI has been tested with is 2.6.6. If you do not see your family of operating system
listed above or receive an error, contact support@wavefront.com.

Note: If you’re using Docker or a Docker optimized operating system such as CentOS Atomic, we highly recommend
looking at Wavefront’s options for Monitoring Docker Containers.

Installing Wavefront CLI

The Wavefront CLI is available on PyPI as a pip package. To install the CLI, run:

$ sudo pip install wavefront-cli

Installing and Running Wavefront CLI

You can install and run the Wavefront CLI directly via curl. This is useful when you want to install the Wavefront CLI, Wavefront proxy, and/or agent in a single command. Arguments added to the following command are passed to the Wavefront CLI.

Wavefront CLI Usage

To invoke the Wavefront CLI, run

$ sudo wave <command>

where <command> is install, integration, or configure. To see a full list of all options, run wave -h.

The Install Command

The most common use for the Wavefront CLI is installing the Wavefront proxy and/or Telegraf. The install command
accepts multiple options each of which accepts arguments. If a required argument is not passed to an option, the CLI
prompts you for missing input. If all required arguments are passed, the CLI does not prompt for input.

The install command accepts one or more options:

--proxy - Install and configure the Wavefront proxy on the current host.

--agent - Install and configure Telegraf on the current host.

--aws - Add AWS EC2 metadata to the Telegraf
configuration as tags. Metrics from an EC2 instance are tagged with the EC2 tags, AWS region, the VPC ID, and Image ID of the EC2 instance.

--statsd - Enable the Telegraf StatsD service plugin. You must also install Telegraf with the --agent option.

Install: Example Usage

Each option has one or more arguments. If you do not provide a required argument, the CLI prompts for input.

Install a Wavefront proxy and Telegraf (the CLI prompts for required options):

Contributing Integrations

The <name> argument of the integration command creates an instance of a wavefront_cli.integrations.Base subclass
matching the <name> argument. When installing an integration, any arguments passed in the [<option>...] part of the
command are passed to the subclass as a dictionary. This makes it possible to drop in new integrations. At a minimum,
an integration subclass must implement the following methods: