创建告警规则


你可以定义告警规则,以在满足某些条件时触发告警。 例如,对某台风机,定义当风速超过 30 米/秒时即触发告警,并且报告预设的告警级别和告警内容。


创建告警规则有两种方式:通过旧版功能或新版功能。新版功能是旧版功能的增强版,可为在配置触发告警的条件时提供更多的对比选项。 有关更多详细信息,请参见下表。


旧版

新版

在创建告警规则之前需要创建告警内容。

告警内容将直接作为告警规则中的“告警内容”的编辑项,在规则配置页面填写。

只能选择一个资产测点作为触发条件。

可以选择两个资产测点作为触发条件的触发器,并且互相做对比。

模型事件不能作为触发条件的触发器。

可以选择模型事件作为触发条件的触发器。

可以选择指定模型下所有设备的设备状态作为触发条件的触发器。

可以选择所有设备的设备状态作为触发条件的触发器。

只能使用测点阈值来作为告警触发条件。

增加基于滚动窗口的时序条件作为告警触发条件。

不支持离散告警。

支持离散告警。

默认保存为历史告警记录。

应许在告警解除之后不保存告警记录。


告警规则面向指定的模型,根据设置可作用于以下范围:

  • 所有基于该模型实例化的资产。

  • 指定资产树中的基于该模型实例化的资产。


本文章详细介绍如何创建触发告警的规则(新版)。 有关如何创建触发告警的规则(旧版), 参见 创建告警规则(旧版)

开始前准备

操作步骤

  1. 在 EnOS 管理控制台 的导航菜单中,点击 告警管理 > 告警规则

  2. 点击 新增规则,在弹窗中定义触发告警的详细规则。如下图所示。

基本信息

基本信息 部分中填写告警规则的基本信息,例如其编号,描述等。

../_images/alert_rule_basic_section.png


  • 规则名称

    告警规则的名称,长度最大不超过 64,并支持国际化。

  • 规则编号

    用户为该规则定义的编号。支持字母、数字、英文句号(.)、下划线(_)、短横线(-),不超过 50 个字符。

  • 规则描述

    描述规则,长度最大不超过100,并支持国际化。

  • 是否启用

    是否立即启用该条告警规则。

  • 标签

    用户可添加自定义的标签,便于根据实际情况对告警规则进行管理,最多可以添加100个标签。

触发器设置

触发器设置 部分可让你选择触发条件所需的触发器和告警范围。

../_images/alert_rule_trigger_section.png


  • 触发器

    选择 资产测点资产事件设备状态 作为触发规则的触发器。

    • 资产测点

      选择资产模型及其对应的测点。如果需要,单击 添加条件 以添加另一个测点作为触发器。关于如何定义资产模型,请参考物模型与资产建模


      最多触发器的数量为 2。如果触发器多于 1 个,则需要指定一个时效,若超过了该时效,则条件将失败,并且不会触发告警。 可以选择一个时效(介于 60 秒和 24 小时之间),也可以使用默认的 一直有效


    • 资产事件

      选择资产模型及其对应的事件参数以做告警条件判断触发告警,如果不满足条件,则解除告警。


    • 设备状态

      选择此选项可在全部设备或所选型模型下的设备状态更改为离线时触发告警。注:只有设备资产具有设备状态。


  • 作用范围

    选择告警规则的作用范围:

    • 如选择All Devices,则该规则作用于所有基于该模型的资产实例。

    • 如指定一棵资产树,则该规则作用于该资产树内所有基于该模型的实例。你也可以指定资产树内的节点,则规则只适用于指定的节点。当资产树产生更新时,规则将自动被继承至相关节点。如,当规则作用的节点下新增了子节点,则子节点自动继承父节点上定义的告警规则。


      可选择的最大节点数为 1000。 如果选择一个父节点,而它的子节点超过 1000 个,则其节点计数为1,但如果不选择父节点,而是选择其 2000 个子节点 ,总节点计数将为 2000,则超过允许的最大限制。

条件

条件 部分使你能够根据所选触发器配置告警条件。

