标记 X-Ray 采样规则和组 - AWS 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-groupupdate-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-nameaws:RequestTag/key-name,或 aws:TagKeys 条件键。如需了解有关这些条件密钥的更多信息,请参阅 使用资源标签控制对AWS资源的访问.

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