:::info
匹配版本:V3.20
页面状态:已完成
原文地址:点击跳转
:::
ThingsBoard提供了创建和管理与您的实体(设备,资产,客户等)相关的警报的功能。例如,您可以将ThingsBoard配置为在温度传感器读数高于特定阈值时自动创建警报。当然,这是一个非常简化的情况,实际情况可能要复杂得多。
主要概念
让我们回顾以下警报的主要概念:
报警源头
警报始发者是引起警报的实体。例如,如果ThingsBoard从设备A接收到温度读数并由于读数超过阈值而引发“高温”警报,则设备A就是警报的发起者。
类型
警报类型有助于区分警报的根本原因。例如,“高温”和“低湿度”是两个不同的警报。
严重程度
每个警报的严重性为CRITICAL(危急)、MAJOR(严重)、MINOR(轻微)、WARNING(警告)、INDETERMINATE(不确定),按优先级从高到低排序。
生命周期
警报可能处于活动状态或已清除。当ThingsBoard创建警报时,它将保留警报的开始时间和结束时间。缺省情况下,开始时间和结束时间相同。如果警报触发条件重复,平台将更新结束时间。当发生符合警报清除条件的事件时,ThingsBoard可以自动清除警报。警报清除条件是可选的。用户可以手动清除警报。
除了激活和清除警报状态外,ThingsBoard还跟踪是否有人确认了警报。可通过仪表板小部件或实体详细信息选项卡进行警报确认。
总而言之,“ status ”字段有4个可能的值:
- 未确认活动(ACTIVE_UNACK)-警报尚未清除且尚未确认;
- 活动已确认(ACTIVE_ACK)-警报未清除,但已被确认;
- 清除后未确认(CLEARED_UNACK)-警报已被清除,但尚未确认;
- 已清除确认(CLEARED_ACK)-警报已被清除并确认;
警报唯一
ThingsBoard使用始发者,类型和开始时间的组合来识别警报。因此,在单个时间点上,只有一个活动警报具有相同的始发者,类型和开始时间。
假设您已设置了警报规则,以在温度高于20时创建“高温”警报,并且还已配置了警报规则,以在温度低于或等于20时清除“ HighTemperature”警报。
假定以下事件序列:
- 12:00-温度等于18
- 12:30-温度等于22
- 13:00-温度等于25
- 13:30-温度等于18
因此,您应该创建一个“ HighTemperature”警报,开始时间= 12:30,结束时间= 13:00。
传播
假设您有一个拓扑,其中一个租户有1000个客户,每个客户有1000个设备。因此,您的服务器安装中有1M设备。您可能需要设计一个仪表板,以在“租户”和“客户”级别上显示所有活动的警报。为了简化数据库查询并缩短加载时间,ThingsBoard支持警报的传播。创建警报后,我们可以指定是否对父实体可见。我们还可以选择指定父实体与发起方之间应该存在的关系,以传播警报。
现在,一旦您了解了理论,就可以继续进行实用教程。
警报常见问题解答和方法
如何创建闹钟?
最简单的方法是使用“警报规则”。
另一种选择是在规则引擎中配置自定义逻辑,并使用“ 创建警报”和“清除警报”规则节点。您可以在此处找到相应的示例。
如何查找特定设备或资产的警报?
要查找特定设备或资产的警报,您应该:
- 打开资产或设备列表;
- 选择所需的实体;
- 导航到“警报”选项卡;
- 选择警报状态和时间间隔。
如何在仪表板上可视化警报?
请参阅此文档以将警报小部件添加到仪表板。
您还可以浏览窗口小部件的数据源设置和高级设置。
数据源设置允许您执行以下操作:
- 使用ack / unack / active / clear的任意组合指定状态过滤器;
- 使用严重性级别的任意组合指定严重性过滤器;
- 指定警报类型列表;
- 启用或禁用对传播警报的搜索(默认情况下禁用)。
创建或清除警报后如何发送通知?
要在警报创建或清除时发送通知,请检查此文档。
如何使用REST API查询告警?
ThingsBoard提供REST API来管理和查询警报。有关更多详细信息,请参见演示环境Alarm REST API和常规REST API文档。