配置 Amazon IoT 日志记录

1. 在 Select trusted entity（选择受信任的实体）下，选择 Amazon Service（Amazon 服务）。然后在 Use case（用例）下，选择 IoT。如果您看不到 IoT，请在 Use cases for other Amazon services:（其他 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 (设置)。在 Settings（设置）页面的 Logs（日志）部分中，选择 Manage logs（管理日志）。

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

   

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

   

4. 选择 Log le vel（详细程度级别），该级别能够描述要显示在日志中的 CloudWatch 日志条目的详细信息级别。

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

使用 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

   向授予在 Logs 中写入日志的Amazon IoT权限的 CloudWatch 角色 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

   向授予在 Logs 中写入日志的Amazon IoT权限的 CloudWatch 角色 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

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