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 Services menu and select Service Directory.
2. On the Service Directory page:
   • If you are creating a new service for your integration, click +New Service and follow the steps outlined, selecting this integration in step 4.
   • 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 Add a new integration.
3. Under Select the integration(s) you use to send alerts to this service search and select this integration.
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.
5. Find the integration in the list, click the v dropdown on the right and copy the Integration Key. Keep this key in a safe place for later use.

In SCORCH

1. Download PagerDuty.oip.
2. Open Deployment Manager.
3. Right-click Integration Packs.
   
4. Select Register IP with the Orchestrator Management Server.
5. Click Next until you reach the Select Integration Packs or Hotfixes window.
   
6. Click Add button and choose the PagerDuty.oip file.
7. Click Next and then Finish.
8. From Deployment Manager, right-click Integration Packs.
   
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.
    
12. Provide hostname of where to deploy the Integration Pack (e.g. localhost) and click Add.
    
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…
   
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.
   
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.
   
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.
   
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.