設定 AWS IoT 記錄

1. 在 Select trusted entity (選取信任的實體) 下，選取 AWS service (服務)。然後在 Use case (使用案例) 下選擇 IoT。如果未顯示 IoT，請從 Use cases for other AWS services: (其他 服務的使用案例：) 下拉式清單中輸入並搜尋 IoT。選取下一步。

2. 在 Add permissions (新增許可) 頁面上，您會看到自動連接到服務角色的政策。選擇 Next (下一步)。

3. 在 Name, review, and create (命名、檢閱和建立) 頁面上，輸入角色的 Role name (角色名稱) 和 Role description (角色描述)，然後選擇 Create role (建立角色)。

4. 在角色 清單中，尋找您建立的角色、開啟角色，然後複製角色 ARN （logging-role-arn） 用於 在 AWS IoT (主控台) 中設定預設記錄。

若要使用 AWS IoT 主控台來設定所有 的預設記錄 AWS IoT

1. 登入 AWS IoT 主控台。如需詳細資訊，請參閱開啟 AWS IoT 主控台。

2. 在左側的導覽窗格中，選擇設定。在 Settings (設定) 頁面的 Logs (記錄) 區段中，選擇 Manage logs (管理日誌)。

   Logs (日誌) 頁面會顯示所有 AWS IoT使用的記錄日誌角色和詳細資訊層級。

   

3. 在 Logs (日誌) 頁面，選擇 Select role (選取角色) 以指定您先前建立於 建立記錄角色 的角色，或選擇 Create Role (建立角色) 以建立一個用於記錄的角色。

   

4. 選擇描述您要出現在日誌中日誌項目詳細資訊層級的 CloudWatch 日誌層級。

5. 選擇 Update (更新) 以儲存您的設定。

使用 CLI設定 的預設記錄 AWS IoT

1. 請使用 set-v2-logging-options 命令來設定您的帳戶的記錄選項。

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

   其中：

   --role-arn

   此角色ARN授予 AWS IoT 許可，以寫入 Logs 中的 CloudWatch 日誌。

   --default-log-level

   欲使用的日誌層級。有效值為 ERROR、WARN、INFO、DEBUG 或 DISABLED。

   --no-disable-all-logs

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

   --disable-all-logs

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

2. 使用 get-v2-logging-options 命令取得目前的記錄選項。

   aws iot get-v2-logging-options

使用 CLI來設定 的資源特定記錄 AWS IoT

1. 請使用 set-v2-logging-options 命令來設定您的帳戶的記錄選項。

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

   其中：

   --role-arn

   此角色ARN授予 AWS IoT 許可，以寫入 Logs 中的 CloudWatch 日誌。

   --default-log-level

   欲使用的日誌層級。有效值為 ERROR、WARN、INFO、DEBUG 或 DISABLED。

   --no-disable-all-logs

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

   --disable-all-logs

   選用參數，可停用所有 AWS 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。日誌目標參數值可以是文字，如上一個命令範例所示，也可以是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

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