服务状态
服务状态页公开展示网关对各模型上游线路的主动探测结果,包括每条线路的状态、首字延迟、吞吐、成功率和最近 24 小时的逐小时记录。点击顶栏 服务状态 即可打开,无需登录。它反映的是平台线路本身是否可用;某个 API Key 的权限、余额、配额,以及你的 BYOK 凭证都不在探测范围内。线路正常但请求失败时,请按响应中的报错原文排查。
页面内容
- 总览:页面顶部显示「全部线路运行正常」或「部分线路性能下降」,以及线路总数和各状态的数量;还没有探测数据时显示「暂无监测数据」。
- 新鲜度:「最近一次探测:」后显示最近一轮探测的时间,后面说明本页多久同步一次结果、探测任务多久执行一轮。探测周期由平台调整,以页面上的说明为准;页面会自动刷新,也可以点击 刷新。
- 模型卡片:每张卡片的标题是模型 ID,右侧的「N/M 条线路正常」统计该模型的线路。卡片中每一行是一条上游线路,以服务商名称标识,依次显示状态、首字延迟、吞吐、成功率、24 小时格子条和更新时间;把鼠标悬停在更新时间上可以查看具体的探测时间。
图 1:服务状态页按模型列出各服务商线路的状态、首字延迟、吞吐、成功率和 24 小时格子条。 截图为演示数据,点击图片可查看原图。
线路状态
把鼠标悬停在状态标签上可以查看判定依据:
| 状态 | 颜色 | 含义 |
|---|---|---|
| 正常 | 绿色 | 最近一次探测中链路可达、鉴权通过、生成正常,延迟与成功率处于该线路自身的常态区间 |
| 性能下降 | 黄色 | 线路仍可用,但相较自身基线明显变差:首字延迟的短期均值超过长期均值约 1.8 倍、成功率低于 98%,或解码吞吐低于基线(也可能来自上游限流) |
| 网络不可达 | 红色 | DNS 解析、TCP 连接或 TLS 握手失败,请求没有到达上游 |
| 服务不可用 | 红色 | 链路可达,但调用没有成功:上游返回错误、超时或空响应 |
| 鉴权失败 | 红色 | 上游拒绝了平台的凭据(HTTP 401/403),通常是密钥失效、账户欠费或权限变更 |
| 暂无数据 | 灰色 | 近期缺少有效探测样本,例如探测刚启动、该模型不在探测范围内,或连续多轮没有取得数据 |
首字延迟、吞吐和成功率都来自探测请求,用于和该线路自己的历史基线比较,不用于在服务商之间横向比较。
24 小时格子条
格子条按你所在时区的自然小时排列,共 24 格,最右边一格是当前小时(轴上标为「现在」)。每格的颜色取该小时内最差的探测结果:
| 颜色 | 图例 | 含义 |
|---|---|---|
| 绿色 | 正常 | 该小时探测正常 |
| 黄色 | 性能下降 | 首字延迟或解码吞吐相较自身基线明显变差 |
| 橙色 | 服务不可用 | 链路可达,但上游返回错误、超时或空响应 |
| 红色 | 网络/鉴权异常 | 网络不可达,或上游拒绝了平台的凭据 |
| 灰色 | 无数据 | 该小时没有有效探测样本 |
把鼠标悬停在格子上,可以看到该小时的时段、状态、成功率、首字延迟、吞吐、「探测轮次」,有错误时还显示「错误类别」。几种特殊情况:
- 进行中:当前小时还没有产出探测样本,格子以斜纹显示。刚过整点时通常如此,不表示线路故障。
- 「生成阶段」显示「未执行」:该小时的探测没有进行到生成阶段(网络不可达或上游拒绝了凭据),所以没有延迟和吞吐数据。
- 灰色但有探测轮次:该小时探测过,但没有产出判定,通常是网关没有取得该线路的可用凭据,不表示上游故障。
探测范围
- 网关定期直接向每条平台线路发送一次最小的流式生成请求,先检查连通性,再检查生成是否成功。探测不经过工作空间的路由设置。
- 只探测对话模型;图像、视频、语音等模型不在页面上。你通过 BYOK 接入的通道也不在探测范围内。
- 实际调用时,网关根据每次请求的结果在通道之间回退:某个通道失败后改用同一模型的其他通道,见失败重试与备用模型。
状态正常但请求失败
按以下顺序排查:
- 读报错原文:401、403 见401 / 403:鉴权与权限,429 见429:限流与配额,模型调不通或 402、503 见模型不可用,504 或流式中断见超时与流式中断。
- 查日志:在请求日志中找到这次请求,「状态说明」列标明错误来自「网关」还是「上游」;在详情中查看「模型(实际)」和「服务商」,再到状态页找对应模型和服务商的那一行比较。
- 确认是否使用 BYOK:请求走的是 BYOK 通道时,状态页不覆盖它。请账号管理员在 BYOK 中重新测试连接,并到服务商处确认额度。
- 对比请求特征:探测使用很短的请求。长上下文、大量工具定义或长时间的流式输出更容易触发上游超时和限流,请对照日志中的耗时和上游响应排查。
常见问题
某条线路显示异常,我的调用会受影响吗?
答: 网关会在该线路失败后改用同一模型的其他通道。模型只有这一条线路时,调用可能失败,可以改用其他模型,或通过虚拟模型的备用模型自动兜底。
报告服务问题时,需要提供哪些信息?
答: 提供调用时间、模型 ID、API Key 名称、完整的报错原文,以及日志详情顶部的 Request ID;如果状态页同时有异常,附上对应的模型和服务商名称。响应中不包含请求 ID,请从日志详情中复制。不要提供 API Key 明文或完整的鉴权头。
