SCOM Integration Guide

System Center Operations Manager (SCOM) is a central component of the Microsoft System Center suite. It is used to monitor the state, health, and performance of everything from servers to individual applications in Microsoft Windows environments.

Using System Center Orchestrator (SCORCH) runbooks, alerts generated in SCOM can trigger incidents in PagerDuty to alert the appropriate technician via SMS, phone, email or push notification. This integration was tested with the following software versions:

  • Windows Server 2016
  • Microsoft System Center Operations Manager 2016
  • Microsoft System Center Orchestrator 2016

If you are using SCOM 2012, refer to our SCOM email integration guide.

In PagerDuty

  1. Go to the Configuration menu and select Services.
  2. On the 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. Select your app from the Integration Type menu
  4. 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.
  6. Copy the Integration Key for your new integration.

In SCORCH

  1. Download PagerDuty.oip.
  2. Open Deployment Manager.
  3. Right-click Integration Packs.
    scom-integration-pack-menu
  4. Select Register IP with the Orchestrator Management Server.
  5. Click Next until you reach the Select Integration Packs or Hotfixes window.
    scom-add-integration-pack
  6. Click Add button and choose the PagerDuty.oip file.
  7. Click Next and then Finish.
  8. From Deployment Manager, right-click Integration Packs.
    scom-integration-pack-menu
  9. Select Deploy IP to Runbook Server or Runbook Designer.
  10. Click Next until you reach the Deploy Integration Packs or Hotfixes window.
  11. Select PagerDuty and click Next.
    scom-deploy-integration-pack
  12. Provide hostname of where to deploy the Integration Pack (e.g. localhost) and click Add.
    scom-add-computer
  13. Click Next, choose when to deploy if needed, and then click Finish.

Using Runbooks with the PagerDuty Integration

The PagerDuty integration can be used with existing runbooks or you can import our sample runbooks to start. For more information on designing and creating runbooks, see Microsoft’s Runbook Guide.

Importing Sample Runbooks

  1. Download the PagerDuty sample runbooks (ois_export files).
  2. Open System Center Orchestrator Runbook Designer.
  3. Right-click to select Runbooks → Import…
    scom-import-runbook
  4. Select the ois_export file you want to import.
  5. Deselect all Import the following global settings and Import global configurations and click Finish.
    scom-import-runbook-options
  6. Optionally double-click the activity in the runbook space to configure the activity to a computer other than localhost.

Configuring Send PagerDuty Event Activity

  1. Click Check-out to edit the runbook.
  2. Double-click the Send PagerDuty Event activity in the runbook space to edit.
  3. Enter your Integration Key that was generated during configuration on PagerDuty.
  4. Optionally edit the PagerDuty Incident Summary data attributes by right-clicking the text field and choosing Subscribe → Published Data.
    scom-pd-subscribe-menu
  5. Click Finish to save Send PagerDuty Event Properties.

Triggering a Test Event on PagerDuty

  1. To test your integration, click the Runbook Tester button.
    scom-runbook-tester
  2. In the Tester window click Run. Wait until all activities finish, then go to your PagerDuty service to see your triggered incident.
  3. From Runbook Designer, when you are ready to run your runbook, click Check-in to save your runbook and click Run to execute.
  4. Congratulations, you have successfully configured your integration!

FAQ

Can I configure the integration to work with multiple PagerDuty services?

Yes! To do this, create a separate integration for each PagerDuty service. When you configure the Send PagerDuty Event activity, use the integration key corresponding to the service on which you want to trigger the event.

What types of events can I send to PagerDuty?

This integration only sends trigger events to PagerDuty. Events cannot be acknowledged or resolved from SCOM.

How can I control which events get sent to PagerDuty?

You can control the flow of data from one activity to another using smart links. Providing conditional logic checks, smart links can work to include or exclude data that meet certain criteria. Smart links also allow for matching by regular expression.