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. Select Team
  2. On the team page, click the “Integrations” tab. Click Integrations Tab
  3. On the “Integrations” tab, click the “+ Integration” button. Click Plus 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 Click Create
  5. Click “Create”
  6. Copy the WebHook URL Copy Webhook URL

In Grafana

Create the Notification Channel
  1. Click Menu -> Alerting -> Notification Channels Click Menu -> Alerting -> Notification Channels
  2. Click the ”+ New Channel” button 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 Enter Details in New Channel Form
Create an Alert
  1. Click Menu -> Dashboards -> Home Click Menu -> Dashboards -> Home
  2. Click -> Home then select the dashboard that has a metric you would like to alert on Select Dashboard
  3. Click the component you would like to add the alert to Click Component
    1. Click “Edit”
    2. Click the Alert Tab
    3. Click the “Create Alert” button Click 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 Configure the Alert Notification
  4. Click the Save Icon at the top of the page to save the dashboard Click the Save Icon

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