使用 視覺化 Lambda 函數叫用 AWS X-Ray

您可以使用 AWS X-Ray 視覺化應用程式的元件、識別效能瓶頸，以及對導致錯誤的請求進行故障診斷。您的 Lambda 函數會將追蹤資料傳送至 X-Ray，而且 X-Ray 會處理資料，以產生服務映射和可搜尋的追蹤摘要。

如果您已在調用函數的服務中啟用 X-Ray 追蹤，則 Lambda 會自動將追蹤傳送至 X-Ray。上游服務 (例如 Amazon API Gateway) 或在 Amazon EC2 上託管並利用 X-Ray 開發套件進行檢測的應用程式會取樣傳入要求，並新增追蹤標頭，告知 Lambda 是否傳送追蹤。來自上游訊息生產者的追蹤 (例如 Amazon SQS) 會自動連結至來自下游 Lambda 函數的追蹤，進而建立整個應用程式的端對端檢視。如需詳細資訊，請參閱《AWS X-Ray 開發人員指南》中的追蹤事件導向應用程式。

若要使用控制台在 Lambda 函數上切換主動追蹤，請按照下列步驟操作：

您的函數需要將追蹤資料上傳至 X-Ray 的許可。當您在 Lambda 主控台中啟用追蹤時，Lambda 會將必要的許可新增至函數的執行角色。否則，請將 AWSXRayDaemonWriteAccess 政策新增至執行角色。

X-Ray 無法追蹤應用程式的所有請求。X-Ray 會套用取樣演算法以確保追蹤的效率，同時仍提供所有請求的代表範本。取樣率為每秒 1 次請求和 5% 的額外請求。不能針對函數設定 X-Ray 取樣率。

了解 X-Ray 追蹤

在 X-Ray 中，追蹤會記錄一或多個服務所處理之要求的相關資訊。Lambda 會在每個追蹤上記錄 2 個區段，這會在服務圖表上建立兩個節點。下圖反白顯示了這兩個節點：

左側第一個節點代表接收調用請求的 Lambda 服務。第二個節點代表您特定的 Lambda 函數。

為 Lambda 服務記錄的區段 AWS::Lambda 涵蓋準備 Lambda 執行環境所需的所有步驟。這包括排程 MicroVM、使用您設定的資源建立或取消凍結執行環境，以及下載函數程式碼和所有層。

AWS::Lambda::Function 區段用於函數要完成的工作。

舊式 AWS X-Ray Lambda 區段結構

AWS::Lambda 區段的舊式 X-Ray 結構如下所示：

在此格式中，函數區段具有 Initialization、Invocation 和 Overhead 的子區段。另外，對於 Lambda SnapStart 還有一個 Restore 子區段 (此圖表中未顯示)。

Initialization 子區段代表 Lambda 執行環境生命週期的初始化階段。在此階段，Lambda 會初始化延伸模組、初始化執行時期，並執行函數的初始化程式碼。

Invocation 子區段表示調用階段，其中 Lambda 調用函數處理常式。這從執行時間和延伸註冊開始，並在執行時間準備傳送響應時結束。

（僅限 Lambda SnapStart) Restore子區段會顯示 Lambda 還原快照、載入執行時間，以及執行任何還原後執行時間掛鉤所需的時間。還原快照的程序可能包括在 MicroVM 以外的活動上花費的時間。此時間在 Restore 子區段中報告。您不需要為在 MicroVM 外還原快照所花費的時間付費。

Overhead 子區段表示當執行時間傳送響應和下一次調用信號之間的時間發生的階段。在此期間，執行時間會完成與調用相關的所有工作，並準備凍結沙盒。

如需 Lambda 執行環境階段的詳細資訊，請參閱了解 Lambda 執行環境生命週期。

下圖顯示了使用舊式 X-Ray 結構的追蹤範例。

請注意此範例中的兩個區段。兩者都被命名為 my-function，但其中之一的來源為 AWS::Lambda，而另一個的來源為 AWS::Lambda::Function。如果 AWS::Lambda 區段顯示錯誤，Lambda 服務就會出現問題。如果 AWS::Lambda::Function 區段顯示錯誤，表示您的函數出現了問題。

新樣式 AWS X-Ray 的 Lambda 區段結構

AWS::Lambda 區段的新式 X-Ray 結構如下所示：

在此新格式中，Init 子區段和以往一樣代表 Lambda 執行環境生命週期的初始化階段。

新格式中沒有調用區段。而客戶子區段則直接連接到 AWS::Lambda::Function 區段。此區段包含以下指標做為註釋：

下圖顯示了使用新式 X-Ray 結構的追蹤範例。

請注意此範例中的兩個區段。兩者都被命名為 my-function，但其中之一的來源為 AWS::Lambda，而另一個的來源為 AWS::Lambda::Function。如果 AWS::Lambda 區段顯示錯誤，Lambda 服務就會出現問題。如果 AWS::Lambda::Function 區段顯示錯誤，表示您的函數出現了問題。

如需在 Lambda 追蹤的語言特定簡介，請參閱下列主題：

如需支援主動設備測試之服務的完整清單，請參閱《 AWS X-Ray 開發人員指南》中的 Supported AWS 服務 一節。

執行角色許可

Lambda 需要下列許可才能傳送追蹤資料到 X-Ray。新增許可到您的函數的執行角色。

這些許可包含在 AWSXRayDaemonWriteAccess 受管政策中。

透過 Lambda API 啟用主動追蹤

若要使用 AWS CLI 或 AWS SDK 管理追蹤組態，請使用下列 API 操作：

下列範例 AWS CLI 命令會在名為 my-function 的函數上啟用主動追蹤。

aws lambda update-function-configuration --function-name my-function \
--tracing-config Mode=Active

追蹤模式是您發布函數版本時版本特定組態的一部分。您無法變更已發佈版本上的追蹤模式。

使用 啟用主動追蹤 AWS CloudFormation

若要在 AWS CloudFormation 範本中的 AWS::Lambda::Function 資源上啟用追蹤，請使用 TracingConfig 屬性。

Resources:
  function:
    Type: AWS::Lambda::Function
    Properties:
      TracingConfig:
        Mode: Active
      ...

對於 an AWS Serverless Application Model (AWS SAM) AWS::Serverless::Function 資源，請使用 Tracing 屬性。

Resources:
  function:
    Type: AWS::Serverless::Function
    Properties:
      Tracing: Active
      ...