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

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

配置组

组是由筛选条件表达式定义的跟踪的集合。您可以使用群组生成其他服务图表并提供亚马逊 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
  1. 登录Amazon Web Services Management Console并打开 X-Ray 控制台,网址为 https://console.aws.amazon.com/xray/home

  2. 从左侧导航窗格的 “群组” 页面或以下页面之一的群组菜单中打开 “创建群组” 页面:服务地图跟踪分析

  3. 创建组页面上,输入组的名称。组名称最多可包含 32 个组名称最多可包含字母数字字符和短短短的短短的时间。组名称区分大小写。

  4. 输入筛选条件表达式。有关如何构建筛选条件表达式的更多信息,请参阅使用筛选表达式。在以下示例中,该组会筛选来自服务的api.example.com故障跟踪以及响应时间大于或等于五秒钟的服务请求。

    fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5
  5. Insights 中,启用或禁用群组的见解访问权限。有关见解的更多信息,请参阅 使用 X-Ray

    
                  群组页面上的见解复选框
  6. 标签中,输入一个标签值,(可选)。添加标签时,会出现一个新行供您输入另一个标签。标签键必须是唯一的。要删除标签,请选择标签行末的 X。有关标签的更多信息,请参阅 为 X-Ray 采样规则和组添加标签

    
                  在 “群组” 页面上标记字段
  7. 选择创建组

CloudWatch console
  1. 登录Amazon Web Services Management Console并通过 https://console.aws.amazon.com/cloudwatch/ 打开主 CloudWatch 机。

  2. 选择左侧导航窗格中的 Setings(设置)。

  3. X-Ray 轨迹部分的 “” 下选择 “查看设置”。

  4. 群组列表上方选择创建群组。

  5. 创建组页面上,输入组的名称。组名称最多可包含 32 个组名称最多可包含字母数字字符和短短短的短短的时间。组名称区分大小写。

  6. 输入筛选条件表达式。有关如何构建筛选条件表达式的更多信息,请参阅使用筛选表达式。在以下示例中,该组会筛选来自服务的api.example.com故障跟踪以及响应时间大于或等于五秒钟的服务请求。

    fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5
  7. Insights 中,启用或禁用群组的见解访问权限。有关见解的更多信息,请参阅 使用 X-Ray

    
                  群组页面上的见解复选框
  8. 标签中,选择添加新标签以输入标签键,也可以选择输入标签值。继续根据需要添加其他标签。标签键必须是唯一的。要删除标签,请选择每个标签下的 Remove(删除)。有关标签的更多信息,请参阅 为 X-Ray 采样规则和组添加标签

    
                  在 “群组” 页面上标记字段
  9. 选择创建组

申请群组

X-Ray console
  1. 登录Amazon Web Services Management Console并打开 X-Ray 控制台,网址为 https://console.aws.amazon.com/xray/home

  2. 从导航窗格中打开以下页面之一:

    • 服务地图

    • 痕迹

    • 分析

  3. 在群组菜单上,选择您在中创建的群组创建组。页面上显示的数据会发生变化,以匹配组中设置的过滤器表达式。

CloudWatch console
  1. 登录Amazon Web Services Management Console并通过 https://console.aws.amazon.com/cloudwatch/ 打开主 CloudWatch 机。

  2. X-Ray traces 下的导航窗格中打开以下页面之一

    • 服务地图

    • 痕迹

  3. 在 “按 X-Ray 筛选” 组过滤器中输入组名。页面上显示的数据会发生变化,以匹配组中设置的过滤器表达式。

编辑组

X-Ray console
  1. 登录Amazon Web Services Management Console并打开 X-Ray 控制台,网址为 https://console.aws.amazon.com/xray/home

  2. 执行以下任一操作以打开 “编辑群组” 页面。

    1. 在 “群组” 页面上,选择群组名称进行编辑。

    2. 在以下任一页面的群组菜单上,指向一个群组,然后选择 “编辑”

      • 服务地图

      • 痕迹

      • 分析

  3. 尽管您无法重命名群组,但可以更新筛选表达式。有关如何构建筛选条件表达式的更多信息,请参阅使用筛选表达式。在以下示例中,群组筛选来自服务的故障跟踪信息api.example.com,其中请求 URL 地址包含example/game,请求的响应时间大于或等于五秒。

    fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5
  4. Insights 中,为群组启用或禁用见解和见解通知。有关见解的更多信息,请参阅 使用 X-Ray

    
                  群组页面上的见解复选框
  5. 标签中,编辑标签键必须和值。标签键必须是唯一的。标签值是可选的;如果需要,可以删除值。要删除标签,请选择标签行末的 X。有关标签的更多信息,请参阅 为 X-Ray 采样规则和组添加标签

    
                  在 “群组” 页面上标记字段
  6. 更新完组后,选择 Update group(更新组)。

