配置 Amazon IoT 日志记录

1. 在选择受信任的实体下，选择 Amazon 服务。然后在使用案例下，选择 IoT。如果您看不到 IoT，请在其他 Amazon 服务的使用案例：下拉菜单中输入并搜索 IoT。选择下一步。

2. 在 Add permissions（添加权限）页面上，您将看到自动附加到服务角色的策略。选择下一步。

3. 在 Name, review, and create（命名、检查和创建）页面上，为此角色输入 Role name（角色名称）和 Role description（角色描述），然后选择 Create role（创建角色）。

进行配置 Amazon IoT 记录：

1. 登录 Amazon IoT 控制台。有关更多信息，请参阅 打开 Amazon IoT 控制台。

2. 在左侧导航窗格中，选择 日志 （以前是 “设置” 下的部分）。

3. 配置账户级别日志：账户级别日志记录适用于您的所有 Amazon IoT 队列（设备或终端节点），除非被事件级别或资源特定设置所覆盖。

   1. 在下面 Account-level 登录，选择 管理账户级别的日志 进行更新。

   2. 选择 “启用日志记录” 复选框以开始将日志发送到 CloudWatch。当未选中 “启用日志记录” 时， Amazon IoT 不会将任何日志发送到 CloudWatch 日志组，无论事件级别或资源级别的日志配置如何。

   3. 在下面 IAM 日志角色，从下拉列表中选择现有角色。你可以 查看角色详情 检查角色权限。或者，选择 创建新角色 设置新的 IAM 角色。日志角色提供的策略允许 Amazon IoT 将日志条目提交到 CloudWatch 以你的名义。如果您使用自定义配置事件级日志记录 CloudWatch 日志组，必须更新角色策略以包括该日志组的 ARN。

   4. 选择 默认日志级别 它对应于 细节级别 您要显示的日志条目中的条目 CloudWatch 日志。注意：日志级别 “DEBUG” 提供了最多的细节，但会增加 CloudWatch 成本。 CloudWatch 无法在账户级别配置日志组目标。但是，您可以为单个事件类型指定自定义日志组，如下一节所述。

   5. 选择 更新日志 保存您的更改。

4. Event-level 日志记录允许您有选择地捕获相关事件的日志，并将其定向到专用 CloudWatch 日志组。这使您可以灵活地按用例整理日志，以提高可发现性，与不同的受众共享并减少 CloudWatch 通过启用日志和根据事件严重程度设置日志级别来降低成本。

   配置 事件级日志: 事件级日志记录捕获特定信息 Amazon IoT 事件，例如客户端身份验证尝试。这些设置会覆盖 Account-Level 记录。

   1. 在下面 Event-level 记录 部分，选择 管理事件级日志 进行更新。

   2. 默认情况下，事件类型继承账户级别的日志配置。注意：配置特定资源的日志记录时，它会覆盖账户和事件级别的设置。

   3. 要修改单个事件的设置，请单击相应事件行中的值。您可以调整日志级别和 CloudWatch 日志组目标。指定自定义时 CloudWatch 日志组目标，您必须验证 IAM 角色策略是否包含新日志组的权限。未能更新角色策略将阻止 Amazon IoT 从写入日志到自定义日志组。做出选择后，点击复选标记以确认您的选择。这个 '已修改' 列将显示 “是” 以表示待处理的更改。

   4. 点击 更新日志 应用您的更改或选择 取消 丢弃。

5. 配置 Resource-specific 覆盖： Resource-specific 覆盖将日志设置应用于所选资源。资源可以是事物组、来源 IP、客户端 ID 或主体 ID。 Resource-specific 日志配置会覆盖账户级别和事件级别的设置。启用后，它将在为指定资源配置的日志记录级别上为所有事件类型生成日志。例如，您可以为特定事物设置调试级别的日志记录，同时为所有其他事物保留信息级别的日志记录。

   1. 选择 添加特定资源的替代 在 Resource-specific 覆盖部分。

   2. 选择日志目标：事物组、源 IP、客户端 ID 或主体 ID。

   3. 为所选目标类型输入相应的日志目标值。

   4. 从的下拉菜单中选择所需的日志级别 Resource-specific 日志级别部分。

   5. 点击 提交 添加替代项或 取消 丢弃更改。

   6. 要修改现有的特定资源覆盖，请选中该资源旁边的复选框，然后单击 “移除” 以删除该替代或单击 “编辑” 进行修改。

