查找和探索跟踪记录

如需详细查找和探索各个跟踪记录，请使用 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. 将指针放在时间间隔一端的选择跟踪记录图表上，然后水平拖动指针到时间间隔的另一端。

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

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

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

   • 点击 添加跟踪记录过滤条件，选择过滤条件选项，然后选择或输入过滤条件值。如果您添加了多个过滤条件，则系统将仅显示满足所有过滤条件的跟踪记录。例如，如需显示包含 HTTP GET 命令且延迟时间至少为 2 秒的所有跟踪记录，请添加过滤条件 Method: GET 和 MinLatency: 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 服务名称。否则，该服务处于未指定状态。

     • Version：（仅限 App Engine）显示至少包含一个 span 且应用版本与过滤条件值匹配的 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 Explorer 页面会发生以下更改：

• 散点图会刷新，并且您选择的点会通过该点周围绘制一个圆圈突出显示。代表所有其他轨迹的点会变暗。

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

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

  • 列出开始时间、时长和 span 数的摘要行。

  • 日志和事件菜单。此菜单选项用于控制日志和事件的显示方式。默认情况下，如果存在日志或事件，系统会向跟踪记录 span 添加一个圆圈。重叠的圆圈表示 span 包含多个日志或事件。如需将每个日志或事件显示为表中的一行，请展开 日志和事件，然后选择显示展开内容。

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

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

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

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

在跟踪记录中搜索 span

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

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

然后，Trace 会在显示的跟踪记录中搜索每个 span 的选择字段。如果搜索字段包含搜索字词，就会发生匹配（不区分大小写）。搜索以下字段：

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

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

例如，如果您输入字词 get，则会突出显示键为 /http/method 且值为 GET 的属性的 span。此外，名称（如 CurrencyService/GetSupportedCurrencies）的 span 也会突出显示。

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

查看 span 详情

注意 ：如需展开跟踪详情窗格以填充 Trace 探索器页面，请转到跟踪详情窗格的工具栏，然后点击 展开跟踪详情。

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

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

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

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

  

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

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

  

  当日志数据可用时，如需查看日志条目的详细信息，请点击 展开：

  

• 若要查找可用堆栈轨迹数量的相关信息以及已捕获的堆栈轨迹的详细信息，请使用堆栈轨迹标签页。

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

  • span ID

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

  • 父级 span ID

  • 项目 ID

  • 开始时间和结束时间

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

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

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

  

后续步骤

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