查找和查看跟踪记录

跟踪记录列表页面(经典版)

跟踪记录列表页面可让您查找和检查每条跟踪记录的详情。您可以在此页面中查看和检查一条跟踪记录的所有 span、查看请求的摘要信息以及该跟踪记录中每条 span 的详情。如需限制正在调查的跟踪记录,请添加过滤条件。例如,您可以添加过滤条件,让系统仅显示延迟时间超过 1 秒的跟踪记录。

跟踪记录列表页面最多可存储和显示 1000 条跟踪记录。

如需查看最近的跟踪记录,请在 Google Cloud Console 中选择跟踪记录,然后选择跟踪记录列表,或使用以下按钮:

转到跟踪记录列表

如果这是您首次使用 Trace,则可能需要等几分钟才能显示跟踪记录。以下屏幕截图显示了 Compute Engine 配置的跟踪记录列表示例:

Compute Engine 的 Cloud Trace 列表。

时间间隔

跟踪记录列表页面默认显示前一小时的数据。您可以使用页面顶部的按钮将此时间间隔更改为预设值。预设选项为:

  • 1 小时
  • 4 小时
  • 12 小时
  • 1 天
  • 3 天
  • 1 周
  • 1 个月

默认情况下,时间间隔设为 1 小时

如需选择自定义时间范围,请使用鼠标指针突出显示延迟时间图表的某个部分。此选项会为显示的跟踪记录设置时间间隔和延迟时间值的范围。例如,下图会选择延迟时间范围大约在 90 ms390 ms 的时间间隔(19:006:10 AM):

在跟踪记录图表中选择自定义时间范围。

如需将图表恢复到预设的时间间隔,请点击撤消缩放

过滤条件

您可以使用过滤条件隐藏或查找单个跟踪记录。上一部分介绍了如何突出显示延迟时间图表的某个部分,以便更详细地显示部分跟踪记录,同时隐藏其他所有跟踪记录。本部分介绍了请求过滤条件和过滤条件菜单。

默认情况下,过滤条件设置为包含所有跟踪记录。

过滤条件 说明
请求过滤条件 可让您指定为显示跟踪记录而必须满足的一个或多个条件。通过过滤条件语法,您可以定义匹配是精确匹配还是前缀测试匹配。所有匹配项都区分大小写。 如需详细了解跟踪记录过滤条件语法,请参阅跟踪记录过滤条件

例如,如需列出根 span 名称为 Recv 的项目的所有跟踪记录,请输入根 span 名称 Recv 或根 span 名称的前缀,例如 Re

如果您想列出包含由 200-299 范围内的 /http/status_code 标签注释的 span 的所有跟踪记录(其中,延迟时间为一秒或更长,并且跟踪记录包含具有确切名称 /modules.GetNumInstances 的 span),请使用以下过滤条件:

    +span:/modules.GetNumInstances latency:1s /http/status_code:2
在上一个示例中,跟踪记录过滤条件字词 +span 会强制对 span 名称执行完全匹配。如果您要包含所有跟踪记录(其中 /modules.GetNumInstances 是 span 名称的前缀),请省略加号。

除非过滤条件表达式包含空格,否则您无需在过滤条件中添加字符串分隔符。例如,Recv"Recv" 是等效的。
HTTP 方法 您为此过滤条件选择的值仅会应用于由 /http/method 标签注释的跟踪记录根 span。您可以添加所有请求,也可以按 HTTP 方法类型过滤:GETDELETEPOSTPUT
HTTP 状态 您为此过滤条件选择的值仅会应用于由 /http/status_code 标签注释的跟踪记录根 span。您可以选择单个状态值(如 301)或状态值范围(如 3xx)。
服务 (仅适用于 App Engine)可让您按对应的服务选择跟踪记录。 系统会根据跟踪记录的所有 span 对您为服务选择的值进行测试。当任何 span 与该服务匹配时,系统会显示跟踪记录。
版本 (仅适用于 App Engine)可让您按应用的版本选择跟踪记录。 系统会根据跟踪记录的所有 span 对您为版本选择的值进行测试。当任何 span 与该值匹配时,系统会显示跟踪记录。

延迟时间图表

延迟时间图表中的每个点都对应一个特定请求。请求的 (x,y) 坐标与该请求的时间和延迟时间相对应。

当您将鼠标指针悬停在某个点上时,系统会显示一个包含日期、时间和延迟时间的对话框:

    5/15/2019, 9:25:02 AM - 69 ms

当您点击某个点时,会发生以下变化:

  • 系统会更新表,以突出显示您选择的请求。
  • 系统会打开一个窗格,其中显示了该请求的各项服务之间的延迟时间信息时间轴。
  • 系统会显示一个窗格,其中包含一个摘要表(包含该请求的相关信息)和一个详情表(包含根 span 的相关信息)。

点击时间轴中的某个 span 时,详细信息窗格会显示该 span 的其他相关信息。在此窗格中,您可以打开和查看日志条目(如果有)。如需了解详情,请参阅查看跟踪记录详情

最近请求表

默认情况下,最近请求表会显示最近的 5 个请求。该表会存储 1000 条跟踪记录。

属性 说明
延迟时间 应用处理请求的端到端时间。
HTTP 方法 HTTP 方法的类型(如果适用)。对于非 HTTP 请求,此字段为空。
URI 请求的相关 URI。
分析报告
指向关联分析报告(如果有)的链接。
时间 请求的开始时间。

您可以通过以下任一方法更改表中显示的请求:

  • 选择时间范围
  • 使用上一个 下一个 按钮可向后或向前浏览。
  • 点击列标题可更改行的顺序。
  • 点击延迟时间图表中的相应点。

后续步骤

