版本类型操作系统要求依赖项配置输入数据本地日志文件问题排查和调试许可证更改日志另请参阅

IoT SiteWise 发布者

IoT SiteWise 发布者组件 (aws.iot.SiteWiseEdgePublisher) 使 AWS IoT SiteWise 网关能够将数据从边缘导出到 AWS Cloud。

有关 AWS IoT SiteWise 网关的更多信息，请参阅《AWS IoT SiteWise 用户指南》中的在边缘使用 AWS IoT SiteWise。

主题

版本
类型
操作系统
要求
依赖项
配置
输入数据
本地日志文件
问题排查和调试
许可证
更改日志
另请参阅

版本

此组件具有以下版本：

3.1.x
3.0.x
2.4.x
2.3.x
2.2.x
2.1.x
2.0.x

类型

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

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

操作系统

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

Linux
Windows

要求

此组件具有以下要求：

Greengrass 核心设备必须在以下其中一个平台上运行：
- OS：Ubuntu 18.04 或更高版本
  
  架构：x86_64 (AMD64) 或 ARMv8 (Aarch64)
- OS：Red Hat Enterprise Linux (RHEL) 8
  
  架构：x86_64 (AMD64) 或 ARMv8 (Aarch64)
- OS：Amazon Linux 2
  
  架构：x86_64 (AMD64) 或 ARMv8 (Aarch64)
- OS：Debian 11
  
  架构：x86_64 (AMD64) 或 ARMv8 (Aarch64)
- 操作系统：Windows Server 2019 或更高版本
  
  架构：x86_64 (AMD64)
Greengrass 核心设备必须连接到互联网。

Greengrass 核心设备必须获得授权才能执行 iotsitewise:BatchPutAssetPropertyValue 操作。有关更多信息，请参阅授权核心设备与 AWS 服务交互。

例权限策略


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "iotsitewise:BatchPutAssetPropertyValue",
            "Resource": "*"
        }
    ]
}

端点和端口

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

Endpoint	端口	必需	描述
`data.iotsitewise.region.amazonaws.com`	443	是	将数据发布到 AWS IoT SiteWise。

依赖项

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

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

依赖关系	兼容版本	依赖关系类型
Greengrass Nucleus	>=2.3.0<3.0.0	硬性
流管理器	>=2.0.10<3.0.0	硬性

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

配置

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

您可以使用 AWS IoT SiteWise 控制台或 API 来配置 IoT SiteWise 发布者组件。有关更多信息，请参阅《AWS IoT SiteWise 用户指南》中的第 3 步：配置发布者 – 可选。

输入数据

此组件从 AWS IoT Greengrass 流管理器读取 PutAssetPropertyValueEntry 消息。有关更多信息，请参阅 AWS IoT SiteWise API 参考中的 PutAssetPropertyValueEntry。

本地日志文件

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

查看此组件的日志

在核心设备上运行以下命令以实时查看此组件的日志文件。将 /greengrass/v2 或 C:\greengrass\v2 替换为 AWS IoT Greengrass 根文件夹的路径。
Linux
```
sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgePublisher.log
```
Windows (PowerShell)
```
Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgePublisher.log -Tail 10 -Wait
```

问题排查和调试

此组件包括一个新的事件日志，可帮助客户识别和修复问题。日志文件与本地日志文件是分开的，位于以下位置。将 /greengrass/v2 或 C:\greengrass\v2 替换为 AWS IoT Greengrass 根文件夹的路径。

此日志包含详细信息和问题排查信息。问题排查信息与诊断信息一起提供，并附有如何解决问题的说明，有时还会提供指向更多信息的链接。诊断信息包含以下内容：

严重性级别
Timestamp
其它事件特定信息

例示例日志


accountBeingThrottled:
  Summary: Data upload speed slowed due to quota limits
  Level: WARN
  Timestamp: '2023-06-09T21:30:24.654Z'
  Description: The IoT SiteWise Publisher is limited to the "Rate of data points ingested"
    quota for a customers account. See the associated documentation and associated
    metric for the number of requests that were limited for more information. Note
    that this may be temporary and not require any change, although if the issue continues
    you may need to request an increase for the mentioned quota.
  FurtherInformation:
  - https://docs.aws.amazon.com/iot-sitewise/latest/userguide/quotas.html
  - https://docs.aws.amazon.com/iot-sitewise/latest/userguide/troubleshooting-gateway.html#gateway-issue-data-streams
  AssociatedMetrics:
  - Name: TotalErrorCount
    Description: The total number of errors of this type that occurred.
    Value: 327724.0
  AssociatedData:
  - Name: AggregatePropertyAliases
    Description: The aggregated property aliases of the throttled data.
    FileLocation: /greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/./logs/data/AggregatePropertyAliases_1686346224654.log

许可证

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

更改日志

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

