Grafana Integration Guide

Grafana Integration

Grafana is the open platform for beautiful analytics and monitoring.

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

1. Click the team you wish to add the integration to.
2. On the team page, click the “Integrations” tab.
3. On the “Integrations” tab, click the “+ Integration” button.
4. In the “Create Integration” box, fill out the following:
   1. Name of the Integration,
   2. Select the Integration Type to Grafana
   3. Select an appropriate urgency for when this integration is triggered
   4. Select the team member the incident will be created by (example: manager or team lead)
   5. Select the team this incident will be assigned to
5. Click “Create”
6. Copy the WebHook URL

In Grafana

Create the Notification Channel

1. Click Menu -> Alerting -> Notification Channels
2. Click the ”+ New Channel” button
3. On the New Channel Form
   1. Name - An appropriate Name (example: PagerTree Webhook)
   2. Type - webhook
   3. Send on all alerts - checked
   4. Include image - checked
   5. URL - Paste the PagerTree WebHook URL you copied
   6. Http Method - POST
4. Click the Save button

Create an Alert

1. Click Menu -> Dashboards -> Home
2. Click -> Home then select the dashboard that has a metric you would like to alert on
3. Click the component you would like to add the alert to
   1. Click “Edit”
   2. Click the Alert Tab
   3. Click the “Create Alert” button
   4. Configure the appropriate parameters under Alert Config
   5. Click the Notifications Tab
      1. Ensure Send to has the PagerTree Webhook channel selected
4. 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