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

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

日志管理器

日志管理器组件 (aws.greengrass.LogManager) 将日志从Amazon IoT Greengrass核心设备上传到 Amazon CloudWatch Logs。您可以上传来自 Greengrass 核心、其他 Greengrass 组件以及其他不是 Greengrass 组件的应用程序和服务的日志。有关如何监控 Logs 和本地文件系统中的 CloudWatch 日志的更多信息,请参阅显示器Amazon IoT Greengrass圆木

使用日志管理器组件写入日志时,以下注意事项适用: CloudWatch

  • 记录延迟

    日志管理器组件仅从轮换的日志文件中写入日志。默认情况下,Amazon IoT GreengrassCore 软件每小时轮换一次日志文件,或者在日志文件大小为 1,024 KB 之后轮换一次。因此,只有在Amazon IoT Greengrass Core 软件或 Greengrass 组件写入超过 1,024 KB 的日志之后,日志管理器组件才会上传日志。您可以配置较低的日志文件大小限制,使日志文件更频繁地旋转。这会导致日志管理器组件更频繁地将 CloudWatch 日志上传到日志。

    日志管理器组件还会定期上传新日志。默认情况下,日志管理器组件每 5 分钟上传一次新日志。您可以配置较短的上传间隔,以便日志管理器组件更频繁地将 CloudWatch 日志上传到日志。

    如果您需要实时观察日志,可以考虑使用文件系统日志

  • 时钟偏差

    日志管理器组件使用标准签名版本 4 签名流程为 CloudWatch 日志创建 API 请求。如果核心设备上的系统时间不同步超过 15 分钟,则 L CloudWatch ogs 会拒绝请求。,4Amazon

有关此组件将日志上传到的日志组和日志流的信息,请参阅用量

版本

此组件有以下版本:

  • 2.2.x

  • 2.1.x

  • 2.0.x

类型

这个组件是一个插件组件 (aws.greengrass.plugin)。Greengrass 核心在与核心相同的 Java 虚拟机 (JVM) 中运行此组件。当您在核心设备上更改此组件的版本时,nucleus 会重新启动。

此组件使用与 Greengrass 核相同的日志文件。有关更多信息,请参阅 显示器Amazon IoT Greengrass圆木

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

操作系统

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

  • Linux

  • Windows

要求

此组件有以下要求:

  • Greengrass 设备角色必须允许logs:CreateLogGrouplogs:CreateLogStreamlogs:PutLogEvents、、和logs:DescribeLogStreams操作,如以下示例 IAM 策略所示。

    { "Version": "2012-10-17", "Statement": [ { "Action": [ "logs:CreateLogGroup", "logs:CreateLogStream", "logs:PutLogEvents", "logs:DescribeLogStreams" ], "Effect": "Allow", "Resource": "arn:aws:logs:*:*:*" } ] }
    注意

    默认情况下,您在安装Amazon IoT Greengrass核心软件时创建的 Greengrass 设备角色包含此示例策略中的权限。

    ,A mazon L CloudWatch ogs(IA CloudWatch M)

端点和端口

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

Endpoint 端口 必填 描述

logs.region.amazonaws.com

443

如果您将日志写入日 CloudWatch 志,则为必填项。

附属物

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

2.2.7

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

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.1.0 <2.9.0 软性
2.2.6

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

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.1.0 <2.8.0 软性
2.2.5

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

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.1.0 <2.7.0 软性
2.2.1 - 2.2.4

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

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.1.0 <2.6.0 软性
2.1.3 and 2.2.0

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

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.1.0 <2.5.0 软性
2.1.2

2.1.2。

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.1.0 <2.4.0 软性
2.1.1

2.1.1。

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.1.0 <2.3.0 软性
2.1.0

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

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.1.0 <2.2.0 软性
2.0.x

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

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.0.3 <2.1.0 软性

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

配置

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

v2.2.x
logsUploaderConfiguration

(可选)日志管理器组件上传的日志的配置。Cons():

systemLogsConfiguration

(可选)Amazon IoT Greengrass核心软件系统日志的配置,其中包括来自 Greengrass 核心插件组件的日志。指定此配置以启用日志管理器组件来管理系统日志。Cons():

uploadToCloudWatch

(可选)您可以将系统日志上传到 CloudWatch 日志。

默认值:false

minimumLogLevel

