• 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

  • Open Integrations page, type SCOM to the search field and click Add on the SCOM.

Under the Free and Essentials plans, the tabs under the Team dashboard are limited to Main, Integrations, Members, and Activity Stream.

An alternative for this step is to add the integration from the Team Dashboard of the team which will own the integration. To add an integration directly to a team, navigate to the Team Dashboard and open Integrations tab. Click Add Integration and select the integration that you would like to add.

  • Click Save Integration.

  • Copy the URL provided in the instructions.

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

SCOM integration

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

SCOM alerts

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

SCOM alert fields

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" }

Sample alert

SCOM sample alert
Last modified on Jan 27, 2021
Cached at 9:10 PM on Apr 20, 2021 |

Additional Help

Ask the Community