# 告警规则

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

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

# 创建告警规则

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

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

以上两种方式的区别是设备源的不同，设备源决定了告警规则的作用范围，也就是对哪些设备有效。

# 告警规则的设备源

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

• 设备类型：告警规则的作用范围包括设备类型下的所有设备。例如：设备源选择燃气浓度传感器设备类型，那么该类型下的所有燃气浓度传感器设备，都可使用该告警规则，而无需为每个设备重复创建告警规则。
• 设备：告警规则的作用范围仅针对指定的一个或多个设备。

# 告警触发条件

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

# 重复次数和持续时间

在满足触发条件的同时，还支持设置重复次数和持续时间。

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

举个例子：告警规则设置如下：

• 触发条件是温度大于 29℃
• 重复次数是 3 次
• 持续时间是 10 分钟

时序图如下：

# 有效时段

当我们希望告警规则只在部分时段有效时，可以开启有效时段选项，如下图：

全天每 30 分钟作为一个时段单位，您可以点选或快速拖选，例如选择 08:00 - 19:00，如下图：

或者选择 00:00 - 08:00 和 19:00 - 24:00 两个有效时段，如下图：

当然，您还可以选择任意想要的时段，像这样：

如果您希望在无效时段期间，允许告警恢复，可以开启 无效时段允许告警恢复 这个选项，如下图：

# 告警级别

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

可选的告警级别包括：

• 普通告警
• 重要告警
• 紧急告警

# 选择通知组

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

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

# 通知用户

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

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

# 通知文字

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

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

# 告警规则的可用状态

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

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

在全局可用状态开启的情况上，您可以对关联的设备独立设置启用或禁用状态。例如，当对某个设备进行维护时，可临时关闭该设备的告警规则，但不影响告警规则关联的其它设备。

# 告警规则的告警状态

告警规则拥有以下几种的告警状态：

• 正常（Ok）：表示最近一次设备属性上报未触发告警规则。
• 告警（Alerting）：表示最近一次设备属性上报已触发告警规则，且达到设置的重复次数和持续时间。如果未设置重复次数和持续时间，则首次触发会进入告警状态。
• 待定（Pending）：表示最近一次设备属性上报已触发告警规则，但未达到设置的重复次数和持续时间。
• 未知（Unknown）：表示告警规则暂时无明确的告警状态，例如：规则创建后一直没有相关设备属性上报，或者告警规则被禁用、不在有效时段等情况。

# 告警历史

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

# 看板告警历史组件

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

# 告警统计

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

# 告警控制台提示

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

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