# ManageEngine Application Manager

[<mark style="color:blue;">ManageEngine Application Manager</mark>](https://www.manageengine.com/products/applications_manager/) is an application performance monitoring software that provides deep visibility into the performance and user experience of business-critical applications and infrastructure components.

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

### How to integrate ManageEngine Application Manager with Squadcast

#### In Squadcast: Using ManageEngine Application Manager 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 Application Manager.** Copy the displayed **Webhook URL** to [configure](#in-manageengine-application-manager-create-a-squadcast-webhook) it within **ManageEngine Application Manager**. 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-a6870e5d4a5d449752204932dae482a83fd474fa%2FManageEngine%20AppManager.png?alt=media)

{% 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 Application Manager: Create a Squadcast Webhook

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-b3fc600f1fd0550036cd4c79e9cc5d5af5774c5b%2Fmanageengine_appmanager_1.png?alt=media)

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

You can configure a webhook for either a Group or a Project.
{% endhint %}

**(1)** Navigate to **Admin > Alarm/Action > Actions**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-abd8d9c0c9248c2f470d7033f9a10c6dcc4d9b4e%2Fmanageengine_appmanager_2.png?alt=media)

**(2)** Select the **RestAPI Action** option from the **Actions** menu

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-53e6129824d7b3cba0b5fec4c6eaf6f1c276784c%2Fmanageengine_appmanager_3.png?alt=media)

**(3)** Enter the **Display Name** for the action. Paste the previously copied Squadcast **Webhook URL** and choose the **Form Submission Method** as `POST`

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-bee002c6315657b61747afa215b14796a339fb0b%2Fmanageengine_appmanager_4.png?alt=media)

**(4)** Choose the **PayLoad Type** to send data requests through as `JSON` and paste the below JSON in the placeholder for **Custom Parameters**

```json
{
    "MONITORNAME" : "$MONITORNAME",
    "MONITORGROUP" : "$MONITORGROUP",
    "ATTRIBUTE" : "$ATTRIBUTE",
    "ATTRIBUTEVALUE" : "$ATTRIBUTEVALUE",
    "SEVERITYASNUMBER" : "$SEVERITYASNUMBER",
    "SEVERITY" : "$SEVERITY",
    "HOSTIP" : "$HOSTIP",
    "MONITORTYPE" : "$MONITORTYPE",
    "OBJECTNAME" : "$OBJECTNAME",
    "HOSTNAME" : "$HOSTNAME",
    "PORT" : "$PORT",
    "DATE" : "$DATE",
    "OID" : "$OID",
    "RCAMESSAGE" : "$RCAMESSAGE",
    "THRESHOLDMESSAGE" : "$THRESHOLDMESSAGE",
    "URL" : "$URL",
    "TECHNICIAN" : "$TECHNICIAN",
    "ANNOTATION" : "$ANNOTATION",
    "STATUSFROM" : "$STATUSFROM",
    "Label" : "$Label",
    "Configuration" : "$Configuration",
    "Department" : "$Department",
    "Description" : "$Description",
    "Location" : "$Location",
    "User" : "$User",
    "ENTITY" : "$ENTITY",
    "GROUPHIERARCHY" : "$GROUPHIERARCHY",
    "RCAMSG_PLAINTEXT" : "$RCAMSG_PLAINTEXT"
}
```

**(5)** Click the **Create Action** button to finish creating the **Webhook** action

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-1f8061bc950c680428c5c03d863f0d78ce81edd0%2Fmanageengine_appmanager_5.png?alt=media)

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

Understanding how the integration works:

* Trigger a new incident: For the values `severity: critical`, `severity: down`, `severity: warning` in the alert payload, an incident is triggered in Squadcast.
* Resolve an existing incident: For the values `severity: clear` and `severity: up`, incidents are resolved in Squadcast (pertaining to auto-resolution of an existing, open incident)

Please ensure that the right `severity` is being sent within the payload for the alerts into Squadcast. If values other than the ones mentioned above are sent for `severity`, the integration will not work as expected.

In case of any queries, please feel free to reach out to our [Support team](mailto:support@squadcast.com).
{% endhint %}

That's it, you are good to go! Your ManageEngine Application Manager integration is now complete.

Now, whenever ManageEngine Application Manager fires an alert, an incident will be created in Squadcast for it. When the alert recovers in ManageEngine Application Manager, the corresponding incident will **automatically get resolved** in Squadcast as well.

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