配置 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. 选择与要在日志中显示的日志条目的详细https://docs.amazonaws.cn/iot/latest/developerguide/configure-logging.html#log-level级别相对应的默认 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

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

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