ManageEngine Opmanager

Steps to configure ManageEngine OpManager integration for incident management, using Squadcast

ManageEngine OpManager is an end-to-end network management software for heterogeneous, multi-vendor enterprise IT networks.

Route detailed alerts from ManageEngine OpManager to the right users in Squadcast.

How to integrate OpManager with Squadcast

In Squadcast: Using ManageEngine OpManager as an Alert Source

1. Navigate to Services -> Service Overview -> select or search for your Service. Expand the accordion -> In the Alert Sources section, click Add.

2. Select ManageEngine OpManager. Copy the displayed Webhook URL to configure it within ManageEngine OpManager. Finish by clicking Add Alert Source -> Done.

Important:

When an alert source turns Active, it’ll show up under Configured Alert Sources, you can either generate a test alert from the integration or wait for a real-time alert to be generated by the Alert Source. An Alert Source is active if there is a recorded incident via that Alert Source for the Service.

In ManageEngine OpManager: Create a Squadcast webhook (Setup guide for ManageEngine OpManager running on a Linux machine)

(1) In /opmanager/bin folder, run the following command

sudo wget https://raw.githubusercontent.com/squadcastHub/squadcast-opmanager-script/master/sq-opmanager-script.py

(2) Once the file is downloaded, kindly ensure that the file has executable permissions for your OpManager user. If not, you will have to provide the same using the following command

sudo chmod +x sq-opmanager-script.py

(3) To add a Notification Profile, go to Settings tab > Notifications > Add Profile

(4) Select Run Program.

(5) (a) In Command Name, paste the following

./sq-opmanager-script.py

(5) (b) In Program Arguments paste the following

"<COPIED_WEBHOOK_URL_FROM_SQUADCAST>" "$alarmid" "$message" "$displayName" "$category" "$stringseverity" "IP Address:$DeviceField(ipAddress)" "$strModTime" "$eventType"  "Entity: $entity"

(5) (c) Click on Next

(6) Choose the appropriate criteria for which alerts should be generated and click on Next

(7) Select the devices for which this particular Notification Profile should be applied and click on Next

(8) Define additional custom settings for this profile as per your preferences and click on Next

(9) Give the profile a name, click on Test Action to generate a test alert. Verify that a test incident was created in Squadcast for the same

(10) Once you have verified this, click on Save to save this profile

In ManageEngine OpManager: Create a Squadcast webhook (Setup guide for ManageEngine OpManager running on a Windows machine)

(1) Download the latest version of Python3 in your system. Make note of the absolute path of where your python.exe file is stored

Note:

This has been tested and documented for Python version 3.9

Pro Tip:

To get the absolute path of python.exe file run the command where python.exe in your Command Prompt

(2) Open the URL given below in a browser and copy the contents of this file into a file locally on your system and name the file sq-opmanager-script.py Make note of the absolute path of where sq-opmanager-script.py is stored

https://raw.githubusercontent.com/squadcastHub/squadcast-opmanager-script/master/sq-opmanager-script.py

(3) To add a Notification Profile, go to Settings tab > Notifications > Add Profile

(4) Select Run Program.

(5) (a) In Command Name, paste the absolute path to python.exe

(5) (b) In Program Arguments, paste the absolute path to sq-opmanager-script.py, followed by the copied webhook URL from Squadcast, followed by the parameters

<ABSOLUTE_PATH_TO_SCRIPT> <COPIED_WEBHOOK_URL_FROM_SQUADCAST>  "$alarmid"  "$message"  "$displayName"  "$category"  "$stringseverity"  "$DeviceField(ipAddress)"  "$strModTime"  "$eventType"  "$entity"

(5) (c) Click on Next

(6) Choose the appropriate criteria for which alerts should be generated and click on Next

(7) Select the devices for which this particular Notification Profile should be applied and click on Next

(8) Define additional custom settings for this profile as per your preferences and click on Next

(9) Give the profile a name, click on Test Action to generate a test alert. Verify that a test incident was created in Squadcast for the same

(10) Once you have verified this, click on Save to save this profile

That is it, you are now good to go!

Whenever OpManager sends an alert, an incident will be created in Squadcast for it. When the alert recovers in OpManager, the corresponding incident will automatically get resolved in Squadcast as well.