物联网 SiteWise 处理器

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

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

主题

版本
类型
操作系统
要求
依赖项
配置
本地日志文件
许可证
更改日志
另请参阅

版本

此组件有以下版本：

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)
- OS：Red Hat Enterprise 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	硬性

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

配置

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

本地日志文件

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

查看此组件的日志

在核心设备上运行以下命令以实时查看此组件的日志文件。将/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
麻省理工学院
BSD-2 条款
BSD-3 条款
CDDL-1.0
CDDL-1.1
ISC
Zlib
GPL-3.0-with-GCC-Exception
公共领域
Python-2.0
Unicode-dfs-2015
BSD-1 条款
OpenSSL
EPL-1.0
EPL-2.0
GPL-2.0-with-classpath-exception
MPL-2.0
CC0-1.0
JSON

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

更改日志

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

版本	更改
3.2.0	性能改进优化 API 服务以减少内存占用量，并减少安装所需的磁盘空间这使整个组件的初始内存使用量减少了 2 GB（现在启动时使用 7.5 GB 的内存，但仍建议使用 16 GB 的内存），并将整个组件的下载大小减少 500 MB（现在需要下载 1.4 GB）。新功能 `GetAssetPropertyValueAggregates`API 现在支持边缘的 15 分钟聚合窗口。此组件无需再有端口 8081 和 8082 即可正常运行。注意 Amazon IoT SiteWise 数据平面 API（例如）的本地端点已从更改`http://localhost:8081`为`http://localhost:11080/data`。`get-asset-property-value` Amazon IoT SiteWise 控制平面 API（例如）的本地端点已从更改`http://localhost:11080`为`http://localhost:11080/control`。`list-asset-models` Amazon 始终建议您使用 SiteWise Edge 网关 HTTPS 终端节点。这些端点没有改变。错误修复和改进现在，如果上一次同步中断，则从同步 Amazon IoT SiteWise 会将资源转换为有效状态。这将修复强制重启后某些资源损坏的问题。修复了一种罕见的情况，即如果在同步期间修改资源，则资源可能会在边缘损坏。现在，如果检测到这种情况，同步将失败，并且将在下次同步时重试该资源。修复了可能允许外部调用 API 的 HTTP 端点的问题。现在只有 HTTPS 可以用来调用本地环回地址之外的 API。 `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。对 Amazon 证书链进行了其他修改，以确定 Amazon IoT Greengrass V2 证书的优先级。
2.1.37	错误修复和改进弃用 dependency-routing-service 流程并将其功能移到流程中，以减少通信 property-state-service 进程的资源消耗。将 `get-asset-property-value-history` API 的最大结果限制增加到 20,000，以匹配使用的限制 Amazon IoT SiteWise。修复了未指定最大结果限制时，未在 `get-asset-property-value-history` API 的分页结果中提供下一个标记的问题。
2.1.35	错误修复和改进修改 Amazon 凭证链以确定 Amazon IoT Greengrass 凭证的优先级。修复了作为 Thing 群组 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	初始版本。

另请参阅

什么是 Amazon IoT SiteWise？在《Amazon IoT SiteWise 用户指南》中。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

物联网 SiteWise 发行商

发布商支持的组件