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


# 统计页

统计页聚合请求用量，按模型/密钥/分组维度拆解，支持时序展示。数据持久化于数据库，1 分钟粒度。

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

## 汇总卡片

顶部 7 张卡片，反映所选时段的总量：

| 卡片 | 含义 |
|------|------|
| 总请求数 | 时段内全部请求 |
| 成功请求 | 2xx |
| 错误请求 | 4xx + 5xx |
| 平均延迟 | 毫秒 |
| 输入 Token | 上游计入的输入 token |
| 输出 Token | 上游计入的输出 token |
| 缓存读取 Token | prompt cache 命中的 token |

## 维度切换

`group_by` 切换拆解维度：

| 维度 | 主表首列 |
|------|---------|
| `model` | 按模型 |
| `access_key` | 按访问密钥（可展开） |
| `access_key_group` | 按密钥组 |

主表其余列：请求数、成功数、错误数、成功率、平均延迟、输入 token、输出 token、缓存读 token。

## 时间范围

- 预设：`24h`（默认）/ `7d` / `30d`
- 自定义：DateRangePicker 选起止时间，支持相对表达式

## 时序图

按所选时段自动选粒度（目标约 120–720 个数据点）：

| 时间跨度 | 粒度 |
|---------|------|
| ≤ 24h | 5 分钟 |
| ≤ 2d | 15 分钟 |
| ≤ 7d | 1 小时 |
| ≤ 30d | 4 小时 |
| ≤ 90d | 12 小时 |
| > 90d | 1 天 |

展示 token 用量（按模型 input+output）与请求数（total/success/error）曲线。

## 导出 Excel

导出入口在计费页（控制台 → **设置** → **计费** → **月度成本**）：选月份点导出，得到含 6 个 sheet 的 Excel（model / access key / key group / access key × model 模型分布 / day / week 时间维度），费用按币种拆列。详见 [导出账单 Excel 与日志排查](/zh-CN/howto/billing-export-and-logs.md)。

## 说明

- `count_tokens` 请求（Anthropic token 计数端点）**不计入统计**，因为它不实际调用上游、不产生费用。
- 持久化统计按 1 分钟桶存储；当前分钟桶在网关崩溃时会丢失，已完成的分钟桶保留。
- **统计与计费记录的是映射后的最终模型名**。若某访问密钥 / 密钥组配了身份作用域模型映射（如 `claude-opus-5 → qwen3.7-max`），统计页、导出 Excel、账单里只会出现目标名 `qwen3.7-max` 的行，**不会**出现源名 `claude-opus-5` 的行——映射对统计与计费完全透明。需要按客户视角的源名归因时，请在客户端侧自行记录。详见 [配置身份作用域模型映射](/zh-CN/howto/configure-identity-model-mapping.md)。

## 常见问题

**Q：统计里的请求数和日志对不上？**
统计是 1 分钟粒度聚合，日志是逐条记录。短时间窗口内可能有最多 1 分钟的刷盘延迟。`count_tokens` 请求在日志里能看到但不进统计。

**Q：token 数偏高？**
确认是否把 `count_tokens` 也算进去了——它不计入统计。若仍偏高，检查是否有上游返回了虚高的 usage 字段。

**Q：配了模型映射，为什么统计里看不到客户端请求的那个模型名？**
因为统计与计费用的是映射后的最终模型名。客户端请求 `claude-opus-5`、被映射到 `qwen3.7-max` 时，统计里只记 `qwen3.7-max`。这是预期行为，详见 [配置身份作用域模型映射](/zh-CN/howto/configure-identity-model-mapping.md)。

**下一步**：[总览仪表板](/zh-CN/console/overview-dashboard.md) 看全局概览；[导出账单 Excel 与日志排查](/zh-CN/howto/billing-export-and-logs.md) 看导出操作；[日志查看器](/zh-CN/console/logs-viewer.md) 看逐条请求详情。