本文档介绍了如何访问和查看 Gemini Enterprise 应用生成的跟踪记录和 span。跟踪记录和 span 可提供有关应用内请求的性能和执行流程的详细洞见，例如在使用助理或智能体时。
您可以使用 Trace 探索器 查看跟踪记录数据，也可以直接在各个智能体中使用智能体的跟踪记录 标签页查看。
主要概念
本部分介绍了与 Gemini Enterprise 中的可观测性相关的主要概念。
| 概念 | 说明 |
|---|---|
| 跟踪记录 |
跟踪记录是一组 span，表示单个请求或
事务在不同服务和组件中的流转过程。
例如，跟踪记录表示请求的整个生命周期。这包括用户向 Gemini Enterprise 助理提问、Gemini Enterprise 助理做出响应， 以及答案触发的任何后续操作，例如发送一封 电子邮件。 |
| Span | Span 是跟踪记录中的单个计时工作单元。它表示特定操作，例如函数调用、API 请求或数据库查询。每个 span 都包含详细信息，例如开始时间和结束时间， 唯一 ID，以及与其他 span 的关系。这些关系 共同构成一条跟踪记录。 |
| Span 日志 | Span 日志是与特定 span 关联的带时间戳的自由格式消息或事件。 它们提供有关 span 执行的详细上下文信息，帮助用户调试问题并了解请求的流程。 |
准备工作
请确保您已备好：
Gemini Enterprise 管理员 角色或 Google Cloud 控制台 Gemini Enterprise 用户角色。
现有的 Gemini Enterprise Web 应用。如需了解如何创建新 应用，请参阅创建应用。
如需访问跟踪记录，您必须拥有 Cloud Trace 用户 角色 (
roles/cloudtrace.user)。启用 Enable instrumentation of OpenTelemetry traces and logs 可观测性设置。根据智能体类型的不同，您可以在应用级配置（对于 Core Assistant 智能体）或智能体的配置 标签页内（对于 Agent Designer 员工制作的智能体和 Deep Research 智能体）启用此设置。如需了解详情，请参阅 管理可观测性设置。
数据保留
Gemini Enterprise 应用生成的跟踪记录和 span 存储在 您的项目 Google Cloud 的 Cloud Trace 中，其保留期限由 Cloud Trace 决定。默认情况下，Cloud Trace 会将 span 数据保留 30 天； 超过保留期限的数据会自动删除。如需了解 权威且最新的保留期限值，请参阅 Cloud Trace 保留期限 在 Cloud Trace 配额和限制 文档中。
在 Trace 探索器中访问跟踪记录
如需使用 Trace 探索器访问跟踪记录和 span，请按以下步骤操作：
在 Google Cloud 控制台中，前往 Trace 探索器 页面。
选择创建 Gemini Enterprise 应用的 Google Cloud 项目。您会看到项目的所有 span。
在表格中，点击 Span ID 以查看跟踪记录详情，包括 span 的时长和其他属性。
访问智能体的跟踪记录
您还可以在智能体的跟踪记录 标签页中直接查看各个智能体的跟踪记录 span，该标签页会显示 span 跟踪记录和父子执行结构的详细时间顺序摘要。
如需访问智能体的跟踪记录，请执行以下操作：
- 在 Google Cloud 控制台中，前往您的应用，然后点击智能体。
- 选择要检查的智能体，然后点击跟踪记录 标签页。
跟踪记录摘要表
跟踪记录 标签页中的主表显示了每个跟踪记录 span 的以下信息：
- 状态：跟踪记录的当前状态（目前显示 Unset）。
- 跟踪记录 span ID：跟踪记录 span 的唯一标识符。点击 span ID 链接可深入了解其详细信息。
- Span 名称：对 span 所执行工作的简要说明。
- Span 类型: span 的类型。选项包括：
Agent to Tool：从智能体到外部工具的调用。Invoke Agent：智能体的调用。Agent to Model：从智能体到大语言模型的请求。
- 时长：完成跟踪记录 span 所花费的时间（以分钟为单位）。
- 输入：发送给 span 的输入数据或消息（如果有）。
- 输出：span 返回的输出结果（如果有）。
- 开始时间：span 开始执行的确切时间戳。
详细跟踪记录视图
点击跟踪记录 span ID 会打开一个详细信息页面，其中包含：
- 摘要：查看基准元数据，包括开始时间、 时长和Span总数。您可以点击在 Cloud Trace 中查看 ，或在图表 和时间轴 视图按钮之间切换。
- 可视化图表：在图形层次结构或时间轴视图之间切换， 以显示所有跟踪记录 span 的父子关系。
- 所选 span 详细信息：选择单个 span 以显示详细部分，其中可能包括：
- 摘要：显示 span 的名称、目标服务、具有此操作的 span 总数以及总时长（以秒为单位）。
- 日志：查看相关事件详细信息（如果已配置）。点击查看日志 可直接前往标准日志。
- 评估：显示任何评估结果（如果已配置）。
- 输入和输出 ：完整的请求和响应载荷。
- 日志和事件 ：此 span 执行期间发生的事件列表。
- 堆栈轨迹：span 执行失败时的错误详细信息。
- 元数据和链接 ：引用相关 Cloud Explorer 实体的链接。
- 属性：资源标签和其他键值对可观测性参数。
