查找和探索跟踪记录

如需详细查找和探索各个跟踪记录,请使用跟踪浏览器页面。此页面会显示您的 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,跟踪记录可能需要几分钟才能显示。以下屏幕截图显示了 Trace Explorer 页面的示例:

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

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

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

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

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

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

  2. 可选:如需过滤显示的跟踪记录和 span,请执行以下任一操作:

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

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

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

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

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

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

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

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

        如果已设置 OpenTelemetry 属性 service.name,系统会从该属性中提取 span 的服务名称。如果未设置该属性,并且服务正在 App Engine 上运行,系统会显示 App Engine 服务名称。否则,该服务处于未指定状态。

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

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

按 ID 查找跟踪记录

在对突发事件或失败进行问题排查时,您可能知道跟踪记录 ID。如需探索该跟踪记录,请执行以下操作:

  1. 在 Google Cloud 控制台的导航面板中,选择 Trace,然后选择 Trace 探索器

    转到 Trace 探索器

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

    您必须选择用于存储轨迹数据的 Google Cloud 项目,除非项目属于某个组织。当某个项目属于组织时,您可以配置跨项目跟踪,以便查看组织中任何项目的跟踪数据。如需了解详情,请参阅跨项目查看跟踪记录

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

    当您输入有效 ID 时,跟踪记录详情窗格会显示跟踪记录及其 span 的相关信息。您可以使用该窗格中的选项探索跟踪记录。

探索跟踪记录

如需探索跟踪记录,请点击散点图中的某个点。点击散点图中的点后,跟踪记录浏览器页面会发生以下更改:

  • 系统会刷新散点图,并突出显示您选择的点,并围绕该点绘制一个圆圈。表示所有其他跟踪记录的点会变暗。
  • 跟踪记录详情窗格显示以下内容:

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

    • 日志和事件菜单。菜单选项用于控制日志和事件的显示方式。默认情况下,如果存在日志或事件,系统会在轨迹 span 中添加一个圆形。重叠的圆圈表示该 span 具有多个日志或事件。如需将每个日志或事件显示为表格中的行,请展开 日志和事件,然后选择展开显示

    • 表格。表的第一行用于跟踪记录。系统会为跟踪记录中的每个 span 添加一行。

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

      延迟时间列会直观地显示延迟时间、状态和事件注释(如果存在)。蓝色延迟条表示成功完成,红色延迟条表示发生错误。空间中的每个事件注解在延迟时间条上用一个圆圈表示。

下图展示了 Trace details 窗格示例:

Cloud Trace 详细信息窗格示例。

查看 span 详细信息

如需查看跟踪记录或特定 span 的详细信息,请在跟踪记录详情窗格中点击条目的延迟时间栏。当您选择延迟栏时,系统会重新绘制跟踪详情窗格,并显示一个标签页式表,其中会提供相应条目的额外信息。

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

如果您为表中的其他行选择了延迟栏(即某个 span 的一行),则该表包含四个标签页:属性日志和事件Stacktrace元数据和链接

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

    Cloud Trace 属性表示例。

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

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

    Cloud Trace 日志和事件标签页示例。

    当日志数据可用时,如需查看有关日志条目的详细信息,请点击 Show more

    展开的日志示例。

  • 如需查找可用的堆栈轨迹数量的相关信息以及捕获的堆栈轨迹的详细信息,请使用 Stacktrace 标签页。

  • 如需查找有关 span 的一般信息以及指向其他 span 的链接表格,请查看元数据和链接标签页。这些信息包括以下内容:

    • Span ID

      span ID 是 0 以外的 64 位整数。如需了解详情,请参阅 TraceSpan

    • 父级 span ID

    • 项目 ID

    • 开始时间和结束时间

    • 列出指向其他 span 的链接的表

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

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

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

后续步骤