IoT SiteWise 连接器 - Amazon IoT Greengrass
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

Amazon IoT Greengrass Version 12023 年 6 月 30 日进入延长寿命阶段。有关更多信息,请参阅Amazon IoT Greengrass V1维护政策。在此日期之后,Amazon IoT Greengrass V1不会发布提供功能、增强功能、错误修复或安全补丁的更新。在上运行的设备Amazon IoT Greengrass V1不会受到干扰,将继续运行并连接到云端。我们强烈建议你迁移到Amazon IoT Greengrass Version 2,它补充说重要的新功能支持其他平台

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

IoT SiteWise 连接器

IoT SiteWise 连接器将本地设备和设备数据发送到中的资产属性Amazon IoT SiteWise。您可以使用此连接器从多个 OPC-UA 服务器收集数据并将其发布到 IoT SiteWise。连接器将数据发送到当前Amazon Web Services 账户和区域中的资产属性。

注意

IoT SiteWise 是一项完全托管的服务,用于收集、处理和可视化来自工业设备和设备的数据。您可以配置资产属性,以处理从此连接器发送到资产的测量属性的原始数据。例如,您可以定义将设备的摄氏温度数据点转换为华氏度的转换属性,也可以定义计算平均每小时温度的指标属性。有关更多信息,请参阅《Amazon IoT SiteWise 用户指南》中的什么是 Amazon IoT SiteWise?

连接器 SiteWise 使用从 OPC-UA 服务器发送的 OPC-UA 数据流路径向IoT 发送数据。例如,数据流路径 /company/windfarm/3/turbine/7/temperature 可能表示风电场 #3 中涡轮机 #7 的温度传感器。如果内Amazon IoT Greengrass核断开与互联网的连接,则连接器会缓存数据,直到它能够成功连接到Amazon Web Services 云。您可以配置用于缓存数据的最大磁盘缓冲区大小。如果缓存大小超过最大磁盘缓冲区大小,则连接器会丢弃队列中最旧的数据。

配置和部署 IoT SiteWise 连接器后,可以在 Io T SiteWise 控制台中添加网关和 OPC-UA 源。在控制台中配置源时,可以筛选 IoT SiteWise 连接器发送的 OPC-UA 数据流路径或为其添加前缀。有关完成网关和源设置的说明,请参阅Amazon IoT SiteWise用户指南中的添加网关

IoT 仅从您映射到 IoT SiteWise 资产测量属性的数据流中 SiteWise 接收数据。要将数据流映射到资产属性,您可以将属性的别名设置为等效于 OPC-UA 数据流路径。要了解如何定义资产模型和创建资产,请参阅Amazon IoT SiteWise用户指南中的工业资产建模

注意

您可以使用流管理器 SiteWise 从 OPC-UA 服务器以外的来源将数据上传到 IoT。直播管理器还为持久性和带宽管理提供可自定义的支持。有关更多信息,请参阅在 Amazon IoT Greengrass 核心上管理数据流

此连接器在无容器隔离模式下运行,因此您可以将其部署到在 Docker 容器中运行的 Greengrass 组。

此连接器有以下版本。

版本

ARN

12(推荐)

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/12

11

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/11

10

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/10

9

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/9

8

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/8

7

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/7

6

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/6

5

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/5

4

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/4

3

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/3

2

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/2

1

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/1

有关版本更改的信息,请参阅更改日志

要求

此连接器具有以下要求:

Version 9, 10, 11, and 12
重要