(可选)要上传的日志消息的最低级别。此最低级别仅在将 Greengrass nucleus 组件配置为输出 JSON 格式日志时适用。要启用 JSON 格式的日志JSON,请指定日志格式参数 (logging.format)。

从以下日志级别中选择,此处按级别顺序列出:

  • DEBUG

  • INFO

  • WARN

  • ERROR

默认值:INFO

diskSpaceLimit

(可选)Greengrass 系统日志文件的最大总大小,单位为您在中指定的单位diskSpaceLimitUnit。在 Greengrass 系统日志文件的总大小超过此最大总大小后,Amazon IoT GreengrassCore 软件会删除最旧的 Greengrass 系统日志文件。

此参数等同于 Greengrass 核分量的对数大小限制参数 (totalLogsSizeKB)。CAmazon IoT Greengrass ore 软件使用这两个值中的最小值作为 Greengrass 系统日志的最大总大小。

diskSpaceLimitUnit

(可选)的单位diskSpaceLimit。从以下选项中进行选择:

  • KB— 千字节

  • MB— 兆字节

  • GB— 千兆字节

默认值:KB

deleteLogFileAfterCloudUpload

(可选)在日志管理器组件将日志上传到日志后,您可以删除 CloudWatch 日志文件。

默认值:false

componentLogsConfigurationMap

(可选)核心设备上组件的日志配置映射。此映射中的每个componentName对象都定义了组件或应用程序的日志配置。日志管理器组件将这些组件日志上传到 CloudWatch 日志。

注意

如果您要从 v2.2.0 之前的日志管理器版本升级,则可以继续使用该componentLogsConfiguration列表而不是componentLogsConfigurationMap。,Cons()。有关componentLogsConfiguration参数的信息,请参阅此组件的 v2.1.x 的配置参数。

componentName

此日志配置的componentName组件或应用程序的日志配置。您可以指定 Greengrass 组件的名称或其他值来标识此日志组。

minimumLogLevel

(可选)要上传的日志消息的最低级别。仅当此组件的日志使用特定的 JSON 格式时,此最低级别才适用,您可以在Amazon IoT Greengrass日志模块存储库中找到该格式 GitHub。

从以下日志级别中选择,此处按级别顺序列出:

  • DEBUG

  • INFO

  • WARN

  • ERROR

默认值:INFO

diskSpaceLimit

(可选)此组件所有日志文件的最大总大小,单位为您在中指定的单位diskSpaceLimitUnit。当此组件的日志文件总大小超过此最大总大小后,Amazon IoT GreengrassCore 软件会删除该组件最旧的日志文件。

此参数与 Greengrass 核分量的对数大小限制参数 (totalLogsSizeKB) 有关。CAmazon IoT Greengrass ore 软件使用这两个值中的最小值作为该组件的最大总日志大小。

diskSpaceLimitUnit

(可选)的单位diskSpaceLimit。从以下选项中进行选择:

  • KB— 千字节

  • MB— 兆字节

  • GB— 千兆字节

默认值:KB

logFileDirectoryPath

(可选)包含此组件日志文件的文件夹的路径。

对于打印到标准输出 (stdout) 和标准错误 (stderr) 的 Greengrass 组件,您无需指定此参数。

默认值:/greengrass/v2/logs

logFileRegex

(可选)指定组件或应用程序使用的日志文件名格式的正则表达式。日志管理器组件使用此正则表达式来识别位于的文件夹中的日志文件logFileDirectoryPath

对于打印到标准输出 (stdout) 和标准错误 (stderr) 的 Greengrass 组件,您无需指定此参数。

如果您的组件或应用程序轮换日志文件,请指定与旋转的日志文件名相匹配的正则表达式。例如,您可以指定hello_world\\w*.log上传 Hello World 应用程序的日志。该\\w*模式匹配零个或多个单词字符,其中包括字母数字字符和下划线。此正则表达式匹配名称中带有和不带时间戳的日志文件。在此示例中,日志管理器上传以下日志文件:

  • hello_world.log— Hello World 应用程序的最新日志文件。

  • hello_world_2020_12_15_17_0.log— Hello World 应用程序的较旧日志文件。

默认:componentName\\w*.log,其中 component Name 是此日志配置的组件的名称。

deleteLogFileAfterCloudUpload

