AWS IoT ログ記録を設定する

1. [Select trusted entity] (信頼されたエンティティを選択) で、[AWS Service] (AWS サービス) を選択します。次に、[Use case] (ユースケース) で [IoT] を選択します。[IoT] が表示されない場合は、[他の AWS サービスのユースケース] ドロップダウンメニューで [IoT] と入力して検索してください。[次へ] を選択してください。

2. [Add permissions] (権限の追加) ページでは、サービスロールに自動的に付加されるポリシーが表示されます。[次へ] を選択します。

3. [Name, review, and create] (名前、確認、作成) ページで、ロールの [Role name] (ロール名) と [Role description] (ロールの説明) を入力し、次に [Create role] (ロールの作成) を選択します。

4. [Roles] (ロール) のリストで、作成したロールを見つけて開き、AWS IoT でデフォルトのログ記録を設定する (コンソール) をするときに使用する [Role ARN] (ロール ARN) (logging-role-arn) をコピーします。

AWS IoT コンソールを使用してすべての のデフォルトログ記録を設定するには AWS IoT

1. AWS IoT コンソールにサインインします。詳細については、「AWS IoT コンソールを開く」を参照してください。

2. 左のナビゲーションペインの [設定] を選択します。[Settings] (設定) ページの [Logs] (ログ) セクションで、[Manage logs] (ログの管理) を選択します。

   [ログ] ページには、すべての AWS IoTで使用されるログ記録ロールと詳細レベルが表示されます。

   

3. [Logs] (ログ) ページで、[Select role] (ログの選択) を選択し、ログ記録ロールの作成 で作成したロールを指定するか、[Create Role] (ロールの作成) を選択してログ記録に使用するロールを作成します。

   

4. [Log level] (ログレベル) を選択し、CloudWatch のログに表示するログエントリの詳細レベルを指定します。

5. [更新] を選択して変更を保存します。

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

   CloudWatch Logs のログに書き込むアクセス AWS IoT 許可を付与するロール ARN。

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

   CloudWatch Logs のログに書き込むアクセス AWS IoT 許可を付与するロール ARN。

   --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。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

   ログ記録レベルを削除するモノグループの名前。