在 AWS Lambda 中檢測 Go 程式碼

Lambda 會與 AWS X-Ray 整合，以協助您追蹤、偵錯和最佳化 Lambda 應用程式。您可以使用 X-Ray 來追蹤請求，因為它會周遊您應用程式中的資源，其中可能包含 Lambda 函數和其他 AWS 服務。

若要將追蹤資料傳送至 X-Ray，您可以使用以下兩個 SDK 庫之一：

• AWS適用於 OpenTelemetry (ADOT) 的發行版 — 安全、可生產就緒且AWS支援的 (OTel) SDK 發行版本 OpenTelemetry 。

• 適用於 Go 的 AWS X-Ray SDK：用於產生追蹤資料並將其傳送至 X-Ray 的 SDK。

每個 SDK 均提供將遙測資料傳送至 X-Ray 服務的方法。然後，您可以使用 X-Ray 來檢視、篩選應用程式的效能指標並獲得洞察，從而識別問題和進行最佳化的機會。

重要

X-Ray 和適用於 AWS Lambda SDK 的 Powertools 包含在 AWS 提供的緊密整合檢測解決方案中。ADOT Lambda Layers 是用於追蹤檢測之業界通用標準的一部分，這類檢測一般會收集更多資料，但可能不適用於所有使用案例。您可以使用任一解決方案在 X-Ray 中實作 end-to-end 追蹤。若要深入了解如何在兩者之間做選擇，請參閱在 AWS Distro for OpenTelemetry 和 X-Ray SDK 之間進行選擇。

使用 ADOT 來檢測您的 Go 函數

ADOT 提供全受管 Lambda 層，包含使用 OTel SDK 收集遙測資料所需的一切內容。透過取用此層，您可以檢測 Lambda 函數，而無需修改任何函數程式碼。您還可以將層設定為對 OTel 進行自訂初始化。如需詳細資訊，請參閱 ADOT 文件中的針對 Lambda 上的 ADOT 收集器進行自訂組態設定。

針對 Go 執行階段，您可以新增適用於 ADOT Go 的 AWS 受管 Lambda 層來自動檢測您的函數。有關如何添加此層的詳細說明，請參閱 AWSADOT 文檔中的 OpenTelemetry Lambda Go Support 發行版。

使用 X-Ray SDK 來檢測 Go 函數

如要記錄 Lambda 函數對應用程式中其他資源所進行之呼叫的詳細資料，您也可以使用適用於 Go 的 AWS X-Ray SDK。要獲取 SDK，請使用以下命令從其GitHub 存儲庫下載 SDKgo get：

go get github.com/aws/aws-xray-sdk-go

若要檢測 AWS 開發套件用戶端，請將用戶端傳遞給 xray.AWS() 方法。然後，便可以使用該方法的 WithContext 版本來追蹤呼叫。

svc := s3.New(session.New())
xray.AWS(svc.Client)
...
svc.ListBucketsWithContext(ctx aws.Context, input *ListBucketsInput)

新增正確的依賴項並進行必要的程式碼變更後，請透過 Lambda 主控台或 API 在函數的組態中啟用追蹤。

透過 Lambda 主控台來啟用追蹤

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

開啟主動追蹤

1. 開啟 Lambda 主控台中的 函數頁面。

2. 選擇一個函數。

3. 選擇 組態 ，然後選擇 監控和操作工具 。

4. 選擇 編輯 。

5. 在 X-Ray 下，打開 主動追蹤 。

6. 選擇 儲存 。

透過 Lambda API 啟用追蹤

若要使用 AWS CLI 或 AWS SDK 在 Lambda 函數上設定追蹤，請使用下列 API 操作：

• UpdateFunctionConfiguration

• GetFunctionConfiguration

• CreateFunction

下列範例 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 屬性。

範例 function-inline.yml - 追蹤組態

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

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

範例 template.yml - 追蹤組態

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

解讀 X-Ray 追蹤

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

設定主動追蹤之後，您可以透過應用程式來觀察特定請求。X-Ray 服務圖顯示了有關應用程式及其所有元件的資訊。下列來自錯誤處理器範例應用程式的範例顯示了具有兩個函式的應用程式。主要函式會處理事件，有時會傳回錯誤。頂部的第二個函數處理出現在第一個日誌組中的錯誤，並使用 AWS SDK 調用 X-Ray，Amazon 簡單存儲服務（Amazon S3）和亞馬遜 CloudWatch 日誌。

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

注意

您無法針對函數設定 X-Ray 取樣率。

使用主動追蹤時，Lambda 會在每個追蹤上記錄 2 個區段，它在服務圖表上會建立兩個節點。下圖反白顯示了錯誤處理器範例應用程式中主要函數的兩個節點。

左側第一個節點代表接收調用請求的 Lambda 服務。第二個節點代表您特定的 Lambda 函數。下列範例顯示了具有這 2 個區段的追蹤。兩者都被命名為 my-function，但其中之一具有 AWS::Lambda 的來源，而另一個具有來源 AWS::Lambda::Function。

此範例會展開函數區段以顯示其子區段︰

• 初始化 - 表示載入函數和執行初始化程式碼所花費的時間。只有函數的每個執行個體所處理的第一個事件會顯示此子區段。

• 調用 – 表示執行處理常式程式碼所花費的時間。

• 額外負荷 - 表示 Lambda 執行期為做好準備以處理下一個事件所花費的時間。

您也可以檢測 HTTP 用戶端、記錄 SQL 查詢，以及建立具有註釋和中繼資料的自訂子區段。如需詳細資訊，請參閱《AWS X-Ray 開發人員指南》中的適用於 Go 的AWS X-Ray 開發套件。

定價

作為 AWS 免費方案的一部分，您可以每月免費使用 X-Ray 追蹤，但有一定限制。達到閾值後，X-Ray 會收取追蹤儲存及擷取的費用。如需詳細資訊，請參閱 AWS X-Ray 定價。