配置 Amazon IoT 日志记录

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

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

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

4. 在角色列表中，找到您刚创建的角色，打开该角色，然后复制角色 ARN（logging-role-arn）以供稍后在 Amazon IoT（控制台）中配置默认日志记录使用。

使用 Amazon IoT 控制台为所有 Amazon IoT 配置默认日志记录

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

2. 在左侧导航窗格中，选择 设置。在 Settings（设置）页面的 Logs（日志）部分中，选择 Manage logs（管理日志）。

   Logs（日志）页面显示 Amazon IoT 使用的日志记录角色和详细程度级别。

   

3. 在日志页面上，选择选择角色以指定您在 创建日志记录角色 中创建的角色，或选择创建角色以创建用于日志记录的新角色。

   

4. 选择描述要显示在 CloudWatch 日志中的日志条目的 level of detail（详细级别）的 Log level（日志级别）。

5. 单击更新以保存您的更改。

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

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

   aws iot set-v2-logging-options \
       --role-arn logging-role-arn \
       --default-log-level log-level

   其中：

   --role-arn

   向 Amazon IoT 授予在 CloudWatch Logs 中写入日志的权限的角色 ARN。

   --default-log-level

   要使用的日志级别。有效值为：ERROR、WARN、INFO、DEBUG 或 DISABLED。

   --no-disable-all-logs

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

   --disable-all-logs

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

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

   aws iot get-v2-logging-options

使用 CLI 为 Amazon IoT 配置资源特定的日志记录

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

   aws iot set-v2-logging-options \
       --role-arn logging-role-arn \
       --default-log-level log-level

   其中：

   --role-arn

   向 Amazon IoT 授予在 CloudWatch Logs 中写入日志的权限的角色 ARN。

   --default-log-level

   要使用的日志级别。有效值为：ERROR、WARN、INFO、DEBUG 或 DISABLED。

   --no-disable-all-logs

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

   --disable-all-logs

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

2. 使用 set-v2-logging-level 命令为事物组配置资源特定的日志记录。

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

   --log-target

   您要配置日志记录的资源的类型和名称。target_type 值必须是下列项之一：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。

   aws iot set-v2-logging-level \ 
                 --log-target targetType=CLIENT_ID,targetName=ClientId1 \
                 --log-level DEBUG

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

   --targetType

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

   --targetName

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