查看跟踪详情

如果您选择了某个跟踪记录,则 Cloud Trace 会在跟踪记录列表页面中显示某个跟踪记录的详细信息。 此视图会显示有关请求的详细信息摘要、图形时间轴(显示请求的根 span 和任何 RPC 调用的子 span)以及为 span 收集的延迟时间数据的详细视图。

查看跟踪详情

  1. 在 Google Cloud Console 中,转到跟踪记录列表页面:

    转到跟踪记录列表

  2. 您可以通过以下多种方式显示有关跟踪记录的详细信息:

    • 点击表格中列出的 URI。
    • 点击图表中相应的点。
    • 选定的跟踪记录详情 视图中,输入十六进制格式的跟踪 ID。如果输入某个跟踪记录 ID,您可能会看到 Selected trace may not match current filtersSelected trace is outside the current time range 消息。这些信息性消息表明显示的跟踪记录与您的过滤条件或时间范围设置不匹配。

所选跟踪记录详情窗格

如果您选择检查某个跟踪记录,则系统会显示有关选定跟踪记录的详细信息:

  • 选定跟踪记录详情文本框将显示该跟踪记录的标识符。

  • 窗格使用瀑布图显示请求的延迟时间数据的图形表示。默认情况下,系统会突出显示选定跟踪记录的根 span。

  • 窗格会在一系列表中显示在瀑布图中突出显示的 span 的详细信息。

每次选择要检查的跟踪记录时,这些字段都会用新数据刷新。以下屏幕截图展示了这些窗格:

Cloud Trace“详细信息”窗格。

瀑布图

瀑布视图中的每一行都对应跟踪记录中的一个 span。

  • 如果显示 符号,则 Cloud Trace 检测到一个 span,其开始时间早于该 span 的父级的开始时间。Cloud Trace 在显示 span 时会自动补偿此不一致;但不会修改 span 数据。

    如果服务依赖于多个时钟源或不同的语言库,则可能会出现时间戳不一致的情况。

  • 如果显示 符号,则表明该 span 包含 HTTP 错误。

  • RPC 调用的名称,格式为 service_name.call_name。 例如 datastore_v3.RunQuery

    对于 App Engine 标准环境,此处报告的内部名称可能与特定语言的服务 API 中的名称不匹配。

  • 完成往返 RPC 调用花费的时间。

显示事件复选框

如果您选中显示事件,则会重新绘制瀑布图,并将事件注释作为行添加到图表中。如需详细了解注释,请参阅为 span 添加注释

点击复制

您只需点击复制 即可将特定跟踪记录的详情视图的网址复制到剪贴板。

包含 Span 详细信息的表

这些表包含当前瀑布图中突出显示的行的详细信息。瀑布图中的每一行都对应一个跟踪记录 span。

如果您突出显示某行,则该 span 的详细信息包含其 URI 名称、相对开始时间和 RPC 调用的名称。

表中显示的数据取决于突出显示的元素。但下表所列数据会始终显示:

属性 说明
相对开始时间 第一个条目是 span 的相对开始时间。

对于根 span,此值始终为 @0 ms

对于子 span,这是相对于请求开始的子 span 的开始时间。也就是说,此值会显示从总体请求开始到此 RPC 调用开始所花费的时间。
名称 下一个条目是 RPC 调用的名称。名称采用 service_name.call_name 格式。例如 datastore_v3.RunQuery

对于 App Engine 标准环境,此处报告的内部名称可能与特定语言的服务 API 中的名称不匹配

如果突出显示了某个根 span,且请求为 HTTP 请求,则将显示名为摘要的表。表中有一行对应于根 span,每个 RPC 对应一行:

摘要表
说明
名称 RPC 调用的名称,格式为 service_name.call_name。显示在 span 标签中。
RPC 数 该过程被调用的次数。
总时长 执行 RPC 花费的总时间。

标题为详情的表列出了 span 的元数据。始终显示以下属性:

详情表
属性
说明
时间戳 应用收到传入请求的时间。
日志 指向日志条目的链接(如果日志数据可用)。如果日志数据不可用,则省略此行。
报告 指向包含此跟踪记录的最新分析报告的链接。如果没有任何报告包含此跟踪记录,则省略此行。
跟踪记录 ID 要查看此字段,请点击详细信息菜单

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

