配置组

组是由筛选条件表达式定义的跟踪的集合。您可以使用群组生成其他服务图表并提供亚马逊 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。
执行以下任一操作以打开 “编辑群组” 页面。
1. 在 “群组” 页面上，选择群组名称进行编辑。
2. 在以下任一页面的群组菜单上，指向一个群组，然后选择 “编辑”。
  - 服务地图
  - 痕迹
  - 分析
尽管您无法重命名群组，但可以更新筛选表达式。有关如何构建筛选条件表达式的更多信息，请参阅使用筛选表达式。在以下示例中，群组筛选来自服务的故障跟踪信息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 组。

在亚马逊上查看群组指标 CloudWatch

创建群组后，当传入的轨迹存储在 X-Ray 服务中时，将根据该组的过滤器表达式进行检查。每分钟都会向亚马逊 CloudWatch 发布符合每个标准的跟踪数量的指标。在 “编辑群组” 页面上选择 “查看指标” 会打开 CloudWatch控制台进入 “指标” 页面。有关如何使用 CloudWatch 指标的更多信息，请参阅《亚马逊 CloudWatch 用户指南》中的 “使用亚马逊 CloudWatch指标”。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

分析

采样