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

IoT SiteWise 连接器

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

注意

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

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

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

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

注意

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

此连接器具有以下版本。

版本

ARN

6(推荐)

arn:aws:greengrass:区域::/connectors/IoTSiteWise/versions/6

5

arn:aws:greengrass:区域::/connectors/IoTSiteWise/versions/5

4

arn:aws:greengrass:区域::/connectors/IoTSiteWise/versions/4

3

arn:aws:greengrass:区域::/connectors/IoTSiteWise/versions/3

2

arn:aws:greengrass:区域::/connectors/IoTSiteWise/versions/2

1

arn:aws:greengrass:区域::/connectors/IoTSiteWise/versions/1

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

要求

此连接器具有以下要求:

Version 6
重要

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

  • AWS IoT Greengrass Core software v1.10.0.

  • Greengrass 组上启用的流管理器

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

  • 此连接器只能在受支持的 AWS 区域中使用。有关更多信息,请参阅限制

  • 将 IAM 策略添加到 Greengrass 组角色。此角色允许 AWS IoT Greengrass 组对目标 root 资产及其子级执行 iotsitewise:BatchPutAssetPropertyValue 操作,如以下示例所示。您可以从策略中删除 Condition,以允许连接器访问您的所有 AWS 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
  • AWS IoT Greengrass Core software v1.9.4.

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

  • 此连接器只能在受支持的 AWS 区域中使用。有关更多信息,请参阅限制

  • 将 IAM 策略添加到 Greengrass 组角色。此角色允许 AWS IoT Greengrass 组对目标 root 资产及其子级执行 iotsitewise:BatchPutAssetPropertyValue 操作,如以下示例所示。您可以从策略中删除 Condition,以允许连接器访问您的所有 AWS 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
  • AWS IoT Greengrass Core software v1.10.0.

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

  • 此连接器只能在受支持的 AWS 区域中使用。有关更多信息,请参阅限制

  • 将 IAM 策略添加到 Greengrass 组角色。此角色允许 AWS IoT Greengrass 组对目标 root 资产及其子级执行 iotsitewise:BatchPutAssetPropertyValue 操作,如以下示例所示。您可以从策略中删除 Condition,以允许连接器访问您的所有 AWS 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
  • AWS IoT Greengrass Core software v1.9.4.

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

  • 此连接器只能在受支持的 AWS 区域中使用。有关更多信息,请参阅限制

  • 将 IAM 策略添加到 Greengrass 组角色。此角色允许 AWS IoT Greengrass 组对目标 root 资产及其子级执行 iotsitewise:BatchPutAssetPropertyValue 操作,如以下示例所示。您可以从策略中删除 Condition,以允许连接器访问您的所有 AWS 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
  • AWS IoT Greengrass Core software v1.9.4.

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

  • 此连接器只能在受支持的 AWS 区域中使用。有关更多信息,请参阅限制

  • 添加到 Greengrass 组角色的 IAM 策略,允许访问 AWS IoT Core 以及对目标 root 资产及其子级执行 iotsitewise:BatchPutAssetPropertyValue 操作,如以下示例所示。您可以从策略中删除 Condition,以允许连接器访问您的所有 AWS 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, and 6
SiteWiseLocalStoragePath

IoT SiteWise 连接器可以向其写入持久性数据的 AWS IoT Greengrass 主机上的目录。默认值为 /var/sitewise

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

必需:false

类型:string

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

AWSSecretsArnList

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

在 AWS 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。

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

必需:false

类型:string

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

Version 1
SiteWiseLocalStoragePath

IoT SiteWise 连接器可以向其写入持久性数据的 AWS IoT Greengrass 主机上的目录。默认值为 /var/sitewise

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

必需:false

类型:string

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

SiteWiseOpcuaUserIdentityTokenSecretArn

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

在 AWS 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

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

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

必需:false

类型:string

有效模式: ^$|.+

MaximumBufferSize

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

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

必需:false

类型:string

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

创建连接器示例 (AWS CLI)

以下 AWS CLI 命令创建一个 ConnectorDefinition,其初始版本包含 IoT SiteWise 连接器。

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

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

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

输入数据

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

输出数据

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

限制

此连接器受以下限制的约束。

  • AWS IoT SiteWise 施加的所有限制,包括以下内容。有关更多信息,请参阅 AWS 一般参考 中的 AWS IoT SiteWise 终端节点和配额

    • 每个 AWS 账户的最大网关数量。

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

    • 每个 AWS 账户存储的时间戳质量值 (TQV) 数据点的最大速率。

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

  • 此连接器只能在同时支持 AWS IoT GreengrassAWS IoT SiteWise 的 AWS 区域中使用。目前包括以下区域:

    • 美国东部(弗吉尼亚北部) - us-east-1

    • 美国西部(俄勒冈) - us-west-2

    • 欧洲(法兰克福) - eu-central-1

    • 欧洲(爱尔兰) - eu-west-1

许可证

Version 6

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

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

Versions 1, 2, 3, 4, and 5

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

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

Changelog

下表描述了连接器每个版本中所做的更改。

版本

更改

日期

6(推荐) 

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

2020 年 4 月 29 日

5

修复了与 AWS 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 组一次只能包含一个版本的连接器。有关升级连接器版本的信息,请参阅升级连接器版本

另请参阅