Seyren Integration Guide

Seyren is an alerting dashboard for Graphite. It has about a dozen methods to alert you of issues, one of them being PagerDuty.

The guide below describes how to integrate PagerDuty with Seyren so you can receive alerts from your Graphite installation. If you are having trouble completing the installation, please contact us.

In PagerDuty

  1. From the Configuration menu, select Services. 

  2. On your Services page:

    If you are creating a new service for your integration, click +Add New Service.

    If you are adding your integration to an existing service, click the name of the service you want to add the integration to. Then click the Integrations tab and click the +New Integration button.

  3. RS-Add-New-Service
    RS-Add-Integration-Existing-Service

  4. Select your app from the Integration Type menu and enter an Integration Name.

    If you are creating a new service for your integration, in General Settings, enter a Name for your new service. Then, in Incident Settings, specify the Escalation Policy, Notification Urgency, and Incident Behavior for your new service.

  5. Click the Add Service or Add Integration button to save your new integration. You will be redirected to the Integrations page for your service.
    RS-Integration-Settings

  6. Copy the Integration Key for your new integration: RS_API_pd_3

In your Seyren web interface

  1. If you don’t already have a check added to Seyren, you’ll need to click on Checks and then Create Check.
    seyren-pd-1

  2. The minimum information to add a check is the Name, Target (which is the graph from Graphite), Warn level and Error level. Click on Create check to add the check.
    seyren-pd-2

  3. Next you’ll want to go to the check that you’d like PagerDuty notifications for and click on Add Subscription.
    seyren-pd-3

  4. Fill in the Target with the Integration Key from above. Select PagerDuty as the Type and click Add to finish the process.
    seyren-pd-4

  5. You’ll be returned to the check page where you’ll see a new subscription method for PagerDuty. You can use the Test button to trigger a test incident or raise/lower your thresholds for warning or critical to produce an alert.
    seyren-pd-5

  6. Once you’ve triggered alerts, you can see the alert log at the bottom of the check page. You’ll see both triggers and resolves.
    seyren-pd-6

FAQ

How do I setup Seyren to work with multiple PagerDuty services?

Simply edit or add a subscription to the check and set the Target to the Integration Key of another PagerDuty service.

What if a Seyren alert happens while my network is down?

If a PagerDuty server can’t be reached for any reason, events will be stored to an on-disk queue.

Since Seyren needs my external Internet connection to send failure reports to PagerDuty, how will I receive notification if our site loses external connectivity?

You should configure an external ping check service such as StatusCake or NodePing to monitor your site’s external connectivity. Of course, you can use PagerDuty to forward alerts from these services.

How can I customize my Seyren alerts?

Unfortunately it is not possible to change the alert messages. They are coded into Seyren.

What about a 2-way ack integration between Seyren and PagerDuty?

There is not a way to mark incidents as acknowledged or resolved within Seyren. Incidents are closed on PagerDuty if Seyren detects that the alert is no longer below the warning or critical threshold and if the notify on “OK” check box is marked for the subscription.