此版本引入了新要求:Amazon IoT Greengrass核心软件 v1.10.2 和直播管理器

  • Amazon IoT Greengrass核心软件 v1.10.2。

  • Greengrass 组上启用的流管理器

  • Java 8 安装在核心设备上并添加到 PATH 环境变量中。

  • 此连接器只能在同时支持 IoT Amazon IoT Greengrass和 IoT 的Amazon Web Servic SiteWise es 区域中使用。

  • 在 Greengrass 群组角色中添加了 IAM 策略。此角色允许 Amazon IoT Greengrass 组对目标 root 资产及其子级执行 iotsitewise:BatchPutAssetPropertyValue 操作,如以下示例所示。您可以Condition从策略中删除,以允许连接器访问您的所有 IoT SiteWise 资产。

    { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*", "Condition": { "StringLike": { "iotsitewise:assetHierarchyPath": [ "/root node asset ID", "/root node asset ID/*" ] } } } ] }

    有关更多信息,请参阅 IAM 用户指南中的添加和删除 IAM 策略

Versions 6, 7, and 8
重要

此版本引入了新要求:Amazon IoT Greengrass Core 软件 v1.10.0 和流管理器

  • Amazon IoT Greengrass核心软件 v1.10.0。

  • Greengrass 组上启用的流管理器

  • Java 8 安装在核心设备上并添加到 PATH 环境变量中。

  • 此连接器只能在同时支持 IoT Amazon IoT Greengrass和 IoT 的Amazon Web Servic SiteWise es 区域中使用。

  • 在 Greengrass 群组角色中添加了 IAM 策略。此角色允许 Amazon IoT Greengrass 组对目标 root 资产及其子级执行 iotsitewise:BatchPutAssetPropertyValue 操作,如以下示例所示。您可以Condition从策略中删除,以允许连接器访问您的所有 IoT SiteWise 资产。

    { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*", "Condition": { "StringLike": { "iotsitewise:assetHierarchyPath": [ "/root node asset ID", "/root node asset ID/*" ] } } } ] }

    有关更多信息,请参阅 IAM 用户指南中的添加和删除 IAM 策略

Version 5
  • Amazon IoT Greengrass核心软件 v1.9.4。

  • Java 8 安装在核心设备上并添加到 PATH 环境变量中。

  • 此连接器只能在同时支持 IoT Amazon IoT Greengrass和 IoT 的Amazon Web Servic SiteWise es 区域中使用。

  • 在 Greengrass 群组角色中添加了 IAM 策略。此角色允许 Amazon IoT Greengrass 组对目标 root 资产及其子级执行 iotsitewise:BatchPutAssetPropertyValue 操作,如以下示例所示。您可以Condition从策略中删除,以允许连接器访问您的所有 IoT SiteWise 资产。

    { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*", "Condition": { "StringLike": { "iotsitewise:assetHierarchyPath": [ "/root node asset ID", "/root node asset ID/*" ] } } } ] }

    有关更多信息,请参阅 IAM 用户指南中的添加和删除 IAM 策略

Version 4
  • Amazon IoT Greengrass核心软件 v1.10.0。

  • Java 8 安装在核心设备上并添加到 PATH 环境变量中。

  • 此连接器只能在同时支持 IoT Amazon IoT Greengrass和 IoT 的Amazon Web Servic SiteWise es 区域中使用。

  • 在 Greengrass 群组角色中添加了 IAM 策略。此角色允许 Amazon IoT Greengrass 组对目标 root 资产及其子级执行 iotsitewise:BatchPutAssetPropertyValue 操作,如以下示例所示。您可以Condition从策略中删除,以允许连接器访问您的所有 IoT SiteWise 资产。

    { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*", "Condition": { "StringLike": { "iotsitewise:assetHierarchyPath": [ "/root node asset ID", "/root node asset ID/*" ] } } } ] }

    有关更多信息,请参阅 IAM 用户指南中的添加和删除 IAM 策略

Version 3
  • Amazon IoT Greengrass核心软件 v1.9.4。

  • Java 8 安装在核心设备上并添加到 PATH 环境变量中。

  • 此连接器只能在同时支持 IoT Amazon IoT Greengrass和 IoT 的Amazon Web Servic SiteWise es 区域中使用。

  • 在 Greengrass 群组角色中添加了 IAM 策略。此角色允许 Amazon IoT Greengrass 组对目标 root 资产及其子级执行 iotsitewise:BatchPutAssetPropertyValue 操作,如以下示例所示。您可以Condition从策略中删除,以允许连接器访问您的所有 IoT SiteWise 资产。

    { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*", "Condition": { "StringLike": { "iotsitewise:assetHierarchyPath": [ "/root node asset ID", "/root node asset ID/*" ] } } } ] }

    有关更多信息,请参阅 IAM 用户指南中的添加和删除 IAM 策略

Versions 1 and 2
  • Amazon IoT Greengrass核心软件 v1.9.4。

  • Java 8 安装在核心设备上并添加到 PATH 环境变量中。

  • 此连接器只能在同时支持 IoT Amazon IoT Greengrass和 IoT 的Amazon Web Servic SiteWise es 区域中使用。

  • 向 Greengrass 群组角色添加了一个 IAM 策略,该策略允许Amazon IoT Core访问目标根资产及其子资产并对其进行iotsitewise:BatchPutAssetPropertyValue操作,如以下示例所示。您可以Condition从策略中删除,以允许连接器访问您的所有 IoT SiteWise 资产。

    { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*", "Condition": { "StringLike": { "iotsitewise:assetHierarchyPath": [ "/root node asset ID", "/root node asset ID/*" ] } } }, { "Effect": "Allow", "Action": [ "iot:Connect", "iot:DescribeEndpoint", "iot:Publish", "iot:Receive", "iot:Subscribe" ], "Resource": "*" } ] }

    有关更多信息,请参阅《IAM 用户指南》中的添加和移除 IAM 身份权限

参数

Versions 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, and 12
SiteWiseLocalStoragePath

Amazon IoT Greengrass主机上的目录,IoT SiteWise 连接器可以将永久数据写入该目录。默认值为 /var/sitewise

Amazon IoT控制台中的显示名称:本地存储路径

必填项:false

类型:string

有效模式:^\s*$|\/.

AWSSecretsArnList

Amazon Secrets Manager 中的秘密列表,其中包含 OPC-UA 用户名和密码密钥值对。每个秘密都必须是密钥值对类型秘密。

在Amazon IoT控制台中显示名称:OPC-UA 用户名/密码密钥的 ARN 列表

必填项:false

类型:JsonArrayOfStrings

有效模式:\[( ?,? ?\"(arn:(aws(-[a-z]+)*):secretsmanager:[a-z0-9\\-]+:[0-9]{12}:secret:([a-zA-Z0-9\\\\]+\/)*[a-zA-Z0-9\/_+=,.@\\-]+-[a-zA-Z0-9]+)*\")*\]

MaximumBufferSize

IoT SiteWise 磁盘使用的最大大小(以 GB 为单位)。默认值为 10GB。

Amazon IoT控制台中的显示名称:最大磁盘缓冲区大小

必填项:false

类型:string

有效模式:^\s*$|[0-9]+

Version 1
SiteWiseLocalStoragePath

Amazon IoT Greengrass主机上的目录,IoT SiteWise 连接器可以将永久数据写入该目录。默认值为 /var/sitewise

Amazon IoT控制台中的显示名称:本地存储路径

必填项:false

类型:string

有效模式:^\s*$|\/.

SiteWiseOpcuaUserIdentityTokenSecretArn

Amazon Secrets Manager 中的密钥,其中包含 OPC-UA 用户名和密码密钥值对。此密钥必须是密钥值对类型密钥。

在Amazon IoT控制台中显示名称:OPC-UA 用户名/密码密码的 ARN

必填项:false

类型:string

有效模式:^$|arn:(aws(-[a-z]+)*):secretsmanager:[a-z0-9\\-]+:[0-9]{12}:secret:([a-zA-Z0-9\\\\]+/)*[a-zA-Z0-9/_+=,.@\\-]+-[a-zA-Z0-9]+

SiteWiseOpcuaUserIdentityTokenSecretArn-ResourceId

Amazon IoT Greengrass 组中引用 OPC-UA 用户名和密码密钥的私有资源。

在Amazon IoT控制台中显示名称:OPC-UA 用户名/密码密钥资源

必填项:false

类型:string

有效模式:^$|.+

MaximumBufferSize

IoT SiteWise 磁盘使用的最大大小(以 GB 为单位)。默认值为 10GB。

Amazon IoT控制台中的显示名称:最大磁盘缓冲区大小

必填项:false

类型:string

有效模式:^\s*$|[0-9]+

创建连接器示例 (Amazon CLI)

以下Amazon CLI命令ConnectorDefinition使用包含 IoT SiteWise 连接器的初始版本创建。

aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version '{ "Connectors": [ { "Id": "MyIoTSiteWiseConnector", "ConnectorArn": "arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/11" } ] }'
注意

此连接器中的 Lambda 函数具有很长的生命周期。

在Amazon IoT Greengrass控制台中,您可以从群组的连接器页面添加连接器。有关更多信息,请参阅Greengrass 连接器入门(控制台)

输入数据

此连接器不接受 MQTT 消息作为输入数据。

输出数据

此连接器不将 MQTT 消息作为输出数据发布。

Limits

此连接器受IoT 规定的以下所有限制的约束 SiteWise,包括以下限制。有关更多信息,请参阅中的Amazon IoT SiteWise终端节点和配额Amazon Web Services 一般参考

  • 每个网关的最大大小Amazon Web Services 账户。

  • 每个网关的 OPC-UA 源的最大数量。

  • 每秒存储的 timestamp-quality-value (TQV) 数据点的最大速率Amazon Web Services 账户。

  • 每个资产属性存储的 TQV 数据点的最大速率。

许可证

Version 9, 10, 11, and 12

IoT SiteWise 连接器包括以下第三方软件/许可:

此连接器根据 Greengrass 核心软件许可协议发布。

Versions 6, 7, and 8

IoT SiteWise 连接器包括以下第三方软件/许可:

此连接器根据 Greengrass 核心软件许可协议发布。

Versions 1, 2, 3, 4, and 5

IoT SiteWise 连接器包括以下第三方软件/许可:

此连接器根据 Greengrass 核心软件许可协议发布。

更改日志

下表说明连接器每个版本的更改。

版本

更改

日期

12

  • 此版本包含错误修复。

2021 年 12 月 22 日

11

  • Support 包含隐藏或不可打印字符的字符串。在将字符串发送到之前,会自动删除隐藏和不可打印的字符Amazon Web Services 云。

  • 修复了导致 IoT SiteWise 网关无限次重试无效请求的问题。

  • 修复了在IoT SiteWise 网关连接到高频数据源时导致检查点损坏的问题。

  • 改进了错误消息以帮助对网关配置进行故障排除。

2021 年 3 月 24 日

10

配置StreamManager为改善源连接丢失并重新建立时的处理。此版本还接受 OPC-UA 值,ServerTimestamp如果没有可用SourceTimestamp,则为。

2021 年 1 月 22 日

9

已Support 自定义 GreengrassStreamManager 直播目的地、OPC-UA 死区、自定义扫描模式和自定义扫描速率。还包括提高从 IoT SiteWise 网关进行配置更新期间的性能。

2020 年 12 月 15 日

8

提高了连接器遇到间歇性网络连接时的稳定性。

2020 年 11 月 19 日

7

修复了网关指标的问题。

2020 年 8 月 14 日

6

增加了对 CloudWatch 指标和自动发现新 OPC-UA 标签的支持。此版本需要流管理器和 Amazon IoT Greengrass Core 软件 v1.10.0 或更高版本。

2020 年 4 月 29 日

5

修复了与 Amazon IoT Greengrass Core 软件 v1.9.4 的兼容性问题。

2020 年 2 月 12 日

4

修复了 OPC-UA 服务器重新连接的问题。

2020 年 2 月 7 日

3

已删除 iot:* 权限要求。

2019 年 12 月 17 日

2

新增对多个 OPC-UA 秘密资源的支持。

2019 年 12 月 10 日

1

首次发布。

2019 年 12 月 2 日

Greengrass 组一次只能包含连接器的一个版本。有关升级连接器版本的信息,请参阅升级连接器版本

另请参阅