标签 X-Ray 采样规则和组 - Amazon X-Ray
标签限制在控制台中管理标签管理标签Amazon CLI基于标签控制对 X-Ray 资源的访问
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

标签 X-Ray 采样规则和组

标签是可用于标识和组织Amazon资源的词或短语。您可以为每个资源添加多个标签。每个标签都包含您所定义的一个键和一个可选值。例如，标签键可能是domain，并且标签值可能为example.com。您可以根据添加的标签搜索和筛选您的资源。有关如何使用标签的更多信息，请参阅。标记Amazonresources中的Amazon一般参考。

您可以使用标签在 CloudFront 分配上强制实施基于标签的权限。有关更多信息，请参阅 。控制对 的访问Amazon使用资源标签的资源。

注意

标签编辑器和Amazon资源组目前不支持 X-Ray 资源。您可以使用添加和管理标签Amazon X-Ray控制台或 API。

您可以通过使用 X-Ray 控制台、API、Amazon CLI、软件开发工具包和Amazon Tools for Windows PowerShell。有关更多信息，请参阅以下文档：

注意

如果您无法在 X-Ray 资源上添加或更改标签，或者无法添加具有特定标记的资源，则可能没有执行此操作的权限。要请求访问权限，请联系Amazon用户在您的企业中拥有管理员X-Ray 中的权限。

标签限制

以下限制适用于标签。

  • 每个资源的标签数上限 – 50

  • 最大密钥长度 – 128 个 Unicode 字符

  • 最大值长度 – 256 个 Unicode 字符

  • 键和值的有效值 – a-z、A-Z、0-9、空格和以下字符：_ . : / = + - 和 @

  • 标签键和值区分大小写。

  • 请勿使用aws:作为键的前缀; 它保留为Amazon使用。

注意

您无法编辑或删除系统标签。

在控制台中管理标签

您可以在创建 X-Ray 组或采样规则时添加可选标签。以后还可以在控制台中更改或删除标签。

以下过程介绍如何在 X-Ray 控制台中为组添加、编辑和删除标签以及采样规则。

向新组添加标签（控制台）

创建新的 X-Ray 组时，您可以在创建组页.

  1. 登录到Amazon Web Services Management Console并在处打开 X-Ray 控制台https://console.aws.amazon.com/xray/home。

  2. 在导航窗格中，展开配置，然后选择Groups。

  3. 选择创建组。

  4. 在存储库的创建组页面上，为组指定名称和筛选器表达式。有关这些属性的更多信息，请参阅在 X-Ray 控制台中配置组。

  5. In标签中，输入标签键和标签值（可选）。例如，您可以输入标签键Stage，标签值为Production，以表示此组用于生产用途。添加标签时，如果需要，将显示一个新行以供您添加另一个标签。请参阅标签限制，了解对标签的限制。

  6. 添加完标签后，选择创建组。

向新采样规则添加标签（控制台）

当您创建新的 X-Ray 采样规则时，您可以在创建采样规则页.

  1. 登录到Amazon Web Services Management Console并在处打开 X-Ray 控制台https://console.aws.amazon.com/xray/home。

  2. 在导航窗格中，展开配置，然后选择采样。

  3. 选择创建采样规则。

  4. 在存储库的创建采样规则页面上，指定名称、优先级、限制、匹配条件和匹配属性。有关这些属性的更多信息，请参阅在 X-Ray 控制台中配置采样规则。

  5. In标签中，输入标签键和标签值（可选）。例如，您可以输入标签键Stage，标签值为Production，以表明此取样规则用于生产。添加标签时，如果需要，将显示一个新行以供您添加另一个标签。请参阅标签限制，了解对标签的限制。

  6. 添加完标签后，选择创建采样规则。

编辑或删除组的标签（控制台）

您可 X-Ray 在编辑组页.

  1. 登录到Amazon Web Services Management Console并在处打开 X-Ray 控制台https://console.aws.amazon.com/xray/home。

  2. 在导航窗格中，展开配置，然后选择Groups。

  3. 在Groups表中，选择组的名称。

  4. 在存储库的编辑组页面, 在中标签，编辑标签键和值。您不能有重复的标签键。标签值是可选的；如果需要，您可以删除值。有关的其他属性的更多信息编辑组页面，请参阅在 X-Ray 控制台中配置组。请参阅标签限制，了解对标签的限制。

  5. 要删除标签，请选择X在标签的右侧。

  6. 编辑或删除完成后，选择更新组。

