Learn about the integrations supported by Wavefront, how to install an integration, and how to work with integration content.

Integrations make it easy for you to get data from external systems into the Wavefront application.

Integration Categories

Wavefront supports several categories of integrations. Each category sets up a different type of link between Wavefront and the external system.

  • Featured, Collector, and Code Instrumentation - set up sending metrics data into Wavefront. These include:
    • Ingesting metrics into Wavefront using the Telegraf collector agent and the Wavefront proxy
    • Ingesting metrics using a technology-specific collector and the Wavefront proxy
    • Ingesting log data
    • Ingesting custom metrics sent from applications to the Wavefront proxy
    • Pulling metrics from Amazon Web Services

    Wavefront architecture

  • Alert Notification - set up sending alerts from Wavefront to incident management systems and notification services.

    alert notification integrations

  • Authentication - set up authentication providers to enable SSO access to the Wavefront application.

    authentication integrations

Integration Support

Wavefront offers two levels of support for integrations: in-product and documentation.

In-product integrations provide assisted installation and configuration. Featured and Data Collector integrations have advanced support such as dashboard installation. In-product integrations typically point to documentation for configuration reference information.

Documentation integrations are available as documentation only and consist of installation and configuration instructions.

In-Product Integrations

To view in-product integrations, click Integrations in the Wavefront UI task bar.

CategoryDashboards?Integrations
Featured Yes Amazon Web Services, Kubernetes (k8s), Docker, Pivotal Cloud Foundry, Mac host, Linux host, Windows host, Ansible, Tour*, Tutorial*, System*
Data Collector Yes NGINX, Memcachd, PostgreSQL, MySQL, Redis, Elasticsearch, HAProxy, Puppet Server, Kafka, RabbitMQ
Custom Collector No Log data, Prometheus, Graphite, OpenTSDB, Telegraf, collectd
Code Instrumentation No StatsD, DropWizard, Go
Alert Notification No Slack, PagerDuty, HipChat, VictorOps
Authentication No Okta, OneLogin, Azure AD, Google, ADFS

Documentation

To view documentation integrations, click the links in the Integrations column.

CategoryIntegrations
Data Collector Amazon Web Services ECS, AppDynamics, JMX, NewRelic, Apache collectd, Cassandra collectd, MySQL collectd, NGINX collectd, Redis collectd, ZooKeeper collected
Date Export External Links, R

In-Product Integration Content

All in-product integrations have an overview of how the integration is implemented and instructions for installing and configuring software required for the integration implementation.

Featured and Data Collector integrations also have:

  • Metrics - searchable list and charts of metrics sent by the integration and the rate that the integration is sending metrics. Each integration has a set of “canary” metrics that Wavefront uses to determine that the integration is functioning correctly. The Metrics tab automatically displays charts of the canary metrics. You can click any metric to display a chart of the metric.
  • Content - pre-defined dashboards that highlight important metrics or illustrate techniques for querying metrics. Some dashboards contain pre-defined alert conditions embedded as queries in charts contained in the dashboards. You can install and uninstall the dashboards.

For example, here is the Docker with cAdvisor integration:

docker integration

In-Product Integration States

The Integrations page reports integration state depending on two factors:

  • Whether metrics ever reported and whether they reported in the last 2 hours or in the last 7 days.
  • The state of content installation: never installed, installed, uninstalled.

The supported states are:

  • Active - integrations whose metrics are reporting and installed or uninstalled content.
  • Available - integrations whose metrics never reported and never installed content or integrations that don’t have metrics.
  • Warning - integrations whose metrics never reported and installed content.
  • Error - integrations whose metrics reported within the last 7 days but have stop reporting for 2 hours and installed content.

You can use the filter bar on the left to filter integrations by state. You can also filter integrations with the following saved searches:

  • New Integrations - integrations that have metrics reporting for at most two hours and have installed content
  • Installed Integrations - integrations in the Active, Warning, or Error state. An integration can be in one of these states even if content has been uninstalled.

State Indicators

When you hover over an integration, Wavefront colors the integration border and displays indicators based on the current state:

MetricsNo Metrics
Content Active Warning or Error
No Content Active Available

For example the following integration is in the Error state because metrics have reported within the last 7 days but have stopped reporting in the past 2 hours and content is installed.

integration state

Adding Integrations

To add an in-product integration, click Integrations in the task bar.

  1. Click a tile in the Featured or Data Collector sections.
  2. Click the Setup tab.
  3. Follow the instructions for installing and configuring required software.
  4. Click the Metrics tab to verify that metrics are flowing.
  5. Optionally click the Content tab and click Install Dashboards.

Adding a Custom Collector or Code Instrumentation Integration

  1. Click a tile in the Custom Collector or Code Instrumentations sections.
  2. Click the Setup tab.
  3. Follow the instructions for installing and configuring required software.
  4. Select Browse > Metrics tab to verify that metrics are flowing.

Adding an Alert Notification Integration

  1. Click a tile in the Alert Notification section.
  2. Click the Setup tab.
  3. Follow the instructions for configuring the notification service.
  4. Create an alert.
  5. Configure the Targets field to use the notification service.
  6. Verify that the notification occurs when the alert changes state.

Adding an Authentication Integration

  1. Click a tile in the Authentication section.
  2. Click the Setup tab.
  3. Follow the instructions for installing and configuring required software.

Installing and Uninstalling Integration Dashboards

You can install and uninstall dashboards from Featured and Data Collector integrations.

  1. Click Integrations.
  2. Click the integration tile.
  3. Click the Content tab.
  4. Click [Install | Uninstall] Dashboards.