(可选)在日志管理器组件将日志上传到日志后,您可以删除 CloudWatch 日志文件。

默认值:false

multiLineStartPattern

(可选)一个正则表达式,用于标识新行上的日志消息何时为新日志消息。如果正则表达式与新行不匹配,则日志管理器组件会将新行附加到上一行的日志消息中。

默认情况下,日志管理器组件检查该行是否以空格字符开头,例如制表符或空格。如果不是,日志管理器会将该行作为新的日志消息处理。否则,它会将该行附加到当前日志消息中。此行为可确保日志管理器组件不会拆分跨多行的消息,例如堆栈跟踪。

periodicUploadIntervalSec

(可选)日志管理器组件检查要上传的新日志文件的时间(以秒为单位)。

300(5)

例 示例:配置合并更新

以下示例配置指定将系统日志和com.example.HelloWorld组件日志上传到日 CloudWatch 志。

{ "logsUploaderConfiguration": { "systemLogsConfiguration": { "uploadToCloudWatch": "true", "minimumLogLevel": "INFO", "diskSpaceLimit": "10", "diskSpaceLimitUnit": "MB", "deleteLogFileAfterCloudUpload": "false" }, "componentLogsConfigurationMap": { "com.example.HelloWorld": { "minimumLogLevel": "INFO", "diskSpaceLimit": "20", "diskSpaceLimitUnit": "MB", "deleteLogFileAfterCloudUpload": "false" } } }, "periodicUploadIntervalSec": "300" }
v2.1.x
logsUploaderConfiguration

(可选)日志管理器组件上传的日志的配置。Cons():

systemLogsConfiguration

(可选)Amazon IoT Greengrass核心软件系统日志的配置,其中包括来自 Greengrass 核心插件组件的日志。指定此配置以启用日志管理器组件来管理系统日志。Cons():

uploadToCloudWatch

(可选)您可以将系统日志上传到 CloudWatch 日志。

默认值:false

minimumLogLevel

(可选)要上传的日志消息的最低级别。此最低级别仅在将 Greengrass nucleus 组件配置为输出 JSON 格式日志时适用。要启用 JSON 格式的日志JSON,请指定日志格式参数 (logging.format)。

从以下日志级别中选择,此处按级别顺序列出:

  • DEBUG

  • INFO

  • WARN

  • ERROR

默认值:INFO

diskSpaceLimit

(可选)Greengrass 系统日志文件的最大总大小,单位为您在中指定的单位diskSpaceLimitUnit。在 Greengrass 系统日志文件的总大小超过此最大总大小后,Amazon IoT GreengrassCore 软件会删除最旧的 Greengrass 系统日志文件。

此参数等同于 Greengrass 核分量的对数大小限制参数 (totalLogsSizeKB)。CAmazon IoT Greengrass ore 软件使用这两个值中的最小值作为 Greengrass 系统日志的最大总大小。

diskSpaceLimitUnit

(可选)的单位diskSpaceLimit。从以下选项中进行选择:

  • KB— 千字节

  • MB— 兆字节

  • GB— 千兆字节

默认值:KB

deleteLogFileAfterCloudUpload

(可选)在日志管理器组件将日志上传到日志后,您可以删除 CloudWatch 日志文件。

默认值:false

componentLogsConfiguration

(可选)核心设备上组件的日志配置列表。此列表中的每种配置都定义了组件或应用程序的日志配置。日志管理器组件将这些组件日志上传到 CloudWatch 日志

componentName

此日志配置的组件或应用程序的名称。您可以指定 Greengrass 组件的名称或其他值来标识此日志组。

minimumLogLevel

(可选)要上传的日志消息的最低级别。仅当此组件的日志使用特定的 JSON 格式时,此最低级别才适用,您可以在Amazon IoT Greengrass日志模块存储库中找到该格式 GitHub。

从以下日志级别中选择,此处按级别顺序列出:

  • DEBUG

  • INFO

  • WARN

  • ERROR

默认值:INFO

diskSpaceLimit

(可选)此组件所有日志文件的最大总大小,单位为您在中指定的单位diskSpaceLimitUnit。当此组件的日志文件总大小超过此最大总大小后,Amazon IoT GreengrassCore 软件会删除该组件最旧的日志文件。

此参数与 Greengrass 核分量的对数大小限制参数 (totalLogsSizeKB) 有关。CAmazon IoT Greengrass ore 软件使用这两个值中的最小值作为该组件的最大总日志大小。

