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

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

流管理器

流管理器组件 (aws.greengrass.StreamManager) 允许您处理Amazon Web Services 云从 Greengrass 核心设备传输到的数据流。

管理 Greengrass 核心设备上的数据流

版本

此组件有以下版本:

  • 2.1.x

  • 2.0.x

注意

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

类型

组件是通用组件 (aws.greengrass.generic)。 Greengrass 核心运行组件的生命周期脚本。

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

操作系统

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

  • Linux

  • Windows

要求

此组件有以下要求:

端点和端口

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

Endpoint 端口 必填 描述

iotanalytics.region.amazonaws.com

443

如果将数据发布到,则为必填项Amazon IoT Analytics。

kinesis.region.amazonaws.com

443

Kinesis Data Firehose,。

data.iotsitewise.region.amazonaws.com

443

如果将数据发布到,则为必填项Amazon IoT SiteWise。

*.s3.amazonaws.com

443

如果您将数据发布到 S3 存储桶,则为必填项。

您可以*使用发布数据的每个存储桶的名称替换。

附属物

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

2.1.1

2.1.1。

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.0.0 <2.9.0 软性
代币交换服务 >=0.0.0 硬性
2.1.0

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

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.0.0 <2.8.0 软性
代币交换服务 >=0.0.0 硬性
2.0.15

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

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.0.0 <2.7.0 软性
代币交换服务 >=0.0.0 硬性
2.0.13 and 2.0.14

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

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.0.0 <2.6.0 软性
代币交换服务 >=0.0.0 硬性
2.0.11 and 2.0.12

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

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.0.0 <2.5.0 软性
代币交换服务 >=0.0.0 硬性
2.0.10

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

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.0.0 <2.4.0 软性
代币交换服务 >=0.0.0 硬性
2.0.9

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

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.0.0 <2.3.0 软性
代币交换服务 >=0.0.0 硬性
2.0.8

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

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.0.0 <2.0 软性
代币交换服务 >=0.0.0 硬性
2.0.7

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

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.0.3 <2.1.0 软性
代币交换服务 >=0.0.0 硬性

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

配置

此组件提供以下配置参数,您可以在部署组件时对其进行自定义。

STREAM_MANAGER_STORE_ROOT_DIR

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

您必须指定现有文件夹,运行流管理器组件的系统用户必须具有读取和写入此文件夹的权限。例如,您可以运行以下命令来创建和配置文件夹/var/greengrass/streams,将其指定为流媒体管理器根文件夹。这些命令允许默认系统用户读取和写入此文件夹。ggc_user

sudo mkdir /var/greengrass/streams sudo chown ggc_user /var/greengrass/streams sudo chmod 700 /var/greengrass/streams

默认值:/greengrass/v2/work/aws.greengrass.StreamManager

STREAM_MANAGER_SERVER_PORT

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

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

默认值:8088

STREAM_MANAGER_AUTHENTICATE_CLIENT

(可选)您可以强制要求客户端先进行身份验证,然后才能与流管理器交互。直播管理器 SDK 控制客户端和直播管理器之间的交互。此参数确定哪些客户端可以调用 Stream Manager SDK 来处理流。,Desh Manager

如果您指定true,则流管理器 SDK 仅允许 Greengrass 组件作为客户端。

如果您指定false,则流管理器 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)。这也是最小值。

LOG_LEVEL

(可选)组件的日志级别。从以下日志级别中选择,此处按级别顺序列出:

  • TRACE

  • DEBUG

  • INFO

  • WARN

  • ERROR

默认值:INFO

JVM_ARGS

(可选)启动时传递给流管理器的自定义 Java 虚拟机参数。。

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

例 示例:配置合并更新

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

{ "STREAM_MANAGER_SERVER_PORT": "18088" }

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

Linux
/greengrass/v2/logs/aws.greengrass.StreamManager.log
Windows
C:\greengrass\v2\logs\aws.greengrass.StreamManager.log

查看此组件的日志

  • 在核心设备上运行以下命令以实时查看此组件的日志文件。将 /greengrass/v2C:\greengrass\v2 替换为Amazon IoT Greengrass根文件夹的路径。

    Linux
    sudo tail -f /greengrass/v2/logs/aws.greengrass.StreamManager.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\aws.greengrass.StreamManager.log -Tail 10 -Wait

更改日志

Version

变更

2.1.1

Greengrass nucleus 2.8.0。

2.1.0

新功能

2.0.15

Greengrass nucleus 2.6.0。

2.0.14

2.0.13

Greengrass nucleus 2.5.0。

2.0.12
Bug。

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

2.0.11

Greengrass nucleus 2.4.0。

2.0.10

Greengrass nucleus 2.3.0。

2.0.9

Greengrass nucleus 2.0。

2.0.8

Greengrass nucleus 2.1.0。

2.0.7

初始版本。