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

Amazon IoT Greengrass Version 1在 2023 年 6 月 30 日之前,不再收到功能更新,只会收到安全补丁和错误修复。,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?

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

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

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

注意

你可以使用直播管理器将数据上传到 IoT SiteWise 来自 OPC-UA 服务器以外的来源。Stream Manager 还为持久性和带宽管理提供可自定义的支持。有关更多信息,请参阅 在 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 组上启用的流管理器

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

  • 此连接器只能在 Amazon Web Services 区域中使用。Amazon IoT GreengrassIoT SiteWise支持。

  • 将 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核心软件 v1.10.0 和流管理器.

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

  • Greengrass 组上启用的流管理器

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

  • 此连接器只能在 Amazon Web Services 区域中使用。Amazon IoT GreengrassIoT SiteWise支持。

  • 将 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核心软件 v1.9.4。

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

  • 此连接器只能在 Amazon Web Services 区域中使用。Amazon IoT GreengrassIoT SiteWise支持。

  • 将 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核心软件 v1.10.0。

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

  • 此连接器只能在 Amazon Web Services 区域中使用。Amazon IoT GreengrassIoT SiteWise支持。

  • 将 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核心软件 v1.9.4。

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

  • 此连接器只能在 Amazon Web Services 区域中使用。Amazon IoT GreengrassIoT SiteWise支持。

  • 将 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核心软件 v1.9.4。

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

  • 此连接器只能在 Amazon Web Services 区域中使用。Amazon IoT GreengrassIoT SiteWise支持。

  • 添加到 Greengrass 组角色的 IAM 策略,允许访问Amazon IoT Core和iotsitewise:BatchPutAssetPropertyValue对目标 root 资产及其子级执行操作,如以下示例所示。您可以删除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 的最大大小(以 GB 为单位) SiteWise 磁盘使用率。默认值为 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 的最大大小(以 GB 为单位) SiteWise 磁盘使用率。默认值为 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 消息作为输出数据发布。

限制

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

  • 每个最大网关数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

ConfiguredStreamManager以改进源连接丢失并重新建立时的处理能力。此版本还接受 OPC-UA 值,带ServerTimestamp当不时SourceTimestamp可用。

2021 年 1 月 22 日

9

为自定义 Greengrass 启动了 SupportStreamManager直播目标、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 组每次只能包含一个连接器。有关升级连接器版本的信息,请参阅升级连接器版本

另请参阅