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

# AWS Lambda 而且 AWS X-Ray
<a name="xray-services-lambda"></a>

**注意**  
X-Ray 開發套件/協助程式維護通知 – 在 2026 年 2 月 25 日， AWS X-Ray SDKs/協助程式將進入維護模式，其中 AWS 將限制 X-Ray 開發套件和協助程式版本，以僅解決安全問題。如需支援時間軸的詳細資訊，請參閱 [X-Ray SDK 和協助程式支援時間表](xray-sdk-daemon-timeline.md)。建議您遷移至 OpenTelemetry。如需遷移至 OpenTelemetry 的詳細資訊，請參閱[從 X-Ray 檢測遷移至 OpenTelemetry 檢測](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html)。

您可以使用 AWS X-Ray 來追蹤 AWS Lambda 函數。Lambda 會[執行 X-Ray 協助程式](xray-daemon.md)，並記錄區段，其中包含叫用和執行函數的詳細資訊。如需進一步檢測，您可以將 X-Ray 開發套件與您的 函數綁定，以記錄外撥通話並新增註釋和中繼資料。

如果您的 Lambda 函數是由另一個經檢測的服務呼叫，Lambda 會追蹤已取樣的請求，而無需任何其他組態。上游服務可以是經檢測的 Web 應用程式或其他 Lambda 函數。您的服務可以直接透過經檢測的 AWS SDK 用戶端叫用 函數，或使用經檢測的 HTTP 用戶端呼叫 API Gateway API。

AWS X-Ray 支援使用 AWS Lambda 和 Amazon SQS 追蹤事件驅動的應用程式。使用 CloudWatch 主控台查看與 Amazon SQS 佇列並由下游 Lambda 函數處理的每個請求的連線檢視。來自上游訊息生產者的追蹤會自動連結至來自下游 Lambda 消費者節點的追蹤，以end-to-end檢視。如需詳細資訊，請參閱[追蹤事件驅動的應用程式](xray-tracelinking.md)。

**注意**  
如果您已啟用下游 Lambda 函數的追蹤，您還必須為呼叫下游函數的根 Lambda 函數啟用追蹤，下游函數才能產生追蹤。

如果您的 Lambda 函數依排程執行，或是由未經檢測的服務調用，您可以設定 Lambda 以使用主動追蹤來取樣和記錄調用。

**在 AWS Lambda 函數上設定 X-Ray 整合**

1. 開啟 [AWS Lambda 主控台](https://console.aws.amazon.com/lambda)。

1. 從左側導覽列選取**函數**。

1. 選擇函數。

1. 在**組態**索引標籤上，向下捲動至**其他監控工具**卡。您也可以選取左側導覽窗格中的**監控和操作工具**來尋找此卡。

1. 選擇 **Edit** (編輯)。

1. 在 **AWS X-Ray** 下，啟用 **Active tracing** (主動追蹤)。

在具有對應 X-Ray 開發套件的執行時間上，Lambda 也會執行 X-Ray 協助程式。

**Lambda 上的 X-Ray SDKs**
+ **適用於 Go 的 X-Ray 開發套件** – Go 1.7 和更新的執行時間
+ **適用於 Java 的 X-Ray 開發套件** – Java 8 執行時間
+ **適用於 Node.js 的 X-Ray 開發套件** – Node.js 4.3 和更新版本執行時間
+ **適用於 Python 的 X-Ray 開發套件** – Python 2.7、Python 3.6 和更新的執行時間
+ **適用於 .NET 的 X-Ray 開發套件** – .NET Core 2.0 和更新的執行時間

若要在 Lambda 上使用 X-Ray 開發套件，請在每次建立新版本時將其與您的函數程式碼綁定。您可以使用用於檢測在其他 服務上執行之應用程式的相同方法，來檢測 Lambda 函數。主要差別是，您無法使用軟體開發套件來檢測傳入的請求、制定抽樣決策及建立區段。

檢測 Lambda 函數和 Web 應用程式之間的另一個區別是，函數程式碼無法修改 Lambda 建立並傳送至 X-Ray 的區段。您可以建立子區段並記錄註釋和中繼資料，但您無法新增註釋和中繼資料到父區段。

如需詳細資訊，請參閱《 *AWS Lambda 開發人員指南*》中的[使用 AWS X-Ray](https://docs.aws.amazon.com/lambda/latest/dg/lambda-x-ray.html)。