# ManageEngine Opmanager

[<mark style="color:blue;">ManageEngine OpManager</mark>](https://www.manageengine.com/products/applications_manager/me-opmanager-monitoring.html) 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**.

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-4fbd74e7ca0b30173c47a1d58ed6a0804a0465aa%2FAlert_Sources.png?alt=media\&token=aaca6610-9d18-4dd4-9cf5-320042f326f1)

2\. Select **ManageEngine OpManager.** Copy the displayed **Webhook URL** to [configure](#in-manageengine-opmanager-create-a-squadcast-webhook-setup-guide-for-manageengine-opmanager-running) it within **ManageEngine OpManager**. Finish by clicking **Add Alert Source** -> **Done.**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-0977fdb95aba75e14523b77fed6cb533e4d03848%2FManageEngine%20OpManager.png?alt=media\&token=42beb7c6-b109-4d5b-84d3-c48fe578e02e)

{% hint style="warning" %}
**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.
{% endhint %}

#### 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**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-ffa65d382972ef16a4c88e011197cea2099a50b8%2Fopmanager_2.png?alt=media\&token=db7f0b36-9509-4387-9206-7ab2d4b0926d)

**(4)** Select **Run Program**.

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-2ed97d8f5b2e8dbc1e6ffb1ce8b77afe7d7a0c1b%2Fopmanager_3.png?alt=media\&token=741b75be-79f9-41ff-a04c-6832961e3b11)

**(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**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-550dece932b5560bcc813868366d8b6f9e7bc04f%2Fopmanager_4.png?alt=media\&token=dc124771-8c4d-4d66-a327-ccf3e2b49dd1)

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

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-5ed3c3a05591563518dd7440406c3b098df98d07%2Fopmanager_5.png?alt=media\&token=b69faa4f-1e54-46e0-a63f-8e5c89f917a6)

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

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-a90b7929a8367bc66714c7137767fea654b39e5c%2Fopmanager_6.png?alt=media\&token=8e457b2d-39e1-4859-9762-94f3ac2e9b5a)

**(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

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-533ae5118d4bec2553bc05faf65b68347bc68def%2Fopmanager_7.png?alt=media\&token=02a04333-5f74-4d7c-b99b-5a914cff7258)

**(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](https://www.python.org/downloads/) in your system. Make note of the absolute path of where your python.exe file is stored

{% hint style="info" %}
**Note:**

This has been tested and documented for Python version 3.9
{% endhint %}

{% hint style="info" %}
**Pro Tip:**

To get the absolute path of *python.exe* file run the command `where python.exe` in your Command Prompt
{% endhint %}

**(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**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-ffa65d382972ef16a4c88e011197cea2099a50b8%2Fopmanager_2.png?alt=media\&token=db7f0b36-9509-4387-9206-7ab2d4b0926d)

**(4)** Select **Run Program**.

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-2ed97d8f5b2e8dbc1e6ffb1ce8b77afe7d7a0c1b%2Fopmanager_3.png?alt=media\&token=741b75be-79f9-41ff-a04c-6832961e3b11)

**(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**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-1087caba57f05cfabe005e701c221c6ffbd7f290%2Fopmanager_8.png?alt=media\&token=1fc754b0-e66a-4a02-bde9-1151fbe3ff20)

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

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-550dece932b5560bcc813868366d8b6f9e7bc04f%2Fopmanager_4.png?alt=media\&token=dc124771-8c4d-4d66-a327-ccf3e2b49dd1)

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

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-5ed3c3a05591563518dd7440406c3b098df98d07%2Fopmanager_5.png?alt=media\&token=b69faa4f-1e54-46e0-a63f-8e5c89f917a6)

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

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-a90b7929a8367bc66714c7137767fea654b39e5c%2Fopmanager_6.png?alt=media\&token=8e457b2d-39e1-4859-9762-94f3ac2e9b5a)

**(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

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-533ae5118d4bec2553bc05faf65b68347bc68def%2Fopmanager_7.png?alt=media\&token=02a04333-5f74-4d7c-b99b-5a914cff7258)

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.

*Have any questions?* [*Ask the community*](https://community.squadcast.com/view/home)*.*
