可视化完整的请求生命周期

概览

时间线（Timeline）是请求详情视图的核心，它以视觉化、按时间顺序排列的方式展现了完整的请求生命周期。您看到的不再仅仅是最终结果，时间线会显示每一个步骤——失败的供应商尝试、主请求、webhook 交付和后端回调——这样您就能确切知道发生了什么以及为什么会发生。

时间线如何工作

访问时间线

1. 导航到项目控制台中的 请求日志（Request Logs）
2. 点击日志表中的任意一行
3. 时间线将出现在详情视图的顶部
4. 即使在查看特定项目的详细信息时，时间线也保持可见

视觉结构

时间线从左到右（或在移动设备上从上到下）按时间先后顺序显示项目：

1. 故障转移尝试（如果有）– 琥珀色/黄色的徽章，显示失败的供应商尝试
2. 主请求 – 绿色（成功）或红色（错误）的徽章，显示最终结果
3. Webhook 交付（如果是异步请求）– 灰色/蓝色/绿色/红色的徽章，显示通知交付情况
4. 后端回调（如果是事件驱动请求）– 闪电图标，显示回调状态

每个项目都可以点击，展开后会显示有关该特定组件的详细信息。

时间线组件

故障转移尝试 (Failover Attempts)

在获取成功请求之前所经历的失败的供应商/模型尝试。这些内容展示了 ModelRiver 的多供应商回退系统何时介入。

• 完整文档 →
• 视觉指示：带有供应商图标的琥珀色/黄色状态徽章
• 显示内容：供应商名称、模型名称、时长、时间戳、失败原因
• 点击可查看：请求主体（Request body）、响应主体（Response body）及错误详情

主请求 (Main Request)

成功（或最终）的请求，它是把响应返回给您应用程序的那次调用。

• 完整文档 →
• 视觉指示：带有供应商图标的绿色（成功）或红色（错误）状态徽章
• 显示内容：供应商名称、模型名称、时长、token 使用量、时间戳
• 点击可查看：完整的请求主体、响应主体和元数据

Webhook 交付 (Webhook Deliveries)

针对异步请求（async requests）或事件驱动工作流发送的 webhook 通知。

• 完整文档 →
• 视觉指示：状态徽章（灰色=已计划，蓝色=交付中，绿色=成功，红色=错误）
• 显示内容：Webhook URL、交付时间、时长、HTTP 状态码
• 点击可查看：Webhook payload、来自您端点的响应、重试按钮

后端回调 (Backend Callbacks)

事件驱动工作流中来自您的后端的回调响应。

• 完整文档 →
• 视觉指示：带有“Backend Callback”标签的闪电图标
• 显示内容：回调状态（成功/超时）、时间戳、模拟（simulated）指示
• 点击可查看：回调 payload、回调响应

阅读时间线

理解时间顺序流

时间线讲述了一个请求的完整故事。以下是如何阅读常见模式的说明：

简单的成功请求

一次直截了当的请求，在第一次尝试时成功，不包含异步组件。

带故障转移的请求

在第三次请求成功之前有两个供应商失败了。您可以检查失败的尝试以了解是什么触发了故障转移。

带有 Webhook 的异步请求

AI 请求成功，并且 webhook 已经成功交付给了您的后端。

事件驱动请求

完整的事件驱动流（event-driven flow）：AI 生成了响应，webhook 被交付，接着您的后端执行了回调。

复杂的故障转移 + 异步

首选供应商失败了，回退（fallback）供应商成功了；第一次 webhook 交付失败了，重试成功了，最后回调顺利完成。

为什么时间线很重要

用于调试

时间线让您立刻能看出问题发生在请求生命周期的哪个阶段——是 AI 供应商失败了，还是 webhook 交付遇到了问题，亦或是后端回调失败了？

用于性能分析

每个组件的耗时都是可见的，因此您可以明确判断出生命周期中的哪个部分造成了最主要的延迟。

用于可靠性监控

故障转移的尝试仅在时间线中可见。如果没有它，您将只会看到最终结果，而忽略底层供应商不稳定的隐患。

为异步工作流提供可见性

Webhook 交付和回调是从主请求独立分离出来的。时间线将所有这些组件连接在一起，形成了一个单一的、连贯的全貌视图。

下一步

• 供应商故障转移 – 了解失败的供应商尝试
• 主请求 – 主请求的详细信息
• Webhook 交付 – 跟踪通知交付情况
• 后端回调 – 事件驱动的回调详细信息
• 返回可观测性 – 返回概览页面