標記 X-Ray 取樣規則和群組

X-Ray API — 請參閱 AWS X-Ray API 參考資料中的以下操作：

AWS CLI — 請參閱《AWS CLI 指令參考》中的 x 射線

開發套件 – 請參閱 AWS 說明文件頁面上適用的開發套件說明文件

每一資源最多標籤數：50

金鑰長度上限 - 128 個 Unicode 字元

數值長度上限 - 256 個 Unicode 字元

金鑰與值的有效值 – a-z、A-Z、0-9、空格和下列字元：_ . : / = + - 及 @

標籤鍵與值皆區分大小寫。

不要用aws:作密鑰的前綴; 它保留供 AWS 使用。

若要將標記新增至新群組，請執行下列命令，將 group_name 取代為您的群組名稱，將 mydomain.com 取代為服務的端點，使用標籤金鑰的 key_name，以及選擇性地以標籤值取代值。如需如何建立群組的詳細資訊，請參閱使用 X-Ray API 設定取樣、群組和加密設定。

aws xray create-group \
   --group-name "group_name" \
   --filter-expression "service(\"mydomain.com\") {fault OR error}" \
   --tags [{"Key": "key_name","Value": "value"},{"Key": "key_name","Value": "value"}]

以下是範例。

aws xray create-group \
   --group-name "AdminGroup" \
   --filter-expression "service(\"mydomain.com\") {fault OR error}" \
   --tags [{"Key": "Stage","Value": "Prod"},{"Key": "Department","Value": "QA"}]

若要將標籤新增至新的取樣規則，請執行下列命令，以標籤鍵取代 key_name，並選擇性地使用標籤值取代值。此命令將--sampling-rule參數中的值指定為 JSON 檔案。如需如何建立取樣規則的詳細資訊，請參閱使用 X-Ray API 設定取樣、群組和加密設定。

aws xray create-sampling-rule \
   --cli-input-json file://file_name.json

以下是由參數指定的 JSON 檔案檔案名稱 .json 的內容。--cli-input-json

{
    "SamplingRule": {
        "RuleName": "rule_name",
        "RuleARN": "string",
        "ResourceARN": "string",
        "Priority": integer,
        "FixedRate": double,
        "ReservoirSize": integer,
        "ServiceName": "string",
        "ServiceType": "string",
        "Host": "string",
        "HTTPMethod": "string",
        "URLPath": "string",
        "Version": integer,
        "Attributes": {"attribute_name": "value","attribute_name": "value"...}
    }
    "Tags": [
           {
               "Key":"key_name",
               "Value":"value"
           },
           {
               "Key":"key_name",
               "Value":"value"
           }
          ]
}

下列是範例命令。

aws xray create-sampling-rule \
   --cli-input-json file://9000-base-scorekeep.json

以下是--cli-input-json參數所指定之範例9000-base-scorekeep.json檔案的內容。

{
    "SamplingRule": {
        "RuleName": "base-scorekeep",
        "ResourceARN": "*",
        "Priority": 9000,
        "FixedRate": 0.1,
        "ReservoirSize": 5,
        "ServiceName": "Scorekeep",
        "ServiceType": "*",
        "Host": "*",
        "HTTPMethod": "*",
        "URLPath": "*",
        "Version": 1
    }
    "Tags": [
           {
               "Key":"Stage",
               "Value":"Prod"
           },
           {
               "Key":"Department",
               "Value":"QA"
           }
          ]
}