Span ID 要查看此字段,请点击详细信息菜单

span 的标识符。此标识符是一个 64 位数字整数(0 除外)。如需了解详情,请参阅 TraceSpan

GKE 容器

显示此表时,该 span 将包含 GKE 容器的规范化标签。表中的每一行都对应于特定标签,值是可用于详细查看资源相关信息的链接。如需详细了解所有标签,请参阅跟踪记录标签

下表列出了标签及其含义:

标签
Project ID 托管 GKE 集群的 Google Cloud 项目。点击项目名称以转到 Google Cloud Console 中的 GKE 信息中心。
Cluster Name 标识 GKE 集群。要转到集群配置页面,请点击此值。
Namespace 标识命名空间。要转到 GKE 的工作负载页面,请点击此值。
Pod Name 标识 GKE Pod。要转到 Pod 详细信息信息中心,请点击此值。
Container Name 标识 GKE 容器。如需转到容器的详细信息页面,请点击此值。
标签 包含请求中的标签和值的表。 标签是应用专用的。如需详细了解所有标签,请参阅跟踪记录标签

下表列出了一些常见标签及其含义:

标签
http/host 应用运行的主机名。
http/response/size HTTP 响应正文中的字节数。
http/url 请求的相对网址。
gae/request_log_id 内部 App Engine 请求 ID。

当您的请求类型为 HTTP 或您的应用在 App Engine 上运行时,可能会列出其他属性。下表显示了一些通常观察到的属性的部分列表:

属性 说明
已跟踪的时间 (仅限 HTTP)完成所有 RPC 调用所花费的总时间。
未跟踪的时间 (仅限 HTTP)未进行 RPC 调用的时间。也就是说,这用于衡量应用在本地花费的时间。请注意,请求开始时未跟踪时间比通常情况要长,这通常是由于创建了处理负载的新实例导致的。
HTTP 方法 (仅限 HTTP)请求的 HTTP 方法。
服务 (仅限 App Engine)处理请求的 App Engine 服务。如需了解详情,请转到 App Engine
版本 (仅限 App Engine)处理请求的应用的版本。

如果您突出显示某个事件,则事件详情会显示在“详细信息”窗格中。 默认情况下,事件不会显示在瀑布图中。如需在瀑布图中添加这些事件,请点击显示事件

数据分析

当有可用的数据分析时,时间轴下方会显示关于请求性能的数据分析。

如需了解详情,请参阅数据分析

为 span 添加注释

您可以使用 Cloud Trace API v1 或 Cloud Trace API v2 为跟踪记录添加注释。本部分介绍了您可以使用的不同选项。

如需将跟踪记录与 Cloud Logging LogEntry 对象相关联,请使用注释。如需详细了解 Cloud Trace 和 Cloud Logging 之间的集成,请参阅与 Cloud Logging 的集成

使用标签添加注释

您可以在使用 Cloud Trace API v1 patchTraces 时向 span 添加注释,方法是创建一个 labels 对象并将其附加到 TraceSpan 对象。

当您查看跟踪记录的详细信息时,这些注释会显示为标签。如需详细了解标签,请参阅跟踪记录标签

使用属性添加注释

您可以在使用 Cloud Trace API v2 batchWrite 时为 span 添加注释,方法是创建一个 attributes 对象并将其附加到 Span 对象。

当您查看跟踪记录的详细信息时,这些注释会显示为标签。如需了解详情,请转到此页面上的查看跟踪记录详情

使用时间事件添加注释

您可以在使用 Cloud Trace API v2 batchWrite 时向 span 添加注释和消息事件,方法是创建一个 TimeEvents 对象并将其附加到 span 对象。

TimeEvents 对象是 TimeEvent 对象的数组,其中每个对象都包含一个消息事件和一个注释。

如需查看跟踪记录的 TimeEvents,请转到跟踪记录的瀑布图,然后点击显示事件。如果您选择 TimeEvent,则其详细信息将显示在“详细信息”窗格中。

后续步骤