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

# Amazon EventBridge Pipes のパフォーマンスのログ記録
<a name="eb-pipes-logs"></a>

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

EventBridge Pipes がレコードを配信する*ログ送信*先として、次の AWS サービスを選択できます。
+ CloudWatch Logs

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

  CloudWatch Logs により、使用しているすべてのシステム、アプリケーション、 AWS のサービスからのログを、１ つの高度にスケーラブルなサービスで一元管理できます。詳細については、「*Amazon CloudWatch Logs ユーザーガイド*」の「[ロググループとログストリームの操作](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html)」を参照してください。
+ Firehose ストリームログ

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

  Amazon Data Firehose は、サポートされているサードパーティーサービスプロバイダーが所有するカスタム HTTP エンドポイントまたは HTTP エンドポイントだけでなく、特定の AWS サービスなどの送信先にリアルタイムのストリーミングデータを配信するためのフルマネージドサービスです。詳細については、「*Amazon Data Firehose ユーザーガイド*」の「[Amazon Data Firehose 配信ストリームの作成](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html)」を参照してください。
+ Amazon S3 ログ

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

  Amazon S3 は、業界をリードするスケーラビリティ、データ可用性、セキュリティ、パフォーマンスを提供するオブジェクトストレージサービスです。詳細については、「Amazon Simple Storage Service ユーザーガイド」の「[Amazon S3 でのオブジェクトのアップロード、ダウンロード、操作](https://docs.aws.amazon.com/AmazonS3/latest/userguide/uploading-downloading-objects.html)」を参照してください。**

## Amazon EventBridge Pipes のログ記録の仕組み
<a name="eb-pipes-logs-overview"></a>

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

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

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

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

EventBridge から選択したログ送信先に送信するレコードは、次の方法でカスタマイズできます。
+ ログレベルを指定できます。これにより、EventBridge から、選択したログ送信先にレコードを送信する実行ステップが決定されます。**詳細については、「[EventBridge Pipes のログレベルの指定](#eb-pipes-logs-level)」を参照してください。
+ EventBridge Pipesでは、関連する実行ステップのレコードに実行データを含めるかどうかを指定できます。これには、以下のデータが含まれます。
  + イベントバッチのペイロード
  +  AWS エンリッチメントまたはターゲットサービスに送信されたリクエスト
  + エン AWS リッチメントまたはターゲットサービスによって返されるレスポンス

  詳細については、「[EventBridge Pipes ログに実行データを含める](#eb-pipes-logs-execution-data)」を参照してください。

## EventBridge Pipes のログレベルの指定
<a name="eb-pipes-logs-level"></a>

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

ログレコードに含める詳細レベルを以下から選択します。ログレベルは、パイプに指定したすべてのログ送信先に適用されます。各ログレベルには、以前のログレベルの実行ステップが含まれます。
+ **OFF** — EventBridge は指定したログ送信先にレコードを送信しません。これはデフォルトの設定です。
+ **ERROR** — EventBridge は、パイプ実行中に発生したエラーに関連するすべてのレコードを、指定したログ送信先に送信します。
+ **INFO** — EventBridge は、エラーに関連するレコードを送信するだけでなく、パイプ実行中に実行された他のステップを選択して、指定したログ送信先に送信します。
+ **TRACE** — EventBridge は、パイプ実行の任意のステップで生成されたレコードを、指定したログ送信先に送信します。

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

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


****  

| Step | TRACE | 情報 | エラー | 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 ログに実行データを含める
<a name="eb-pipes-logs-execution-data"></a>

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 実行ステップ](eb-pipes-logs-execution-steps.md)」を参照してください。

### EventBridge Pipes ログレコードの実行データの切り捨て
<a name="eb-pipes-logs-execution-data-truncation"></a>

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

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

## EventBridge Pipes ログレコードのエラー報告
<a name="eb-pipes-logs-errors"></a>

EventBridge は、エラー状態を示すエラーデータ (ある場合) もパイプ実行ステップに含めます。ステップには以下が含まれます。
+ `ExecutionThrottled`
+ `ExecutionTimeout`
+ `ExecutionFailed`
+ `ExecutionPartiallyFailed`
+ `EnrichmentTransformationFailed`
+ `EnrichmentInvocationFailed`
+ `EnrichmentStageFailed`
+ `TargetTransformationFailed`
+ `TargetInvocationFailed`
+ `TargetInvocationPartiallyFailed`
+ `TargetStageFailed`
+ `TargetStagePartiallyFailed`