创建和管理告警类型¶
告警类型是根据设备的不同状态或触发告警的原因,对不同告警设置的类型。告警类型可用于过滤告警消息和历史告警数据,通过告警类型编号或描述来筛选触发告警的设备状态,及时作出回应。
对于特定领域而言,设备的告警类型通常在设备说明书中有详细介绍。你可以根据设备说明书配置,也可以当前业务需要和设备实际情况自定义告警的类型。
例如,根据某一变压器的温度和效能的关系,可设置 3 种告警类型:
当温度超过 85℃ 时,设备效能严重受损,无法正常工作,可以据此设置“过热停机”这一告警类型。
当温度下降到 84-55℃ 区间时,设备存在无法正常工作的风险,可以据此设置“高温停机风险”这一告警类型。
当温度下降到 54℃ 及以下时,设备正常工作,没有风险,可以据此设置“温度正常”这一告警类型。
下面将介绍如何创建、编辑和删除告警类型,以及告警类型在告警引擎中的使用场景。
前提条件¶
确保已阅读告警类型的使用限制。参见 使用限制。
创建告警类型¶
在 EnOS 应用门户的开发者控制台,进入 告警引擎 > 告警类型 页面。
点击 新建类型,在弹窗中输入以下内容。
类型编号:告警类型的唯一标识符。同一个 OU 内不能重复,且一旦创建后不可编辑。
类型描述:对告警类型的描述。
类型标签:告警类型的标签。可以根据设备状态添加一个或多个标签,便于过滤告警类型。标签数量最多为 100 条。标签由 Key 和 Value 两部分组成,在同一个告警类型中,Key 不能重复,Value 可以重复。可点击 添加标签 按钮,添加多条标签。
创建子类型¶
创建告警类型之后,可以进一步为告警类型创建子类型。子类型是已有告警类型的进一步细分,便于层级管理和筛选告警类型。例如,在创建一个“温度异常”的告警类型之后,你可以为之创建“温度过高”“温度过低”等若干子类型。
在告警类型列表中,点击特定告警类型对应的 添加子类型 图标。
在弹窗中,输入子类型的编号、描述,并为子类型添加标签。
子类型的编号唯一,不可与 OU 内已有的父类型和子类型编号重复。
父类型的描述和标签不会同步到子类型,子类型标签的 Key 可以和父类型标签的 Key 重复。
输入类型编号、描述或标签查找时,查找结果将同时展示父类型和子类型。例如,如果按子类型的标签查找告警类型,即使父类型没有配置该标签,父子类型都会展示在查找结果中。按父类型查找,子类型也同样出现在结果中。
成功创建子类型的告警类型,类型编号旁将显示图标
,点击可以展示其下的所有子类型。
另外,还可以通过调用 Open API 接口为当前 OU 创建告警类型,创建成功的告警类型将同样出现在告警类型列表。更多信息,参见 有关 EnOS API。无法在页面为通过 Open API 接口创建的告警类型创建子类型。
在 1 个 OU 下,父类型和子类型的总数量不能超过 1000 条。在配置告警规则时,只能为之选择当前 OU 下已有的告警类型,且只能为 1 个规则选择 1 个类型。为规则选择父类型时,不会同时选中子类型,同样,选中子类型时不会选中父类型。
编辑告警类型¶
在 告警引擎 > 告警类型 页面创建的告警类型,可以通过每条告警类型对应的 编辑 图标 ,对 类型描述 和 类型标签 进行编辑。类型编号 不可编辑。
通过 Open API 接口创建的告警类型,在 告警引擎 > 告警类型 页面只能查看,不能编辑。
删除告警类型¶
在 告警引擎 > 告警类型 页面创建的告警类型,可以通过每条告警类型对应的 删除 图标 进行删除。如果一个类型下有子类型,则必须先删除所有子类型,才能删除父类型。
通过 Open API 接口创建的告警类型,在 告警引擎 > 告警类型 页面无法删除。