物联网 SiteWise 处理器 - AWS IoT Greengrass
版本类型操作系统要求依赖项配置本地日志文件许可证更改日志另请参阅

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

物联网 SiteWise 处理器

物联网 SiteWise 处理器组件 (aws.iot.SiteWiseEdgeProcessor) 使 AWS IoT SiteWise 经典流、V2 网关能够在边缘处理数据。

借助此组件， AWS IoT SiteWise 网关可以使用资产模型和资产来处理网关设备上的数据。有关 AWS IoT SiteWise 网关的更多信息，请参阅《AWS IoT SiteWise 用户指南》中的在边缘使用 AWS IoT SiteWise。

版本

此组件具有以下版本：

  • 3.5.x

  • 3.4.x

  • 3.3.x

  • 3.2.x

  • 3.1.x

  • 3.0.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

类型

此组件是一个通用组件 (aws.greengrass.generic)。Greengrass Nucleus 运行组件的生命周期脚本。

有关更多信息，请参阅组件类型。

操作系统

此组件可以安装在运行以下操作系统的核心设备上：

  • Linux

  • Windows

要求

此组件具有以下要求：

  • Greengrass 核心设备必须在以下其中一个平台上运行：

    • 操作系统：Ubuntu 20.04 或更高版本

      架构：x86_64 () AMD64

    • 操作系统：红帽企业 Linux (RHEL) 8

      架构：x86_64 () AMD64

    • 操作系统：亚马逊 Linux 2

      架构：x86_64 () AMD64

    • 操作系统：Windows Server 2019 或更高版本

      架构：x86_64 () AMD64

    • 操作系统：Debian 11（Bullseye）或更高版本

      架构：x86_64 () AMD64

  • Greengrass 核心设备必须允许端口 443 的入站流量。

  • Greengrass 核心设备必须允许端口 443 和 8883 的出站流量。

  • 以下端口已保留供以下用户使用 AWS IoT SiteWise：80、443、3001、4569、4572、8000、8081、8082、8084、8085、8086、8445、9000、9500、11080 和 50010。使用预留端口通信可能导致连接终止。

    注意

    仅此组件的 2.0.15 及更高版本需要端口 8087。

  • Greengrass 设备角色必须拥有允许您在设备上使用网关的 AWS IoT SiteWise 权限。 AWS IoT Greengrass V2 有关更多信息，请参阅《AWS IoT SiteWise 用户指南》中的要求。

端点和端口

除基本操作所需的端点和端口外，此组件还必须能够对以下端点和端口执行出站请求。有关更多信息，请参阅 允许设备流量通过代理或防火墙。

Endpoint 端口 必需 描述

model.iotsitewise.region.amazonaws.com

 443 是

获取有关您的 AWS IoT SiteWise 资产和资产模型的信息。

edge.iotsitewise.region.amazonaws.com

 443 是

获取有关核心设备 AWS IoT SiteWise 网关配置的信息。

ecr.region.amazonaws.com

 443 是

从亚马逊弹性容器注册表下载 AWS IoT SiteWise Edge 网关 Docker 镜像。

iot.region.amazonaws.com

 443 是

获取您 AWS 账户的设备端点。

sts.region.amazonaws.com

 443 是

获取您的身份证 AWS 账户。

monitor.iotsitewise.region.amazonaws.com

 443 否

如果您访问核心设备上的 AWS IoT SiteWise Monitor 门户，则为必填项。

依赖项

部署组件时， AWS IoT Greengrass 还会部署其依赖项的兼容版本。这意味着您必须满足组件及其所有依赖关系的要求，才能成功部署组件。本部分列出了此组件的已发布版本的依赖关系，以及定义每个依赖关系的组件版本的语义版本约束。您还可以在 AWS IoT Greengrass 控制台中查看每个组件版本的依赖关系。在组件详细信息页面上，查找依赖关系列表。

下表列出了此组件的版本 2.0.x 至 2.1.x 的依赖关系。

依赖关系 兼容版本 依赖关系类型
令牌交换服务 >=2.0.3 <3.0.0 硬性
流管理器 >=2.0.10 <3.0.0 硬性
Greengrass CLI >=2.3.0 <3.0.0 硬性

有关组件依赖关系的更多信息，请参阅组件配方参考。

配置

此组件没有任何配置参数。

本地日志文件

此组件使用以下日志文件。

Linux
/greengrass/v2/logs/aws.iot.SiteWiseEdgeProcessor.log
Windows
C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeProcessor.log
查看此组件的日志

  • 在核心设备上运行以下命令可实时查看此组件的日志文件。将/greengrass/v2或C:\greengrass\v2替换为 AWS IoT Greengrass 根文件夹的路径。

    Linux
    sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgeProcessor.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeProcessor.log -Tail 10 -Wait

许可证

