In complex enterprise environments, IT teams often rely on multiple monitoring tools to manage different systems: servers, networks, applications, and more. OpManager supports ingesting alerts from these third-party tools, through multiple flexible and standardized methods. Integrating third-party events into OpManager allows you to consolidate event data, gain centralized visibility across your IT environment, regardless of the source.
This help document explains the supported methods and provides detailed steps to help you easily set up event ingestion.
OpManager provides versatile REST APIs and Webhooks that allow third-party tools to push alerts directly into its monitoring system. By ingesting events via API, organizations can centralize alerts from across their IT infrastructure, enabling a unified view of network health and quicker incident response.
The addEvent API allows third-party applications to send event data directly to OpManager by using their native REST API or webhook capabilities.
Endpoint: api/json/events/addEvent
Method: POST
Supported Formats: Form Data, Query Parameters
Authentication: API Key
You can send event data to OpManager by making a POST request with form-encoded data. This method is ideal for tools that support submitting data as application/x-www-form-urlencoded.
POST https://<OpManager_Server>:8060/api/json/events/addEvent
Headers: Content-Type: application/x-www-form-urlencoded
Form data: source=Test_Device_MoName severity=1 message=Sample_Critical_Message alarmCode=Sample_AlarmCode entity=Sample_Entity eventType=Sample_EventType apiKey=***
POST https://<OpManager_Server>:8060/api/json/events/addEvent?source=Test_Device_MoName&severity=1&message=Sample_Critical_Message&alarmCode=Sample_AlarmCode&entity=Sample_Entity&eventType=Sample_EventType&apiKey=***
To ingest alerts from Cisco Meraki devices using JSON payloads, refer this document.
Users can create custom scripts to automatically forward events from third-party tools to OpManager as alerts. Below are example scripts on how to send such alerts to OpManager.
# Define form data as a hashtable
$formData = @{
apiKey= "***"
source= "Windows_Server"
severity = "1"
message= "Disk space low"
alarmCode= "Disk_Space_Alert"
entity = "Server_XYZ"
eventType= "Performance_Alert"
}
# Send form-encoded POST request
Invoke-RestMethod -Uri "https://<OpManager_Server>:8060/api/json/events/addEvent" `
-Method Post `
-Body $formData `
-ContentType "application/x-www-form-urlencoded"
# OpManager server details
OPMANAGER_HOST="https://<OpManager_Server>:8060"
API_ENDPOINT="/api/json/events/addEvent"
# API key
API_KEY="your_api_key_here"
# Form data payload
curl -k -X POST "${OPMANAGER_HOST}${API_ENDPOINT}" \
-H "Content-Type: application/x-www-form-urlencoded" \
--data "apiKey=${API_KEY}" \
--data "source=Windows_Server" \
--data "severity=1" \
--data "message=Disk space low" \
--data "alarmCode=Disk_Space_Alert" \
--data "entity=Server_XYZ" \
--data "eventType=Performance_Alert" Thank you for your feedback!