本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Amazon S3 和 AWS X-Ray
<a name="xray-services-s3"></a>

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 主控台](aws-xray-interface-console.md#xray-console)。

Amazon S3 支援*預設 http 標頭*檢測。當您透過 SDK 呼叫 Amazon S3 時，X-Ray AWS SDK 會自動將追蹤標頭填入為 HTTP 標頭。預設追蹤標頭由 承載`X-Amzn-Trace-Id`。若要進一步了解追蹤標頭，請參閱 概念頁面上[追蹤標頭](xray-concepts.md#xray-concepts-tracingheader)的 。Amazon S3 追蹤內容傳播支援下列訂閱者：Lambda、SQS 和 SNS。由於 SQS 和 SNS 本身不會發出區段資料，因此它們不會在 S3 觸發時出現在追蹤或追蹤映射中，即使它們會將追蹤標頭傳播到下游服務。

## 設定 Amazon S3 事件通知
<a name="xray-services-s3-notification"></a>

使用 Amazon S3 通知功能，當儲存貯體中發生特定事件時，您會收到通知。然後，這些通知可以傳播到應用程式中的下列目的地：
+ Amazon Simple Notification Service (Amazon SNS)
+ Amazon Simple Queue Service (Amazon SQS)
+ AWS Lambda

如需支援的事件清單，請參閱《[Amazon S3 開發人員指南》中的支援的事件類型](https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html#supported-notification-event-types)。

### Amazon SNS 和 Amazon SQS
<a name="xray-services-s3-notifications-snssqs"></a>

若要發佈通知至 SNS 主題或 SQS 佇列，您必須先授予 Amazon S3 許可。若要授予這些許可，請將 AWS Identity and Access Management (IAM) 政策連接至目的地 SNS 主題或 SQS 佇列。若要進一步了解所需的 IAM 政策，請參閱[授予發佈訊息至 SNS 主題或 SQS 佇列的許可](https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html#grant-sns-sqs-permission-for-s3)。

如需整合 SNS 和 SQS 與 X-Ray 的相關資訊，請參閱 [Amazon SNS 和 AWS X-Ray](xray-services-sns.md)和 [Amazon SQS 和 AWS X-Ray](xray-services-sqs.md)。

### AWS Lambda
<a name="xray-services-s3-notifications-lambda"></a>

當您使用 Amazon S3 主控台為 Lambda 函數設定 S3 儲存貯體的事件通知時，主控台會設定 Lambda 函數的必要許可，讓 Amazon S3 具有從儲存貯體叫用函數的許可。如需詳細資訊，請參閱《Amazon Simple Storage Service 主控台使用者指南》中的[如何啟用和設定 S3 儲存貯體的事件通知？](https://docs.aws.amazon.com/AmazonS3/latest/user-guide/enable-event-notifications.html)。

您也可以從 授予 Amazon S3 許可 AWS Lambda ，以叫用 Lambda 函數。如需詳細資訊，請參閱《[AWS Lambda 開發人員指南》中的教學課程：搭配 Amazon S3 使用](https://docs.aws.amazon.com/lambda/latest/dg/with-s3-example.html) AWS Lambda。

如需整合 Lambda 與 X-Ray 的詳細資訊，請參閱[在 AWS Lambda 中檢測 Java 程式碼](https://docs.aws.amazon.com/lambda/latest/dg/java-tracing.html)。