diskSpaceLimitUnit

(可选)的单位diskSpaceLimit。从以下选项中进行选择:

  • KB— 千字节

  • MB— 兆字节

  • GB— 千兆字节

默认值:KB

logFileDirectoryPath

(可选)包含此组件日志文件的文件夹的路径。

对于打印到标准输出 (stdout) 和标准错误 (stderr) 的 Greengrass 组件,您无需指定此参数。

默认值:/greengrass/v2/logs

logFileRegex

(可选)指定组件或应用程序使用的日志文件名格式的正则表达式。日志管理器组件使用此正则表达式来识别位于的文件夹中的日志文件logFileDirectoryPath

对于打印到标准输出 (stdout) 和标准错误 (stderr) 的 Greengrass 组件,您无需指定此参数。

如果您的组件或应用程序轮换日志文件,请指定与旋转的日志文件名相匹配的正则表达式。例如,您可以指定hello_world\\w*.log上传 Hello World 应用程序的日志。该\\w*模式匹配零个或多个单词字符,其中包括字母数字字符和下划线。此正则表达式匹配名称中带有和不带时间戳的日志文件。在此示例中,日志管理器上传以下日志文件:

  • hello_world.log— Hello World 应用程序的最新日志文件。

  • hello_world_2020_12_15_17_0.log— Hello World 应用程序的较旧日志文件。

默认:componentName\\w*.log,其中 component Name 是此日志配置的组件的名称。

deleteLogFileAfterCloudUpload

(可选)在日志管理器组件将日志上传到日志后,您可以删除 CloudWatch 日志文件。

默认值:false

multiLineStartPattern

(可选)一个正则表达式,用于标识新行上的日志消息何时为新日志消息。如果正则表达式与新行不匹配,则日志管理器组件会将新行附加到上一行的日志消息中。

默认情况下,日志管理器组件检查该行是否以空格字符开头,例如制表符或空格。如果不是,日志管理器会将该行作为新的日志消息处理。否则,它会将该行附加到当前日志消息中。此行为可确保日志管理器组件不会拆分跨多行的消息,例如堆栈跟踪。

periodicUploadIntervalSec

(可选)日志管理器组件检查要上传的新日志文件的时间(以秒为单位)。

300(5)

例 示例:配置合并更新

以下示例配置指定将系统日志和com.example.HelloWorld组件日志上传到日 CloudWatch 志。

{ "logsUploaderConfiguration": { "systemLogsConfiguration": { "uploadToCloudWatch": "true", "minimumLogLevel": "INFO", "diskSpaceLimit": "10", "diskSpaceLimitUnit": "MB", "deleteLogFileAfterCloudUpload": "false" }, "componentLogsConfiguration": [ { "componentName": "com.example.HelloWorld", "minimumLogLevel": "INFO", "diskSpaceLimit": "20", "diskSpaceLimitUnit": "MB", "deleteLogFileAfterCloudUpload": "false" } ] }, "periodicUploadIntervalSec": "300" }
v2.0.x
logsUploaderConfiguration

(可选)日志管理器组件上传的日志的配置。Cons():

systemLogsConfiguration

(可选)Amazon IoT Greengrass核心软件系统日志的配置。指定此配置以启用日志管理器组件来管理系统日志。Cons():

uploadToCloudWatch

(可选)您可以将系统日志上传到 CloudWatch 日志。

默认值:false

minimumLogLevel

(可选)要上传的日志消息的最低级别。此最低级别仅在将 Greengrass nucleus 组件配置为输出 JSON 格式日志时适用。要启用 JSON 格式的日志JSON,请指定日志格式参数 (logging.format)。

从以下日志级别中选择,此处按级别顺序列出:

  • DEBUG

  • INFO

  • WARN

  • ERROR

默认值:INFO

diskSpaceLimit

(可选)Greengrass 系统日志文件的最大总大小,单位为您在中指定的单位diskSpaceLimitUnit。在 Greengrass 系统日志文件的总大小超过此最大总大小后,Amazon IoT GreengrassCore 软件会删除最旧的 Greengrass 系统日志文件。

此参数等同于 Greengrass 核分量的对数大小限制参数 (totalLogsSizeKB)。CAmazon IoT Greengrass ore 软件使用这两个值中的最小值作为 Greengrass 系统日志的最大总大小。

