> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 日志

> 查看 Hive Agent 运行历史、状态、追踪、节点、成本、来源和部分结果

Hive Agent logs 会在一个表格中显示 workspace 的所有 Hive Agent 运行,并支持查看追踪、节点、来源、预算 ledger 和最终响应。

## 如何打开 Hive Agent logs? <a href="#open-logs" id="open-logs" />

在侧边栏打开 **Hive Agents**。

点击 **Logs**。

## 如何筛选 logs? <a href="#filter-logs" id="filter-logs" />

使用日期范围、分页、列显示、筛选,以及用于 **All Sources**、**Dashboard** 和 **API** 的 **Source** 导航。

Hive Agent logs 支持 **Hive Agent**、**Status**、用于 **All Sources**、**Dashboard** 和 **API** 的 来源导航,以及按名称、目标或 request ID 搜索。

## pass 和 attempt 有什么区别? <a href="#passes-vs-attempts" id="passes-vs-attempts" />

**Pass** 是一次完整的执行和验证轮次。如果一个或多个节点被拒绝,Hive Agents 可以为仍需修复的工作开始下一轮 pass。

**Attempt** 是单个节点的一次具体执行或验证尝试。节点在执行、检查、被拒绝并重试时,可能会显示多个 attempts。

在 Run Console 中,节点执行尝试完成、但 verifier 尚未开始时,可能会显示 **等待验证**。这是用于查看实时进度的显示状态,不是已存储的运行状态。

**Compose attempts** 与节点 attempts 分开计算。它们发生在必需节点已经验证通过之后,用于重新生成并检查最终响应。

示例: 如果 pass 1 验证通过两个节点并拒绝一个节点,pass 2 会重试被拒绝的节点。该节点可能显示多个 attempts,因为每一次执行或验证尝试都会记录下来。

## 状态词汇表 <a href="#status-glossary" id="status-glossary" />

| 状态                  | 含义                                                                                                                                                                         |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `pending`           | 运行已创建,等待开始                                                                                                                                                                 |
| `preparing_sources` | Fetch Hive 在计划前处理来源                                                                                                                                                        |
| `planning`          | planner 创建节点和验证标准                                                                                                                                                          |
| `executing`         | executor 正在处理节点                                                                                                                                                            |
| `verifying`         | verifier 正在检查输出                                                                                                                                                            |
| `retrying`          | 被拒绝节点准备进入下一轮                                                                                                                                                               |
| `composing`         | composer 正在组装并检查最终响应                                                                                                                                                       |
| `blocked`           | 运行到达预算 gate。使用 `budget_block_state` 区分暂停: `awaiting_approval` 表示 workflow 正在等待 magic-link 审批（`ended_at` 为 null）；`stopped` 表示运行已因预算结束（hard cap、审批被拒绝或审批过期）,且 `ended_at` 已设置 |
| `completed`         | 运行成功完成或 best effort 完成                                                                                                                                                     |
| `failed`            | 运行无法完成                                                                                                                                                                     |
| `cancelling`        | 已请求取消                                                                                                                                                                      |
| `cancelled`         | 运行已取消                                                                                                                                                                      |

## 如何阅读详情页? <a href="#detail-sheet" id="detail-sheet" />

点击运行行。

根视图会显示最终响应、来源、节点、预算和运行配置。有已接受的编写结果时,最终响应优先使用它;已验证节点输出仍作为支持详情保留。

Run Console 会分别显示 **awaiting approval**（可以批准继续）和 **stopped on budget**（运行已结束）的 banner。stop banner 会尽量使用导致 blocked 的预算事件: 它会区分已花费金额已经达到 cap,还是下一步预计成本会超过 cap,并使用 blocked 当时记录的 cap,而不是之后 blueprint 中的值。控制台里的预算花费用 `cumulative_cost_usd`,也就是 `BudgetGate` 实际执行的同一数字,而不是计划阶段的 `projected_cost_usd` 估算。

## 追踪如何工作? <a href="#traces" id="traces" />

追踪会显示来源准备、planning、execution、verification、repeat decisions、compose attempts、budget checks、重试和最终状态。

compose span 会在编写开始时就出现,而不是等 composer 完成后才出现。compose 尝试进行中时,运行状态为 `composing`,且 `run_config.composition.status` 为 `running`。

execute 和 verify span 也会在每个节点阶段运行期间出现(`status: running`),并在阶段结束时在同一条 span 上完成。瀑布图按语义顺序(`pass_number`、节点位置、execute 在 verify 之前)对每个 pass 的每个节点分组显示 execute 再 verify,而不是仅按开始时间排序 — 这样即使子 trace 完成时间不同,并行节点仍然清晰可读。

选择阶段可查看 **Input**、**Output** 和 **Metadata**。失败、blocked 或可重试阶段会显示问题提示。预算 span 会在 span 头部显示预算设置,重复 span 会在同一位置显示重复设置。运行级失败信息只显示在 overview 和终态 span 上,允许通过的 budget check 保持为信息提示。

planner、executor、verifier 和 composer 调用可以展开显示子 AgentRun,包括模型推理、LLM 响应以及工具输入和响应面板。

## partial-result 取消后会怎样? <a href="#partial-result" id="partial-result" />

partial-result cancellation 会停止新节点工作,让已开始的工作完成,并保留已验证输出。最终状态仍是 `cancelled`。

另请参阅: [Log History](../monitoring/log-history) and [Troubleshooting](./troubleshooting).