此组件包含以下第三方软件/许可：

  • Apache-2.0

  • MIT

  • BSD-2-Clause

  • BSD-3-Clause

  • CDDL-1.0

  • CDDL-1.1

  • ISC

  • Zlib

  • GPL-3.0-with-GCC-exception

  • 公共域

  • Python-2.0

  • Unicode-DFS-2015

  • BSD-1-Clause

  • OpenSSL

  • EPL-1.0

  • EPL-2.0

  • GPL-2.0-with-classpath-exception

  • MPL-2.0

  • CC0-1.0

  • JSON

此组件在 Greengrass Core 软件许可协议下发行。

更改日志

下表介绍每个组件版本的更改。

版本

更改

3.5.1
新特征

如果在中启用了摄取，则增加了对提取 Null 和 NaN 值的支持。 AWS IoT SiteWise要查看或修改中的 Null 和 NaN 配置 AWS IoT SiteWise，请参阅DescribeStorageConfiguration和PutStorageConfiguration APIs。

错误修复和改进

更新了依赖关系以解决潜在的安全漏洞。

3.4.0
新特征
性能改进

将传入数据到达边缘设备存储的时间从 5 秒缩短到不到 1 秒。数据上传的延迟保持不 AWS IoT SiteWise 变。

3.3.1
新特征

  • 为 SiteWise Edge 添加了可选的 CORS 支持 APIs，增强了跨域资源共享功能。此功能提高了与交互的 Web 应用程序的灵活性 APIs。

3.3.0
性能改进

  • 优化了缓存刷新机制，只刷新新资产或已更新后资产的条目，从而减少了 AWS IoT SiteWise 资产同步之间的 I/O 使用率。

  • 减少了维护具有大量同步资产属性的缓存所需的内存占用。

错误修复和改进

  • 禁止在没有摄取错误时摄取单个属性值的日志，以降低高摄取速率期间的日志噪音。

  • 对某些日志条目使用便于阅读的格式，提高了日志的可读性。

  • 添加了对 Java 17 及更高版本的支持。

3.2.1
错误修复和改进

  • 修复了 AWS IoT SiteWise API 调用无法与 SiteWise Edge 同步分页的问题。

  • 修复了相关问题，不再发布 MessageRemaining.SiteWise_Edge_Stream 指标。

  • 添加了以下 CloudWatch 指标来监控与 MQTT 代理的连接。

    • IoTSiteWiseProcessor.IsConnectedToMqttBroker

    • IoTSiteWiseProcessor.NumberOfSubscriptionsToMqttBroker

    • IoTSiteWiseProcessor.NumberOfUniqueMqttTopicsReceived

    • IoTSiteWiseProcessor.MqttMessageReceivedSuccessCount

    • IoTSiteWiseProcessor.MqttReceivedSuccessBytes

    有关这些指标的更多信息，请参阅 AWS IoT Greengrass Version 2 网关指标。

3.2.0
性能改进

  • 优化了 API 服务，从而减少了内存占用量和安装所需的磁盘空间

    • 这使整个组件的初始内存使用量减少了 2 GB（现在启动时使用 7.5 GB 内存，但仍建议使用 16 GB 内存），并将整个组件的下载大小减少了 500 MB（现在需要下载 1.4 GB）。

新特征

  • GetAssetPropertyValueAggregates API 现在支持在边缘使用 15 分钟聚合窗口。

  • 此组件正常运行不再需要端口 8081 和 8082 处于可用状态。

    注意

    AWS IoT SiteWise 数据平面的 APIs本地端点（例如get-asset-property-value）正在从更改http://localhost:8081为http://localhost:11080/data。 AWS IoT SiteWise 控制平面的 APIs本地端点（例如list-asset-models）正在从更改http://localhost:11080为http://localhost:11080/control。 AWS 始终建议您使用 SiteWise Edge 网关 HTTPS 终端节点。这些端点没有变化。

错误修复和改进

  • 现在，如果上一次同步中断，则从同步 AWS IoT SiteWise 会将资源转换为有效状态。这将修复强制重启后部分资源损坏的问题。

  • 修复了一种罕见状况，即如果在同步期间修改资源，则资源可能会在边缘损坏的问题。现在，如果检测到这种状况，同步将会失败，并会在下次同步时重试该资源。

  • 修复了可能允许外部调用 HTTP 端点的问题。 APIs 现在只能使用 HTTPS 在本地环回地址 APIs 之外进行呼叫。

  • ListAssets API 现在显示存储在边缘的资产的资产层次结构。

  • 修复了数据处理包无法在 Windows 上重启、升级或降级的问题。

  • 修复了 Windows 操作系统数据处理包中的一个错误，该错误会导致客户无法使用凭证连接 MQTT 代理。

3.1.3
错误修复和改进

  • 修复了当某些资源实际同步失败时，数据处理包误报告同步成功的问题。

  • 允许具有不同父项的多个资源使用同一名称。