跟踪记录列表页面可让您查找和检查每条跟踪记录的详情。您可以在此页面中查看和检查一条跟踪记录的所有 span、查看请求的摘要信息以及该跟踪记录中每条 span 的详情。如需限制正在调查的跟踪记录,请添加过滤条件。例如,您可以添加过滤条件,让系统仅显示延迟时间超过 1 秒的跟踪记录。

跟踪记录列表页面最多可存储和显示 1000 条跟踪记录。

如需查看最近的跟踪记录,请在 Google Cloud Console 中选择跟踪记录,然后选择跟踪记录列表,或使用以下按钮:

转到跟踪记录列表

如果这是您首次使用 Trace,则可能需要等几分钟才能显示跟踪记录。以下屏幕截图显示了 Compute Engine 配置的跟踪记录列表示例:

Compute Engine 的 Cloud Trace 列表。

时间间隔

跟踪记录列表页面默认显示前一小时的数据。您可以使用页面顶部的按钮将此时间间隔更改为预设值。预设选项为:

  • 1 小时
  • 6 小时
  • 12 小时
  • 1 天
  • 2 天
  • 4 天
  • 7 天
  • 14 天
  • 30 天

如需查看自定义时间间隔,请执行以下操作:

  1. 选择一个比您所需的自定义时间间隔要长的预设选项。
  2. 将鼠标指针放在选择跟踪记录图上的时间间隔一端,然后将鼠标指针水平拖动到间隔的另一端。
  3. (可选)如需查看自定义的延迟时间值范围,请将鼠标指针放在所需范围的某一端,然后将其垂直拖动到另一端。

您可以重复上述操作,直到您选择了所需的时间间隔和延迟时间范围/

如需将图表恢复到预设时间间隔,请点击重置

过滤条件

您可以使用过滤条件来隐藏或查找单个跟踪记录。每个过滤条件都由与 VALUE 配对的预定义 OPTION 指定。常规语法如下:

[OPTION] : [VALUE]

例如,以下屏幕截图演示了单个过滤条件。过滤条件选项为 RootSpanRecv. 为过滤条件值。使用此过滤条件时,系统仅会显示根 span 以 Recv. 为前缀的跟踪记录。

显示过滤条件。

如需显示与 Recv. 完全匹配的跟踪记录,请使用 +Recv. 作为过滤条件值。使用加号 + 表示您需要完全匹配。如需详细了解过滤选项,请参阅跟踪记录过滤条件

如果您添加多个过滤条件,系统仅会显示满足所有过滤条件的跟踪记录。

如需添加过滤条件,请执行以下操作:

  1. 点击添加跟踪记录过滤条件 以显示过滤条件选项菜单,然后选择一个 OPTION。您始终可以选择以下选项:

    • RootSpan:与根 span 名称一致。
    • SpanName:与 span 名称一致。
    • 方法:显示根 span 由 /http/method 标签注释的跟踪记录,其中标签的值与 VALUE 一致。
    • 状态:显示根 span 由 /http/status_code 标签注释的跟踪记录,其中值标签与 VALUE 匹配。在本例中,VALUE 可以包含特定的状态代码(如 301)或状态值范围(如 3xx)。
    • 最短延迟:显示其延迟时间至少为 VALUE 毫秒的跟踪记录。
    • 拥有标签:显示 VALUE 指定的标签至少显示在一个 span 中的跟踪记录。
    • 服务:(仅适用于 App Engine)显示包含至少一个其服务名称与 VALUE 一致的 span 的跟踪记录。
    • 版本:(仅适用于 App Engine)显示至少包含一个其应用版本与 VALUE 一致的 span 的跟踪记录。

    您可能会看到其他选项,例如网址标签:客户端

  2. (可选)如果您需要完全匹配,请输入加号 +。默认情况下,您可以通过使用 VALUE 执行前缀测试来确定匹配方式。如需详细了解过滤选项,请参阅跟踪记录过滤条件

  3. 通过执行某项以下操作来指定过滤条件 VALUE

    • VALUE 菜单中选择。菜单值选项并不能保证是完整的。
    • 手动输入值,然后按键盘上的 return

例如,如需显示包含 HTTP POST 命令且其延迟时间至少为 2 秒的所有跟踪记录,请添加一个包含值为 2000MinLatency 选项的过滤条件。

延迟时间图表

带有选择跟踪记录标签的图表会为您所选时间间隔内的每个请求显示一个点。请求的 (x,y) 坐标与该请求的时间和延迟时间相对应。

当您将鼠标指针悬停在某个点上时,系统会显示一条工具提示,其中包含日期、时间、URI 和延迟时间:

显示的跟踪记录工具提示,其中包含延迟时间信息。

当您点击某个点时,会发生以下变化:

  • 系统会刷新图表,并在您选择的点周围画一个圆圈,以突出显示该点。
  • 请求表会突出显示选定的 URI。
  • 跟踪记录列表页面中可能会打开两个新窗格。瀑布图以 URI 形式显示每个 span。“详细信息”窗格会显示有关 URI 的详细信息,并包含指向日志和分析报告(如果有)的链接。如果这些窗格已打开,点击相应点会刷新这些窗格中显示的数据。

最近请求表

默认情况下,最近请求表会显示最近的 5 个请求。该表会存储 1000 条跟踪记录。

属性 说明
延迟时间 应用处理请求的端到端时间。
HTTP 方法 HTTP 方法的类型(如果适用)。对于非 HTTP 请求,此字段为空。
URI 请求的相关 URI。
分析报告 指向关联分析报告(如果有)的链接。
时间 请求的开始时间。

您可以通过以下任一方法更改表中显示的请求:

  • 选择时间范围
  • 使用上一个 下一个 按钮可向后或向前浏览。
  • 点击列标题可更改行的顺序。
  • 点击延迟时间图表中的相应点。

后续步骤