使用 CLI 为配置默认日志 Amazon IoT

1. 使用 set-v2-logging-options 命令为您的账户设置日志记录选项。

   aws iot set-v2-logging-options \
       --event-configurations event-configuration-list \
       --role-arn logging-role-arn \
       --default-log-level log-level

   其中：

   --role-arn

   授予的角色 ARN Amazon IoT 写入您的登录信息的权限 CloudWatch 日志。 Role-arn 初始设置需要配置。

   --default-log-level

   要使用的日志级别。有效值为： ERROR， WARN， INFO， DEBUG，或 DISABLED。 Default-log-level 初始设置需要配置。

   --no-disable-all-logs

   启用所有功能的可选参数 Amazon IoT 记录。使用此参数可在当前禁用日志记录时启用日志记录。

   --disable-all-logs

   禁用所有功能的可选参数 Amazon IoT 记录。使用此参数可在当前启用日志记录时禁用日志记录。

   --event-configurations

   此参数是可选的，允许您为单个事件类型自定义日志记录设置：

   • EventType：覆盖账户级别设置的事件类型

   • LogLevel：使用 DEBUG、INFO、ERROR、WARN 或 DISABLED 覆盖账户级别设置

   • 日志目标：指定自定义 CloudWatch 用于传输日志的日志组

   您可以为每种事件类型单独配置日志记录级别和日志目的地。如果未指定，则事件将继承账户级别的设置

   aws iot set-v2-logging-options \
       --event-configurations "[{\"eventType\":\"Publish-In\",\"logLevel\":\"INFO\",\"logDestination\":\"examplePublishInLogGroup\"}]"

2. 使用 get-v2-logging-options 命令获取当前日志记录选项。

   aws iot get-v2-logging-options \
       --verbose

   其中：

   --verbose

   一个可选参数，使您能够检索所有事件类型及其配置。

使用 CLI 进行配置 Resource-specific 的覆盖 Amazon IoT

1. 在使用以下命令配置特定资源日志记录之前，启用账户级日志记录：aws iot set-v2-logging-options 命令

2. 使用 set-v2-logging-level 要配置的命令 Resource-specific 覆盖。有关事物组配置的示例，请参见以下示例：

   aws iot set-v2-logging-level \
                 --log-target targetType=THING_GROUP,targetName=thing_group_name \
                 --log-level log_level

   --log-target

   您要配置日志记录的资源的类型和名称。targetType 值必须是下列项之一：THING_GROUP | CLIENT_ID | SOURCE_IP | PRINCIPAL_ID。log-target 参数值可以是文本（如前面的命令示例所示），也可以是 JSON 字符串，如以下示例所示。

   aws iot set-v2-logging-level \
                 --log-target '{"targetType": "THING_GROUP","targetName": "thing_group_name"}' \
                 --log-level log_level

   --log-level

   为指定资源生成日志时使用的日志记录级别。有效值为：DEBUG、INFO、ERROR、WARN 和 DISABLED。

3. 使用 list-v2-logging-levels 命令列出当前配置的日志记录级别。

   aws iot list-v2-logging-levels

4. 使用 delete-v2-logging-level 命令删除资源特定的日志记录级别，比如下面的例子。

   aws iot delete-v2-logging-level \
                 --target-type "THING_GROUP" \
                 --target-name "thing_group_name"

   aws iot delete-v2-logging-level \
                 --target-type=CLIENT_ID 
                 --target-name=ClientId1

   --target-type

   target-type 值必须是下列项之一：THING_GROUP | CLIENT_ID | SOURCE_IP | PRINCIPAL_ID。

   --target-name

   要删除日志记录级别的事物组的名称。