> 原始 Markdown 孪生体（构建期从源 Markdown 生成）。渲染页：https://docs.gatellm.io/zh-CN/console/overview-dashboard · 文档索引：https://docs.gatellm.io/zh-CN/llms.txt


# 总览仪表板

总览是登录控制台后的首页，提供全局概览：资源计数、实例运行状态、门控请求监控和时序趋势图。

入口：控制台 → **总览**（admin、monitor 可见）。

## 汇总卡片

顶部 4 张卡片，实时反映当前配置规模：

| 卡片 | 含义 |
|------|------|
| 上游总数 | 已配置的上游数量 |
| 活跃协议 | 正在使用的协议种类数 |
| 活跃模型 | 已配置的模型数量 |
| 活跃访问密钥 | 已签发的访问密钥数量 |

## 实例面板

展示网关各运行实例的状态，每行一个实例：

| 信息 | 说明 |
|------|------|
| 实例 ID | 8 字符前缀（可点击复制完整 UUID） |
| 任务状态 | R=运行中、P=崩溃（红色高亮）、S=已停止 |
| 内存水位 | Normal / Warning / Pressure / Reclaim / Critical；显示 `已用/上限`，水位 ≥ Warning 显示 ⚠ 警告 |
| 磁盘用量 | 总磁盘占用（悬浮查看各存储细分） |

实例面板的状态实时刷新：配置了 Redis 的多实例部署下，实例优雅下线约 1 秒内从面板消失；未配置 Redis 的单实例部署通过定期轮询刷新，延迟略高。

### 磁盘详情（悬浮展开）

悬浮「磁盘用量」展开各存储区的详细指标：

**日志队列**（按角色分：memory / drain / live）：
- 磁盘占用 / 上限
- 写指针位置
- 分段数 × 分段大小
- 保留下限（retention floor）
- DB 排空游标位置（drain 角色）
- SSE 消费者数量及最小游标

**其他存储区**：
- 响应 body 存储（已用 / 上限）
- 请求 body 存储（已用 / 上限）
- 累加器存储（已用 / 上限）
- 入口溢出存储（已用 / 上限）

## 门控请求面板

显示当前排队或正在处理的请求（内存压力时网关会排队新请求）：

| 列 | 说明 |
|----|------|
| 时间 | 入队时间 |
| 实例 | 处理的实例 ID（8 字符） |
| 客户端 | 访问密钥名 |
| 方法 | POST 等 |
| 路径 | 请求路径 |
| 状态 | Queued（排队中）/ Active（处理中）/ Completed / Rejected（超时或队列满） |
| 耗时 | 排队等待时长 |

- 默认只显示 Active 和 Queued 状态的请求。
- 点「显示全部历史」可看 Completed 和 Rejected 的快照。

## 时序图

底部两张时序图，支持时间范围预设：Today / 12h / 24h / 2d / 7d / 30d。

**Token 用量图**（左）：按模型分组的折线图，悬浮显示各模型的输入/输出 token 明细。图例显示模型名和总量，可点击图例隐藏某条线。

**请求数图**（右）：总量 / 成功 / 错误三条折线，悬浮显示各指标具体数值。

## 常见问题

**Q：总览里的实例数和我部署的不一样？**
只有正在处理请求的实例才会显示。空闲实例（无运行中任务）不会出现在列表里。

**Q：内存水位显示 Critical 怎么办？**
网关正在主动回收内存，可能影响请求延迟。检查是否有内存泄漏或流量突增，必要时扩容。

**Q：门控请求一直 Queued 不动？**
网关内存压力大，排队请求等待处理资源。检查内存水位，必要时限流或扩容。

**Q：时序图没数据？**
时序数据来自持久化统计。若网关刚启动或统计功能未启用，图表可能为空。确认 `statistics` 相关配置正常。

**下一步**：[控制台登录与角色](/zh-CN/console/login-and-roles.md) 看登录与角色；[统计](/zh-CN/console/statistics.md) 看用量统计；[日志查看器](/zh-CN/console/logs-viewer.md) 看请求详情。