# 服务状态

来源: https://platform.lyrouter.com/ai_gateway/docs/status
更新日期: 2026-10-14

[服务状态](https://platform.lyrouter.com/ai_gateway/status)页公开展示网关对各模型上游线路的主动探测结果，包括每条线路的状态、首字延迟、吞吐、成功率和最近 24 小时的逐小时记录。点击顶栏 **服务状态** 即可打开，无需登录。它反映的是平台线路本身是否可用；某个 API Key 的权限、余额、配额，以及你的 BYOK 凭证都不在探测范围内。线路正常但请求失败时，请按响应中的报错原文排查。

## 页面内容

- **总览**：页面顶部显示「全部线路运行正常」或「部分线路性能下降」，以及线路总数和各状态的数量；还没有探测数据时显示「暂无监测数据」。
- **新鲜度**：「最近一次探测：」后显示最近一轮探测的时间，后面说明本页多久同步一次结果、探测任务多久执行一轮。探测周期由平台调整，以页面上的说明为准；页面会自动刷新，也可以点击 **刷新**。
- **模型卡片**：每张卡片的标题是模型 ID，右侧的「N/M 条线路正常」统计该模型的线路。卡片中每一行是一条上游线路，以服务商名称标识，依次显示状态、首字延迟、吞吐、成功率、24 小时格子条和更新时间；把鼠标悬停在更新时间上可以查看具体的探测时间。

（截图：服务状态页按模型列出各服务商线路的状态、首字延迟、吞吐、成功率和 24 小时格子条。）

## 线路状态

把鼠标悬停在状态标签上可以查看判定依据：

| 状态 | 颜色 | 含义 |
| --- | --- | --- |
| 正常 | 绿色 | 最近一次探测中链路可达、鉴权通过、生成正常，延迟与成功率处于该线路自身的常态区间 |
| 性能下降 | 黄色 | 线路仍可用，但相较自身基线明显变差：首字延迟的短期均值超过长期均值约 1.8 倍、成功率低于 98%，或解码吞吐低于基线（也可能来自上游限流） |
| 网络不可达 | 红色 | DNS 解析、TCP 连接或 TLS 握手失败，请求没有到达上游 |
| 服务不可用 | 红色 | 链路可达，但调用没有成功：上游返回错误、超时或空响应 |
| 鉴权失败 | 红色 | 上游拒绝了平台的凭据（HTTP 401/403），通常是密钥失效、账户欠费或权限变更 |
| 暂无数据 | 灰色 | 近期缺少有效探测样本，例如探测刚启动、该模型不在探测范围内，或连续多轮没有取得数据 |

首字延迟、吞吐和成功率都来自探测请求，用于和该线路自己的历史基线比较，不用于在服务商之间横向比较。

## 24 小时格子条

格子条按你所在时区的自然小时排列，共 24 格，最右边一格是当前小时（轴上标为「现在」）。每格的颜色取该小时内最差的探测结果：

| 颜色 | 图例 | 含义 |
| --- | --- | --- |
| 绿色 | 正常 | 该小时探测正常 |
| 黄色 | 性能下降 | 首字延迟或解码吞吐相较自身基线明显变差 |
| 橙色 | 服务不可用 | 链路可达，但上游返回错误、超时或空响应 |
| 红色 | 网络/鉴权异常 | 网络不可达，或上游拒绝了平台的凭据 |
| 灰色 | 无数据 | 该小时没有有效探测样本 |

把鼠标悬停在格子上，可以看到该小时的时段、状态、成功率、首字延迟、吞吐、「探测轮次」，有错误时还显示「错误类别」。几种特殊情况：

- **进行中**：当前小时还没有产出探测样本，格子以斜纹显示。刚过整点时通常如此，不表示线路故障。
- **「生成阶段」显示「未执行」**：该小时的探测没有进行到生成阶段（网络不可达或上游拒绝了凭据），所以没有延迟和吞吐数据。
- **灰色但有探测轮次**：该小时探测过，但没有产出判定，通常是网关没有取得该线路的可用凭据，不表示上游故障。

## 探测范围

- 网关定期直接向每条平台线路发送一次最小的流式生成请求，先检查连通性，再检查生成是否成功。探测不经过工作空间的路由设置。
- 只探测对话模型；图像、视频、语音等模型不在页面上。你通过 BYOK 接入的通道也不在探测范围内。
- 实际调用时，网关根据每次请求的结果在通道之间回退：某个通道失败后改用同一模型的其他通道，见[失败重试与备用模型](https://platform.lyrouter.com/ai_gateway/docs/fallback)。

## 状态正常但请求失败

按以下顺序排查：

1. **读报错原文**：401、403 见[401 / 403：鉴权与权限](https://platform.lyrouter.com/ai_gateway/docs/auth-errors)，429 见[429：限流与配额](https://platform.lyrouter.com/ai_gateway/docs/rate-errors)，模型调不通或 402、503 见[模型不可用](https://platform.lyrouter.com/ai_gateway/docs/unavailable)，504 或流式中断见[超时与流式中断](https://platform.lyrouter.com/ai_gateway/docs/stream-errors)。
2. **查日志**：在[请求日志](https://platform.lyrouter.com/ai_gateway/docs/logs)中找到这次请求，「状态说明」列标明错误来自「网关」还是「上游」；在详情中查看「模型（实际）」和「服务商」，再到状态页找对应模型和服务商的那一行比较。
3. **确认是否使用 BYOK**：请求走的是 BYOK 通道时，状态页不覆盖它。请账号管理员在 [BYOK](https://platform.lyrouter.com/ai_gateway/docs/byok) 中重新测试连接，并到服务商处确认额度。
4. **对比请求特征**：探测使用很短的请求。长上下文、大量工具定义或长时间的流式输出更容易触发上游超时和限流，请对照日志中的耗时和上游响应排查。

## 常见问题

### 某条线路显示异常，我的调用会受影响吗？

**答：** 网关会在该线路失败后改用同一模型的其他通道。模型只有这一条线路时，调用可能失败，可以改用其他模型，或通过[虚拟模型](https://platform.lyrouter.com/ai_gateway/docs/presets)的备用模型自动兜底。

### 报告服务问题时，需要提供哪些信息？

**答：** 提供调用时间、模型 ID、API Key 名称、完整的报错原文，以及日志详情顶部的 Request ID；如果状态页同时有异常，附上对应的模型和服务商名称。响应中不包含请求 ID，请从日志详情中复制。不要提供 API Key 明文或完整的鉴权头。