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

物联网 SiteWise 发行商

物联网 SiteWise 发布者组件 (aws.iot.SiteWiseEdgePublisher) 使 Amazon IoT SiteWise 网关能够将数据从边缘导出到 Amazon Web Services 云。

有关 Amazon IoT SiteWise 网关的更多信息，请参阅《Amazon IoT SiteWise 用户指南》中的在边缘使用 Amazon 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 核心运行组件的生命周期脚本。

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

操作系统

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

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有关更多信息，请参阅授权核心设备与 Amazon 服务交互。

例权限策略


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

端点和端口

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

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

依赖项

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

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

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

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

配置

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

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

输入数据

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

本地日志文件

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

查看此组件的日志

在核心设备上运行以下命令以实时查看此组件的日志文件。将/greengrass/v2或 C:\greengrass\v2 替换为 Amazon 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 替换为 Amazon 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 核心软件许可协议发布的。

更改日志

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

版本	更改
3.1.3	错误修复和改进解决了位于的事件日志文件已创建`/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/logs/IoTSiteWisePublisherEvents.log`但未记录任何事件的问题。添加了以下 CloudWatch 指标，用于监控与 MQTT 代理的连接： `IoTSiteWisePublisher.IsConnectedToMqttBroker` `IoTSiteWisePublisher.NumberOfSubscriptionsToMqttBroker` `IoTSiteWisePublisher.NumberOfUniqueMqttTopicsReceived` `IoTSiteWisePublisher.MqttMessageReceivedSuccessCount` `IoTSiteWisePublisher.MqttReceivedSuccessBytes` 有关这些指标的更多信息，请参阅Amazon IoT Greengrass Version 2 网关指标。解决了即使将 parquet 文件上传到 S3 失败，仍会调用 `BatchCreateJob` API 的问题。
3.1.2	错误修复和改进修复了 3.1.1 版本中引入的 CPU 使用率过高的问题。
3.1.1	错误修复和改进添加额外的日志记录，用于在发生错误时识别受影响的数据别名。在本地强制执行 Amazon IoT SiteWise API 对采集数据的年限的限制。修复了当有多个 Amazon S3 目标时，Publisher 会混淆 StreamManager 直播检查点的问题。修复了发布者如何从 StreamManager 直播中读取数据的性能瓶颈。
3.1.0	新功能增加了对将数据作为 parquet 文件发布到 Amazon S3 的支持。增加了对 Amazon 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	错误修复和改进重新引入了 Amazon IoT SiteWise 通过 HTTP 代理服务器上传数据的支持。
2.2.1	注意此版本不支持 HTTP 代理配置。2.2.2 及更高版本重新引入了对此功能的支持。新功能为该组件添加了支持，以便在将数据上传到时切换压缩 Amazon IoT SiteWise。
2.2.0	注意此版本不支持 HTTP 代理配置。2.2.2 及更高版本重新引入了对此功能的支持。新功能更新此组件以在将数据发送到 Amazon IoT SiteWise 服务之前对其进行压缩。在大多数情况下，与该组件的先前版本相比，此更改可将带宽使用量减少75％。在大多数情况下，此更改会将 CPU 使用率增加多达 5%。在处理大量数据的网关上，此更改可将 CPU 使用率增加多达 15%。此更改不会影响 Amazon IoT SiteWise 服务费或服务配额的使用。添加对 Windows Server 2019 或更高版本的支持。错误修复和改进修复了在检查点文件损坏时阻止此组件启动的问题。
2.1.4	错误修复和改进修复了与 Java 版本 8 的兼容性。
2.1.3	警告此版本不再可用，但美国东部（俄亥俄州）、加拿大（中部）和 Amazon GovCloud （美国东部）地区除外。此组件版本需要 Java 版本 11 或更高版本才能运行。此版本的改进将在此组件的更高版本中提供。错误修复和改进改进了在不支持的设备上部署此组件时的错误消息。更新以记录数据上传失败时的错误。
2.1.2	错误修复和改进更新以在数据过期后立即调用过期的数据导出功能。
2.1.1	错误修复和改进。
2.1.0	新功能增加了对先将最新数据发布到云端的支持。增加了对不将过期数据发布到云端的支持。增加了对在本地存储过期数据的支持。错误修复和改进减少磁盘 I/O 和相应的延迟。
2.0.2	错误修复和改进。
2.0.1	初始版本。

另请参阅

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

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

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

物联网 SiteWise OPC-UA 数据源模拟器

物联网 SiteWise 处理器