Amazon EventBridge Pipes のパフォーマンスのログ記録 - Amazon EventBridge
パイプのログ記録のしくみログレベルの指定ログに実行データを含めるログレコードのエラー報告

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon EventBridge Pipes のパフォーマンスのログ記録

EventBridge Pipes のログ記録を使用すると、EventBridge Pipes から、サポートされている AWS のサービスにパイプのパフォーマンスを詳述したレコードを送信できます。ログを使用して得たパイプの実行パフォーマンスへのインサイトを、トラブルシューティングやデバッグに役立てることができます。

EventBridge Pipes からのレコードを配信するログ送信先として、以下の AWS のサービスを選択できます。

  • CloudWatch Logs

    EventBridge は、指定した CloudWatch Logs ロググループにログレコードを配信します。

    CloudWatch Logs により、使用しているすべてのシステム、アプリケーション、AWS のサービスからのログを、１ つの高度にスケーラブルなサービスで一元管理できます。詳細については、「Amazon CloudWatch Logs ユーザーガイド」の「ロググループとログストリームの操作」を参照してください。

  • Firehose ストリームログ

    EventBridge は、Firehose 配信ストリームにログレコードを配信します。

    Amazon Data Firehose は、特定の AWS のサービスや、サポートされているサードパーティのサービスプロバイダーが所有する任意の HTTP エンドポイントなどの送信先に、リアルタイムのストリーミングデータを配信するフルマネージドサービスです。詳細については、「Amazon Data Firehose ユーザーガイド」の「Amazon Data Firehose 配信ストリームの作成」を参照してください。

  • Amazon S3 ログ

    EventBridge は、ログレコードを Amazon S3 オブジェクトとして指定先のバケットに配信します。

    Amazon S3 は、業界をリードするスケーラビリティ、データ可用性、セキュリティ、およびパフォーマンスを提供するオブジェクトストレージサービスです。詳細については、「Amazon Simple Storage Service ユーザーガイド」の「Amazon S3 でのオブジェクトのアップロード、ダウンロード、操作」を参照してください。

Amazon EventBridge Pipes のログ記録の仕組み

パイプの実行は、パイプによって受信され、エンリッチメントやターゲットに送信されるイベントまたはイベントのバッチです。有効にすると、EventBridge はイベントバッチの処理時に実行する各実行ステップのログレコードを生成します。レコード内の情報は、イベントバッチ (単一のイベントから最大 10,000 までのイベント) に適用されます。

パイプのソースとターゲットでイベントバッチのサイズを設定できます。詳細については、「Amazon EventBridge Pipes のバッチ処理と同時実行」を参照してください。

各ログ送信先に送信されるレコードデータは同じです。

Amazon CloudWatch Logs を送信先に設定した場合、すべての送信先に配信されるログレコードは 256 KB に制限されます。フィールドは必要に応じて切り捨てられます。

EventBridge から選択したログ送信先に送信するレコードは、次の方法でカスタマイズできます。

  • ログレベルを指定できます。これにより、EventBridge から、選択したログ送信先にレコードを送信する実行ステップが決定されます。詳細については、「EventBridge Pipes のログレベルの指定」を参照してください。

  • EventBridge Pipesでは、関連する実行ステップのレコードに実行データを含めるかどうかを指定できます。これには、以下のデータが含まれます。

    • イベントバッチのペイロード

    • AWS エンリッチメントまたはターゲットサービスに送信されたリクエスト

    • AWS エンリッチメントまたはターゲットサービスから返された応答。

    詳細については、「EventBridge Pipes ログに実行データを含める」を参照してください。

EventBridge Pipes のログレベルの指定

EventBridge から選択したログ送信先にレコードを送信する実行ステップの種類を指定できます。

ログレコードに含める詳細レベルを以下から選択します。ログレベルは、パイプに指定したすべてのログ送信先に適用されます。各ログレベルには、以前のログレベルの実行ステップが含まれます。

  • OFF — EventBridge は指定したログ送信先にレコードを送信しません。これはデフォルトの設定です。

  • ERROR — EventBridge は、パイプ実行中に発生したエラーに関連するすべてのレコードを、指定したログ送信先に送信します。

  • INFO — EventBridge は、エラーに関連するレコードを送信するだけでなく、パイプ実行中に実行された他のステップを選択して、指定したログ送信先に送信します。

  • TRACE — EventBridge は、パイプ実行の任意のステップで生成されたレコードを、指定したログ送信先に送信します。

EventBridge コンソールでは、ERROR ログレベルと同様に、CloudWatch ログがログ送信先としてデフォルトで選択されます。そのため、デフォルトでは、EventBridge Pipes は新しい CloudWatch ロググループを作成し、このロググループに ERROR レベルの詳細を含むログレコードを送信します。ログをプログラムで設定する場合、デフォルトは選択されません。

次の表は、各ログレベルに含まれる実行ステップを示しています。

Step TRACE 情報 ERROR VOFF

実行の失敗

 x x x

実行が部分的に失敗

 x x x

実行の開始

 x x

実行の成功

 x x

実行がスロットリング

 x x x

実行タイムアウト

 x x x

エンリッチメントの呼び出しが失敗

 x x x

エンリッチメント呼び出しをスキップ

 x x

エンリッチメント呼び出しが開始

 x

エンリッチメント呼び出しが成功

 x