3.1.1
错误修复和改进

  • 修复了由于时区不匹配而导致的 SigV4 请求失败的问题。

  • 修复了重启后依赖于属性的转换和指标属性会停止计算的问题。

  • 支持 Stream Manager 端口配置。

  • 修复了同步到边缘的属性可能会停止更新的问题。

3.1.0
错误修复和改进

  • 修复了 ListAssetModels API 无法生成下一个令牌的问题。

3.0.0
新特征

  • 支持从 MQTT 代理进行数据摄取。

2.2.1
错误修复和改进

  • 调整同步过程，使控制面板数据存储与云的运行方式更加一致。这会对升级有轻微影响。

    注意

    在版本 2.2.1 或更高版本上同步的控制面板数据将与之前的版本不兼容。要降级到以前的版本，您需完成全新安装。这不会影响升级，在先前版本上同步的数据在版本 2.2.1 上同样适用。

  • 对 AWS 证书链进行了其他修改，以确定 AWS IoT Greengrass V2 证书的优先级。

2.1.37
错误修复和改进

  • 弃用 dependency-routing-service流程并将其功能移到流程中，以减少通信 property-state-service进程的资源消耗。

  • 将 get-asset-property-value-history API 的最大结果限制增加到 20,000，以匹配使用的限制 AWS IoT SiteWise。

  • 修复了未指定最大结果限制时，不在 get-asset-property-value-history API 的分页结果中提供下一个令牌的问题。

2.1.35
错误修复和改进

  • 修改 AWS 凭证链以确定 AWS IoT Greengrass 凭证的优先级。

  • 修复了作为 AWS IoT 事物组的一部分进行部署时出现的账户检测问题。

2.1.34
错误修复和改进

  • 调整了指标/转换计算，以在 Linux 上使用多线程。出于兼容性考虑，Windows 会继续运行单线程计算。

  • 修复了某些计算窗口缺失指标计算的问题。

2.1.33
错误修复和改进

  • 修复了向 Greengrass 控制台报告错误状态的问题。

2.1.32
错误修复和改进

  • 添加了对自定义用户名和组的支持。

2.1.31
错误修复和改进

  • 针对在 AWS IoT SiteWise中建模的数据，添加了对计算时间加权平均值和时间加权标准差的支持。

2.1.29
错误修复和改进

  • 针对边缘功能添加了支持，允许筛选资产。

2.1.28
错误修复和改进

  • 优化资源同步，使大量资产能够从边缘同步 AWS 云 到边缘。

2.1.24
错误修复和改进

  • 修复了在第二次同步资源时导致的控制面板消失问题。

2.1.23
错误修复和改进

  • 为 aws.iot.SiteWiseEdgeProcessor 安装过程添加了超时时限，以避免互联网连接速度慢时安装失败。

  • 优化了资源同步，提高了云端和边缘之间的同步效率。

2.1.21
警告

从 2.0.x 版本升级到 2.1.x 版会导致本地数据丢失。

新特征

  • 支持 Windows Server 2019 或更高版本。

  • 移除了基于 Linux 的操作系统的 Docker。

2.0.16

此版本包含错误修复和改进。

2.0.15
错误修复和改进

  • 将此组件用于资源同步 API 操作的端口从 8085 更改为了 8087。因此，此组件现在要求端口 8087 可用。此组件依旧要求端口 8085 可用。

  • 更新 AWS OpsHub 身份验证以在登录期间拒绝未经授权的用户，而不是在用户尝试调用 API 操作时拒绝未经授权的用户。

2.0.14

此版本包含错误修复和改进。

2.0.13
错误修复和改进

  • 修复了一个问题，当此组件向 Amazon CloudWatch 指标报告数据时，它现在可以正确指示哪些数据未建模。

2.0.9
错误修复和改进

  • 提高了在核心设备上创建和更新 AWS IoT SiteWise 资源的可靠性。

  • 添加了其它本地 API 操作，您可以使用这些操作来监控核心设备上安装的组件、每个组件的版本以及每个组件的状态。您可以在核心设备上的 for AWS IoT SiteWise 应用程序的 “设置” 选项卡上查看此信息。 AWS OpsHub

  • 为此组件运行的 Docker 容器添加了运行状况。您可以运行 docker ps 命令来查看容器的运行状况。

2.0.7
错误修复和改进

  • 修复了对在核心设备上查看 AWS IoT SiteWise Monitor 传送门的支持。

2.0.6
错误修复和改进

  • 修复了 AWS IoT SiteWise statetime()此组件在核心设备上计算的earliest()、和latest()函数。

2.0.5
错误修复和改进

  • 添加对该组件在核心设备上计算的变换中的 AWS IoT SiteWise pretrigger()函数的支持。

  • 更改此组件存储轻型目录访问协议（LDAP）配置（用于身份验证）的路径。

2.0.2

初始版本。

另请参阅