Stackdriver Integration Guide

Stackdriver Integration

Stackdriver aggregates metrics, logs, and events from infrastructure, giving developers and operators a rich set of observable signals that speed root-cause analysis and reduce mean time to resolution (MTTR).

How Stackdriver users benefit from PagerTree

Stackdriver triggers alerts when monitoring policies are breached. 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.

Functionality of Integration

The Stackdriver integration is one-way, meaning:

  • When an alert is Open (incident.state == 'open') in Stackdriver, an incident is created in PagerTree automatically.
  • When an alert is Closed (incident.state == 'closed') in Stackdriver, the incident is resolved in PagerTree automatically.

Tutorial Overview

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

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 Stackdriver
    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 Stackdriver

  1. From the top navigation menu click [Workspace Name] -> Workspace Settings Menu Workspace Settings
  2. From the Settings Page
    1. Select Notifications -> Webhooks
    2. Click the Add Webhook button Navigate to Add Webhook
      1. Endpoint URL - Paste the PagerTree Endpoint URL you copied earlier
      2. Webhook Name - Name the webhook appropriately (e.g. “PagerTree Webhook”)
      3. Click Test Connection
      4. Click Save Create the Stackdriver Webhook
  3. From the left navigation menu click Alerting -> Create a Policy Navigate to Create Alerting Policy
    1. Conditions - Select conditions for when this alerting policy will be breached
    2. Notifications - Select the type Webhook and then select the PagerTree Webhook we created earlier.
    3. Name this policy - Give an appropriate name (e.g. PagerTree Alerting Policy)
    4. Click Save Policy Create the Stackdriver Alerting Policy

You have successfully completed the Stackdriver Integration. Now when Stackdriver 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