---
title: "Wavefront Integration"
slug: "wavefront-integration"
updated: 2023-01-06T15:48:57Z
published: 2023-01-06T15:48:57Z
canonical: "docs.catchpoint.com/wavefront-integration"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.catchpoint.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Wavefront Integration

## Introduction

Wavefront is an analytics tool that supports observability (metrics, histograms, etc.) It enables you to collect data from multiple sources and helps to plot them together. This allows you to give a better view of a system state with data from code level, infrastructure, and from monitoring tools.

## Prerequisites

• Wavefront account.

## Installation & Configuration

This integration uses Test Data Webhook to send Catchpoint test metrics to the Wavefront service.

**Integration Overview**

- Configure Catchpoint **Test Data Webhook** to send default raw JSON data to an endpoint.
- Catchpoint data is parsed and converted into a format that Wavefront supports. Once the data is converted into a desired format, it will be pushed to the Wavefront portal.
- To distinguish different users from each other, we need to set two header values while configuring Test Data Webhook. First, **Wavefront-Cluster** - this is specific to a user account (like a sub domain). Second, **Wavefront-Secret** - API key for an account.

## Implementation

Create Test Data Webhook

1. Log in into Catchpoint.
2. Navigate to **Settings > API > Test Data Webhook > Add URL**.
3. Specify the **URL** as `https://cps.wavefront.com/report` and the format as JSON.
4. Optionally, you can specify a list of email addresses to notify in case an agent fails to   post data. 
5. Below is the list of headers that need to be sent as a part of Request.
    - `Content-Type : application/json`
    - `Wavefront-Cluster : https://YOUR_CLUSTER.wavefront.com`
    - `Wavefront-Secret : YOUR_API_TOKEN`
6. Optional Headers.
    - `Metrics-Prefix: (Default - "catchpoint")`
    - `Metrics-Blacklist: A comma-separated list of regex to blacklist the metrics`
    - `Metrics-Whitelist: A comma-separated list of regex to whitelist the metrics`
    - `Disable-Default-Blacklist: (true/false)`
By default, the integration blocks some metrics (`hostcollections`, `action`, `contentzones`, `diagnostic`). To whitelist these metrics, set this parameter to `true`. Default is `false`.

### Enable Test Data Webhook
By default, Catchpoint will not push any data to the subscriber unless the test has been enabled for the Test Data Webhook. This allows you to only receive data for tests that matter and ignore any tests that might not have importance.

In order to assign test results to the subscriber you should add the Test Data Webhook to the desired Tests.

To accomplish this, follow the below steps:

1. Navigate to **Control Center > Tests**. 
2. Select and **Edit** the desired Test, Folder, or Product.
3. Enable **Test Data Webhook** under **More Settings** and choose the previously-created Test Data Webhook from the dropdown.
4. To assign Test Data Webhook to Tests, go to any test in the Product and check the checkbox for Enable test Data Webhook.

**Note:** More information can be found<a href="https://docs.wavefront.com/catchpoint.html#enable-test-data-webhook" target="_self">Here</a>

## Results

![wavefront.png](https://cdn.document360.io/cb4af8f9-6751-4fd2-b39c-07aae832badb/Images/Documentation/360059603672-wavefront.png)