AWS X-Ray 適用於 Go 的 SDK

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

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

適用於 Go 的 X-Ray 開發套件是一組適用於 Go 應用程式的程式庫，提供產生追蹤資料並將其傳送至 X-Ray 協助程式的類別和方法。追蹤資料包含應用程式所提供服務之傳入 HTTP 請求的相關資訊，以及應用程式使用 AWS SDK、HTTP 用戶端或 SQL 資料庫連接器對下游服務進行的呼叫。您也可以手動建立區段，並將除錯資訊新增至註釋和中繼資料中。

使用 go get 以從軟體開發套件的 GitHub 儲存庫下載軟體開發套件：

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

若是 Web 應用程式，請先使用 xray.Handler 函數來追蹤傳入請求。訊息處理常式會為每個追蹤的請求建立區段，並在傳送回應時完成區段。當區段開啟時，您可以使用軟體開發套件用戶端的方法，將資訊新增到區段，並建立子區段以追蹤下游呼叫。軟體開發套件也會在區段為開啟時自動記錄應用程式擲回的例外狀況。

對於由經檢測的應用程式或服務呼叫的 Lambda 函數，Lambda 會自動讀取追蹤標頭並追蹤取樣的請求。對於其他 函數，您可以設定 Lambda 來取樣和追蹤傳入的請求。無論哪種情況，Lambda 都會建立區段，並將其提供給 X-Ray 開發套件。

接著，請呼叫 AWS 函數以包裝您的用戶端。此步驟可確保 X-Ray 檢測到對任何用戶端方法的呼叫。您也可以檢測對 SQL 資料庫的呼叫。

開始使用 SDK 之後，請設定記錄器和中介軟體來自訂其行為。您可以新增外掛程式，以記錄執行應用程式所需的運算資源相關資料、定義抽樣規則以自訂抽樣行為，並設定日誌層級以在應用程式日誌中查看更多或更少的軟體開發套件資訊。

使用註釋與中繼資料，記錄應用程式所做的請求和工作等其他資訊。註釋是簡單的鍵/值對，系統會為其建立索引以用於篩選條件表達式，因此您可以搜尋包含特定資料的追蹤。中繼資料項目的限制性較低，可以記錄整個物件和陣列，任何可以序列化為 JSON 的項目。

當程式碼中有很多經過檢測的用戶端時，單一請求區段可能包含大量子區段，每個使用經檢測用戶端進行的呼叫都有一個子區段。您可以將用戶端呼叫包裝在自訂子區段中，以組織和群組子區段。您可以為整個函數或任何部分的程式碼建立自訂子區段，並記錄子區段上的中繼資料和註釋，而不必寫入父區段上的所有項目。

要求

適用於 Go 的 X-Ray 開發套件需要 Go 1.9 或更新版本。

軟體開發套件在編譯和執行時間需仰賴下列程式庫：

軟體開發套件的 README.md 檔案中有宣告這些相依性。

參考文件

下載軟體開發套件之後，請本機建置和託管文件以在 Web 瀏覽器中檢視。