AWS IoT Greengrass Version 1在 2023 年 6 月 30 日之前，将不再接收功能更新，并且将仅收到安全补丁和错误修复。有关更多信息，请参阅AWS IoT Greengrass V1维护政策。我们强烈建议您迁移到AWS IoT Greengrass Version 2，这增加了重要的新功能并支持其他平台。

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

利用 AWS IoT Greengrass 日志进行监控

AWS IoT Greengrass 由云服务和 AWS IoT Greengrass 核心软件组成。这些区域有：AWS IoT Greengrass核心软件可以将日志写入亚马逊 CloudWatch 以及核心设备的本地文件系统。在核心上运行的 Lambda 函数和连接器也可以将日志写入 CloudWatch 日志和本地文件系统。您可以使用日志来监控事件和排查问题。所有 AWS IoT Greengrass 日志条目包含时间戳、日志级别和事件相关信息。对日志记录设置所做的更改在部署组后生效。

在组级别配置日志记录。有关说明如何为 Greengrass 组配置日志记录的步骤，请参阅为 AWS IoT Greengrass 配置日志记录。

访问 CloudWatch 日志

如果你配置 CloudWatch 日志记录，则可在日志亚马逊的页面 CloudWatch 控制台。AWS IoT Greengrass 日志的日志组使用以下命名约定：

/aws/greengrass/GreengrassSystem/greengrass-system-component-name
/aws/greengrass/Lambda/aws-region/account-id/lambda-function-name

每个日志组包含的日志流使用以下命名约定：

date/account-id/greengrass-group-id/name-of-core-that-generated-log

在使用时，请注意以下几点 CloudWatch 日志：

访问文件系统日志

如果您配置文件系统日志记录，则日志文件存储在核心设备上的 greengrass-root/ggc/var/log 下。下面是高级别目录结构：

greengrass-root/ggc/var/log
    - crash.log
    - system
        - log files for each Greengrass system component
    - user
        - region
            - account-id
                - log files generated by each user-defined Lambda function
            - aws
                - log files generated by each connector

在使用文件系统日志时，请注意以下几点：

默认日志记录配置

如果未显式配置日志记录设置，AWS IoT Greengrass 将在第一个组部署后使用以下默认日志记录配置。

为 AWS IoT Greengrass 配置日志记录

您可以使用AWS IoT控制台或AWS IoT GreengrassAPI来配置AWS IoT Greengrass日志记录。

配置日志记录 (控制台)

您可以在组的 Settings (设置) 页面上配置日志记录。

配置日志记录 (API)

您可以使用 AWS IoT Greengrass 记录器 API 以编程方式配置日志记录。例如，使用 CreateLoggerDefinition 操作根据 LoggerDefinitionVersion 负载创建记录器定义，该定义使用以下语法：

{
  "Loggers": [
    {
      "Id": "string",
      "Type": "FileSystem|AWSCloudWatch",
      "Component": "GreengrassSystem|Lambda",
      "Level": "DEBUG|INFO|WARN|ERROR|FATAL",
      "Space": "integer"
    },
    {
      "Id": "string",
      ...
    }
  ]
}

LoggerDefinitionVersion 是一个或多个具有以下属性的 Logger 对象的数组：

配置示例

以下 LoggerDefinitionVersion 示例指定的日志记录配置可以：

{
  "Name": "LoggingExample",
  "InitialVersion": {
    "Loggers": [
      {
        "Id": "1",
        "Component": "GreengrassSystem",
        "Level": "ERROR",
        "Space": 10240,
        "Type": "FileSystem"
      },
      {
        "Id": "2",
        "Component": "Lambda",
        "Level": "INFO",
        "Space": 10240,
        "Type": "FileSystem"
      },
      {
        "Id": "3",
        "Component": "Lambda",
        "Level": "INFO",
        "Type": "AWSCloudWatch"
      }
    ]
  }
}

在创建日志记录器定义版本后，可以使用其版本 ARN 创建组版本，然后再部署组。

日志记录限制

AWS IoT Greengrass 具有以下日志记录限制。

每秒事务数

登录到时 CloudWatch 启用后，日志记录组件会在将事件发送到之前在本地批量记录事件 CloudWatch，使您能够以高于每个日志流每秒 5 个请求的速度进行日志记录。

内存

如果AWS IoT Greengrass配置为将日志发送到 CloudWatch 并且 Lambda 函数在很长一段时间以超过 5 MB/秒的速度进行日志记录，则内部处理管道最终会填满。理论上，最差的情况为每个 Lambda 函数 6 MB。

时钟偏差

登录到时 CloudWatch 启用时，日志记录组件将签署对的请求 CloudWatch使用常规的签名版本 4 签名流程。如果系统时间在AWS IoT Greengrass核心设备不同步的速度进行日志记录15 分钟，则请求将被拒绝。

磁盘使用量

使用以下公式可计算用于日志记录的最大总磁盘使用量。

greengrass-system-component-space * 8    // 7 if automatic IP detection is disabled
  + 128KB                                // the internal log for the local logging component
  + lambda-space * lambda-count          // different versions of a Lambda function are treated as one

其中：

记录丢失

如果您的AWS IoT Greengrass核心设备配置为仅登录到 CloudWatch 并且没有 Internet 连接，您无法检索当前位于内存中的日志。

当 Lambda 函数终止时 (例如，在部署期间)，会有几秒钟的日志不被写入到 CloudWatch.

CloudTrail 圆木

AWS IoT Greengrass运行时长AWS CloudTrail，提供用户、角色或AWS服务于AWS IoT Greengrass. 有关更多信息，请参阅使用 AWS IoT Greengrass 记录 AWS CloudTrail API 调用。