• 文档
• 设置根据设备状态触发的告警

设置根据设备状态触发的告警

在某些情况下，EnOS 需要在设备处于某种状态时发出告警。

例如，在使用 EnOS 告警引擎监控某个智能楼宇的空调设备时，设置告警的触发规则为：当该空调设备离线时，触发“空调离线”告警。当设备再次上线时，该告警解除。

EnOS 目前仅支持离线状态的设备告警。

根据设备状态触发的告警与告警屏蔽、告警延时

• 你可以对根据设备状态触发的告警设置告警屏蔽：

  • 当该状态告警触发时，告警相关设备在资产树上的子节点的设备的告警都会被屏蔽；

  • 当你对状态告警相关设备的上级节点的设备设置了告警屏蔽且上级节点告警触发时，该设备的状态告警触发后会被屏蔽。

• 你可以对根据设备状态触发的告警设置告警延时。例如，你可以设置告警规则：基于某个模型的设备，离线 5 分钟仍未上线，方触发“设备离线”告警。

任务描述

本文以一个智能楼宇场景，介绍如何设置根据设备状态触发的告警。本教程使用了 教程：为同一模型的设备设置不同阈值的告警 中模拟的测量电冰箱实时电流的电流表来设置根据设备状态触发的告警。

前提条件

• 你需要有告警引擎相关操作权限，如果没有请联系组织管理员添加，参见 策略，角色，与权限。

• 你已经完成了 为同一模型的设备设置不同阈值的告警 这一教程。

步骤

1. 选择 告警规则，创建如下的新告警规则。创建告警规则的操作，参见 创建告警规则。

   
   

   

   
   

   此时告警被设定为当电流表设备离线时，告警立即触发。

2. 复制 为同一模型的设备设置不同阈值的告警 教程中的示例代码 fridgeMQTT 到你的IDE中

3. 运行 fridgeMQTT。此时在 设备管理 > 设备资产 中，可以观察到 冰箱电表 设备已上线。

4. 此时，停止运行 fridgeMQTT 代码块。

结果

进入 告警引擎 > 告警记录，你就能看到告警的 状态 为 已触发，如下图所示：

如果此时你再次运行 fridgeMQTT 代码块，该告警就会解除，状态 将改成 历史。

对 API 的影响

以下 API 的请求参数 (Body) 中，增加了一个可选参数 deviceStatus，可用值为 offline：

• Create Alert Rule

• Update Alert Rule

• Search Active Alerts

• Search History Alerts

• Search Alert Rule

用以实现以下目的：

• 创建或更新告警规则，使告警根据状态触发

• 返回基于设备状态触发的当前告警记录或历史告警记录