エンリッチメントステージ開始

 x x

エンリッチメントステージが失敗

 x x x

エンリッチメントステージが成功

 x x

エンリッチメント変換が失敗

 x x x

エンリッチメント変換が開始

 x

エンリッチメント変換が成功

 x

ターゲット呼び出しが失敗

 x x x

ターゲット呼び出しが部分的に失敗

 x x x

ターゲット呼び出しをスキップ

 x

ターゲット呼び出しが開始

 x

ターゲット呼び出しが成功

 x

ターゲットステージ開始

 x x

ターゲットステージが失敗

 x x x

ターゲットステージが部分的に失敗

 x x x

ターゲットステージをスキップ

 x

ターゲットステージが成功

 x x

ターゲット変換が失敗

 x x x

ターゲット変換が開始

 x

ターゲット変換が成功

 x

EventBridge Pipes ログに実行データを含める

EventBridge が生成するレコードに実行データを含めるように指定できます。実行データには、イベントバッチペイロード、エンリッチメントとターゲットに送信されたリクエスト、エンリッチメントとターゲットからの応答を表すフィールドが含まれます。

実行データは、トラブルシューティングやデバッグに役立ちます。payload フィールドには、バッチに含まれる各イベントの実際の内容が含まれているため、個々のイベントを特定のパイプ実行に関連付けることができます。

実行データを含めることを選択した場合、実行データはパイプに指定したすべてのログ送信先に含まれます。

重要

これらのフィールドには機密情報が含まれている可能性があります。EventBridge は、ロギング中にこれらのフィールドの内容を編集しようとはしません。

実行データを含める場合、EventBridge は以下のフィールドを関連レコードに追加します。

  • payload

    パイプで処理しているイベントバッチの内容を表します。

    EventBridge は、イベントバッチの内容が更新されている可能性があるステップで生成されたレコードに payload フィールドを含めます。これには以下のステップが含まれます。

    • EXECUTION_STARTED

    • ENRICHMENT_TRANSFORMATION_SUCCEEDED

    • ENRICHMENT_STAGE_SUCCEEDED

    • TARGET_TRANSFORMATION_SUCCEEDED

    • TARGET_STAGE_SUCCEEDED

  • awsRequest

    エンリッチメントまたはターゲットに送信された JSON 文字列のリクエストを表します。API 送信先に送信されるリクエストの場合、これはそのエンドポイントに送信された HTTP リクエストを表します。

    EventBridge は、エンリッチメントとターゲティングの最終ステップ (つまり、指定したエンリッチメントまたはターゲットサービスに対して EventBridge がリクエストを実行したか、実行しようとした後) で生成されるレコードに awsRequest フィールドを含めます。これには以下のステップが含まれます。

    • ENRICHMENT_INVOCATION_FAILED

    • ENRICHMENT_INVOCATION_SUCCEEDED

    • TARGET_INVOCATION_FAILED

    • TARGET_INVOCATION_PARTIALLY_FAILED

    • TARGET_INVOCATION_SUCCEEDED

  • awsResponse

    エンリッチメントまたはターゲットから返された JSON 形式のレスポンスを表します。API 送信先に送信されたリクエストの場合、これはそのエンドポイントから返された HTTP レスポンスを表します。

    awsRequest と同様に、EventBridge は、エンリッチメントとターゲティングの最終ステップ (指定したエンリッチメントまたはターゲットサービスに対して EventBridge がリクエストを実行したか、実行しようとした後) で生成されるレコードに awsResponse フィールドを含めます。これには以下のステップが含まれます。

    • ENRICHMENT_INVOCATION_FAILED

    • ENRICHMENT_INVOCATION_SUCCEEDED

    • TARGET_INVOCATION_FAILED

    • TARGET_INVOCATION_PARTIALLY_FAILED

    • TARGET_INVOCATION_SUCCEEDED

パイプ実行ステップの説明については、「EventBridge Pipes 実行ステップ」を参照してください。

EventBridge Pipes ログレコードの実行データの切り捨て

EventBridge でパイプのログレコードに実行データを含めるように選択すると、レコードが 256 KB のサイズ制限を超える可能性があります。これを防ぐために、EventBridge は、実行データフィールドを次の順序で自動的に切り捨てます。EventBridge は、フィールドごとに完全に切り捨ててから、次のフィールドの切り捨てに進みます。EventBridge は、データ文字列の末尾から文字を単に削除することでフィールドデータを切り捨てます。データの重要度に基づいて切り捨てることはなく、切り捨てにより JSON フォーマットが無効になります。

  • payload

  • awsRequest

  • awsResponse

EventBridge がイベント内のフィールドを切り捨てると、truncatedFields フィールドには切り捨てられたデータフィールドのリストが含まれます。

EventBridge Pipes ログレコードのエラー報告

EventBridge は、エラー状態を示すエラーデータ (ある場合) もパイプ実行ステップに含めます。ステップには以下が含まれます。

  • ExecutionThrottled

  • ExecutionTimeout

  • ExecutionFailed

  • ExecutionPartiallyFailed

  • EnrichmentTransformationFailed

  • EnrichmentInvocationFailed

  • EnrichmentStageFailed

  • TargetTransformationFailed

  • TargetInvocationFailed

  • TargetInvocationPartiallyFailed

  • TargetStageFailed

  • TargetStagePartiallyFailed