版本	更改
3.1.3	错误修复和改进解决了位于 `/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/logs/IoTSiteWisePublisherEvents.log` 的事件日志文件已创建但未记录任何事件的问题。添加了以下 CloudWatch 指标，以监控与 MQTT 代理的连接： `IoTSiteWisePublisher.IsConnectedToMqttBroker` `IoTSiteWisePublisher.NumberOfSubscriptionsToMqttBroker` `IoTSiteWisePublisher.NumberOfUniqueMqttTopicsReceived` `IoTSiteWisePublisher.MqttMessageReceivedSuccessCount` `IoTSiteWisePublisher.MqttReceivedSuccessBytes` 有关这些指标的更多信息，请参阅 AWS IoT Greengrass Version 2 网关指标。解决了即使 Parquet 文件上传到 S3 失败，仍会调用 `BatchCreateJob` API 的问题。
3.1.2	错误修复和改进修复了版本 3.1.1 中引入的 CPU 使用率过高的问题。
3.1.1	警告版本 3.1.1 已于 2024 年 3 月 12 日停用。此版本的改进将在此组件的更高版本中提供。错误修复和改进添加了额外的日志记录，用于在发生错误时识别受影响的数据别名。添加了本地强制执行对数据摄取年限的 AWS IoT SiteWise API 限制的功能。修复了存在多个 Amazon S3 目标时，发布者会混淆 StreamManager 流的检查点的问题。修复了发布者从 StreamManager 流中读取数据时的性能瓶颈。
3.1.0	新功能添加了对将数据作为 Parquet 文件发布到 Amazon S3 的支持。添加了对 AWS IoT SiteWise 缓冲摄取的支持。
3.0.0	错误修复和改进修复了与代理支持有关的问题。新功能支持从 MQTT 代理进行数据摄取。
2.4.1	错误修复和改进让组件能够与 Java Corretto 11 版本 11.0.20.8.1 及更高版本一起使用。当与 Java Corretto 版本 11.0.20.8.1 一起使用时，组件版本 2.4.0 和 2.3.3 会显示 `"Could not find or load main class"` 错误信息。
2.4.0	新功能添加了新的事件日志，便于识别和修复问题。错误修复和改进改进了发布者检查点恢复性能。
2.3.3	错误修复和改进改进了支持高吞吐量的能力。
2.3.2	错误修复和改进修复了下载发布者配置时对 HTTP 代理的支持。
2.3.1	新功能添加了对在 Linux ARMv8 架构上安装数据收集包的支持。 Linux ARMv8 的最低要求：内存：4 GB CPU：ARM Cortex-A72 或同等规格
2.2.3	错误修复和改进移除了针对不在可重试异常列表中的通用异常的重试。
2.2.2	错误修复和改进重新引入了对通过 HTTP 代理服务器向 AWS IoT SiteWise 上传数据的支持。
2.2.1	注意此版本不支持 HTTP 代理配置。版本 2.2.2 及更高版本重新引入了对此功能的支持。新功能为此组件添加了支持，在将数据上传到 AWS IoT SiteWise 时可切换压缩。
2.2.0	注意此版本不支持 HTTP 代理配置。版本 2.2.2 及更高版本重新引入了对此功能的支持。新功能更新此组件以在将数据发送到 AWS IoT SiteWise 服务之前对其进行压缩。在大多数情况下，与此组件的先前版本相比，该更改可减少 75% 带宽使用量。在大多数情况下，该更改会将 CPU 使用率提高多达 5%。在处理大量数据的网关上，该更改可将 CPU 使用率提高多达 15%。该更改不会影响 AWS IoT SiteWise 服务费用或服务配额使用情况。支持 Windows Server 2019 或更高版本。错误修复和改进修复了在检查点文件损坏时阻止此组件启动的问题。
2.1.4	错误修复和改进修复了与 Java 版本 8 的兼容性。
2.1.3	警告除美国东部（俄亥俄州）、加拿大（中部）和 AWS GovCloud（美国东部）区域外，其它区域已不再提供此版本。此组件版本需要 Java 版本 11 或更高版本才能运行。此版本的改进将在此组件的更高版本中提供。错误修复和改进改进了在不支持的设备上部署此组件时的错误消息。更新为在数据上传失败时记录错误。
2.1.2	错误修复和改进更新为在数据到期后立即调用过期数据导出功能。
2.1.1	错误修复和改进。
2.1.0	新功能添加了对将最新数据首先发布到云端的支持。添加了对不将过期数据发布到云端的支持。添加了对在本地存储过期数据的支持。错误修复和改进降低磁盘 I/O 和相应延迟。
2.0.2	错误修复和改进。
2.0.1	初始版本。

另请参阅

《AWS IoT SiteWise 用户指南》中的什么是 AWS IoT SiteWise？

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

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

文档惯例

IoT SiteWise OPC-UA 数据来源模拟器

IoT SiteWise 处理器