质量评估规则模板¶

EnOS 数据质量基于领域经验累积了一套规则模板，终端用户只需根据模板内容填写相关信息，即可完成质量评估规则的配置。

越限模板¶

若选择 越限 模版，需输入以下信息：

阈值类型	描述及示例	所需操作	备注
固定阈值	当监控对象的数据超过设定的固定阈值时，数据越限。	在阈值条件栏中选择一种运算符，并在输入框内填写数值。例如，设固定阈值为 100，阈值条件为 > 100，当监控对象的数据值大于 100 时，数据越限。	当上送的数据为数组型数据时，数组中任一元素值超出阈值范围，该数组就被视为越限。例如，设阈值条件为 < 80 OR > 100，上送的数组为 [79,90,100,111]，数组中第 1、4 个元素的值超出阈值，该数据被视为越限。
动态阈值	针对同一监控组下的不同监控对象，仅用固定阈值来判断所有测点的数据值有时会无法满足业务需求。此时可以通过创建质量维度表，将设备属性作为变量，灵活定义阈值条件。例如，某一风机模型包含具有不同额定功率的风机设备，此时若以一个固定的数值来判断设备功率是否超出阈值，不符合实际需求。这种情况下，可以设置动态阈值条件为 > {ratedPower}*2，当设备额定功率大于 ratedPower 模型属性的 2 倍时，设备上送的数据越限。	在阈值条件栏中选择一种运算符，并在输入框内填写数值或表达式，或填写默认值。	输入表达式前请确保所选属性已在质量维度表中被配置。动态阈值需以 ${属性值} 格式表达。表达式支持的运算符：加 +、减 -、乘、除 /、小括号()，例如，${属性1}+${属性2}2/3。如果填写的表达式不符合规范或属性值为空：此时若填写过默认值，将按照默认值进行数据是否越限的判断；若未填写默认值，则无法判断，默认数据有效。当上送的数据为数组型数据时，数组中任一元素值超出动态阈值，该数组就被视为越限。

备注

当维度表和属性已经与质量评估规则相关联时，若维度表和属性发生变化，不会对该条质量评估规则所配置的动态阈值条件造成影响。资产管理员可以通过给该条质量评估规则重新配置维度表和属性的方法来同步维度表中的现有配置。

当配置了 2 个阈值条件时：

And：代表两个条件之间为“与”的关系，此规则需同时满足两个阈值条件才会被视为越限。
Or：代表两个条件之间为“或”的关系，此规则只需满足其中一个阈值条件即会被视为越限。

缺失模板¶

若选择 缺失 模版，需指定缺失模板的统计类型。

统计类型	所需操作及含义	数据完整率计算公式
周期	在统计周期下拉框选择一个周期，代表“以 x 为周期进行统计”，只要该周期内有数据上送，则视为没有发生数据缺失。当前支持选择 5 分钟、10 分钟、15 分钟、30 分钟、1 小时及 6 小时作为统计周期。	日总周期数 = 24 小时/统计周期完整率 =（日完整周期数/日总周期数）*100%
有效时长	在有效时长输入框中指定时间段，支持以天、小时或分钟为单位（31 天内），仅支持输入正整数。若设置有效时长为 m 天，此时如果出现连续 n（n > m）天无数据上送，则从第 m+1 天到第 n 天会被判定为“缺失”，而前 m 天虽无数据上送但不会被判定为“缺失”。	完整周期数 = 总周期数 - 完整时间段内的 5 min 个数（总周期数为 288）完整率 =（完整周期数/总周期数）*100%

可参照以下缺失示例：

例：设置 有效时长 为 30 天。此时，在 2023-05-01 10：00：00 到 2023-05-31 10：00：00时间段内，虽无上送数据但并不被判定为缺失（因其在有效时长内）。自 2023-05-31 10：00：00 开始，由于距第 1 个无数据上送的点已超过 30 天（即有效时长），此后无数据上送的点均发生缺失。

卡值模板¶

若选择 卡值 模版，需填写以下信息：

统计类型：指定“卡值”的统计类型，可选择 有效点数 或 有效时长。
- 有效点数：输入一个正整数。若设置 有效点数 为 m，此时如果出现连续 n（n≥m）个点数据都相同的情况，则从第 m 个点到第 n 个点间的 m-n+1 个点均被判定为“卡值”，而前 m 个点虽然数据值相同但仍不会被判定为“卡值”。
- 有效时长：指定特定时间段为有效时长，支持以天、小时或分钟为单位，仅支持输入正整数。在有效时长内，即使监控对象数值不变，也不会判定为“卡值”；若超出有效时长后，监控对象的数值仍保持不变，则会判定为出现“卡值”。
描述：输入规则描述。

可参照以下卡值示例：

例 1：场景一中，设置 有效点数 为 4，此时连续 6 个点数据都相同，则在第 4、5、6 个点发生了卡值。
例 2：场景二中，设置 有效点数 为 4，此时连续 4 个点数据都相同，则在第 4 个点发生了卡值。
例 3：场景三中，设置 有效点数 为 4，此时连续 3 个点数据都相同，则没有发生卡值。
例 4：场景四中，设备连续上送 5 个相同的数组型数据，设置 有效点数 为 3，此时第 3、4、5 个数据发生了卡值。
例 5：场景五中，设置 有效时长 为 30 天，此时，在 2023-05-01 10:00:00 到 2023-05-31 10:00:00 时间段内，上送数值虽然相同但并不被判定为卡值（因其在有效时长内）。自 2023-05-31 10:00:00 开始，由于距第 1 个相同的数值点已超过 30 天（即有效时长），此后的连续 5 个数据点均发生卡值。

跳变模板¶

若选择 跳变 模版，需输入以下信息：

阈值类型：选择 固定阈值 或 动态阈值。
阈值条件：关于 固定阈值 和 动态阈值 的选择与配置，参见越限模板中的解释。

延时模板¶

若选择 延时 模版，需输入以下信息：

延时时长：输入正整数并选择时间单位，代表“消息到达 EnOS Cloud 的时间 — 设备时间戳 > 延时时长，视为延时”。
- 以分钟为单位时，可填数值范围为 1-1440。
- 以秒为单位时，可填数值范围为 1-86400。
描述：输入规则描述。

时间戳超前模板¶

若选择 时间戳超前 模版，需输入以下信息：

超前时长：输入正整数并选择时间单位，代表“设备时间戳 — 消息到达 EnOS Cloud 的时间 > 超前时长，视为时间戳超前”。此时默认设备时间戳晚于消息到达 EnOS Cloud 的时间。
- 以分钟为单位时，可填数值范围为 1-1440。
- 以秒为单位时，可填数值范围为 1-86400。
描述：输入规则描述。