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

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

流管理器

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

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

版本

此组件具有以下版本:

  • 2.0.x

注意

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

类型

组件是一个通用组件(aws.greengrass.generic)。这些区域有:Greengrass 核心运行组件的生命周期脚本。

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

操作系统

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

  • Linux

  • Windows

要求

此组件具有以下要求:

端口和端口

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

端点 端口 必填 描述

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.0.13 and 2.0.14

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

依赖关系 兼容的版本 依赖项类型
Greengrass 核心 >=2.0.0 软性
令牌交换服务 >=0.0.0 硬性
2.0.11 and 2.0.12

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

依赖关系 兼容的版本 依赖项类型
Greengrass 核心 >=2.0.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 软性
令牌交换服务 >=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 控制客户端和流管理器之间的交互。此参数确定哪些客户端可以调用流管理器 SDK 来处理流。有关更多信息,请参阅 。流管理器客户端验证.

如果你指定true,Stream Manager SDK 只允许 Greengrass 组件作为客户端。

如果你指定false,Stream Manager 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 时段的最小大小(以字节为单位)。Stream Manager 使用此设置和输入文件的大小来确定如何在多部分 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

查看此组件的日志

  • 在核心设备上运行以下命令以实时查看此组件的日志文件。Replace/绿草/v2要么C:\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.0.14

此版本包含错误修复和改进。

2.0.13

版本更新为 Greengrass 核心版本 2.5.0 发布。

2.0.12
错误修复和改进

修复了阻止将直播管理器 v2.0.7 升级到 v2.0.8 和 v2.0.11 之间的版本的问题。如果您使用流管理器将数据导出到云,则现在可以升级到 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

初始版本。