# ManageEngine OpManager
## Prerequisites:
This section explains on how to integrate and ingest alerts from ManageEngine OpManager Monitoring tool into CloudFabrix AIOPs platform.
ManageEngine OpManager Monitoring tool supports alert notifications via Email, SMS, Running a Command, Chat, SNMP Traps, invoking a Webhook through HTTP(s) protocol and others. CloudFabrix AIOPs platform uses webhook notification method from ManageEngine OpManager Monitoring tool to receive and ingest the alerts or events.
Supported/Qualified Versions: 12.5.201 or above
Click here for [Alert Sources](/features-guide/alert-watch/alert-sources.md) to create a Webhook URL for ManageEngine OpManager Monitoring tool's alert notifications in CloudFabrix OIA application.
## **Configure** ManageEngine OpManager **for Alert notifications over a Webhook:**
**Step 1:** Login into ManageEngine OpManager UI portal with user account which has enough privileges to create and configure Alert/Alarm notifications.
**Step 2:** Click on **Settings** and click on **Notifications.**
**Step 3:** Click on **Add** button to create a new notification profile**.**
**Step 4:** Click on **Invoke a Webhook** box**.**
**Step 5:** Under Hook URL filed, select **POST** and enter the [Webhook URL](/features-guide/alert-watch/alert-sources.md#create-webhook-for-incoming-alerts-from-different-monitoring-tools) that was created for ManageEngine OpManager alert notifications under CloudFabrix OIA application. Select **raw** as data type and selet **JSON** as payload type. For body content, enter the payload as shown in the code block next to below screen. For request headers, add the below two and set the **Time Out** as 60 seconds. Click **Next**
**Content-Type** => **application/json**
**Authorization** => Basic \ (Optional, this is needed only when Webhook is enabled with HTTP basic authentication)
```
{
"Alert_Id": "$alarmid",
"Alert_Severity": "$stringseverity",
"Alert_AssetName": "$displayName",
"Alert_Message": "$message",
"Alert_AssetType": "$DeviceField(type)",
"Alert_AssetIPAddress": "$DeviceField(ipAddress)",
"Alert_Category": "$category",
"Alert_Time": "$strModTime",
"Alert_Type": "$eventType",
"Alert_AssetEntity": "$entity",
"Alert_LastPolledValue": "$lastPolledValue"
}
```
**Step 6:** Select the check boxes that are needed to be notified and make sure **Notify when the alarm is cleared** option. Select all of the **Severity** check boxes. Click **Next**
**Step 7:** Under **Available Devices,** add all of the monitored assets that need to be notified whenever there is an alert/alarm is raised or cleared as shown in the below screen and click **Next**.
**Step 8:** Select **Apply this profile 24x7** and other appropriate options and click **Next**.
**Step 9:** Enter a profile name under **Give profile name to add** filed and click on **Test Action** and make sure it is successful. Once successful, click on **Save** to save the Webhook notification configuration.
{% hint style="warning" %}
For a successful alert/alarm notification over a Webhook to CloudFabrix OIA application, make sure the cfxDimensions platform is configured with FQDN and CA Signed certificate. Self-signed SSL certificates will cause a failure.
{% endhint %}
{% hint style="info" %}
Additionally, make sure the created Webhook notification profile is associated with all of the monitored assets for their alerts/alarms to be notified to CloudFabrix OIA application. Below screen is for an example on how to associate a monitored asset to a Webhook notification profile.
{% endhint %}
### ManageEngine OpManager Alert Field Mappings:
| ManageEngine OpManager Alert Field | CFX OIA Field | Mandatory |
| --------------------------------------------------- | -------------------------- | --------- |
| Alert\_AssetName +
Alert\_AssetEntity
| Key | Yes |
| Alert\_Message | message | Yes |
| Alert\_AssetName | assetName | Yes |
| Alert\_AssetIpAddress | assetIpAddress | Yes |
| Alert\_Time | raisedAt / clearedAt | Yes |
| Alert\_AssetType | assetType | Yes |
| Alert\_Type | alertType | Yes |
| Alert\_AssetEntity | componentName | Yes |
| Alert\_Category | alertCategory | Yes |
| Alert\_LastPolledValue | lastPolledValue (Enriched) | No |
| Alert\_Id | Alert\_Id (Enriched) | No |
| Alert\_Severity | severity | Yes |
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://oiadocs.cloudfabrix.io/integrations-guide/integrations/manageengine-opmanager.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.