AWS IoT Greengrass Version 1 2023 年 6 月 30 日进入延长寿命阶段。有关更多信息，请参阅 AWS IoT Greengrass V1 维护策略。在此日期之后，将 AWS IoT Greengrass V1 不会发布提供功能、增强功能、错误修复或安全补丁的更新。在上面运行的设备 AWS IoT Greengrass V1 不会中断，将继续运行并连接到云端。我们强烈建议您迁移到 AWS IoT Greengrass Version 2，这样可以添加重要的新功能并支持其他平台。

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

利用 AWS IoT Greengrass 日志进行监控

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

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

访问 CloudWatch 日志

如果您配置了 CloudWatch 日志记录，则可以在 Amazon 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 Greengrass API 配置 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，因此您可以以高于每个日志流每秒五个请求的速率进行记录。

内存

如果配置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 且没有互联网连接，则无法检索内存中当前的日志。

当 Lambda 函数终止时（例如，在部署期间），将不会写入几秒钟的日志。 CloudWatch

CloudTrail 日志

AWS IoT Greengrass 使用 AWS CloudTrail 运行，后者是在 AWS IoT Greengrass 中记录用户、角色或 AWS 服务所执行操作的服务。有关更多信息，请参阅 使用 AWS CloudTrail 记录 AWS IoT Greengrass API 调用。