配置AWS IoT日志

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

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

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

要配置AWS IoT记录，请执行以下操作：

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

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

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

   1. 在 “账户级日志记录” 下，选择 “管理账户级日志记录” 以进行更新。

   2. 选择 “启用日志记录” 复选框以开始向其发送日志 CloudWatch。如果未选中 “启用日志记录”，则无论事件级别或资源级别的日志记录配置如何，都AWS IoT不会向 CloudWatch 日志组发送任何日志。

   3. 在 IAM 日志角色下，从下拉列表中选择一个现有角色。您可以查看角色详细信息以检查角色权限。或者，选择创建新角色来设置新的 IAM 角色。日志角色提供的策略允许代表您AWS IoT向提交日志条目。 CloudWatch 如果您使用自定义日志组配置事件级 CloudWatch 日志记录，则必须更新角色策略以包含该日志组的 ARN。

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

   5. 选择 “更新日志记录” 以保存您的更改。

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

   配置事件级别的日志记录：事件级别的日志记录会捕获特定AWS IoT事件，例如客户端身份验证尝试。这些设置会覆盖账户级别的日志记录。

   1. 在 “事件级日志记录” 部分下，选择 “管理事件级日志记录” 以进行更新。

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

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

   4. 单击 “更新日志” 以应用您的更改，或者选择 “取消” 放弃。

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

   1. 在 “特定于资源的替代” 部分中，选择 “添加特定于资源的替代”。

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

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

   4. 从 “特定于资源的日志级别” 部分的下拉菜单中选择所需的日志级别。

   5. 单击 “提交” 添加改写，或单击 “取消” 放弃更改。

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

使用 CLI 配置默认日志记录 AWS 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

   授予在日志中写入日志AWS IoT权限的角色 ARN。 CloudWatch 初始设置需要角色ARN配置。

   --default-log-level

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

   --no-disable-all-logs

   一个可选参数，用于启用所有AWS IoT日志记录。使用此参数可在当前禁用日志记录时启用日志记录。

   --disable-all-logs

   一个可选参数，用于禁用所有AWS IoT日志记录。使用此参数可在当前启用日志记录时禁用日志记录。

   --event-configurations

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

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

   • LogLevel：使用 “调试”、“信息”、“错误”、“警告” 或 “已禁用” 来覆盖账户级别的设置

   • LogDestination：为 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

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

使用 CLI 为以下各项配置特定于资源的替代 AWS IoT

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

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

   您要配置日志记录的资源的类型和名称。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

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