本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 物联网 SiteWise 处理器
物联网 SiteWise 处理器组件 (`aws.iot.SiteWiseEdgeProcessor`) 使 AWS IoT SiteWise 经典流、V2 网关能够在边缘处理数据。
通过此组件， AWS IoT SiteWise 网关可以使用资产模型和资产来处理网关设备上的数据。有关 AWS IoT SiteWise 网关的更多信息，请参阅[《*AWS IoT SiteWise 用户指南》*中的在边缘使用 AWS IoT SiteWise](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways-ggv2.html)。
**注意**
从 2025 年 11 月 7 日起，数据处理包（DPP）功能将不再对新客户开放。如果您想要使用 DPP，请在该日期前注册。现有客户可以继续正常使用该服务。有关更多信息，请参阅《AWS IoT SiteWise 用户指南》**中的[数据处理包可用性变更](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-dpp-availability-change.html)。
**Topics**
+ [版本](#iotsitewise-processor-component-versions)
+ [Type](#iotsitewise-processor-component-type)
+ [操作系统](#iotsitewise-processor-component-os-support)
+ [要求](#iotsitewise-processor-component-requirements)
+ [依赖项](#iotsitewise-processor-component-dependencies)
+ [配置](#iotsitewise-processor-component-configuration)
+ [本地日志文件](#iotsitewise-processor-component-log-file)
+ [许可证](#iotsitewise-processor-component-licenses)
+ [更改日志](#iotsitewise-processor-component-changelog)
+ [另请参阅](#iotsitewise-processor-component-see-also)
## 版本
此组件具有以下版本：
+ 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
## Type
此组件是一个通用组件 (`aws.greengrass.generic`)。[Greengrass Nucleus](greengrass-nucleus-component.md) 运行组件的生命周期脚本。
有关更多信息，请参阅[组件类型](develop-greengrass-components.md#component-types)。
## 操作系统
此组件可以安装在运行以下操作系统的核心设备上：
+ Linux
+ Windows
## 要求
此组件具有以下要求：
+ Greengrass 核心设备必须在以下其中一个平台上运行：
+ 操作系统：Ubuntu 20.04 或更高版本
架构：x86\_64 () AMD64
+ 操作系统：Red Hat Enterprise Linux（RHEL）8
架构：x86\_64 () AMD64
+ 操作系统：Amazon 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 设备角色必须拥有允许您在设备](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-service-role.html)上使用网关的 AWS IoT SiteWise 权限。 AWS IoT Greengrass V2 有关更多信息，请参阅《AWS IoT SiteWise 用户指南》**中的[要求](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-gateway-ggv2.html#gateway-requirements)。
### 端点和端口
除基本操作所需的端点和端口外，此组件还必须能够对以下端点和端口执行出站请求。有关更多信息，请参阅 [允许设备流量通过代理或防火墙](allow-device-traffic.md)。
| 端点 | 端口 | 必需 | 说明 |
| --- | --- | --- | --- |
| `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 还会部署其依赖项的兼容版本。这意味着您必须满足组件及其所有依赖关系的要求，才能成功部署组件。本部分列出了此组件的[已发布版本](#iotsitewise-processor-component-changelog)的依赖关系，以及定义每个依赖关系的组件版本的语义版本约束。您还可以在 [AWS IoT Greengrass 控制台](https://console.aws.amazon.com//greengrass)中查看每个组件版本的依赖关系。在组件详细信息页面上，查找**依赖关系**列表。
下表列出了此组件的版本 2.0.x 至 2.1.x 的依赖关系。
| 依赖关系 | 兼容版本 | 依赖关系类型 |
| --- | --- | --- |
| [令牌交换服务](token-exchange-service-component.md) | >=2.0.3 <3.0.0 | 硬性 |
| [流管理器](stream-manager-component.md) | >=2.0.10 <3.0.0 | 硬性 |
| [Greengrass CLI](greengrass-cli-component.md) | >=2.3.0 <3.0.0 | 硬性 |
有关组件依赖关系的更多信息，请参阅[组件配方参考](component-recipe-reference.md#recipe-reference-component-dependencies)。
## 配置
此组件没有任何配置参数。
## 本地日志文件
此组件使用以下日志文件。
------
#### [ 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 软件许可协议](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf)下发行。
## 更改日志
下表介绍每个组件版本的更改。
| **版本** | **更改** |
| --- | --- |
| 3.5.1 | **新特征**
增加了在 AWS IoT SiteWise中启用摄取功能时对摄取 Null 和 NaN 值的支持。要查看或修改中的 Null 和 NaN 配置 AWS IoT SiteWise，请参阅[DescribeStorageConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeStorageConfiguration.html)和[PutStorageConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_PutStorageConfiguration.html) APIs。
**错误修复和改进**
更新了依赖关系，消除了潜在的安全漏洞。 |
| 3.4.0 | **新特征**
添加了可选的 HTTP 和 HTTPS 代理支持，可以通过需要自定义证书的代理服务器进行网关通信。有关为内 AWS IoT Greengrass 核设置 HTTP 代理的更多信息，请参阅[通过端口 443 或网络代理进行连接](configure-greengrass-core-v2.md#configure-alpn-network-proxy)。有关特定于 SiteWise Edge 的代理支持的更多信息，请参阅*《AWS IoT SiteWise 用户指南》*中的 “[管理 AWS IoT SiteWise Edge 代理支持的信任存储](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/edge-apis-manage-trust-stores-proxy.html)”。 添加了可配置的会话超时设置，以管理 AWS OpsHub 和 SiteWise Edge APIs 的闲置时间。有关更多信息，请参阅*AWS IoT SiteWise 用户指南*中的[配置 AWS IoT SiteWise Edge 会话超时](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/edge-apis-session-timeout.html)。
**性能改进**
将传入数据到达边缘设备存储的时间从 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 网关指标](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateway-metrics-ggv2.html)。 |
| 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 上调整 metric/transform 计算以使用多线程。出于兼容性考虑，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 | 初始版本。 |
## 另请参阅
+ [什么是 AWS IoT SiteWise？](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html) 在《*AWS IoT SiteWise 用户指南》*中。