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

# 在设备上安装 AWS IoT Greengrass 日志管理器组件
<a name="gs-publish-edge"></a>

**注意**  
注意配[CloudWatch额](https://docs.aws.amazon.com//AmazonCloudWatch/latest/logs/cloudwatch_limits_cwl.html)。

按照以下步骤将 Amazon Kinesis Video Streams Video Streams Edge Agent 日志配置 CloudWatch 为使用日志管理器 AWS IoT Greengrass 组件自动上传到。此为可选步骤。

**安装 AWS IoT Greengrass 日志管理器组件**

1. 确认 AWS IoT Greengrass 设备角色具有[相应的权限](https://docs.aws.amazon.com//greengrass/v2/developerguide/log-manager-component.html#log-manager-component-requirements)。

   1. 登录 AWS 管理控制台 并打开 IAM 控制台，网址为[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)。

   1. 在左侧导航栏中单击 “**角色**”。

   1. 选择在中创建的 TES 角色的名称[在设备上设置 AWS IoT Greengrass V2 核心设备](gs-setup-gg.md)。如有必要，请使用搜索栏。

   1. 选择 `GreengrassV2TokenExchangeRoleAccess` 策略。

   1. 选择 JSON 选项卡并验证策略是否如下所示：

------
#### [ JSON ]

****  

      ```
      {
          "Version":"2012-10-17",		 	 	 
          "Statement": [
              {
                  "Effect": "Allow",
                  "Action": [
                      "logs:CreateLogGroup",
                      "logs:CreateLogStream",
                      "logs:PutLogEvents",
                      "logs:DescribeLogStreams",
                      "s3:GetBucketLocation"
                  ],
                  "Resource": "*"
              }
          ]
      }
      ```

------

   1. 如果该`GreengrassV2TokenExchangeRoleAccess`策略不存在，或者缺少某些必需的权限，请使用这些权限创建一个新的 IAM 策略，并将其附加到中创建的 TES 角色[在设备上设置 AWS IoT Greengrass V2 核心设备](gs-setup-gg.md)。

1. 登录 AWS 管理控制台 并打开 AWS IoT Core 控制台，网址为[https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/)。确认选择了相应的区域。

1. **在左侧导航栏中，选择 **Greengrass** 设备，然后选择 “部署”。**

   选择与您在中创建的目标相同的部署[在设备上设置 AWS IoT Greengrass V2 核心设备](gs-setup-gg.md)。

1. 在右上角选择**操作**，然后选择**修订**。

   在出现的弹出窗口中，选择**修订部署**。

1. 完成以下各节：

   1. **步骤 1：指定目标。**选择**下一步**。

   1. **步骤 2：选择组件。**

      1. **验证 aws.greenGrass.cli 组件和 **aws.greengras** s。 SecretManager**组件仍处于选中状态。
**重要**  
不要卸载这些组件。

      1. 切换 “**仅显示选定的组件”** 开关并搜索 **aws.greengrass。 LogManager**。

      1. 选中 **aws.greengrass 旁边的复选框。 LogManager**，然后选择 “**下一步**”。

   1. **步骤 3：配置组件。**配置 AWS IoT Greengrass 日志管理器组件以上传由 Amazon Kinesis Video Streams Edge Agent 生成的日志。

      选择 **aws.greengrass。 LogManager**组件，然后选择**配置组件**。

      在出现的屏幕中，将以下日志管理器配置粘贴**到要合并的配置**框中。

      ```
      {
          "logsUploaderConfiguration": {
              "componentLogsConfigurationMap": {
                  "aws.kinesisvideo.KvsEdgeComponent/java_kvs.log": {
                      "diskSpaceLimit": "100",
                      "diskSpaceLimitUnit": "MB",
                      "logFileDirectoryPath": "/greengrass/v2/work/aws.kinesisvideo.KvsEdgeComponent/log",
                      "logFileRegex": "java_kvs.log\\w*"
                  },
                  "aws.kinesisvideo.KvsEdgeComponent/cpp_kvs_edge.log": {
                      "diskSpaceLimit": "100",
                      "diskSpaceLimitUnit": "MB",
                      "logFileDirectoryPath": "/greengrass/v2/work/aws.kinesisvideo.KvsEdgeComponent/log",
                      "logFileRegex": "cpp_kvs_edge.log\\w*"
                  },
                  "aws.kinesisvideo.KvsEdgeComponent/cpp_kvssink.log": {
                      "diskSpaceLimit": "100",
                      "diskSpaceLimitUnit": "MB",
                      "logFileDirectoryPath": "/greengrass/v2/work/aws.kinesisvideo.KvsEdgeComponent/log",
                      "logFileRegex": "cpp_kvssink.log\\w*"
                  },
                  "aws.kinesisvideo.KvsEdgeComponent/cpp_kvs_streams.log": {
                      "diskSpaceLimit": "100",
                      "diskSpaceLimitUnit": "MB",
                      "logFileDirectoryPath": "/greengrass/v2/work/aws.kinesisvideo.KvsEdgeComponent/log",
                      "logFileRegex": "cpp_kvs_streams.log\\w*"
                  }
              }
          },
          "periodicUploadIntervalSec": "1"
      }
      ```
**重要**  
上述配置`logFileDirectoryPath`中的假设使用了默认的日志输出位置。
**注意**  
有关日志管理器配置的每个参数的更多信息，请参阅《 AWS IoT Greengrass Version 2 开发人员指南》的 “[日志管理器](https://docs.aws.amazon.com//greengrass/v2/developerguide/log-manager-component.html#log-manager-component-configuration)” 部分。

      完成后，选择 “**确认**”，然后选择 “**下一步**”。

   1. **步骤 4：配置高级设置。**选择**下一步**。

   1. **第 5 步：查看。**选择**部署**。

1. 确认 AWS 日志管理器组件和权限已正确安装。

1. 在 Ubuntu Amazon EC2 实例上，键入`sudo /greengrass/v2/bin/greengrass-cli component details --name aws.greengrass.LogManager`以验证组件已收到更新的配置。

1. 检查 AWS IoT Greengrass 核心日志。

   键入。`sudo less /greengrass/v2/logs/greengrass.log`

   查看是否存在部署错误。

   如果出现错误，请修改部署以删除该`aws.greengrass.LogManager`组件。

   键入`sudo service greengrass restart`以重新启动 AWS IoT Greengrass 核心服务。

   如果部署错误与缺少权限有关，请查看[为令牌交换服务 (TES) 角色添加权限](gs-add-permissions.md)以确保 TES 角色具有适当的权限。然后，重复本节。