本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
配置组
组是由筛选条件表达式定义的跟踪的集合。您可以使用群组生成其他服务图表并提供亚马逊 CloudWatch 指标。您可以使用Amazon X-Ray控制台或 X-Ray API 为您的服务创建和管理群组。本主题描述如何使用 X-Ray 控制台创建和管理组。有关如何使用 X-Ray API 管理群组的信息,请参阅组。
您可以为服务地图、追踪或分析创建追踪组。创建群组后,该群组将在所有三个页面的群组下拉菜单中作为筛选器使用:服务地图、跟踪和分析。

组由其名称或 Amazon 资源名称 (ARN) 标识,并包含筛选条件表达式。此服务将比较传入到表达式的跟踪并相应地存储它们。有关如何构建筛选条件表达式的更多信息,请参阅使用筛选表达式。
更新组的筛选条件表达式不会更改已记录的数据。更新仅应用于后续跟踪。这可能会生成新旧表达式的合并图表。要避免这种情况,请删除当前组并创建一个新的组。
注意
群组按检索到的匹配筛选表达式的跟踪记录数量计费。有关更多信息,请参阅 Amazon X-Ray 定价
创建组
注意
现在,您可以从亚马逊 CloudWatch 控制台中配置 X-Ray 组。您也可以继续使用 X-Ray 控制台。
- X-Ray console
-
登录Amazon Web Services Management Console并打开 X-Ray 控制台,网址为 https://console.aws.amazon.com/xray/home
。 -
从左侧导航窗格的 “群组” 页面或以下页面之一的群组菜单中打开 “创建群组” 页面:服务地图、跟踪和分析。
-
在创建组页面上,输入组的名称。组名称最多可包含 32 个组名称最多可包含字母数字字符和短短短的短短的时间。组名称区分大小写。
-
输入筛选条件表达式。有关如何构建筛选条件表达式的更多信息,请参阅使用筛选表达式。在以下示例中,该组会筛选来自服务的
api.example.com
故障跟踪以及响应时间大于或等于五秒钟的服务请求。fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5
-
在 Insights 中,启用或禁用群组的见解访问权限。有关见解的更多信息,请参阅 使用 X-Ray。
-
在标签中,输入一个标签值,(可选)。添加标签时,会出现一个新行供您输入另一个标签。标签键必须是唯一的。要删除标签,请选择标签行末的 X。有关标签的更多信息,请参阅 为 X-Ray 采样规则和组添加标签。
-
选择创建组。
- CloudWatch console
-
登录Amazon Web Services Management Console并通过 https://console.aws.amazon.com/cloudwatch/
打开主 CloudWatch 机。 -
选择左侧导航窗格中的 Setings(设置)。
-
在 X-Ray 轨迹部分的 “组” 下选择 “查看设置”。
-
在群组列表上方选择创建群组。
-
在创建组页面上,输入组的名称。组名称最多可包含 32 个组名称最多可包含字母数字字符和短短短的短短的时间。组名称区分大小写。
-
输入筛选条件表达式。有关如何构建筛选条件表达式的更多信息,请参阅使用筛选表达式。在以下示例中,该组会筛选来自服务的
api.example.com
故障跟踪以及响应时间大于或等于五秒钟的服务请求。fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5
-
在 Insights 中,启用或禁用群组的见解访问权限。有关见解的更多信息,请参阅 使用 X-Ray。
-
在标签中,选择添加新标签以输入标签键,也可以选择输入标签值。继续根据需要添加其他标签。标签键必须是唯一的。要删除标签,请选择每个标签下的 Remove(删除)。有关标签的更多信息,请参阅 为 X-Ray 采样规则和组添加标签。
-
选择创建组。
申请群组
- X-Ray console
-
登录Amazon Web Services Management Console并打开 X-Ray 控制台,网址为 https://console.aws.amazon.com/xray/home
。 -
从导航窗格中打开以下页面之一:
-
服务地图
-
痕迹
-
分析
-
-
在群组菜单上,选择您在中创建的群组创建组。页面上显示的数据会发生变化,以匹配组中设置的过滤器表达式。
- CloudWatch console
-
登录Amazon Web Services Management Console并通过 https://console.aws.amazon.com/cloudwatch/
打开主 CloudWatch 机。 -
从 X-Ray traces 下的导航窗格中打开以下页面之一:
-
服务地图
-
痕迹
-
-
在 “按 X-Ray 筛选” 组过滤器中输入组名。页面上显示的数据会发生变化,以匹配组中设置的过滤器表达式。
编辑组
- X-Ray console
-
登录Amazon Web Services Management Console并打开 X-Ray 控制台,网址为 https://console.aws.amazon.com/xray/home
。 -
执行以下任一操作以打开 “编辑群组” 页面。
-
在 “群组” 页面上,选择群组名称进行编辑。
-
在以下任一页面的群组菜单上,指向一个群组,然后选择 “编辑”。
-
服务地图
-
痕迹
-
分析
-
-
-
尽管您无法重命名群组,但可以更新筛选表达式。有关如何构建筛选条件表达式的更多信息,请参阅使用筛选表达式。在以下示例中,群组筛选来自服务的故障跟踪信息
api.example.com
,其中请求 URL 地址包含example/game
,请求的响应时间大于或等于五秒。fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5
-
在 Insights 中,为群组启用或禁用见解和见解通知。有关见解的更多信息,请参阅 使用 X-Ray。
-
在标签中,编辑标签键必须和值。标签键必须是唯一的。标签值是可选的;如果需要,可以删除值。要删除标签,请选择标签行末的 X。有关标签的更多信息,请参阅 为 X-Ray 采样规则和组添加标签。
-
更新完组后,选择 Update group(更新组)。
- CloudWatch console
-
登录Amazon Web Services Management Console并通过 https://console.aws.amazon.com/cloudwatch/
打开主 CloudWatch 机。 -
选择左侧导航窗格中的 Setings(设置)。
-
在 X-Ray 轨迹部分的 “组” 下选择 “查看设置”。
-
从 “群组” 部分中选择一个群组,然后选择 “编辑”。
-
尽管您无法重命名群组,但可以更新筛选表达式。有关如何构建筛选条件表达式的更多信息,请参阅使用筛选表达式。在以下示例中,群组筛选来自服务的故障跟踪信息
api.example.com
,其中请求 URL 地址包含example/game
,请求的响应时间大于或等于五秒。fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5
-
在 Insights 中,启用或禁用群组的见解访问权限。有关见解的更多信息,请参阅 使用 X-Ray。
-
在标签中,选择添加新标签以输入标签键,也可以选择输入标签值。继续根据需要添加其他标签。标签键必须是唯一的。要删除标签,请选择每个标签下的 Remove(删除)。有关标签的更多信息,请参阅 为 X-Ray 采样规则和组添加标签。
-
更新完组后,选择 Update group(更新组)。
克隆组
克隆群组会创建一个具有现有组的过滤器表达式和标签的新组。克隆组时,新组与从中克隆该组的组同名,并在名称-clone
后追加。
- X-Ray console
-
登录Amazon Web Services Management Console并打开 X-Ray 控制台,网址为 https://console.aws.amazon.com/xray/home
。 -
从左侧导航窗格中打开 “群组” 页面,然后选择要克隆的群组的名称。
-
从 “操作” 菜单中选择 “克隆组”。
-
在 “创建群组” 页面上,群组的名称是
群组名称
-clone
。(可选)输入组的新名称。组名称最多可包含 32 个组名称最多可包含字母数字字符和短短短的短短的时间。组名称区分大小写。 您可以保留现有组中的过滤器表达式,也可以选择输入新的筛选表达式。有关如何构建筛选条件表达式的更多信息,请参阅使用筛选表达式。在以下示例中,该组会筛选来自服务的
api.example.com
故障跟踪以及响应时间大于或等于五秒钟的服务请求。service("api.example.com") { fault = true OR responsetime >= 5 }
-
在标签中,根据需要编辑标签键和值。标签键必须是唯一的。标签值是可选的;如果需要,可以删除值。要删除标签,请选择标签行末的 X。有关标签的更多信息,请参阅 为 X-Ray 采样规则和组添加标签。
-
选择创建组。
- CloudWatch console
-
登录Amazon Web Services Management Console并通过 https://console.aws.amazon.com/cloudwatch/
打开主 CloudWatch 机。 -
选择左侧导航窗格中的 Setings(设置)。
-
在 X-Ray 轨迹部分的 “组” 下选择 “查看设置”。
-
从 “组” 部分中选择一个组,然后选择 “克隆”。
-
在 “创建群组” 页面上,群组的名称是
群组名称
-clone
。(可选)输入组的新名称。组名称最多可包含 32 个组名称最多可包含字母数字字符和短短短的短短的时间。组名称区分大小写。 您可以保留现有组中的过滤器表达式,也可以选择输入新的筛选表达式。有关如何构建筛选条件表达式的更多信息,请参阅使用筛选表达式。在以下示例中,该组会筛选来自服务的
api.example.com
故障跟踪以及响应时间大于或等于五秒钟的服务请求。service("api.example.com") { fault = true OR responsetime >= 5 }
-
在标签中,根据需要编辑标签键和值。标签键必须是唯一的。标签值是可选的;如果需要,可以删除值。要删除标签,请选择标签行末的 X。有关标签的更多信息,请参阅 为 X-Ray 采样规则和组添加标签。
-
选择创建组。
删除组
按照本部分中的步骤删除组。您无法删除 Defa ul t 组。
- X-Ray console
-
登录Amazon Web Services Management Console并打开 X-Ray 控制台,网址为 https://console.aws.amazon.com/xray/home
。 -
从左侧导航窗格中打开 Group(组页面),然后选择要删除的组的名称。
-
在 “操作” 菜单上,选择 “删除群组”。
-
当系统提示确认时,选择 Delete(删除)。
- CloudWatch console
-
登录Amazon Web Services Management Console并通过 https://console.aws.amazon.com/cloudwatch/
打开主 CloudWatch 机。 -
选择左侧导航窗格中的 Setings(设置)。
-
在 X-Ray 轨迹部分的 “组” 下选择 “查看设置”。
-
从 “群组” 部分中选择一个群组,然后选择 “删除”。
-
当系统提示确认时,选择 Delete(删除)。
在亚马逊上查看群组指标 CloudWatch
创建群组后,当传入的轨迹存储在 X-Ray 服务中时,将根据该组的过滤器表达式进行检查。每分钟都会向亚马逊 CloudWatch 发布符合每个标准的跟踪数量的指标。在 “编辑群组” 页面上选择 “查看指标” 会打开 CloudWatch控制台进入 “指标” 页面。有关如何使用 CloudWatch 指标的更多信息,请参阅《亚马逊 CloudWatch 用户指南》中的 “使用亚马逊 CloudWatch指标”。
- X-Ray console
-
登录Amazon Web Services Management Console并打开 X-Ray 控制台,网址为 https://console.aws.amazon.com/xray/home
。 -
从左侧导航窗格中打开 “群组” 页面,然后选择要查看其指标的群组的名称。
-
在编辑群组页面上,选择查看指标。
控制 CloudWatch 台指标页面在新选项卡中打开。
- CloudWatch console
-
登录Amazon Web Services Management Console并通过 https://console.aws.amazon.com/cloudwatch/
打开主 CloudWatch 机。 -
选择左侧导航窗格中的 Setings(设置)。
-
在 X-Ray 轨迹部分的 “组” 下选择 “查看设置”。
-
从 “群组” 部分中选择一个群组,然后选择 “编辑”。
-
在编辑群组页面上,选择查看指标。
控制 CloudWatch 台指标页面在新选项卡中打开。