本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
标记 X-Ray 采样规则和组
标签是可用于标识和组织 AWS 资源的词或短语。您可以向每个资源添加多个标记。每个标签都包含一个关键值和一个您定义的可选值。例如,标签键可能是 domain
,标签值可能是 example.com
...您可以根据添加的标签搜索和筛选资源。有关使用标签的方法的更多信息,请参阅 标记 AWS 资源 在 AWS 一般参考.
以下是标签如何用于如何有效的 X-Ray:
-
使用标签跟踪不同类别的账单信息。当您应用标签到 X-Ray 组和取样规则并激活标签, AWS 将成本分配报告作为逗号分隔值(CSV)文件生成以使用主动标签汇总的使用和成本。您可以应用代表业务类别(例如成本中心、系统名称或所有者)的标签,以便整理多种服务的成本。有关使用标签进行成本分配的更多信息,请参阅 使用成本分配标签 在 AWS Billing and Cost Management 用户指南.
-
使用标签在 CloudFront 分配上强制实施基于标签的权限。有关详细信息,请参阅 使用资源标签控制对AWS资源的访问
.
您可以使用 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 您可以在 创建组 第页。
-
登录 AWS 管理控制台并通过以下网址打开 X-Ray 控制台:https://console.amazonaws.cn/xray/home
。 -
在导航窗格中,展开 配置,然后选择 组.
-
选择 创建组.
-
在 创建组 页面,指定组的名称和筛选器表达式。有关这些属性的更多信息,请参阅在中配置组 X-Ray 控制台.
-
在 标签,输入标签密钥,也可以输入标签值。例如,您可以输入
Stage
、和标签值Production
,表示该组用于生产。在添加标签时,如有需要,将显示一条新的行以添加另一个标签。参见 标签限制 在本主题中有关标签的限制。 -
添加标签后,选择 创建组.
将标签添加到新的取样规则(控制台)
在您创建新的 X-Ray 采样规则,您可以在 创建取样规则 第页。
-
登录 AWS 管理控制台并通过以下网址打开 X-Ray 控制台:https://console.amazonaws.cn/xray/home
。 -
在导航窗格中,展开 配置,然后选择 采样.
-
选择 创建取样规则.
-
在 创建取样规则 页面,指定名称、优先级、限制、匹配条件和匹配属性。有关这些属性的更多信息,请参阅在 X-Ray 控制台中配置采样规则.
-
在 标签,输入标签密钥,也可以输入标签值。例如,您可以输入
Stage
、和标签值Production
,表示此采样规则用于生产使用。在添加标签时,如有需要,将显示一条新的行以添加另一个标签。参见 标签限制 在本主题中有关标签的限制。 -
添加标签后,选择 创建取样规则.
编辑或删除组的标记(控制台)
您可以在 X-Ray 组上的 编辑组 第页。
-
登录 AWS 管理控制台并通过以下网址打开 X-Ray 控制台:https://console.amazonaws.cn/xray/home
。 -
在导航窗格中,展开 配置,然后选择 组.
-
在 组 表,选择组的名称。
-
在 编辑组 页面, 标签,编辑标签密钥和值。您不能有重复标记密钥。标签值为可选;如果需要,可以删除值。有关 编辑组 页面,参见 在中配置组 X-Ray 控制台. 参见 标签限制 在本主题中有关标签的限制。
-
要删除标记,请选择 X 标签右侧。
-
完成编辑或删除标签后,选择 更新组.
编辑或删除取样规则的标记(控制台)
您可以在 X-Ray 采样规则 编辑取样规则 第页。
-
登录 AWS 管理控制台并通过以下网址打开 X-Ray 控制台:https://console.amazonaws.cn/xray/home
。 -
在导航窗格中,展开 配置,然后选择 采样.
-
在 采样规则 表,选择取样规则的名称。
-
在 标签,编辑标签密钥和值。您不能有重复标记密钥。标签值为可选;如果需要,可以删除值。有关 编辑取样规则 页面,参见 在 X-Ray 控制台中配置采样规则. 参见 标签限制 在本主题中有关标签的限制。
-
要删除标记,请选择 X 标签右侧。
-
完成编辑或删除标签后,选择 更新取样规则.
管理 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 基于标签的组和采样规则.