标记 X-Ray 采样规则和组 - Amazon X-Ray
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

标记 X-Ray 采样规则和组

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

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

注意

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

可以使用 X-Ray 控制台、API、Amazon CLI、开发工具包和 Amazon Tools for Windows PowerShell 将标签应用于资源。有关更多信息,请参阅以下文档:

注意

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

标签限制

以下限制适用于标签。

  • 每个资源的标签数上限 – 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. 在导航窗格中,展开配置,然后选择

  3. 选择创建组

  4. 创建组页面上,为组指定名称和筛选表达式。有关这些属性的更多信息,请参阅配置组

  5. 标签中,输入一个标签键和可选的标签值。例如,可以输入标签键“Stage”和标签值“Production”以指示该组用于生产。添加标签时会出现一个新行,供您根据需要添加另一个标签。请参阅本主题中的 标签限制,了解标签的限制。

  6. 在添加完标签后,请选择创建组

向新采样规则添加标签(控制台)

创建新的 X-Ray 采样规则时,可以在创建采样规则页面上添加标签。

  1. 登录到 Amazon Web Services Management Console,然后通过以下网址打开 X-Ray 控制台:https://console.aws.amazon.com/xray/home

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

  3. 选择创建采样规则

  4. 创建采样规则页面上,指定名称、优先级、限制、匹配标准和匹配属性。有关这些属性的更多信息,请参阅配置采样规则

  5. 标签中,输入一个标签键和可选的标签值。例如,可以输入标签键“Stage”和标签值“Production”以指示采购规则用于生产。添加标签时会出现一个新行,供您根据需要添加另一个标签。请参阅本主题中的 标签限制,了解标签的限制。

  6. 在添加完标签后,请选择创建采样规则

编辑或删除某个组的标签(控制台)

您可以在编辑组页面上更改或删除应用于某个 X-Ray 组的标签。

  1. 登录到 Amazon Web Services Management Console,然后通过以下网址打开 X-Ray 控制台:https://console.aws.amazon.com/xray/home

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

  3. 表中,选择相应组的名称。

  4. 编辑组页面的标签中,编辑标签键和值。标签键不得重复。标签值是选填,如果需要可以删除。有关编辑组页面上其他属性的更多信息,请参阅 配置组。请参阅本主题中的 标签限制,了解标签的限制。

  5. 若要删除标签,请选择标签右侧的 X

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

编辑或删除采样规则标签(控制台)

您可以在编辑采样规则页面上更改或删除应用于 X-Ray 采样规则的标签。

  1. 登录到 Amazon Web Services Management Console,然后通过以下网址打开 X-Ray 控制台:https://console.aws.amazon.com/xray/home

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

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

  4. 标签中,编辑标签键和值。标签键不得重复。标签值是选填,如果需要可以删除。有关编辑采样规则页面上其他属性的更多信息,请参阅 配置采样规则。请参阅本主题中的 标签限制,了解标签的限制。

  5. 若要删除标签,请选择标签右侧的 X

  6. 编辑或删除完标签后,选择更新采样规则

在 Amazon CLI 中管理标签

您可以在创建 X-Ray 组或采样规则时添加标签。您也可以使用 Amazon CLI 创建和管理标签。若要更新应用于现有组或采样规则的标签,请使用 Amazon X-Ray 控制台,或 TagResourceUntagResource API。

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

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

  • 若要向新的组添加标签,请运行以下命令,将 group_name 替换为您的组的名称,将 mydomain.com 替换为您的服务的端点,将 key_name 替换为标签键,还可以选择将替换为标签值。有关如何创建组的更多信息,请参阅

    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

    以下是由 --cli-input-json 参数指定的 JSON 文件 file_name.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" } ] }

向现有资源添加标签 (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-nameaws:TagKeys 条件键在策略的条件元素中提供标签信息。请参阅使用资源标签控制对 Amazon 资源的访问,了解有关这些条件键的更多信息。

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