Microsoft SCOM Integration

Microsoft System Center Operations Manager (SCOM) is a state, health, and performance monitoring infrastructure for Microsoft Windows environments. SCOM ensures the predictable performance and availability of applications and offers monitoring for data centers and the cloud, both public and private.

​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 compatibility.

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.

πŸ“˜

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.

🚧

For Free and Essentials plans, you can only add the integrations from the Team Dashboards, please use the alternative instructions given above to add this integration.

  • Click Save Integration.
  • Copy the URL provided in the instructions.
  • To modify default rules for the "SCOM Integration", click on Go to Advanced Settings.

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

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)

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)

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

Sample payload sent from SCOM to Opsgenie

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

Updated 11 months ago


Microsoft SCOM Integration


Microsoft System Center Operations Manager (SCOM) is a state, health, and performance monitoring infrastructure for Microsoft Windows environments. SCOM ensures the predictable performance and availability of applications and offers monitoring for data centers and the cloud, both public and private.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.