設定 AWS IoT 記錄

1. 在 Select trusted entity (選取信任的實體) 下，選取 AWS service (服務)。然後在 Use case (使用案例) 下選擇 IoT。如果未顯示 IoT，請從 Use cases for other AWS services: (其他 服務的使用案例：) 下拉式清單中輸入並搜尋 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 Logs 中日誌項目詳細資訊層級的預設日誌層級。注意：日誌層級「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

   角色 ARN，授予在 CloudWatch Logs 中寫入日誌的 AWS IoT 許可。初始設定需要 Role-arn 組態。

   --default-log-level

   欲使用的日誌層級。有效值為：ERROR、WARN、DEBUG、 INFO或 DISABLED。初始設定需要Default-log-level組態。

   --no-disable-all-logs

   啟用所有 AWS IoT 記錄的選用參數。使用此參數可在目前該參數停用時啟用記錄功能。

   --disable-all-logs

   選用參數，可停用所有 AWS IoT 記錄。使用此參數可在該參數目前啟用時停用記錄功能。

   --event-configurations

   此參數是選用的，可讓您自訂個別事件類型的記錄設定：

   • eventType：覆寫帳戶層級設定的事件類型

   • logLevel：使用 DEBUG、INFO、 ERROR、WARN 或 DISABLED 覆寫帳戶層級設定

   • 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

   選用參數，可讓您擷取所有 eventTypes 及其組態。

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

   要移除日誌層級之物件群組的名稱。