外部事件检测¶
当前文档定位
本文档为检测规则配置流程中的第二步。配置完成后，请返回主文档继续第三步：关联故障。
外部事件检测功能用于接收来自第三方系统的异常记录。当这些记录通过检测规则中预设的 Webhook 地址传入系统后，系统会将其自动转化为标准的监控器事件，并可进一步关联告警策略与可视化仪表板，实现统一的监控管理。
适用于将第三方系统（如 Prometheus、Zabbix、Nagios 等）产生的异常事件或记录通过指定 URL 地址，以 POST 请求方式发送到观测云后生成事件数据，实现跨平台的统一告警管理。
应用场景¶
- 对接第三方监控系统，将分散的告警统一汇聚到观测云平台
- 接收自定义业务系统的异常事件，实现业务监控告警
- 整合多云、混合云环境下的监控数据，统一展示和分析
默认配置¶
基础配置¶
| 配置项 | 说明 |
|---|---|
| 监控器名称 | 自定义监控器名称，用于标识此外部事件检测器 |
| Webhook 地址 | 系统默认自动生成唯一 Webhook 地址，支持自定义追加参数以标记地址用途。 格式： http://<域名>/api/v1/push-events/<随机字符串>第三方系统需将异常事件通过 POST 请求发送到该地址 |
事件数据格式¶
外部事件数据由第三方系统主动向观测云中心上报，并提供必要的事件数据。只有检测并匹配到对应字段才能生成事件并产生异常记录。
必需字段（必须包含 event 对象下的五大字段才能与系统侧匹配成功）：
| 字段 | 类型 | 说明 |
|---|---|---|
status |
string | 事件状态，可选值：fatal（致命）、error（严重）、warning（警告）、info（信息）、ok（正常） |
title |
string | 事件标题，用于描述事件的核心内容 |
message |
string | 事件详情，用于描述事件的具体信息 |
dimension_tags |
object | 维度标签，用于标识事件来源，如 {"host": "server01", "service": "nginx"} |
check_value |
number | 检测值，用于触发条件判断的数值 |
可选字段：
| 字段 | 类型 | 说明 |
|---|---|---|
extraData |
object | 自定义扩展字段，可用于事件通知模板中的变量替换 |
请求示例：
{
"event": {
"status": "warning",
"title": "外部事件监控器测试1",
"message": "你好，这是外部事件监控器的message",
"dimension_tags": {"heros": "caiwenji"},
"check_value": 20
},
"extraData": {
"name": "xxxxxxxx"
}
}
更多详情，可参考 外部事件监控器事件接受。
后续配置¶
完成检测规则配置后，您还需要进行以下相关设置：