查找和探索跟踪记录

如需查找和探索各个跟踪记录的详情,请使用 Trace 探索器 页面。此页面显示了您的 Google Cloud 项目所对应的跟踪记录 至少存储一个 span。 为显示的每条跟踪记录和 span 显示的数据包括摘要信息、 例如延迟时间和命令类型,以及详细信息。 详细信息包括日志、事件和其他信息。

Trace Explorer 页面最多可显示 1000 条跟踪记录。

准备工作

如需获取使用 Google Cloud 控制台查看跟踪记录数据所需的权限, 请让管理员授予您 您的项目的 Cloud Trace User (roles/cloudtrace.user) IAM 角色。 如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

如需详细了解角色,请参阅使用 Identity and Access Management 控制访问权限

显示近期轨迹

如需显示最新的轨迹,请执行以下操作:

  1. 在 Google Cloud 控制台中,转到 Trace 探索器页面:

    转到 Trace 探索器

    您也可以使用搜索栏查找此页面。

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

    Cloud Trace 最近的跟踪记录窗格。

    散点图会为所选时间间隔内的每个请求显示一个点:

    • 请求的 (x,y) 坐标对应于 请求的时间和延迟时间

    • 错误信息会编码为圆点的颜色。蓝色表示成功,红色表示失败。在上一个 屏幕截图,大多数命令都已成功完成。

    • 将指针悬停在某个点上时激活的提示, 会显示日期、时间、URI 和延迟时间:

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

  2. 可选:如需过滤显示的轨迹和跨度,请执行以下任一操作:

    • 按时间过滤。默认情况下,最近一小时的数据 。如需查看自定义时间间隔,请执行以下操作:

      1. 选择一个比您自定义的时间间隔要长的预设选项。
      2. 将鼠标指针放在选择跟踪记录图上的时间间隔一端,然后将鼠标指针水平拖动到间隔的另一端。

      如需将图表恢复到���设时间间隔,请点���������

    • 按延迟时间过滤。默认情况下,系统会显示所选时间间隔内的所有轨迹。如需仅显示延迟时间在某个时间范围内的轨迹,请将鼠标指针放在延迟时间值的一端,然后将鼠标指针垂直拖动到另一端。

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

    • 点击 Add trace filter(添加跟踪记录过滤器),选择过滤条件选项,然后选择或输入过滤条件值。如果您添加了多个过滤条件 系统仅显示满足所有过滤条件的跟踪记录。 例如,如需显示包含 HTTP GET 命令且其延迟时间至少为 2 秒的所有跟踪记录,请添加过滤条件 Method: GETMinLatency: 2000

      以下过滤条件选项始终可用:

      • RootSpan:与根 span 名称一致。
      • SpanName:与 span 名称一致。
      • 方法:显示根 span 由 /http/method 标签注释的跟踪记录,其中标签的值与过滤条件值一致。
      • 状态:显示根 span 由 /http/status_code 标签注释的跟踪记录,其中值标签与过滤条件值匹配。过滤条件值可以包含特定的状态代码 (例如 301)或状态值的范围, 例如 3xx
      • MinLatency:显示延迟时间至少与时一样长的跟踪记录 作为过滤条件值。过滤条件值必须以毫秒为单位。
      • HasLabel:显示过滤器指定的标签的跟踪记录 值至少在一个 span 中出现。
      • 服务:显示至少包含以下内容的跟踪记录 一个服务名称与过滤条件值匹配的 span。

        span 的服务名称是从 OpenTelemetry 中提取的 属性 service.name(如果设置了该属性)。 如果未设置该属性,且运行服务 App Engine,那么 App Engine 服务名称为 。否则,该服务处于未指定状态。

      • 版本:(仅限 App Engine)显示包含 至少一个其应用版本与过滤条件值匹配的 span。

      您可能会看到其他过滤选项,例如网址或 HTTP 标签。 如果您有与预定义过滤条件匹配的用户定义标签,则用户定义标签会添加 LABEL 作为前缀,以便您区分这两者。例如,如果您创建了一个 Service 标签,则 在过滤器菜单中可看到 ServiceLABEL:Service

按 ID 查找轨迹

在排查突发事件或故障时,您可能知道轨迹 ID。如需探索该跟踪记录,请执行以下操作:

  1. 在 Google Cloud 控制台中,转到 Trace 探索器页面:

    转到 Trace 探索器

    您也可以使用搜索栏查找此页面。

  2. 选择要查看跟踪记录数据的 Google Cloud 项目。

    除非您的项目属于某个组织,否则您必须选择存储轨迹数据的 Google Cloud 项目。当某个项目 属于可以配置跨项目跟踪的组织的一部分,并且该 可让您查看组织内任何项目的跟踪记录数据。 如需了解详情,请参阅跨项目查看跟踪记录

  3. 跟踪记录 ID 字段中输入此 ID。

    当您输入有效 ID 后,跟踪详情窗格将填充以下内容 有关跟踪记录及其 span 的信息。您可以使用该窗格中的选项来浏览轨迹。

探索跟踪记录