diskSpaceLimitUnit

(可选)的单位diskSpaceLimit。从以下选项中进行选择:

  • KB— 千字节

  • MB— 兆字节

  • GB— 千兆字节

默认值:KB

deleteLogFileAfterCloudUpload

(可选)在日志管理器组件将日志上传到日志后,您可以删除 CloudWatch 日志文件。

默认值:false

componentLogsConfiguration

(可选)核心设备上组件的日志配置列表。此列表中的每种配置都定义了组件或应用程序的日志配置。日志管理器组件将这些组件日志上传到 CloudWatch 日志

componentName

此日志配置的组件或应用程序的名称。您可以指定 Greengrass 组件的名称或其他值来标识此日志组。

minimumLogLevel

(可选)要上传的日志消息的最低级别。仅当此组件的日志使用特定的 JSON 格式时,此最低级别才适用,您可以在Amazon IoT Greengrass日志模块存储库中找到该格式 GitHub。

从以下日志级别中选择,此处按级别顺序列出:

  • DEBUG

  • INFO

  • WARN

  • ERROR

默认值:INFO

diskSpaceLimit

(可选)此组件所有日志文件的最大总大小,单位为您在中指定的单位diskSpaceLimitUnit。当此组件的日志文件总大小超过此最大总大小后,Amazon IoT GreengrassCore 软件会删除该组件最旧的日志文件。

此参数与 Greengrass 核分量的对数大小限制参数 (totalLogsSizeKB) 有关。CAmazon IoT Greengrass ore 软件使用这两个值中的最小值作为该组件的最大总日志大小。

diskSpaceLimitUnit

(可选)的单位diskSpaceLimit。从以下选项中进行选择:

  • KB— 千字节

  • MB— 兆字节

  • GB— 千兆字节

默认值:KB

logFileDirectoryPath

包含此组件日志文件的文件夹的路径。

要上传 Greengrass 组件的日志,请指定/greengrass/v2/logs并将 /greengrass/v2 替换为 Greengrass 根文件夹。

logFileRegex

一个正则表达式,用于指定组件或应用程序使用的日志文件名格式。日志管理器组件使用此正则表达式来识别位于的文件夹中的日志文件logFileDirectoryPath

要上传 Greengrass 组件的日志,请指定与旋转的日志文件名相匹配的正则表达式。例如,您可以指定com.example.HelloWorld\\w*.log上传 Hello World 组件的日志。该\\w*模式匹配零个或多个单词字符,其中包括字母数字字符和下划线。此正则表达式匹配名称中带有和不带时间戳的日志文件。在此示例中,日志管理器上传以下日志文件:

  • com.example.HelloWorld.log— Hello World 组件的最新日志文件。

  • com.example.HelloWorld_2020_12_15_17_0.log— Hello World 组件的较旧日志文件。Greengrass 核心为日志文件添加了旋转时间戳。

deleteLogFileAfterCloudUpload

(可选)在日志管理器组件将日志上传到日志后,您可以删除 CloudWatch 日志文件。

默认值:false

multiLineStartPattern

(可选)一个正则表达式,用于标识新行上的日志消息何时为新日志消息。如果正则表达式与新行不匹配,则日志管理器组件会将新行附加到上一行的日志消息中。

默认情况下,日志管理器组件检查该行是否以空格字符开头,例如制表符或空格。如果不是,日志管理器会将该行作为新的日志消息处理。否则,它会将该行附加到当前日志消息中。此行为可确保日志管理器组件不会拆分跨多行的消息,例如堆栈跟踪。

periodicUploadIntervalSec

(可选)日志管理器组件检查要上传的新日志文件的时间(以秒为单位)。

300(5)

例 示例:配置合并更新

以下示例配置指定将系统日志和com.example.HelloWorld组件日志上传到日 CloudWatch 志。

{ "logsUploaderConfiguration": { "systemLogsConfiguration": { "uploadToCloudWatch": "true", "minimumLogLevel": "INFO", "diskSpaceLimit": "10", "diskSpaceLimitUnit": "MB", "deleteLogFileAfterCloudUpload": "false" }, "componentLogsConfiguration": [ { "componentName": "com.example.HelloWorld", "minimumLogLevel": "INFO", "logFileDirectoryPath": "/greengrass/v2/logs", "logFileRegex": "com.example.HelloWorld\\w*.log", "diskSpaceLimit": "20", "diskSpaceLimitUnit": "MB", "deleteLogFileAfterCloudUpload": "false" } ] }, "periodicUploadIntervalSec": "300" }

