StackStorm Integration Guide

StackStorm provides a powerful open-source automation platform that wires together all of your apps, services and workflows. It’s extendable, flexible, and built with love for DevOps and ChatOps. The learning from Facebook, LinkedIn and others is: if you don’t automate, you die. This guide will go over integrating StackStorm with PagerDuty, allowing you to trigger, acknowledge and resolve incidents.

If you have any trouble setting up your integration, contact us.

In PagerDuty

  1. Create a PagerDuty REST API key (v2) for the integration to use. Save the API key in a secure manner.
  2. From the Configuration menu, select Services.
  3. Add the StackStorm service integration as follows:
    • Create a new service to be used with StackStorm, and for the Integration Type select StackStorm, or:
    • Add the StackStorm integration to an existing service by navigating to it, going to its Integrations tab and clicking New Integration.
  4. Save the integration key of the new integration in a secure manner.

In StackStorm

There are two ways of installing and configuring the integration: in the StackStorm administrative web UI, and from the command line of the StackStorm server.

At the end of each of them, a file should exist at the path /opt/stackstorm/configs/pagerduty.yaml containing the options in the following format:

api_key: XXXXXXXXXXXXXXXXXXXX
service_key: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
debug: false

Using the command line interface

  1. Run the command: st2 pack install pagerduty.
  2. Run st2 pack config pagerduty.
  3. Enter the data as prompted:
    • Enter REST API key when prompted for the API Key;
    • Enter the integration key when prompted for the Service Key.
    • For debugging info, enter y when prompted.

Using the administrative web UI

  1. Navigate to Packs, search for PagerDuty and click Install.
  2. Enter the information into the appropriate fields:
    • Put the REST API key into the api_key field;
    • Put the integration key into the service_key field.
  3. Click Save.

Test the Integration

Using the web interface:

  1. Go to the Actions menu.
  2. Under PagerDuty, select Launch Incident.
  3. Enter a description in the description field, and click Run

Or, using the command line interface:

st2 run pagerduty.launch_incident description='New StackStorm incident'

That should trigger a new incident on the StackStorm-integrated service.