如需探索跟踪记录,请点击散点图中的某个点。当您点击散点图中的某个点时,轨迹探索器页面会发生以下变化:

  • 系统会刷新散点图,并突出显示您选择的圆点 圆点的周围绘制了一个圆圈。代表所有其他广告资源的点 都处于灰显状态
  • 轨迹详情窗格会显示以下内容:

    • 轨迹标识符。此跟踪记录的全局唯一标识符是 128 位整数,表示为 32 字节的十六进制字符串。如需了解详情,请参阅 请参阅 Resource: Trace
    • 列出开始时间、时长和跨度数量的摘要行。

    • A 日志和活动菜单。菜单选项用于控制日志和事件的显示方式。默认情况下,如果存在日志或事件,系统会在轨迹跨度中添加一个圆圈。重叠的圆圈表示该 span 包含多个日志或事件。要以行的形式显示每个日志或事件, 表格,展开 日志和事件和 选择展开显示

    • 表格。表格的第一行用于显示轨迹。系统会为轨迹中的每个 span 添加一行。

      对于 span,该表列出了 span 名称和关联的服务 服务名称是从 OpenTelemetry 属性 service.name(如果设置了该属性)。 如果未设置该属性,并且服务正在 App Engine 上运行,系统会显示 App Engine 服务名称。否则,该服务处于未指定状态。

      延迟时间列直观地显示了延迟时间, 状态和事件注释(如果存在)。蓝色延迟时间条表示 则红色延迟时间条表示发生了错误。 时空中的每个事件注释都用延迟时间栏上的圆圈表示。

以下是轨迹详情窗格的示例:

Cloud Trace 详细信息窗格的示例。

在轨迹中搜索 span

您可以在跟踪记录中的 span 和属性中搜索关键字。例如: 在上一个屏幕截图中,突出显示了某些 span 和一个属性键。 这些字段之所以被突出显示,是因为它们与搜索字词 net.sock.peer.port 匹配。

如需搜索跟踪记录中的 span,请在跟踪记录详情窗格的工具栏中执行以下操作: 在在跟踪中查找字段中输入搜索字词,然后按 Enter

然后,Trace 会搜索 显示的跟踪记录。如果搜索的字段包含搜索字词,则会出现匹配,不区分大小写。搜索以下字段:

  • Span 名称。
  • 服务名称。
  • 属性的键和值。

搜索完成后,轨迹详情窗格会刷新,并突出显示匹配的字段。

例如,如果输入字词 get,则 span 包含的属性 键为 /http/method,并且其值为 GET,则突出显示。此外, 带有“CurrencyService/GetSupportedCurrencies”等名称的图标会突出显示。

您无法使用正则表达式进行搜索,也无法搜索日志, 事件或元数据

查看 span 详情

如需查看跟踪记录或特定跨度的详细信息,请在跟踪记录详情窗格中点击相应条目的延迟时间条。选择延迟时间条后,跟踪记录详情窗格会重新绘制,并显示一个标签页式表格,其中包含有关该条目的更多信息。

如果您为表格中的第一行选择了延迟时间条,则此行 名为跟踪 ID, 则该表格包含两个标签页:摘要日志摘要 标签页列出了有关跟踪记录的常规信息。例如,对于 HTTP 命令 这个标签页会显示 HTTP 命令的类型、服务和延迟时间信息 为跟踪记录中的每个 span 提供的名称。

如果您为表中的其他行(即某行)选择了延迟时间条 则表包含以下四个标签页: 属性日志和事件堆栈轨迹元数据和链接

  • 如需��找附加到 span 的标签,请查看属性标签页。如需了解标签,请参阅跟踪记录标签。以下屏幕截图展示了此标签页:

    Cloud Trace 属性表示例。

    如需查找特定标签或一组标签,请添加过滤条件。例如,如果您添加过滤条件键:g.co,则表格会列出 标签键包含 g.co 的所有标签。

  • 如需查看相关日志条目和事件的相关信息(如果存在), 请查看日志和事件标签页。如需了解事件注释 请参阅为跟踪记录 span 添加注释。 以下屏幕截图展示了此标签页:

    示例:Cloud 的“跟踪日志和事件”标签页。

    当日志数据可用时,若要查看有关日志条目的详细信息, 点击 展开

    展开式日志示例。

  • 如需查找可用堆栈轨迹数量的相关信息, 如需详细了解捕获的堆栈轨迹,请参阅 Stacktraces 标签页。

  • 查找有关该 span 的常规信息以及指向 请参阅元数据和链接标签页。这些信息包括 以下:

    • span ID

      span ID 是 0 以外的 64 位整数。有关详情,请参阅 TraceSpan

    • 父级 span ID

    • 项目 ID

    • 开始时间和结束时间

    • 列出指向其他跨度的链接的表格

      表中名为“Links”的每一行都列出了当前 span 之间的关联 和另一个 span。Attributes 字段列出了所关联的 span 的键值对。Trace 字段链接到 关联到 span。当此字段包含 Current trace 时, 链接到 span 与当前 span 位于同一跟踪记录中。否则,该字段包含跟踪 ID。如需了解关联,请参阅 Links API 参考文档页面。

    以下屏幕截图展示了此标签页:

    Cloud Trace 元数据列表和链接表示例。

后续步骤