跳转到主要内容

​
日志历史

当你想查看单独的提示词、工作流或智能体运行,并检查请求过程中发生了什么时,使用 Fetch Hive 中的日志历史。

​
概述

Fetch Hive 为提示词、工作流、智能体和知识库处理提供了独立的日志视图。每个视图以运行表格开始,然后允许你打开详情面板进行更深入的追踪和运行级检查。 这些日志视图用于按资源进行调查。如果你想从被跟踪的终端用户开始,然后打开他们的运行,请参阅筛选与钻取。

​
如何打开提示词、工作流或智能体的日志?

在主侧边栏中打开以下任一分区:
  • Prompts
  • Workflows
  • Agents
  • Knowledge Bases
然后在二级导航中点击 Logs。 Fetch Hive 会打开该资源类型的日志表格。 提示词、工作流和智能体日志在二级导航中暴露了 Source 分区。工作流日志可以在 All Sources、Dashboard、API、Scheduled、Webhook 和 Agent 之间切换。提示词日志可以在 Dashboard、API、Webhook 和 Experiment 之间切换。智能体日志可以在 Dashboard、API、Webhook、Experiment 和 Agent 之间切换。 如果你已经有完整的请求 ID,可以将 req_... 值粘贴到全局搜索并选择 Go to request,以直接打开请求详情页。

​
如何筛选日志?

三个日志页面都使用页眉中的日期范围控件、分页和表格中的列可见性控件。 每个日志页面还有自己的筛选集:
  • Prompts 日志支持 Provider、Model、API keys 和 Prompt
  • Workflows 日志支持 API keys、Workflow(仪表盘工作流和工作流部署)、源导航和 Delivery
  • Agents 日志支持 Provider、Model、API keys 和源导航
  • Knowledge Base 日志支持 Knowledge Base、API keys 和 Type
工作流日志上的 Delivery 筛选器允许你在 All、Callback 和 Direct 运行之间切换。源(Source)是启动运行的方式;投递(Delivery)是结果返回的方式。 某些筛选器选择器还包含行内搜索框,这样你可以快速在列表中找到某个提示词或工作流。 使用 Clear filters 来重置当前日志视图的有效筛选集。

​
跟踪的内容

日志表格展示了你在调试和监控时使用的主要运行字段。根据资源类型,Fetch Hive 显示以下字段的组合:
  • 完成或运行时间
  • 资源名称
  • 提供商或模型详情
  • 工具使用情况
  • 状态
  • 总成本
  • 总 token 数
  • 时长
  • API 密钥
  • 协作者
提示词日志在主表格中包含 Total Tokens 和 Total Cost。 智能体日志在主表格中也包含 Total Tokens 和 Total Cost,以及 Tools 列。 工作流日志聚焦于 Tools、Total Cost、Duration、API Key 和运行状态。 知识库日志聚焦于 Knowledge Base、Item、Type、Total Tokens、Total Cost、Duration、API Key 和运行状态。

​
如何阅读运行详情面板?

点击日志表格中的某一行可打开相应的详情面板。 面板以页眉开始,显示请求或运行 ID、当前状态,以及当该运行来自部署时显示的任何实时部署徽章。 下方,Fetch Hive 显示一个摘要条,根据运行类型展示最重要的运行级详情,例如时长、成本、token、工具数量、所有者或计费类型。 在面板右侧,Fetch Hive 显示所选运行或跨度的详细内容。这可能包括响应内容、请求详情、输入、元数据和输出部分。 对于基于模型的提示词、工作流提示词和智能体跨度,详情面板会在提供商报告时显示模型停止原因。这有助于区分正常停止与 token 限制、停止序列、工具使用或内容过滤。如果提供商在响应中途流断开,Fetch Hive 会将该运行标记为失败,并在日志详情中保留部分响应和提供商错误。

​
追踪

当某次运行具有追踪数据时,Fetch Hive 在详情面板的左侧显示瀑布面板。 使用该面板可逐步移动浏览该运行。选择跨度会更新详情面板,从而让你检查该跨度的时序和载荷详情。某些提供商报告的阶段不包含真实的时间边界;Fetch Hive 将其显示为时序不可用的结构性标记,而不是将它们当作零时长的提供商工作。 跨度详情可能包括:
  • 时长
  • 占总运行时间的百分比
  • 开始和完成时间戳
  • API 密钥
  • 用户
  • 元数据
  • 输出
对于提示词、工作流、智能体和知识库处理运行,该追踪视图是了解请求的哪个部分耗时、失败或产生特定输出的最快方式。智能体子智能体跨度保留其 child_request_id,因此即使子运行延迟完成或在部分工作后失败,嵌套的子运行也可以被单独打开,并被对账回父级追踪。 OpenTelemetry 不是该面向客户追踪视图的事实来源。OTel 是一种内部关联层,帮助工程团队跨 Rails、Sidekiq、Rust、Redis、SQL 和出站 HTTP 跟踪请求。Fetch Hive 的追踪行和 Analytics V3 继续使用产品追踪数据。

​
注意事项

  • 提示词和工作流日志支持 Source 切换,但智能体日志不暴露该导航。
  • 工作流日志在状态变化时刷新运行中的行,运行中的工作流行在不再处于运行状态之前不会打开详情面板。
  • 当某次运行具有可用的追踪数据时,会出现追踪瀑布。
  • 你也可以在 Users 部分钻取被跟踪的终端用户后,打开这些相同的详情面板。
另请参阅:额度使用。