> ## 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.

# 日志

> 查看工作流运行，按来源和投递方式过滤活动，检查追踪，并调试回调投递

# 日志

工作流日志帮助你检查运行启动之后发生的情况，无论该运行来自仪表板、API、定时任务、Webhook 触发还是智能体。使用此页面可查看最近的工作流活动、过滤你关心的运行，并打开包含追踪数据和输出的运行详情面板。

## 概述

工作流日志 UI 是工作流部分中 **Logs** 下的表格驱动视图。它支持从侧边栏进行来源过滤、从标题栏进行日期范围过滤，并通过详细的运行面板进行行级检查。

当你打开已完成的运行时，详情面板会汇总摘要数据、追踪瀑布图、请求详情、输出、启动输入以及（在存在时）回调投递信息。

## 如何打开工作流日志？ <a href="#open-workflow-logs" id="open-workflow-logs" />

在侧边栏中打开 **Workflows**。

点击工作流部分菜单中的 **Logs**。

当你想在 **All Sources**、**Dashboard**、**API**、**Scheduled**、**Webhook** 和 **Agent** 之间切换时，请使用侧边栏中的 **Source** 分组。

当你只想查看从编辑器或仪表板 UI 启动的运行时，使用 **Dashboard**。当你只想查看通过公共 API 从工作流部署启动的运行时，使用 **API**。对于由这些来源启动的运行，请使用 **Scheduled**、**Webhook** 和 **Agent**。

{/* Add screenshot: workflow logs table */}

## 我可以在工作流日志中过滤哪些内容？ <a href="#filter-workflow-logs" id="filter-workflow-logs" />

使用标题栏中的日期范围控件选择自定义范围或可用的预设。预设包括最近 1、7、30 或 90 天等范围，但更长的范围可能需要日志历史更久的套餐。

使用 **API keys** 将表格缩小到使用一个或多个工作区 API 密钥启动的运行。

当你想单独查看某个工作流的运行时，使用 **Workflow**。

使用 **Delivery** 在 **All**、**Callback** 和 **Direct** 运行之间切换。投递方式与来源是独立的：API invoke 运行可以使用回调投递，而由 Webhook 触发的运行始终使用回调投递。

使用 **User metadata** 按已跟踪的元数据属性过滤。选择一个属性键来查找该键存在的运行，或添加一个精确值来匹配标量值，如 `cus_123`、`enterprise`、`true` 或 `12`。

点击 **Clear filters** 重置当前活动的过滤状态。

## 工作流日志表中跟踪哪些内容？

主日志表显示每次运行的摘要字段，包括：

* **Completed At**
* **Name**
* **Tools**
* **Status**
* **Total Cost**
* **Duration**
* **API Key**
* **Collaborator**

对于实时运行，**Name** 列还可以显示部署变体标记，包括变体名称和版本号。

**Tools** 列反映为该运行贡献了实际工作完成的提供商或步骤来源。工作流编排记录（例如并行步骤聚合）不会出现在此摘要中，尽管它们仍可能出现在追踪时间线中。

## 如何检查一次工作流运行？ <a href="#inspect-workflow-run" id="inspect-workflow-run" />

在日志表中点击一行已完成的运行。

Fetch Hive 会在右侧打开运行详情面板。

标题显示运行 ID、状态、开始时间、部署变体标记（如有）、来源标记（如 **Scheduled** 或 **Webhook**），以及当运行使用回调投递时显示的 **Callback** 标记。

下方的摘要条显示该运行的工作流、持续时间、成本、工具和所有者。

如果工作流仍存在且未归档，则摘要条中的工作流名称会链接回工作流编辑器。

## 追踪 <a href="#traces" id="traces" />

使用运行详情面板左侧的追踪瀑布图，了解运行随时间推进的情况。

每个 span 帮助你检查运行的特定部分，例如传入的请求、工作流启动、工具活动、LLM 活动和工作流完成。

当你选择一个 span 时，右侧会更新以显示该 span 的详情和任何关联的补全数据。根据所选 span，这可能包括：

* 模型响应数据
* 请求详情
* 启动输入
* 输出内容
* 用户元数据
* 元数据
* 令牌和成本明细

对于 Claude AI 提示词补全，请求详情可以包含 **Prompt Cache**，即分配给该步骤运行的已配置 Anthropic 提示词缓存 TTL。实际的缓存读取和写入仍通过缓存令牌使用字段显示。

这是工作流运行的主要调试视图。当你需要了解工作流的哪个部分运行缓慢、失败或产生错误结果时，请从此处开始。

## 如何检查输出、回调投递和 Webhook 日志？ <a href="#inspect-output-and-webhooks" id="inspect-output-and-webhooks" />

从日志表中打开一次运行。

在追踪面板中选择请求或补全 span 以切换右侧的详情。

当你想从 **workflow\.complete** span 检查最终的工作流结果时，请使用输出部分。可复制的日志卡片包括复制所显示内容或在比较其他运行详情时最小化卡片的控件。

如果运行使用了回调投递，则请求级详情还可以显示 **Callback delivery** 及该次运行所使用的回调 URL。

如果存在 Webhook 投递日志，同一面板还可显示 **Webhook Logs**，包括回调 URL、重试次数、响应代码、负载、响应体，以及针对失败回调投递尝试的 **Retry** 操作。Webhook 日志是投递尝试，而非运行来源。

{/* Add screenshot: workflow run detail showing webhook logs */}

## 注意事项

* 日志表会根据工作流运行状态的变化进行更新，因此你在查看页面时，最近的运行可以刷新。
* Fetch Hive 会持续从工作流调用中跟踪用户元数据属性名，以便元数据过滤器可以建议你的工作区实际发送过的键。请参阅 [调用元数据](../user-tracking/invoke-metadata) 获取请求示例。
* 运行中的行不是深度检查的主要入口。当你需要完整的详情面板和追踪视图时，请打开已完成的运行。
* 仅当所选运行实际使用了回调投递时，才会显示回调投递详情。
* Source 告诉你运行是由什么启动的。Delivery 告诉你运行是等待直接响应，还是立即返回以进行回调投递。

另请参阅：[发布与版本管理](./publishing-and-versioning)、[回调投递与 Webhook 触发](./async-and-webhooks) 和 [使用 API 运行](./run-with-api)