在复杂的企业环境中，IT 团队通常依赖多种监控工具来管理不同的系统：Server、网络、application 等。OpManager 通过多种灵活且标准化的方法，支持从这些第三方工具中接入告警。将第三方事件集成到 OpManager 后，可以整合事件数据，并在不受来源限制的情况下，获得对整个 IT 环境的集中可视化。
本帮助文档说明了支持的接入方式，并提供详细步骤，帮助你轻松完成事件接入配置。
OpManager 提供了多种REST API 和 Webhook，允许第三方工具将告警直接推送到其监控系统中。通过 API 接入事件，组织可以将整个 IT 基础架构中的告警进行集中管理，从而实现统一的网络健康视图并加快事件响应。
addEvent API 允许第三方 application 通过其原生 REST API 或 webhook 功能，将事件数据直接发送到 OpManager。
Endpoint： api/json/events/addEvent
方法： POST
支持的格式： Form Data、查询参数
认证方式： API Key
你可以通过发送携带 form-encoded 数据的 POST 请求，将事件数据发送到 OpManager。此方法非常适合支持以 application/x-www-form-urlencoded 方式提交数据的工具。
POST https://<OpManager_Server>:8060/api/json/events/addEventHeaders： Content-Type: application/x-www-form-urlencodedForm 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=***
若要通过 JSON 负载接入来自 Cisco Meraki 设备的告警，请参考此文档。
用户可以创建自定义脚本，将第三方工具中的事件自动转发到 OpManager 作为告警。下面是一些示例脚本，展示如何将此类告警发送到 OpManager。
# 将表单数据定义为哈希表
$formData = @{
apiKey= "***"
source= "Windows_Server"
severity = "1"
message= "Disk space low"
alarmCode= "Disk_Space_Alert"
entity = "Server_XYZ"
eventType= "Performance_Alert"
}
# 发送 form-encoded 的 POST 请求
Invoke-RestMethod -Uri "https://<OpManager_Server>:8060/api/json/events/addEvent" `
-Method Post `
-Body $formData `
-ContentType "application/x-www-form-urlencoded" # OpManager Server 详情
OPMANAGER_HOST="https://<OpManager_Server>:8060"
API_ENDPOINT="/api/json/events/addEvent"
# API key
API_KEY="your_api_key_here"
# Form data 负载
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" 感谢您的反馈！