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

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

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

物联网 SiteWise 连接器

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

注意

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

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

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

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 Core 软件 v1.10.2 和流管理器

  • Amazon IoT Greengrass Core 软件 v1.10.2。

  • Greengrass 组上启用的流管理器

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

  • 此连接器只能在同时支持两者Amazon IoT Greengrass以及物联 SiteWise网的 Amazon Web Services 区域中使用。

  • 将 IAM 策略添加到 Greengrass 组角色。此角色允许 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 Core 软件 v1.10.0。

  • Greengrass 组上启用的流管理器

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

  • 此连接器只能在同时支持两者Amazon IoT Greengrass以及物联 SiteWise网的 Amazon Web Services 区域中使用。

  • 将 IAM 策略添加到 Greengrass 组角色。此角色允许 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 Core 软件版本 v1.9.4。

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

  • 此连接器只能在同时支持两者Amazon IoT Greengrass以及物联 SiteWise网的 Amazon Web Services 区域中使用。

  • 将 IAM 策略添加到 Greengrass 组角色。此角色允许 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 Core 软件 v1.10.0。

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

  • 此连接器只能在同时支持两者Amazon IoT Greengrass以及物联 SiteWise网的 Amazon Web Services 区域中使用。

  • 将 IAM 策略添加到 Greengrass 组角色。此角色允许 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 Core 软件版本 v1.9.4。

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

  • 此连接器只能在同时支持两者Amazon IoT Greengrass以及物联 SiteWise网的 Amazon Web Services 区域中使用。

  • 将 IAM 策略添加到 Greengrass 组角色。此角色允许 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 Core 软件版本 v1.9.4。

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

  • 此连接器只能在同时支持两者Amazon IoT Greengrass以及物联 SiteWise网的 Amazon Web Services 区域中使用。

  • 添加到 Greengrass 组角色的 IAM 策略,允许访问 Amazon IoT Core 以及对目标 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/*" ] } } }, { "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主机上的目录,物联网 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

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

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

必需:false

类型:string

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

Version 1
SiteWiseLocalStoragePath

Amazon IoT Greengrass主机上的目录,物联网 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

物联网 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 消息作为输出数据。

限制

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

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

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

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

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

许可证

Version 9, 10, 11, and 12

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

此连接器在 Greengrass Core 软件许可协议下发布。

Versions 6, 7, and 8

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

此连接器在 Greengrass Core 软件许可协议下发布。

Versions 1, 2, 3, 4, and 5

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

此连接器在 Greengrass Core 软件许可协议下发布。

更改日志

下表介绍每个版本连接器的更改。

版本

更改

Date

12

  • 此版本包含错误修复。

2021 年 12 月 22 日

11

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

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

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

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

2021 年 3 月 24 日

10

配置了 StreamManager,以改进源连接丢失并重新建立时的处理能力。当没有可用的 SourceTimestamp 时,此版本也接受 OPC-UA 值的 ServerTimestamp

2021 年 1 月 22 日

9

支持自定义 Greengrass StreamManager 流目标、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 组在一个时间上只能包含一个版本的连接器。有关升级连接器版本的信息,请参阅升级连接器版本

另请参阅