查找和探索跟踪记录

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

Trace 探索器页面最多可显示 1000 个 跟踪记录。

准备工作

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

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

有关角色的详细信息，请参阅 使用 Identity and Access Management 控制访问权限。

显示最近的跟踪记录

如需显示最近的跟踪记录，请执行以下操作：

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

   转到 Trace 探索器

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

   如果这是您第一次使用 Trace， 那么跟踪记录可能要过几分钟才会显示 以下屏幕截图显示了 Trace Explorer 的示例 页面：

   

   在散点图中，选定 时间间隔：

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

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

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

     

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

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

     1. 选择时������过自定义时���的预���选项 。
     2. 将指针放在时间的某一端的“Select a trace”图表中 然后水平拖动指针移动到 。

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

   • 按延迟时间过滤。默认情况下，所选时间间隔内的所有跟踪记录 。仅显示延迟时间为 将指针放在延迟时间值的一端 然后垂直拖动指针到另一端。

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

   • 点击 filter_list 添加跟踪记录过滤条件，选择一个过滤条件选项，然后 然后选择或输入一个过滤条件值。如果您添加了多个过滤条件 系统仅显示满足所有过滤条件的跟踪记录。 例如，显示包含 HTTP GET 命令的所有跟踪记录 并且延迟时间至少为 2 秒，请添加过滤条件方法：GET 和 MinLatency: 2000。

     以下过滤选项始终可用：

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

     • 服务：显示至少包含以下内容的跟踪记录 一个服务名称与过滤条件值匹配的 span。

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

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

     您可能会看到其他过滤选项，例如网址或 HTTP 标签。 如果您有与预定义过滤器匹配的用户定义的标签，那么 用户定义的标签带有 LABEL 前缀，以便区分 。例如，如果您创建了一个 Service 标签，则 在过滤器菜单中可看到 Service 和 LABEL:Service。

按 ID 查找跟踪记录

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

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

   转到 Trace 探索器

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

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

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

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

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

探索跟踪记录

如要探索跟踪记录，请点击散点图中的点。 当您点击散点图中的某个点时， Trace 探索器页面：

• 系统会刷新散点图，并突出显示您选择的圆点 圆点的周围绘制了一个圆圈。代表所有其他广告资源的点 都处于灰显状态

• 跟踪详情窗格显示以下内容：

  • 跟踪记录标识符。跟踪记录的全局唯一标识符是 128 位整数，表示为 32 字节的十六进制字符串。如需了解详情，请参阅 请参阅 Resource: Trace。

  • 一个摘要行，其中列出了开始时间、持续时间和 span。

  • A 日志和活动菜单。此菜单选项可控制系统如何记录和事件 。默认情况下，如果存在日志或事件，系统会在 跟踪 span。重叠的圆圈表示该 span 的 多个日志或事件要以行的形式显示每个日志或事件， 表格，展开 arrow_drop_down 日志和事件和 选择展开显示。

  • 表格。表格的第一行用于跟踪记录。添加了一行 为跟踪记录中的每个 span 提供的名称。

    对于 span，该表列出了 span 名称和关联的服务 服务名称提取自 OpenTelemetry 属性 service.name（如果设置了该属性）。 如果未设置该属性且运行服务 App Engine，那么 App Engine 服务名称为 。否则，该服务处于未指定状态。

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

下图演示了一个示例跟踪详情窗格：

在跟踪记录中搜索 span

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

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

然后，Trace 搜索 显示的跟踪记录。当搜索字段出现以下情况时，即视为匹配： 包含搜索字词（不区分大小写）。搜索以下字段：

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

搜索完成后，系统会刷新跟踪详情窗格，并 会突出显示匹配的字段。

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

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

查看 span 详情

如需查看有关跟踪记录或特定 span 的详细信息， 在跟踪详情窗格中，点击相应条目的延迟时间条。当您 选择延迟时间条，系统会重新绘制跟踪详情窗格并显示 一个标签式表格，可提供有关该条目的更多信息。

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

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

• 如需查找附加到 span 的标签，请查看属性标签页。对于 如需了解标签，请参阅 Trace 标签。 以下屏幕截图展示了此标签页：

  

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

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

  

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

  

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

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

  • span ID

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

  • 父级 span ID

  • 项目 ID

  • 开始时间和结束时间

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

    表中名为“Links”的每一行都列出了当前 span 之间的关联 和另一个 span。属性字段会列出 所关联到的 spanTrace 字段链接到 关联到 span。当此字段包含 Current trace 时， 链接到 span 与当前 span 位于同一跟踪记录中。否则 该字段包含跟踪记录 ID。有关链接的信息，请参阅 Links API 参考文档页面。

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

  

后续步骤

• 向跟踪记录 span 添加事件注释
• 跨项目查看跟踪记录
• 创建和查看报表