AWS IoT ログ記録を設定する

1. [信頼されたエンティティを選択] で、[AWS サービス] を選択します。次に、[Use case] (ユースケース) で [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 ロールを設定します。ログ記録ロールは、 がユーザーに代わって CloudWatch AWS IoT にログエントリを送信できるようにするポリシーを提供します。カスタム CloudWatch ロググループを使用してイベントレベルのログ記録を設定する場合は、ロールポリシーを更新して、このロググループの ARN を含める必要があります。

   4. CloudWatch Logs に表示するログエントリの詳細レベルに対応するデフォルトのログレベルを選択します。 https://docs.aws.amazon.com/iot/latest/developerguide/configure-logging.html#log-level注: ログレベル「DEBUG」は最も詳細ですが、CloudWatch のコストが増加します。CloudWatch ロググループの送信先をアカウントレベルで設定することはできません。ただし、次のセクションで説明するように、個々のイベントタイプのカスタムロググループを指定できます。

   5. ログ記録の更新を選択して変更を保存します。

4. イベントレベルのログ記録を使用すると、関連するイベントのログを選択的にキャプチャし、専用の CloudWatch ロググループに送信できます。これにより、ログを有効にし、イベントの重要度に基づいてログレベルを設定することで、検出可能性を高め、さまざまな対象者と共有し、CloudWatch コストを削減するために、ユースケースごとにログを柔軟に整理できます。

   イベントレベルのログ記録を設定する: イベントレベルのログ記録は、クライアント認証の試行などの特定の AWS IoT イベントをキャプチャします。これらの設定は、アカウントレベルのログ記録を上書きします。

   1. イベントレベルのログ記録セクションで、イベントレベルのログ記録の管理を選択して更新を行います。

   2. デフォルトでは、イベントタイプはアカウントレベルのログ記録設定を継承します。注: リソース固有のログ記録を設定すると、アカウントとイベントレベルの設定が上書きされます。

   3. 個々のイベントの設定を変更するには、対応するイベント行の値をクリックします。ログレベルと CloudWatch ロググループの送信先の両方を調整できます。カスタム CloudWatch ロググループの送信先を指定するときは、IAM ロールポリシーに新しいロググループのアクセス許可が含まれていることを確認する必要があります。ロールポリシーを更新しないと、 AWS IoT はカスタムロググループにログを書き込むことができません。選択したら、チェックマークをクリックして選択を確定します。「Is Modified」列に「Yes」と表示され、保留中の変更を示します。

   4. ログ記録の更新をクリックして変更を適用するか、キャンセルを選択して破棄します。

5. リソース固有のオーバーライドを設定する: リソース固有のオーバーライドは、選択したリソースにログ記録設定を適用します。リソースには、モノのグループ、ソース IP、クライアント ID、またはプリンシパル ID を指定できます。リソース固有のログ記録設定は、アカウントレベルとイベントレベルの両方の設定を上書きします。有効にすると、指定されたリソースに対して設定されたログ記録レベルですべてのイベントタイプのログが生成されます。たとえば、他のすべてのモノの情報レベルのログ記録を維持しながら、特定のモノのデバッグレベルのログ記録を設定できます。

   1. 「リソース固有のオーバーライドの追加」セクションの「リソース固有のオーバーライドの追加」を選択します。

   2. ログターゲットを選択します: モノのグループ、ソース IP、クライアント ID、またはプリンシパル ID。

   3. 選択したターゲットタイプに対応するログターゲット値を入力します。

   4. リソース固有のログレベルセクションのドロップダウンメニューから目的のログレベルを選択します。

   5. Submit をクリックしてオーバーライドを追加するか、Cancel をクリックして変更を破棄します。

   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

   CloudWatch Logs のログに書き込むアクセス AWS IoT 許可を付与するロール ARN。初期設定には Role-arn 設定が必要です。

   --default-log-level

   使用するログレベル。有効な値は、ERROR、、WARN、INFODEBUG、または です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

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