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

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

标记 X-Ray 采样规则和组

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

以下是标签如何用于如何有效的 X-Ray:

  • 使用标签跟踪不同类别的账单信息。当您应用标签到 X-Ray 组和取样规则并激活标签， AWS 将成本分配报告作为逗号分隔值(CSV)文件生成以使用主动标签汇总的使用和成本。您可以应用代表业务类别（例如成本中心、系统名称或所有者）的标签，以便整理多种服务的成本。有关使用标签进行成本分配的更多信息，请参阅 使用成本分配标签 在 AWS Billing and Cost Management 用户指南.

  • 使用标签在 CloudFront 分配上强制实施基于标签的权限。有关详细信息，请参阅 使用资源标签控制对AWS资源的访问.

注意

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

您可以使用 X-Ray 控制台、API、 AWS CLI、SDK和 适用于 Windows PowerShell 的 AWS 工具. 有关更多信息，请参阅以下文档：

注意

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

标签限制

以下限制适用于标签。

  • 每个资源的最大标签数 – 50

  • 最大键长度 – 128 个 Unicode 字符

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

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

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

  • 请不要使用 aws: 作为键的前缀；它保留为供 AWS 使用。

注意

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

管理控制台中的标记

您可以在创建 X-Ray 组或采样规则。也可以稍后在控制台中更改或删除标记。

以下步骤说明如何为您的组添加、编辑和删除标记，以及在 X-Ray 控制台。

将标签添加到新组（控制台）

在您创建新的 X-Ray 您可以在 创建组 第页。

  1. 登录 AWS 管理控制台并通过以下网址打开 X-Ray 控制台：https://console.amazonaws.cn/xray/home。

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

  3. 选择 创建组.

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

  5. 在 标签，输入标签密钥，也可以输入标签值。例如，您可以输入 Stage、和标签值 Production，表示该组用于生产。在添加标签时，如有需要，将显示一条新的行以添加另一个标签。参见 标签限制 在本主题中有关标签的限制。

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

将标签添加到新的取样规则（控制台）

在您创建新的 X-Ray 采样规则，您可以在 创建取样规则 第页。

  1. 登录 AWS 管理控制台并通过以下网址打开 X-Ray 控制台：https://console.amazonaws.cn/xray/home。

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

  3. 选择 创建取样规则.

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

  5. 在 标签，输入标签密钥，也可以输入标签值。例如，您可以输入 Stage、和标签值 Production，表示此采样规则用于生产使用。在添加标签时，如有需要，将显示一条新的行以添加另一个标签。参见 标签限制 在本主题中有关标签的限制。

  6. 添加标签后，选择 创建取样规则.

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

您可以在 X-Ray 组上的 编辑组 第页。

  1. 登录 AWS 管理控制台并通过以下网址打开 X-Ray 控制台：https://console.amazonaws.cn/xray/home。

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

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

  4. 在 编辑组 页面， 标签，编辑标签密钥和值。您不能有重复标记密钥。标签值为可选；如果需要，可以删除值。有关 编辑组 页面，参见 在中配置组 X-Ray 控制台. 参见 标签限制 在本主题中有关标签的限制。

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

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

编辑或删除取样规则的标记（控制台）

您可以在 X-Ray 采样规则 编辑取样规则 第页。

  1. 登录 AWS 管理控制台并通过以下网址打开 X-Ray 控制台：https://console.amazonaws.cn/xray/home。

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

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

  4. 在 标签，编辑标签密钥和值。您不能有重复标记密钥。标签值为可选；如果需要，可以删除值。有关 编辑取样规则 页面，参见 在 X-Ray 控制台中配置采样规则. 参见 标签限制 在本主题中有关标签的限制。

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

  6. 完成编辑或删除标签后，选择 更新取样规则.

管理 AWS CLI

您可以在创建 X-Ray 组或采样规则。您还可以使用 AWS CLI 创建和管理标记。要更新现有组或采样规则上的标记，请使用 AWS X-Ray 控制台，或 标签资源 或 非标语资源 API。

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

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

  • 要将标记添加到新组，请运行以下命令，更换 group_name 您的团队名称，mydomain.com 随着服务的终点 key_name 带标签钥匙，可选 value 标记值。有关如何创建组的详细信息，请参阅 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 带标签钥匙，可选 value 标记值。此命令指定在 --sampling-rule 参数作为JSON文件。有关如何创建取样规则的详细信息，请参阅 采样规则. 

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

    以下是JSON文件的内容 file_name.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 条件键。如需了解有关这些条件密钥的更多信息，请参阅 使用资源标签控制对AWS资源的访问.

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