使用 Go 的 X-Ray SDK 將註釋和中繼資料新增至區段 - AWS X-Ray
使用 X-Ray 進SDK行記錄註釋使用 X-Ray 進SDK行記錄中繼資料使用 X-Ray 進SDK行記錄使用者 IDs

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

使用 Go 的 X-Ray SDK 將註釋和中繼資料新增至區段

您可以使用註釋和中繼資料記錄有關請求、環境或應用程式的其他資訊。您可以將註釋和中繼資料新增至 X-Ray SDK 建立的區段，或新增至您建立的自訂子區段。

註釋是與字符串，數字或布爾值鍵-值對。註釋會編製索引以與篩選器運算式搭配使用 使用註釋來記錄您要用來在主控台中分組追蹤的資料，或在呼叫 GetTraceSummariesAPI.

中繼資料是索引鍵-值配對，可以具有任何類型的值 (包括物件和清單)，但不會編製索引以供篩選運算式使用。使用元數據記錄要存儲在跟踪中但不需要與搜索一起使用的其他數據。

除了註釋和中繼資料，您也可以在區段上記錄使用者 ID 字串。使用者IDs會記錄在區段上的個別欄位中，並建立索引以供搜尋使用。

使用 X-Ray 進SDK行記錄註釋

針對您想要建立索引以用於搜尋的區段，請使用註釋來記錄這些區段上的資訊。

註釋要求

  • 按鍵 — X-Ray 註解的金鑰最多可包含 500 個英數字元。您不能使用點或句點 (.) 以外的空格或符號

  • 值 — X-Ray 註釋的值最多可包含 1,000 個 Unicode 字元。

  • 註釋的數量 — 每個追蹤最多可以使用 50 個註釋。

若要記錄註釋，請使用包含要與區段建立關聯之中繼資料的字串來呼叫 AddAnnotation。

xray.AddAnnotation(key string, value interface{})

將註釋SDK記錄為段文檔中的對annotations象中的鍵-值對。若使用相同索引鍵呼叫 AddAnnotation 兩次，則會覆寫之前在相同區段上記錄的值。

若要尋找具有特定值之註釋的繪線，請在篩選器運算式中使用annotation[key]關鍵字。

使用 X-Ray 進SDK行記錄中繼資料

針對您不想要建立索引以用於搜尋的區段，請使用中繼資料來記錄這些區段上的資訊。

若要記錄中繼資料，請使用包含要與區段建立關聯之中繼資料的字串來呼叫 AddMetadata。

xray.AddMetadata(key string, value interface{})

使用 X-Ray 進SDK行記錄使用者 IDs

記錄請求區段IDs上的使用者，以識別傳送請求的使用者。

記錄使用者 IDs

  1. 從 AWSXRay 取得目前區段的參考。

    import (
  "context"
  "github.com/aws/aws-xray-sdk-go/xray"
)

mySegment := xray.GetSegment(context)

  2. 使用傳送請求之使用者的字串 ID 呼叫 setUser。

    mySegment.User = "U12345"

若要尋找使用者 ID 的追蹤，請在篩選運算式中使用user關鍵字。