Grafana Integration Guide

Grafana Integration

How Grafana users benefit from PagerTree

Grafana triggers user defined alerts by monitoring time series metrics. PagerTree acts as the dispatcher for these alerts, determining the right people to notify based on on-call schedules. PagerTree notifies them via email, sms, voice, and/or push notifications until the incident is acknowledged or closed.

Functionality of Integration

The Grafana integration is one-way, meaning:

When an alert is triggered ('alerting' state) in Grafana, an incident is created in PagerTree automatically.

When the alert is resolved ('ok' state) in Grafana, the incident is resolved in PagerTree automatically.

Tutorial Overview

In this integration tutorial we will show you how to send alerts from Grafana into PagerTree. The estimated time for this integration is 10 minutes. We assume that you already have a PagerTree account and Grafana setup.

In PagerTree

Click the team you wish to add the integration to.

On the team page, click the “Integrations” tab.

On the “Integrations” tab, click the “+ Integration” button.

In the “Create Integration” box, fill out the following:

Name of the Integration,

Select the Integration Type to Grafana

Select an appropriate urgency for when this integration is triggered

Select the team member the incident will be created by (example: manager or team lead)

Select the team this incident will be assigned to

Click “Create”

Copy the WebHook URL

In Grafana

Create the Notification Channel

Click Menu -> Alerting -> Notification Channels

Click the ”+ New Channel” button

On the New Channel Form

Name - An appropriate Name (example: PagerTree Webhook)

Type - webhook

Send on all alerts - checked

Include image - checked

URL - Paste the PagerTree WebHook URL you copied

Http Method - POST

Click the Save button

Create an Alert

Click Menu -> Dashboards -> Home

Click -> Home then select the dashboard that has a metric you would like to alert on

Click the component you would like to add the alert to

Click “Edit”

Click the Alert Tab

Click the “Create Alert” button

Configure the appropriate parameters under Alert Config

Click the Notifications Tab

Ensure Send to has the PagerTree Webhook channel selected

Click the Save Icon at the top of the page to save the dashboard

You have successfully completed the Grafana Integration. Now when Grafana creates an alert, PagerTree will create an incident and route it to the correct team member that is on-call. If you have any questions please contact support@pagertree.com