物联网 SiteWise 发行商 - Amazon IoT Greengrass
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

物联网 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

本地日志文件

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

Linux
/greengrass/v2/logs/aws.iot.SiteWiseEdgePublisher.log
Windows
C:\greengrass\v2\logs\aws.iot.SiteWiseEdgePublisher.log
查看此组件的日志
  • 在核心设备上运行以下命令以实时查看此组件的日志文件。将/greengrass/v2C:\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/v2C:\greengrass\v2 替换为Amazon IoT Greengrass根文件夹的路径。

Linux
/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/logs/IotSiteWisePublisherEvents.log
Windows
C:\greengrass\v2\work\aws.iot.SiteWiseEdgePublisher\logs\IotSiteWisePublisherEvents.log

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

  • 严重性级别

  • 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.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

初始版本。

另请参阅