本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
汇总来自财产和其他资产(指标)的数据
指标是使用聚合函数处理所有输入数据点并按指定时间间隔输出单个数据点的数学表达式。例如,指标可以从温度数据流计算每小时平均温度。
指标可以从关联资产的指标中输入数据,这样您可以计算统计信息,从而提供对整个操作或部分操作的见解。例如,指标可以计算风电场中所有风力涡轮机的每小时平均温度。有关如何定义资产之间的关联的更多信息,请参阅定义资产模型(层次结构)之间的关系。
指标还可以输入来自其他属性的数据,而无需聚合每个时间间隔内的数据。如果您指定属性在公式中,Amazon IoT SiteWise使用最新计算公式时该属性的值。如果您在公式中指定指标,Amazon IoT SiteWise使用最后的计算公式的时间间隔的值。这意味着你可以定义像这样的指标OEE = Availability * Quality *
Performance
,其中Availability
,Quality
,以及Performance
是同一资产模型上的所有其他指标。
Amazon IoT SiteWise 还会自动为所有资产属性计算一组基本聚合指标。要降低计算成本,您可以使用这些聚合,而不是为基本计算定义自定义指标。有关更多信息,请参阅查询资产属性聚合:
定义指标(控制台)
在 Amazon IoT SiteWise 控制台中为资产模型定义指标时,请指定以下参数:
-
姓名— 物业的名称。
-
公式— 指标表达式。指标表达式可以使用聚合函数从属性中输入层次结构中所有关联资产的数据。开始键入或按向下箭头键打开自动完成功能。有关更多信息,请参阅使用公式表达式:
重要
指标只能是整数、双精度、布尔值或字符串类型的属性。布尔值转换为
0
(假)和1
(真的)。如果您在指标表达式中定义任何指标输入变量,这些输入必须与输出指标具有同一个时间间隔。
公式表达式只能输出双精度值或字符串值。嵌套表达式可以输出其他数据类型,例如字符串,但整个公式必须计算为数字或字符串。你可以使用jp 函数将字符串转换为数字。布尔值必须为 1(真)或 0(假)。有关更多信息,请参阅未定义值、无限值和溢出值:
-
数据类型— 转换的数据类型,可以是双倍要么字符串。
-
时间间隔— 度量时间间隔。Amazon IoT SiteWise支持以下翻滚窗口时间间隔,其中每个间隔从前一个间隔结束时开始:
-
1 分钟—1 分钟,在每分钟结束时计算(上午 12:00:00、凌晨 12:01:00、上午 12:02:00 等)。
-
5 分钟—5 分钟,从一小时开始每五分钟结束时计算(上午 12:00:00、凌晨 12:05:00、上午 12:10:00 等)。
-
15 分钟—15 分钟,从一小时开始每十五分钟结束时计算(上午 12:00:00、凌晨 12:15:00、上午 12:30:00 等)。
-
1 个小时—1 小时(60 分钟),以 UTC 为单位在每小时结束时计算(上午 12:00:00、凌晨 01:00:00、凌晨 02:00:00 等)。
-
1 天—1 天(24 小时),以 UTC 为单位在每天结束时计算(星期一上午 12:00:00,星期二上午 12:00:00,依此类推)。
-
1 个星期—1 周(7 天),在 UTC 的每个星期日结束时计算(每周一上午 12:00:00)。
-
自定义间隔— 您可以输入一分钟到一周之间的任何时间间隔。
-
-
抵消日期—(可选)聚合数据的参考日期。
-
偏移时间—(可选)聚合数据的参考时间。偏移时间必须介于 00:00:00 和 23:59:59 之间。
-
偏移时区—(可选)偏移量的时区。如果未指定,则默认偏移时区为世界协调时间 (UTC)。
-
(UTC+ 00:00) 世界协调时间
-
(UTC+ 01:00) 欧洲中部时间
-
(UTC+ 02:00) 东欧
-
(UTC03+:00) 东非时间
-
(UTC+ 04:00) 近东时间
-
(UTC+ 05:00) 巴基斯坦拉合尔时间
-
(UTC+ 05:30) 印度标准时间
-
(UTC+ 06:00) 孟加拉国标准时间
-
(UTC+ 07:00) 越南标准时间
-
(UTC+ 08:00) 中国台北时间
-
(UTC+ 09:00) 日本标准时间
-
(UTC+ 09:30) 澳大利亚中部时间
-
(UTC+ 10:00) 澳大利亚东部时间
-
(UTC+ 11:00) 所罗门标准时间
-
(UTC+ 12:00) 新西兰标准时间
-
(UTC-11:00) 中途岛时间
-
(UTC-10:00) 夏威夷标准时间
-
(UTC-09:00) 阿拉斯加标准时间
-
(UTC-08:00) 太平洋标准时间
-
(UTC-07:00) 菲尼克斯标准时间
-
(UTC-06:00) 中部标准时间
-
(UTC-05:00) 东部标准时间
-
(UTC-04:00) 波多黎各和美属维尔京群岛时间
-
(UTC-03:00) 阿根廷标准时间
-
(UTC-02:00) 南乔治亚时间
-
(UTC-01:00) 中非时间
-
例 带偏移量的自定义时间间隔(控制台)
以下示例向您展示如何在 2021 年 2 月 20 日下午 6:30:30(太平洋标准时间)定义带偏移量的 12 小时时间间隔。
使用偏移量定义自定义间隔
-
对于时间间隔,选择自定义间隔。
-
对于时间间隔,请执行以下操作之一:
-
输入
12
,然后选择小时。 -
输入
720
,然后选择分钟。 -
输入
43200
,然后选择秒。
重要
这个时间间隔无论单位如何,都必须是整数。
-
-
对于抵消日期,选择2021/02/20。
-
对于偏移时间,输入
18:30:30
。 -
对于偏移时区,选择(UTC-08:00) 太平洋标准时间。
如果您在 2021 年 7 月 1 日下午 06:3030(太平洋标准时间)之前或当天创建指标,则在 2021 年 7 月 1 日下午 06:3030(太平洋标准时间)获得第一个聚合结果,在 2021 年 7 月 2 日上午 06:3030(太平洋标准时间)获得第二个聚合结果,依此类推。
例 指标定义示例
以下示例演示一个指标属性,该属性可聚合资产的温度数据以计算每小时最高温度。