../_images/alert_rule_condition_section.png


  • 告警条件 (当 触发器资产测点

    • 选择一个条件触发告警。

      • 阈值:选择此选项可为已选的 触发器 设置阈值。

        • 选择触发器之间的关系

          • :在满足所有条件时才触发告警。

          • :只要满足所有条件之一就触发告警。

        • 选择触发器,运算符,然后从下拉列表中选择 Value属性触发器

          • Value:输入条件阈值。

          • 属性:所选模型中与所选测点具有相同数据类型的属性将在相应的下拉列表中列出,从而选择告警条件所需的一个。

          • 触发器:仅在 触发器设置 中选择了两个触发器时,才能用此功能。如果两个触发器具有相同的数据类型,则未在告警条件中选择的触发器将在相应的下拉列表中列出。例如,如果在 触发器设置 选择了数据类型为 int 的两个触发器甲和乙,触发器甲是告警条件,触发器乙将显示在下拉列表中。


          你可以根据需要添加更多条件或条件组。

          备注

          可添加的条件/条件组数是有限制的。有关使用限制,参见 告警规则使用限制


      • 上报频率: 在设置的时序内未上报任何数据时触发警报。 仅适用于单个测点。

      • 无数值变新: 有数据刷新,但是数值在一定时间内都没有任何变化时触发警报。 仅适用于单个测点。


  • 告警条件 (当 触发器资产事件

    • 选择一个条件触发告警。

      • 阈值:选择此选项可为已选的 触发器 设置阈值。

        • 选择触发器之间的关系

          • :在满足所有条件时才触发告警。

          • :只要满足所有条件之一就触发告警。

        • 选择触发器,运算符,然后从下拉列表中选择 Value

          • Value:输入条件值。


      你可以根据需要添加更多条件或条件组。

      备注

      可添加的条件/条件组数是有限制的。有关使用限制,参见 告警规则使用限制


  • 告警条件 (当 触发器设备状态

    触发告警的设备的状态,目前仅支持 离线


  • 时序

    启用此功能来根据特定的时间触发告警。目前仅支持 滚动窗口。 选择窗口时长,若在 条件 选择了 阈值上报频率,选择一个操作符和次数。更多信息,参见 时序告警

    备注

    该功能仅适用于单个测量点。若在 触发器 选择了多个测点,则该功能将被禁用。

告警详情

告警详情 部分让你设置更多信息,例如告警内容,级别,类型等。

../_images/alert_rule_details_section.png


  • 告警内容

    为告警规则选择预设的告警内容,可包含触发告警的可能原因和解决方法,长度最大不超过 500。输入支持国际化,并且可以是文本或使用测点变量的标识符以返回其值。

    • 格式:"${pointId}" 用于 int,string,float 等数据类型。

    • 格式:"${pointId/parameterId}" 用于带参数的 struct 数据类型。

  • 告警级别

    根据业务需要,为告警规则选择预设的告警级别,如严重,警告,信息等。

  • 告警类型

    从列表中选择一个告警类型或子类型。

  • 延后告警

    设置时间(秒)以延迟触发告警。满足条件时,“0” 值将立即触发告警。

  • 告警屏蔽

    仅当 作用范围 为指定资产树或未启用 时序 时可用。开启告警屏蔽后,规则作用的资产树节点以下的子节点告警将被屏蔽,不再上报给应用侧。该选项可帮忙有效减少无效的告警。有关屏蔽行为的详细信息,参见 屏蔽告警

  • 启用离散告警

    若启用该告警将在满足告警条件时立即触发并解除,告警的结束时间与告警触发事件相同。由于在满足告警条件时会立即触发告警,因此如果启用了该功能,不能设置 延后告警告警屏蔽

  • 保存告警记录

    保存告警记录是默认启用的,该告警将在解除后保存为告警历史记录。如果需要,可在 告警 > 告警记录 搜索和查看历史记录。如果不想保存为历史记录,可关闭此开关,则解除后将无法找到告警被触发的任何记录。


单击 确认 以创建告警规则。

结果

在创建或编辑告警规则后,该规则将于 5 分钟后生效。你可以在 告警管理 > 告警记录 中查看当前已告警和历史告警(已解除的告警)。