用量

日志管理器组件上传到以下日志组和日志流。

2.1.0 and later
日志组名称
/aws/greengrass/componentType/region/componentName

日志组名称使用以下变量:

  • componentType—():

    • GreengrassSystemComponent— 该成分是 Greengrass 核的一部分。该日志组包括插件组件的日志,这些组件与 Greengrass 核心在同一 JVM 中运行。

    • UserComponent—,Greengras()。此日志组包括通用组件、Lambda 组件和设备上其他应用程序的日志。

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

  • region— 核心设备使用的Amazon区域。

  • componentName— 组件的名称。对于系统日志,此值为System

日志流名称
/date/thing/thingName

日志流名称使用以下变量:

  • date— 日志的日期,例如2020/12/15。日志管理器组件使用该yyyy/MM/dd格式。

  • thingName— 核心设备的名称。

注意

如果事物名称包含冒号 (:),则日志管理器将用加号 (+) 替换冒号。

2.0.x
日志组名称
/aws/greengrass/componentType/region/componentName

日志组名称使用以下变量:

  • componentType—():

    • GreengrassSystemComponent— 该成分是 Greengrass 核的一部分。

    • UserComponent—,Greengras()。日志管理器将这种类型用于设备上的 Greengrass 组件和其他应用程序。

  • region— 核心设备使用的Amazon区域。

  • componentName— 组件的名称。对于系统日志,此值为System

日志流名称
/date/deploymentTargets/thingName

日志流名称使用以下变量:

  • date— 日志的日期,例如2020/12/15。日志管理器组件使用该yyyy/MM/dd格式。

  • deploymentTargets— 部署中包含组件的内容。日志管理器组件用斜线分隔每个目标。如果组件在本地部署后在核心设备上运行,则此值为LOCAL_DEPLOYMENT

    举一个例子,你有一个名为的核心设备MyGreengrassCore,核心设备有两个部署:

    • 以核心设备为目标的部署MyGreengrassCore

    • 以名为的事物组为目标的部署MyGreengrassCoreGroup,该事物组包含核心设备。

    该核心设备的deploymentTargets用法是thing/MyGreengrassCore/thinggroup/MyGreengrassCoreGroup

  • thingName— 核心设备的名称。

此组件使用与 Greengrass 核心组件相同的日志文件。

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

查看此组件的日志

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

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

更改日志

Cons()。

Version

更改

2.2.7

Greengrass 2.8.0

2.2.6

Greengrass 2.7.0。

2.2.5

Greengrass 2.6.0

2.2.4

  • 提高了处理无效配置时的稳定性。

2.2.3

  • 提高了组件重启或遇到错误的某些情况下的稳定性。

  • 修复了在某些情况下无法上传大型日志消息和大型日志文件的问题。

  • 修复了此组件如何处理配置重置更新的问题。

  • 修复了nulldiskSpaceLimit配置值阻止组件部署的问题。

2.2.2

  • 增加了对大于 256 千字节的日志消息的支持。日志管理器组件将这些大型日志消息拆分为具有相同日志事件时间戳的多条消息。

2.2.1

Greengrass 2.5.0

2.2.0

新功能
  • 添加componentLogsConfigurationMap配置参数以支持组件日志配置的映射格式。映射中的每个componentName对象都定义了组件或应用程序的日志配置。

2.1.3

Greengrass 2.4.0。

2.1.2

Greengrass 2.3.0。

2.1.1

  • 修复了在某些情况下系统日志配置未更新的问题。

2.1.0

  • 对打印到标准输出 (stdout)logFileDirectoryPathlogFileRegex标准错误 (stderr) 的 Greengrass 组件使用默认值,这些组件适用于 Greengrass 组件。

  • 将日志上传到 CloudWatch 日志时,通过配置的网络代理正确路由流量。

  • 正确处理日志流名称中的冒号字符 (:)。 CloudWatch 日志日志流名称不支持冒号。

  • 通过从日志流中移除事物组名称来简化日志流名称。

  • 删除在正常行为期间打印的错误日志消息。

2.0.x

初始版本。