CloudWatch console
  1. 登录Amazon Web Services Management Console并通过 https://console.aws.amazon.com/cloudwatch/ 打开主 CloudWatch 机。

  2. 选择左侧导航窗格中的 Setings(设置)。

  3. X-Ray 轨迹部分的 “” 下选择 “查看设置”。

  4. 从 “群组” 部分中选择一个群组,然后选择 “编辑”

  5. 尽管您无法重命名群组,但可以更新筛选表达式。有关如何构建筛选条件表达式的更多信息,请参阅使用筛选表达式。在以下示例中,群组筛选来自服务的故障跟踪信息api.example.com,其中请求 URL 地址包含example/game,请求的响应时间大于或等于五秒。

    fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5
  6. Insights 中,启用或禁用群组的见解访问权限。有关见解的更多信息,请参阅 使用 X-Ray

    
                  群组页面上的见解复选框
  7. 标签中,选择添加新标签以输入标签键,也可以选择输入标签值。继续根据需要添加其他标签。标签键必须是唯一的。要删除标签,请选择每个标签下的 Remove(删除)。有关标签的更多信息,请参阅 为 X-Ray 采样规则和组添加标签

    
                  在 “群组” 页面上标记字段
  8. 更新完组后,选择 Update group(更新组)。

克隆组

克隆群组会创建一个具有现有组的过滤器表达式和标签的新组。克隆组时,新组与从中克隆该组的组同名,并在名称-clone后追加。

X-Ray console
  1. 登录Amazon Web Services Management Console并打开 X-Ray 控制台,网址为 https://console.aws.amazon.com/xray/home

  2. 从左侧导航窗格中打开 “组” 页面,然后选择要克隆的群组的名称。

  3. 从 “操作” 菜单中选择 “克隆组”。

  4. 在 “创建群组” 页面上,群组的名称是群组名称-clone。(可选)输入组的新名称。组名称最多可包含 32 个组名称最多可包含字母数字字符和短短短的短短的时间。组名称区分大小写。

  5. 您可以保留现有组中的过滤器表达式,也可以选择输入新的筛选表达式。有关如何构建筛选条件表达式的更多信息,请参阅使用筛选表达式。在以下示例中,该组会筛选来自服务的api.example.com故障跟踪以及响应时间大于或等于五秒钟的服务请求。

    service("api.example.com") { fault = true OR responsetime >= 5 }
  6. 标签中,根据需要编辑标签键和值。标签键必须是唯一的。标签值是可选的;如果需要,可以删除值。要删除标签,请选择标签行末的 X。有关标签的更多信息,请参阅 为 X-Ray 采样规则和组添加标签

  7. 选择创建组

CloudWatch console
  1. 登录Amazon Web Services Management Console并通过 https://console.aws.amazon.com/cloudwatch/ 打开主 CloudWatch 机。

  2. 选择左侧导航窗格中的 Setings(设置)。

  3. X-Ray 轨迹部分的 “” 下选择 “查看设置”。

  4. 从 “组” 部分中选择一个,然后选择 “克隆”。

  5. 在 “创建群组” 页面上,群组的名称是群组名称-clone。(可选)输入组的新名称。组名称最多可包含 32 个组名称最多可包含字母数字字符和短短短的短短的时间。组名称区分大小写。

  6. 您可以保留现有组中的过滤器表达式,也可以选择输入新的筛选表达式。有关如何构建筛选条件表达式的更多信息,请参阅使用筛选表达式。在以下示例中,该组会筛选来自服务的api.example.com故障跟踪以及响应时间大于或等于五秒钟的服务请求。

    service("api.example.com") { fault = true OR responsetime >= 5 }
  7. 标签中,根据需要编辑标签键和值。标签键必须是唯一的。标签值是可选的;如果需要,可以删除值。要删除标签,请选择标签行末的 X。有关标签的更多信息,请参阅 为 X-Ray 采样规则和组添加标签

  8. 选择创建组

删除组

按照本部分中的步骤删除组。您无法删除 Defa ul t 组。

X-Ray console
  1. 登录Amazon Web Services Management Console并打开 X-Ray 控制台,网址为 https://console.aws.amazon.com/xray/home

  2. 从左侧导航窗格中打开 Group(页面),然后选择要删除的组的名称。

  3. 在 “操作” 菜单上,选择 “删除群组”。

  4. 当系统提示确认时,选择 Delete(删除)。

CloudWatch console
  1. 登录Amazon Web Services Management Console并通过 https://console.aws.amazon.com/cloudwatch/ 打开主 CloudWatch 机。

  2. 选择左侧导航窗格中的 Setings(设置)。

  3. X-Ray 轨迹部分的 “” 下选择 “查看设置”。

  4. 从 “群组” 部分中选择一个群组,然后选择 “删除”。

  5. 当系统提示确认时,选择 Delete(删除)。

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

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

X-Ray console
  1. 登录Amazon Web Services Management Console并打开 X-Ray 控制台,网址为 https://console.aws.amazon.com/xray/home

  2. 从左侧导航窗格中打开 “组” 页面,然后选择要查看其指标的群组的名称。

  3. 编辑群组页面上,选择查看指标

    控制 CloudWatch 台指标页面在新选项卡中打开。

CloudWatch console
  1. 登录Amazon Web Services Management Console并通过 https://console.aws.amazon.com/cloudwatch/ 打开主 CloudWatch 机。

  2. 选择左侧导航窗格中的 Setings(设置)。

  3. X-Ray 轨迹部分的 “” 下选择 “查看设置”。

  4. 从 “群组” 部分中选择一个群组,然后选择 “编辑”

  5. 编辑群组页面上,选择查看指标

    控制 CloudWatch 台指标页面在新选项卡中打开。