用量分析

控制台 用量 页是日常对账与排查问题的主入口。member 看到自己的数据；admin / owner 看到全组织聚合 + 任意成员钻取。

概览卡片

页面顶部的几张卡片：

时区按 Asia/Shanghai (UTC+8) —— “本月”指上海时区的当月。

趋势图

时间序列折线，可切换：

• 粒度：日 / 小时
• 范围：7 天 / 30 天 / 自定义
• 维度：调用次数 / 输入 token / 输出 token / 扣费

按模型拆分

表格列出所选时间范围内每个 model 的：

• 请求数
• 输入 / 输出 / 缓存读 / 缓存写 token
• 输入 / 输出 / 缓存成本（USD）
• 活跃用户数

点表头排序，点每行展开看小时分布。 这是**评估”哪些模型最省钱 / 最爱被用”**的最直观入口。

按成员拆分（admin / owner）

表格列出每个成员在所选范围内的：

• 调用次数
• 总扣费
• 活跃密钥数

点击行进入该成员详情页（也可由 团队管理 → 成员 → 详情进入）：

• 该成员的趋势图
• 该成员的密钥列表与各自用量
• 该成员的请求日志（分页）

admin 钻取其他成员数据时会写一条 view_member_* 审计日志，自己钻取自己不会。

按客户端拆分

按调用方 SDK / 工具聚合，常见识别值：

• claude-code
• codex-cli
• cursor
• cline
• continue
• aider
• cherry-studio
• lobe-chat
• openai-python / openai-node / anthropic-python / anthropic-node
• unknown（自建应用，未在 User-Agent 里声明）

想让自建应用被精确识别？SDK 调用时设 User-Agent 为 your-app-name/1.0，并在请求 metadata 里带可选 x-app-name 头部，控制台的客户端识别会优先使用这些。

请求日志（审计）

最详细的原始记录视图，每行：

时间 · 模型 · 成员 · 密钥 · 客户端 · 状态码 · 耗时 ·
input/output/cache token · 扣费 · request_id · tag

支持过滤：

• 时间范围
• 模型
• 成员
• 密钥
• 状态码（只看失败）
• 客户端
• tag

排查”为啥这条扣了这么多”或”是谁烧掉了余额”的精确入口。把 request_id 提给工单可以一秒定位上游链路。

异常检测（admin / owner）

控制台会用规则 + 简单模型识别异常模式：

• 单成员日扣费陡增（同比 > 5x）
• 单密钥短时间高失败率（> 50%）
• 单密钥持续撞限速
• 持续命中”模型不存在”

异常会以红点标注在团队管理页对应成员卡上，点进去看详情；不会自动停用任何东西，由人工决定是否撤销密钥 / 联系成员。

导出

页面右上角 导出 按钮支持把当前过滤条件下的数据导出 CSV：

• 趋势点（按日 / 按小时）
• 按模型聚合
• 按成员聚合
• 原始请求日志（最多 1 万行 / 单次）

CSV 里时间字段是 ISO 8601 + Asia/Shanghai 偏移（2026-05-04T15:30:00+08:00），方便扔进 Excel / SQL 复盘。

数据延迟

如果你刚发了请求几秒后看趋势图没动，是正常 —— 等下一轮聚合即可。原始日志已经能查到。

常见问题

Q: 为什么我看到的扣费比我用 SDK 估算的多 / 少？ A: 真实计费基于上游返回的精确 usage，会包含 cache_read / cache_write 等字段；本地估算容易漏算。把单条记录展开看 raw usage 即可还原。

Q: 为什么趋势图把零调用的成员也显示出来？ A: admin 视图的”按成员”表格用的是 LEFT JOIN——所有组织成员都会出现，方便看到”谁还没用上”。

Q: 我能对接 Prometheus / Grafana 吗？ A: 暂未提供 Pull 风格的 metrics 端点。导出 CSV 后可以入仓自查；或在你自己的服务端把 request_id 与业务 trace 关联。

Q: 历史数据保留多久？ A: 原始请求日志保留 90 天；按日 / 按月聚合数据永久保留。