物联网 SiteWise 处理器 - Amazon IoT Greengrass
版本类型操作系统要求依赖项配置本地日志文件许可证更改日志另请参阅
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

物联网 SiteWise 处理器

物联网 SiteWise 处理器组件 (aws.iot.SiteWiseEdgeProcessor) 使 Amazon IoT SiteWise 网关能够在边缘处理数据。

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

版本

此组件有以下版本：

  • 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 核心运行组件的生命周期脚本。

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

操作系统

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

  • Linux

  • Windows

要求

此组件具有以下要求：

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

    • 操作系统：Ubuntu 20.04 或 18.04

      架构：x86_64 () AMD64

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

      架构：x86_64 () AMD64

    • OS：Amazon Linux 2

      架构：x86_64 () AMD64

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

      架构：x86_64 () AMD64

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

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

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

    注意

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

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

端点和端口

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

Endpoint 端口 必需 描述

model.iotsitewise.region.amazonaws.com

 443 是

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

edge.iotsitewise.region.amazonaws.com

 443 是

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

ecr.region.amazonaws.com

 443 是

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

iot.region.amazonaws.com

 443 是

获取您的设备终端节点 Amazon Web Services 账户。

sts.region.amazonaws.com

 443 是

获取您的身份证 Amazon Web Services 账户。

monitor.iotsitewise.region.amazonaws.com

 443 否

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

依赖项

部署组件时， Amazon IoT Greengrass 还会部署其依赖项的兼容版本。这意味着您必须满足组件及其所有依赖项的要求才能成功部署该组件。本节列出了此组件已发布版本的依赖关系以及定义每个依赖项的组件版本的语义版本限制。您还可以在Amazon 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 <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 包含 Amazon 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 条款

  • BSD-3 条款

  • CDDL-1.0

  • CDDL-1.1

  • ISC

  • Zlib

  • GPL-3.0-有---异常 GCC

  • 公共领域

  • Python-2.0

  • Unicode-2015 DFS

  • BSD-1 个条款

  • 打开 SSL

  • EPL-1.0

  • EPL-2.0

  • GPL-2.0-with-classpath-exception

  • MPL-2.0

  • CC0-1.0

  • JSON

该组件是根据 Greengrass 核心软件许可协议发布的。

更改日志

下表描述了该组件的每个版本中的更改。

版本

更改

3.3.1
新功能

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

3.3.0
性能改进

  • 优化了缓存刷新机制，通过仅刷新新或更新 Amazon IoT SiteWise 资产的条目来减少资产同步之间的 I/O 使用量。

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

错误修复和改进

  • 禁止在没有摄取错误时采集单个属性值的日志，这样可以减少高摄取速率期间的日志噪音。

  • 通过对某些日志条目使用人类可读的格式来提高日志的可读性。

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

3.2.1
错误修复和改进

  • 修复了 Amazon IoT SiteWise API呼叫无法与 SiteWise Edge 同步分页的问题。

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

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

    • IoTSiteWiseProcessor.IsConnectedToMqttBroker

    • IoTSiteWiseProcessor.NumberOfSubscriptionsToMqttBroker

    • IoTSiteWiseProcessor.NumberOfUniqueMqttTopicsReceived

    • IoTSiteWiseProcessor.MqttMessageReceivedSuccessCount

    • IoTSiteWiseProcessor.MqttReceivedSuccessBytes

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

3.2.0
性能改进

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

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

新功能

  • GetAssetPropertyValueAggregatesAPI现在支持边缘上的 15 分钟聚合窗口。

  • 此组件无需再有端口 8081 和 8082 即可正常运行。

    注意

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

错误修复和改进

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

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

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

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

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

  • 修复了适用于 Windows 操作系统的数据处理包中的一个错误，该错误使客户无法使用凭据与MQTT代理建立联系。

3.1.3
错误修复和改进

  • 修复了当某些资源实际出现故障时，数据处理包错误地报告同步成功的问题。

  • 允许多个资源使用相同的名称，前提是它们的父项不相同。

3.1.1
错误修复和改进

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

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

  • 启用对自定义 Stream Manager 端口配置的支持。

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

3.1.0
错误修复和改进

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

3.0.0
新功能

  • 启用对代理数据摄取的MQTT支持。

2.2.1
错误修复和改进

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

    注意

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

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

2.1.37
错误修复和改进

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

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

  • 修复了未指定最大结果限制get-asset-property-value-historyAPI时，分页结果中未提供下一个标记的问题。

2.1.35
错误修复和改进

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

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

2.1.34
错误修复和改进

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

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

2.1.33
错误修复和改进

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

2.1.32
错误修复和改进

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

2.1.31
错误修复和改进

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

2.1.29
错误修复和改进

  • 添加对边缘资源过滤功能的支持。

2.1.28
错误修复和改进

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

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 才可用。

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

2.0.14

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

2.0.13
错误修复和改进

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

2.0.9
错误修复和改进

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

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

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

2.0.7
错误修复和改进

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

2.0.6
错误修复和改进

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

2.0.5
错误修复和改进

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

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

2.0.2

初始版本。

另请参阅