Prometheus Integration Guide

Prometheus Integration

Prometheus is an open-source systems monitoring and alerting toolkit.

How Prometheus users benefit from PagerTree

Prometheus Alertmanager creates alerts. 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 Prometheus integration is one-way, meaning:

  • When an alert is firing (status == "firing") in Prometheus, an incident is created in PagerTree automatically.
  • When a incident is resolved (status == "resolved") in Prometheus, the incident is resolved in PagerTree automatically.
Note. PagerTree will only make 1 incident per groupKey (see docs), until the incident is resolved by Prometheus.

Tutorial Overview

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

Warning. The group_wait and group_interval will affect the delay of alerts sent into PagerTree. See this documentation for details.

In PagerTree

  1. From the navigation menu, click the “+ Integration” button. Click Plus Integration Button
  2. In the “Create Integration” box, fill out the following:
    1. Name of the Integration,
    2. Select the Integration Type to Prometheus
    3. Select an appropriate urgency for when this integration is triggered
    4. Select the team this incident will be assigned to Click Create
  3. Click “Create”
  4. Copy the Endpoint URL Copy Endpoint URL

In Prometheus

  1. In your Prometheus Alertmanager receiver configuration, Copy & Paste the following, replacing <Copied PagerTree Endpoint URL> with your Endpoint URL

       # A default receiver
       receiver: pagertree_issues
     - name: 'pagertree_issues'
       - url: '<Copied PagerTree Endpoint URL>'
  2. Start the Alertmanager, or restart it for your configuration changes to take effect if was already running.

You have successfully completed the Prometheus Integration. Now when a prometheus alert is triggered, PagerTree will create an incident and route it to the correct team member that is on-call. If you have any questions please contact

Additional Resources

Below are sample configuration files for a simple Prometheus setup