第 11 章 告警管理
11.1 功能说明
告警管理汇总设备主动上报的报警事件，支持按级别、方法、类型、时间检索，查看报文摘要，并执行单条或批量删除、一键清空。
菜单路径：「告警管理」（路由 /gb28181/alarm-management）。 所需权限：查看 gb28181:alarm:view；删除 gb28181:alarm:delete；清空 gb28181:alarm:clear。
无 gb28181:alarm:view 时整页显示「无权查看告警，请联系管理员分配告警查看权限。」且不发起数据请求。
11.2 页面结构
| 区域 | 内容 |
|---|---|
| 查询筛选区 | 关键词、时间范围、告警级别、告警方法、告警类型、「查询」「重置」、「一键清理」 |
| 批量操作条 | 勾选后显示「已选 N 条」 |
| 数据表格 | 告警列表 |
| 详情抽屉 | 右侧滑出 |
界面如图 11-1 所示。
图 11-1 告警管理页
11.3 筛选条件
| 条件 | 选项 | 说明 |
|---|---|---|
| 关键词 | 设备／通道名称、国标编码、告警描述 | 模糊匹配 |
| 时间范围 | 任意区间，含时分 | 作用于「设备告警时间」，可清空 |
| 告警级别 | 「一级警情」「二级警情」「三级警情」「四级警情」 | 见 11.4 |
| 告警方法 | 「电话报警」「设备报警」「短信报警」「GPS 报警」「视频报警」「设备故障」「其他报警」 | 决定可选的告警类型 |
| 告警类型 | 随方法联动 | 未选方法时禁用，占位「请先选择报警方法」；切换方法会清空已选类型 |
11.3.1 告警类型取值
| 告警方法 | 可选类型 |
|---|---|
| 设备报警 | 视频丢失报警、设备防拆报警、存储设备磁盘满报警、设备高温报警、设备低温报警 |
| 视频报警 | 人工视频报警、运动目标检测报警、遗留物检测报警、物体移除检测报警、绊线检测报警、入侵检测报警、逆行检测报警、徘徊检测报警、流量统计报警、密度检测报警、视频异常检测报警、快速移动报警、图像遮挡报警（2022） |
| 设备故障 | 存储设备磁盘故障报警、存储设备风扇故障报警 |
| 电话报警、短信报警、GPS 报警、其他报警 | 无类型，显示「该报警方法无类型」 |
界面如图 11-2 所示。
图 11-2 告警筛选条件
11.4 告警级别
| 级别 | 颜色 | 建议处置时效 |
|---|---|---|
| 一级警情 | 红色 | 立即处置 |
| 二级警情 | 橙色 | 30 分钟内确认 |
| 三级警情 | 金色 | 当班内确认 |
| 四级警情 | 蓝色 | 记录备查 |
告警级别筛选包含一级至四级警情，完整页面与下拉选项如图 11-3 所示。
图 11-3 告警管理中的告警级别筛选
11.5 表格列
| 列 | 说明 |
|---|---|
| 「平台接收时间」 | 平台收到的时刻 |
| 「设备告警时间」 | 设备产生告警的时刻（可能与接收时间有差） |
| 「设备」 | 名称 + 编码 |
| 「来源」 | 通道名称；为空显示「未知来源」，下行显示来源编码 |
| 「级别」 | 彩色标签 |
| 「方法」 | 告警方法 |
| 「类型」 | 告警类型 |
| 「告警描述」 | 设备上报的文本描述 |
| 「操作」 | 「详情」「删除」 |
时间或文本为空时统一显示「未知」。
11.6 操作
| 按钮 | 位置 | 前置条件 | 行为 | 二次确认 | 提示 |
|---|---|---|---|---|---|
| 「查询」 | 筛选区 | — | 回第 1 页查询 | 无 | 失败「查询告警失败，请稍后重试」 |
| 「重置」 | 筛选区 | — | 清空条件后查询 | 无 | — |
| 「一键清理」 | 筛选区右侧（警示样式） | alarm:clear | 清空数据权限内全部告警 | 标题「一键清理告警」，正文「将清除您数据权限范围内的所有告警记录，删除后不可恢复。」 | 「已清空 N 条告警」；失败「清空告警失败，请刷新后重试」 |
| 「批量删除」 | 批量条 | alarm:delete | 物理删除选中 | 标题「批量删除告警」，正文「将物理删除选中的 N 条告警记录，删除后不可恢复。」 | 「已物理删除 N 条告警」 |
| 「取消选择」 | 批量条 | — | 清空勾选 | 无 | — |
| 「详情」 | 行操作 | — | 打开详情抽屉 | 无 | — |
| 「删除」 | 行操作 | alarm:delete | 删除单条，悬停提示「物理删除告警，不可恢复」 | 标题「物理删除告警」，正文「将物理删除 {设备} / {来源} 在 {时间} 的告警记录，删除后不可恢复。」 | 「已物理删除 N 条告警」 |
注意 - 「一键清理」作用于当前账号数据权限范围内的全部告警，不受当前筛选条件限制。清理前请确认无需留存追溯。 - 告警删除为物理删除，无回收站。 - 告警是由设备上报触发写入，删除后若设备重新上报同一事件会产生新记录，不会「记住已删除」。
11.7 告警详情
点击行内「详情」，右侧滑出抽屉（宽度自适应，最大 840px）。界面如图 11-4 所示。
图 11-4 告警详情完整抽屉与原始报文
| 区块 | 字段 |
|---|---|
| 顶部 | 「告警对象」：设备名称与编码、「来源」（通道名或「未知来源」+ 来源编码）；右上「物理删除」 |
| 「事件信息」 | 「平台接收时间」「设备告警时间」「告警级别」「告警方法」「告警类型」「类型原始值」「类型参数」「告警描述」 |
| 「补充信息」 | 「经度」「纬度」「摘要指纹」「创建时间」「更新时间」 |
| 「报文摘要」 | 等宽字体展示原始报文；无报文时「无报文摘要」 |
加载失败显示「加载告警详情失败，请重试」与「重试」按钮。
注意 - 「类型原始值」与「类型参数」是设备上报的原始编码与附加参数，用于与厂商核对。若界面显示的类型与实际不符，请以原始值为准并向厂商确认映射关系。 - 类型显示「未知(N)」表示该「告警方法」下没有定义这个类型编码。例如方法为「短信报警」时，国标并未为它分配类型子表，此时设备仍带 AlarmType 上报就会显示成「未知(2)」——这是设备侧字段组合不规范，不是平台解析错误。
11.8 常见问题
| 现象 | 原因 | 处理 |
|---|---|---|
| 设备产生报警但列表没有 | 未开启「报警订阅」，或平台未开启「是否存储报警消息」 | 在「订阅管理」开启报警订阅；联系管理员确认系统配置 |
| 告警类型下拉是灰的 | 未选择「告警方法」 | 先选方法 |
| 告警时间为「未知」 | 设备上报报文缺少时间字段 | 正常现象，以平台接收时间为准 |
| 同一事件出现多条 | 设备重复上报（部分厂商会重发） | 用「摘要指纹」判断是否重复，必要时联系厂商关闭重发 |