Amazon S3 および AWS X-Ray

は、Amazon S3 と統合して、アプリケーションの S3 バケットを更新するアップストリームリクエストをトレースします。サービスが X-Ray SDK を使用してリクエストをトレースする場合、Amazon S3 は AWS Lambda、Amazon SQS、Amazon SNS などのダウンストリームイベントサブスクライバーにトレースヘッダーを送信できます。X-Ray は Amazon S3 イベント通知のトレースメッセージを有効にします。

X-Ray トレースマップを使用して、Amazon S3 およびアプリケーションが使用する他のサービス間の接続を表示できます。コンソールを使用して、平均レイテンシーや障害発生率などのメトリクスを表示することもできます。X-Ray コンソールの詳細については、「X-Ray コンソールを使用する」を参照してください。

Amazon S3 は、デフォルトの HTTP ヘッダーの計測をサポートしています。X-Ray SDK は、AWS SDK を通じて Amazon S3 を呼び出すとき、X-Ray SDK はトレースヘッダーを HTTP ヘッダーとして自動的に入力します。デフォルトのトレースヘッダーは、X-Amzn-Trace-Id によって伝送されます。トレースヘッダーの詳細については、コンセプトページの「トレースヘッダー」を参照してください。Amazon S3 トレースコンテキストの伝播では、Lambda、SQS、および SNS のサブスクライバーがサポートされます。SQS と SNS はそれ自体でセグメントデータを送信しないため、S3 でトリガーされた場合、トレースヘッダーはダウンストリームのサービスに伝達されるものの、トレースやトレースマップには表示されません。

Amazon S3 イベント通知を設定する

Amazon S3 通知機能で、バケット内で の特定のイベントが発生したときに、通知を受けることができます。これらの通知は、アプリケーション内の次の宛先に伝播できます。

• Amazon Simple Notification Service (Amazon SNS)

• Amazon Simple Queue Service (Amazon SQS)

• AWS Lambda

サポートされているイベントのリストについては、Amazon S3 開発者ガイドでサポートされているイベントタイプを参照してください。。

Amazon SNS と Amazon SQS

SNS トピックや SQS キューに通知を発行するには、まず Amazon S3 のアクセス許可を付与する必要があります。これらの権限を付与するには、AWS Identity and Access Management (IAM) ポリシーを発行先の SNS トピックや SQS キューに指定します。必要な IAM ポリシーの詳細については、SNS トピックまたは SQS キューにメッセージを発行するアクセス許可の付与を参照してください。

SNS および SQS の X-Ray との統合については、Amazon SNS および APIAWS X-Ray および Amazon SQS および AWS X-Ray を参照してください。

AWS Lambda

Amazon S3 コンソールを使用して、Lambda 関数で S3 バケットのイベント通知を設定する場合、コンソールは Lambda 関数で必要なアクセス許可を設定し、Amazon S3 がバケットから関数を呼び出すアクセス許可を持つようにします。詳細については、Amazon Simple Storage Service コンソールユーザーガイドの「S3 バケットのイベント通知を有効化および設定する方法」を参照してください。

AWS Lambda から Amazon S3 の許可を付与して、Lambda 関数を呼び出すこともできます。詳細については、 Lambda 開発者ガイドの「チュートリアル: Amazon S3AWS で AWS Lambda を使用する」を参照してください。

X-Ray と Lambda の統合の詳細については、「AWS Lambda での Java コードの実装」を参照してください。