流管理器 - Amazon IoT Greengrass
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

流管理器

流管理器组件 (aws.greengrass.StreamManager)使您能够处理数据流以传输到Amazon Web Services 云来自 Greengrass 的核心设备。

有关如何在自定义组件中配置和使用流管理器的更多信息,请参阅。在上管理数据流Amazon IoT Greengrass核心实例.

Versions

此组件具有以下版本:

  • 2.0.x

注意

如果使用流管理器将数据导出到云,则无法将流管理器组件的 2.0.7 版升级到 v2.0.8 和 v2.0.11 之间的版本。如果您是首次部署流管理器,我们强烈建议您部署流管理器组件的最新版本。

Type

这个组件是一个插件组件(aws.greengrass.plugin)。这些区域有:Greengrass 核心在与核心相同的 Java 虚拟机 (JVM) 中运行此组件。当您安装或重新启动此组件时,核心将重新启动。

此组件使用与 Greengrass 核相同的日志文件。有关更多信息,请参阅查看Amazon IoT GreengrassCore 软件日志

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

Dependencies

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

2.0.12 and 2.0.11

下表列出了此组件 2.0.11 版的依赖关系。

依赖关系 兼容的版本 依赖关系类型
Greengrass 核心 >==2.0.0 软性
Token Token Service > =0.0 硬性
2.0.10

下表列出了此组件 2.0.10 版本的依赖关系。

依赖关系 兼容的版本 依赖关系类型
Greengrass 核心 >==2.0.0 软性
Token Token Service > =0.0 硬性
2.0.9

下表列出了此组件 2.0.9 版的依赖关系。

依赖关系 兼容的版本 依赖关系类型
Greengrass 核心 >==2.0.0 软性
Token Token Service > =0.0 硬性
2.0.8

下表列出了此组件 2.0.8 版的依赖关系。

依赖关系 兼容的版本 依赖关系类型
Greengrass 核心 >==2.0.0 软性
Token Token Service > =0.0 硬性
2.0.7

下表列出了此组件 2.0.7 版的依赖关系。

依赖关系 兼容的版本 依赖关系类型
Greengrass 核心 >=2.0.3 软性
Token Token Service > =0.0 硬性

有关组件依赖项的更多信息,请参阅。组件配方参考.

Configuration

此组件提供了以下配置参数,您可以在部署组件时自定义这些参数。

STREAM_MANAGER_STORE_ROOT_DIR

(可选)用于存储流的本地目录的绝对路径。此值必须以正斜杠开头(例如, /data)。

STREAM_MANAGER_SERVER_PORT

(可选)用于与流管理器通信的本地端口号。

您可以指定0使用随机可用端口。

默认值:8088

STREAM_MANAGER_AUTHENTICATE_CLIENT

(可选)您可以强制要求客户端进行身份验证,然后才能与流管理器进行交互。这些区域有:Amazon IoT Greengrass核心 SDK 控制客户端和流管理器之间的交互。此参数确定哪些客户端可以调用Amazon IoT Greengrass处理流的核心 SDK。有关更多信息,请参阅 。流管理器客户端验证.

如果您指定true,Amazon IoT Greengrass核心 SDK 只允许 Greengrass 组件作为客户端。

如果您指定false,Amazon IoT Greengrass核心 SDK 允许核心设备上的所有进程都是客户端。

默认值:true

STREAM_MANAGER_EXPORTER_MAX_BANDWIDTH

(可选)流管理器可用于导出数据的平均最大带宽(以千位/秒为单位)。

默认值:无限制

STREAM_MANAGER_THREAD_POOL_SIZE

(可选)流管理器可用于导出数据的最大活动线程数。

最佳大小取决于您的硬件、流的量和计划的导出流数量。如果导出速度较慢,您可以调整此设置以找出适合您的硬件和业务案例的最佳大小。核心设备硬件的 CPU 和内存是限制因素。首先,您可以尝试将此值设置为等于设备上的处理器核心数。

请注意,不要设置大于硬件可以支持的大小。每个流都会消耗硬件资源,因此尝试限制受约束设备上的导出流的数量。

默认值:5 个线

STREAM_MANAGER_EXPORTER_S3_DESTINATION_MULTIPART_UPLOAD_MIN_PART_SIZE_BYTES

(可选)分段上传到 Amazon S3 中的段的最小大小(以字节为单位)。流管理器使用此设置和输入文件的大小来确定如何批处理多部分 PUT 请求中的数据。

注意

流管理器使用流sizeThresholdForMultipartUploadBytes属性来确定是作为单次上传还是分段上传导出到 Amazon S3。Amazon IoT Greengrass组件可以在创建导出到 Amazon S3 的流时设置此阈值。

默认值:5242880(5 MB). 这也是最小值。

JVM_ARGS

(可选)启动时传递给流管理器的自定义 Java 虚拟机参数。用空格分隔多个参数。

仅当您必须覆盖 JVM 使用的默认设置时才使用此参数。例如,如果计划导出大量的流,则可能需要增加默认堆大小。

例如:配置 merge 更新

以下配置示例指定使用非默认端口。

{ "STREAM_MANAGER_SERVER_PORT": "18088" }

Changelog

下表介绍每一版的中的更改。

Version

更改

2.0.12
错误修复和改进

修复了无法将流管理器 v2.0.7 升级到 v2.0.8 和 v2.0.11 之间版本的问题。如果您使用流管理器 v2.0.7 将数据导出到云,则现在可以升级到 v2.0.12。

2.0.11

已更新适用于 Greengrass 原核 2.4.0 版发行。

2.0.10

已更新适用于 Greengrass 原核 2.3.0 版发行。

2.0.9

已更新适用于 Greengrass 原核 2.2.0 版发行。

2.0.8

已更新适用于 Greengrass 原核 2.1.0 版发行。

2.0.7

初始版本。