# 告警规则

ThingsCloud 提供了内置的告警规则，支持将设备属性的变化作为告警触发条件，您可以为接入的设备创建灵活的告警规则，实现告警通知。

当然，您也可以通过云平台提供的 API，以及 MQTT 或 WebURL 实时消息订阅等方式，实现应用端的任意告警逻辑。

# 创建告警规则

您可以在 设备详情页 > 告警 > 告警规则 中，为当前设备创建告警规则。例如：

您也可以在 设备类型详情页 > 告警 中，为当前设备类型创建告警规则。

# 告警规则的设备源

告警规则支持两种设备源类型：

• 设备类型：规则的作用范围包括选中设备类型下的所有设备。
• 设备：规则的作用范围仅针对指定的一个或多个设备。

# 告警触发条件

触发条件是告警规则中的重要部分，这里支持设置多个属性运算条件。如下图：

同时，还支持设置重复次数和持续时间。

• 重复次数：设置重复次数后，告警条件首次触发时不会进入告警状态，也不会发送告警通知。当告警条件重复触发该次数后，进入告警状态并发送告警通知。
• 持续时间：设置持续时间后，系统会在告警条件被连续触发达到该持续时间后，进入告警状态。

例如下图：

# 告警级别

告警级别用来区分告警的重要级别，用在告警历史和告警通知的显示文字中。例如，在邮件通知方式中，告警级别会显示在邮件标题中。

# 选择通知组

将已创建的通知组加入告警规则中，用于发送告警通知。支持设置多个通知组。

关于通知组的详细介绍，请浏览 告警通知组。

# 通知用户

可开启是否为设备所属用户发送告警通知，支持多种用户通知方式，包括：

• 微信公众号通知
• 短信通知

# 通知文字

通知文字会显示在告警通知的内容中，不同的通知方式会体现在不同位置。例如：

• 邮件通知：显示在邮件正文中。
• 微信公众号通知：显示在模板消息字段中。

# 告警规则状态

每个告警规则可设置全局状态，用来启用或禁用该规则，对该告警规则的所有设备源都生效。

# 对设备启用/禁用告警规则

在全局状态的基础上，同时支持对每个关联的设备源独立设置启用或禁用状态。例如，当对某个设备进行维护时，可临时关闭该设备的告警规则，但不影响相同设备类型下的其它设备。

# 设备的告警状态

设备的告警状态分为以下几类：

• 正常（Ok）：表示最近一次设备属性更新未触发告警规则的条件。
• 告警（Alerting）：表示最近一次设备属性更新已触发告警规则的条件，且达到设置的重复次数和持续时间。如果未设置重复次数和持续时间，则首次触发会进入告警的状态。
• 待定（Pending）：表示最近一次设备属性更新已触发告警规则的条件，但未达到设置的重复次数和持续时间。
• 未知（Unknown）：表示告警规则创建后截至目前，设备属性未发生更新，设备无实际告警状态。

# 告警历史

您可以方便的浏览设备的所有告警历史，以及某个指定告警规则的告警历史。

# 看板告警历史组件

您可以在看板中加入所有设备或指定设备的告警历史数据，配合其它数据和控制组件，帮助用户全方位掌握设备的运行状况。

# 告警统计

在项目概要和设备概要中，可以快速浏览告警历史统计，帮助您直观的分析在过去的不同时段中，设备告警的出现频次。

# 告警控制台提示

当设备触发告警或恢复正常时，控制台右上角会有通知提示，点击提示栏可以快速到达设备页面。

提示支持告警音效。您可以在项目的通用设置中，开启或关闭通知及相关音效。