编辑或删除采样规则的标签（控制台）

您可以更改或删除 X-Ray 采样规则上的标签编辑采样规则页.

  1. 登录到Amazon Web Services Management Console并在处打开 X-Ray 控制台https://console.aws.amazon.com/xray/home。

  2. 在导航窗格中，展开配置，然后选择采样。

  3. 在采样规则表中，选择采样规则的名称。

  4. In标签，编辑标签键和值。您不能有重复的标签键。标签值是可选的；如果需要，您可以删除值。有关的其他属性的更多信息编辑采样规则页面，请参阅在 X-Ray 控制台中配置采样规则。请参阅标签限制，了解对标签的限制。

  5. 要删除标签，请选择X在标签的右侧。

  6. 编辑或删除完成后，选择更新采样规则。

管理标签Amazon CLI

您可以在创建 X-Ray 组或采样规则时添加标签。您也可以使用Amazon CLI创建和管理标签。要更新现有组或采样规则上的标签，请使用Amazon X-Ray控制台或TagResource或者UntagResourceAPI。

将标签添加到新的 X-Ray 组或采样规则 (CLI)

要在创建新的 X-Ray 组或采样规则时添加可选标签，请使用以下命令之一。

  • 要向新组添加标签，请运行以下命令，将group_name使用您组的名称，我的域与服务的终端节点，key_name带有标签键，也可以选择值使用标签值。有关如何创建组的更多信息，请参阅。Groups。 

    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 文件。有关如何创建采样规则的更多信息，请参阅。采样规则。 

    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

    以下是示例的内容9000-base-scorekeep.json文件中指定的--cli-input-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"
           }
          ]
}

向现有资源添加标签 (CLI)

您可以运行tag-resource命令将标签添加到现有的 X-Ray 组或采样规则此方法可能比通过运行update-group或者update-sampling-rule。

要向组或抽样规则添加标签，请运行以下命令，将 ARN 替换为资源的 ARN，并指定要添加的标签的键和可选值。

aws xray tag-resource \
   --resource-arn "ARN" \
   --tag-keys [{"Key":"key_name","Value":"value"}, {"Key":"key_name","Value":"value"}]

以下是示例。

aws xray tag-resource \
   --resource-arn "arn:aws:xray:us-east-2:01234567890:group/AdminGroup" \
   --tag-keys [{"Key": "Stage","Value": "Prod"},{"Key": "Department","Value": "QA"}]

列出资源上的标签 (CLI)

您可以运行list-tags-for-resource命令列出 X-Ray 组或采样规则的标签。

要列出与组或抽样规则关联的标记，请运行以下命令，将 ARN 替换为资源的 ARN。

aws xray list-tags-for-resource \
   --resource-arn "ARN"

以下是示例。

aws xray list-tags-for-resource \
   --resource-arn "arn:aws:xray:us-east-2:01234567890:group/AdminGroup"

删除资源上的标签 (CLI)

您可以运行untag-resource命令可以从 X-Ray 组或采样规则中删除标签。

要从组或抽样规则中删除标签，请运行以下命令，将 ARN 替换为资源的 ARN，并指定要删除的标签的键。

您只能使用untag-resource命令。要删除标签值，请使用 X-Ray 控制台，或者删除标签并添加具有相同键但不同或空值的新标签。 

aws xray untag-resource \
   --resource-arn "ARN" \
   --tag-keys ["key_name","key_name"]

以下是示例。

aws xray untag-resource \
   --resource-arn "arn:aws:xray:us-east-2:01234567890:group/group_name" \
   --tag-keys ["Stage","Department"]

基于标签控制对 X-Ray 资源的访问

您可以将标签附加到 X-Ray 组或采样规则，或将请求中的标签传递给 X-Ray。要基于标签控制访问，您需要使用 xray:ResourceTag/key-name、aws:RequestTag/key-name 或 aws:TagKeys 条件键在策略的条件元素中提供标签信息。要了解有关这些条件键的更多信息，请参阅。控制对 的访问Amazon使用资源标签的资源。

要查看基于身份的策略（用于基于资源上的标签来限制对该资源的访问）的示例，请参阅管理基于标签的 X-Ray 组和采样规则的访问。