• Products
  • Get started
  • Documentation
  • Resources

Integrate Opsgenie with Microsoft SCOM

SCOM logo

What does Opsgenie offer to SCOM users?

Integrate SCOM with Opsgenie to forward both Operations Manager alerts and updates to Opsgenie and benefit from Opsgenie’s actionable alerts, powerful on-call schedules, escalations and reporting services. Microsoft System Center Operations Manager forwards alert events to Opsgenie to create alerts and acknowledge, close, and add notes to them using PowerShell. Benefit from Opsgenie’s Alert De-Duplication using SCOM integration.

Functionality of the integration

  • When an alert is created on SCOM, an alert is created in Opsgenie automatically through the integration.

  • When an alert is resolved or closed on SCOM, the related alert is closed in Opsgenie.

  • When an alert is acknowledged on SCOM, the related alert is acknowledged in Opsgenie.

Setup instructions for Microsoft SCOM Integration:

Integration capability

This guide has been tested on the following versions of Windows:

Windows Server 2012 R2 (Windows Server 2012 should also work)
Windows Server 2016
Windows Server 2019

This guide has been tested on the following versions of SCOM:

System Center Operations Manager 2012 R2 (SCOM 2012 will also work)
System Center Operations Manager 2016
System Center Operations Manager 2019

The integration is untested on the 2018 releases of SCOM but the integration is expected to work without issues on:

System Center Operations Manager 1801
System Center Operations Manager 1807

Add SCOM Integration in Opsgenie

You can add this integration from your team dashboard

If you're using Opsgenie's Free or Essentials plan, or if you’re using Opsgenie with Jira Service Management's Standard plan, you can only add this integration from your team dashboard as the Integrations page under Settings is not available in your plan.

Adding the integration from your team dashboard will make your team the owner of the integration. This means Opsgenie will assign the alerts received through this integration to your team only.

To do that,

  1. Go to your team’s dashboard from Teams,

  2. Select Integrations, and select Add integration.

Follow the rest of the steps to complete the integration.

  1. Go to Settings > Integrations. Search for SCOM and select Add

  2. Select Save Integration.

  3. Copy the URL provided in the instructions.

  4. To modify default rules for the "SCOM Integration", click on Go to Advanced Settings.

  5. Create/edit conditions for filtering SCOM alerts on Filter segment.

  6. Modify fields for the alerts generated by SCOM using Alert Fields segments.

Configuration on Microsoft SCOM

  • On each SCOM application host in your cluster, create a new folder with name opsgenie under your root scripts directory. Resulting directory is C:\scripts\opsgenie

  • Download Opsgenie's SCOM PowerShell Script and place it to the directory created in the previous step. Make sure that the name of the script file is opsgenie.ps1 and the final path to the file is C:\scripts\opsgenie\opsgenie.ps1

Minimum required Powershell version for the script to be able to work is 3.0. If a version below 3.0 is being used, the Powershell Script code for converting the values into JSON and posting the HTTP request to Opsgenie should be developed by the user's side.

  • To install open an elevated command prompt and enter the below commands:

First unblock the file so it can be run: (This needs to be done on all SCOM application hosts in your cluster)

Shell

1 Powershell -command "Unblock-File C:\scripts\opsgenie\opsgenie.ps1"

Then install it: (This needs to be done on only one SCOM application host in your cluster not all)

Shell

1 Powershell -ExecutionPolicy bypass -file C:\scripts\opsgenie\opsgenie.ps1 -Url [integration url] -install

Sample payload sent from SCOM to Opsgenie

JSON

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 { "owner": "np", "lastModified": "12/24/2015 11:47:16 AM", "resolutionState": "New", "timeRaised": "12/24/2015 11:47:16 AM", "resolutionStateLastModified": "np", "workflowId": "{7eba60fd-b179-69a7-3897-47b6753601f2}", "category": "Custom", "alertId": "{2ba87d56-a7af-4b42-bdcc-eb18486bd8cd}", "alertName": "Alert for event 999", "priority": "1", "severity": "2", "createdByMonitor": "false", "repeatCount": "0", "alertDescription": "np", "managedEntitySource": "WIN-RQTU8UB5TU5.opsgeniescom.com" }

Additional Help