标签 X-Ray 采样规则和组 - Amazon 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-nameaws:RequestTag/key-nameaws:TagKeys 条件键在策略的条件元素中提供标签信息。要了解有关这些条件键的更多信息,请参阅。控制对 的访问Amazon使用资源标签的资源

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