Google Stackdriver Integration Guide

This integration requires use of our v1 REST API which is currently in a decommissioning period, please contact support to gain access to a v1 REST API key to configure this integration.

For more information about the v1 REST API deprecation take a look at our FAQ here: https://v2.developer.pagerduty.com/v2/docs/v1-rest-api-decommissioning-faq

We are working with partners to upgrade integrations to use our v2 REST API.

Google Stackdriver is a SaaS monitoring solution that uses data analytics to help engineers identify and resolve critical issues with their cloud-powered applications. Stackdriver makes it easy to monitor your cloud infrastructure (Google Cloud Platform, AWS, Rackspace), systems (Linux, Windows), and application services (Nginx, Apache, MySQL, MongoDB, etc.).  Stackdriver has implemented two-way integration with PagerDuty, so alerts from Stackdriver can automatically trigger and resolve PagerDuty incidents.

If you run into any issues in integrating Stackdriver with PagerDuty, contact our support team at support@pagerduty.com.

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.

    RS-Add-New-Service
    RS-Add-Integration-Existing-Service

  3. 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.

  4. 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

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

In Stackdriver

  1. From the Stackdriver homepage, click Account in the top right and then Account Settings from the dropdown.
    Account Settings

  2. Under Settings, click PagerDuty then click +Add next to PagerDuty Services.
    PagerDuty Services

  3. Fill in Service Name with the same name you used in step 3 of the PagerDuty setup section.

  4. Fill in API Key with the Integration Service API Key that you copied from the PagerDuty service page.
    Integration Service API Key

  5. Now when you create a policy, you’ll see an option for PagerDuty in the dropdown under “notify via” in the alert section.
    Notify Via

Advanced Integration (Two-Way Sync)

Within PagerDuty

  1. To enable two-way sync with the Stackdriver service, in your PagerDuty account, under the Configuration menu, select API Access.
    apiaccess-0

  2. On your API Access page, click the +Create New API Key button.apiaccess-1

  3. In the dialog that pops up, you’ll be prompted to enter a Description for your key, and choose an API version. You will also have the option to create the key as Read-only; leaving this box unchecked will create a full access key.api__1_ A note about versioning: API v2.0 is designed to make it easier for new integrations to communicate with PagerDuty. Most existing PagerDuty integrations will require an API v1.0 key. If you have questions on which API version to use, please contact support@pagerduty.com

  4. Once you have filled in your options, click Create Key.

  5. Once you click Create Key, you will see a dialog displaying your key and confirming the options you filled in on the previous step. Make sure to copy this key into any application that needs it now, as you will not have access to the key after this step. If you lose a key that you created previously and need access to it again, you should remove the key and create a new one. Click Close once you have successfully copied your key.api__2_

  6. To set up sync, head back to your Account Settings page and click PagerDuty under Settings. Next to PagerDuty Sync API, click Configure.
    Configure

  7. Fill in API key name with name you used in step 2 of the PagerDuty Sync setup.

  8. Fill in your company subdomain name used to navigate to PagerDuty.

  9. Fill in API key with the API Access Key you copied from the PagerDuty setup section.

  10. Click Submit to finish. Now Stackdriver incidents resolved or acknowledged in PagerDuty will automatically be resolved in both applications.
    Edit PagerDuty Sync
    In addition, incidents will automatically be resolved within PagerDuty once they are resolved within Stackdriver:
    PagerDuty Incident

    *For documentation concerning PagerDuty authentication, click the link below.

    http://developer.pagerduty.com/documentation/rest/authentication