例 从关联资产输入数据的指标定义示例
以下示例演示了一个度量属性,该属性汇总了多个风力涡轮机的平均功率数据,以计算风力发电场的总平均功率。

定义指标 (CLI)
使用 Amazon IoT SiteWise API 为资产模型定义指标时,请指定以下参数:
-
name
— 物业的名称。 -
dataType
— 指标的数据类型,可以是DOUBLE
要么STRING
。 -
expression
— 指标表达式。指标表达式可以使用聚合函数从属性中输入层次结构中所有关联资产的数据。有关更多信息,请参阅使用公式表达式: -
window
— 指标翻滚窗口的时间间隔和偏移量,其中每个间隔从前一个间隔结束时开始:-
interval
— 翻滚窗口的时间间隔。时间间隔必须介于一分钟到一周之间。 -
offsets
— 翻滚窗户的偏移量。
有关更多信息,请参阅《Amazon IoT SiteWise API 参考》中的 TumblingWindow。
例 带有偏移量的自定义时间间隔 (Amazon CLI)
以下示例向您展示如何在 2021 年 2 月 20 日下午 06:3030(太平洋标准时间)定义带偏移量的 12 小时时间间隔。
{ "window": { "tumbling": { "interval": "12h", "offset": " 2021-07-23T18:30:30-08" } } }
如果您在 2021 年 7 月 1 日下午 06:3030(太平洋标准时间)之前或当天创建指标,则在 2021 年 7 月 1 日下午 06:3030(太平洋标准时间)获得第一个聚合结果,在 2021 年 7 月 2 日上午 06:3030(太平洋标准时间)获得第二个聚合结果,依此类推。
-
-
variables
— 变量列表,用于定义要在表达式中使用的资产或子资产的其他属性。每个变量结构包含一个在表达式中使用的简单名称,以及一个指定哪个属性与该变量关联的value
结构。value
结构包含以下信息:-
propertyId
— 要从中提取值的属性的 ID。如果属性是在当前模型中定义的(而不是在层次结构的模型中定义的),您可以使用属性的名称而不是其 ID。 -
hierarchyId
—(可选)用于查询属性的子资产的层次结构的 ID。您可以使用层次结构定义的名称而不是其 ID。如果忽略该值,Amazon IoT SiteWise 将在当前模型中查找属性。
重要
指标只能是整数、双精度、布尔值或字符串类型的属性。布尔值转换为
0
(假)和1
(真的)。如果您在指标表达式中定义任何指标输入变量,这些输入必须与输出指标具有同一个时间间隔。
公式表达式只能输出双精度值或字符串值。嵌套表达式可以输出其他数据类型,例如字符串,但整个公式必须计算为数字或字符串。你可以使用jp 函数将字符串转换为数字。布尔值必须为 1(真)或 0(假)。有关更多信息,请参阅未定义值、无限值和溢出值:
-
-
unit
—(可选)属性的科学单位,例如毫米或摄氏度。
例 指标定义示例
以下示例演示一个指标属性,该属性可聚合资产的温度测量值数据,以计算每小时最高温度(以华氏度为单位)。此对象是一个示例AssetModelProperty其中包含一个公制。您可以将此对象指定为 CreateAssetModel 请求负载的一部分,以创建指标属性。有关更多信息,请参阅创建资产模型 (CLI):
{
...
"assetModelProperties": [...
{ "name": "Max temperature", "dataType": "DOUBLE", "type": { "metric": { "expression": "max(temp_f)", "variables": [ { "name": "temp_f", "value": { "propertyId": "Temperature F" } } ], "window": { "tumbling": { "interval": "1h" } } } }, "unit": "Fahrenheit" } ],...
}
例 从关联资产输入数据的指标定义示例
以下示例演示了一个度量属性,该属性汇总了多个风力涡轮机的平均功率数据,以计算风力发电场的总平均功率。此对象是一个示例AssetModelProperty其中包含一个公制。您可以将此对象指定为 CreateAssetModel 请求负载的一部分,以创建指标属性。有关更多信息,请参阅创建资产模型 (CLI):
{
...
"assetModelProperties": [...
{ "name": "Total Average Power", "dataType": "DOUBLE", "type": { "metric": { "expression": "avg(power)", "variables": [ { "name": "power", "value": { "propertyId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "hierarchyId": "Turbine Asset Model" } } ], "window": { "tumbling": { "interval": "5m" } } } }, "unit": "kWh" } ],...
}