账单与用量监控
适用角色：组织（顶层用户）、子用户 更新日期：2026-07-02
新版控制台为组织提供专属的仪表盘（Dashboard）与使用记录页面，帮你一站式回答「这个月花了多少、谁在花、花在哪些模型、有没有异常」。本文说明仪表盘能看什么、如何按时间和用户维度查用量，以及"今日 vs 累计"等口径上的注意点。
一、功能入口
| 入口 | 路径 | 看到的数据范围 |
|---|---|---|
| 仪表盘 | 左侧导航 → 仪表盘（/dashboard） | 组织级汇总 + 子用户分布/排行 |
| 使用记录 | 左侧导航 → 使用记录（/usage） | 按时间、按用户维度的调用明细 |
数据严格按层级隔离：组织只看本组织数据，子用户登录后只看自己的用量。组织能看到组织级汇总与名下各子用户的用量；子用户看不到其他子用户的数据。
二、仪表盘能看什么
组织登录后，仪表盘提供以下几块内容：
1. 余额概览
展示组织余额池的当前余额。所有子用户的消费都从这里扣，余额是唯一的资金来源。低余额时的预警与欠费行为见 余额预警与欠费。
2. 消费趋势
按时间展示组织的消费走势，帮你判断余额消耗速度、预判何时需要充值。
3. 按模型分布（Top）
展示本组织各模型的消费/用量占比（Top 排序），帮你了解团队主要在用哪些模型、成本集中在哪里。
4. 最近用量
展示最近一段时间的调用情况，用于快速掌握当前的活跃程度。
5. 额度总览卡片
展示组织在平台上的额度信息，包括总额度上限、已用额度等。额度上限是平台为你的组织设定的消费上限（即额度上限的累计消费计数），与余额是两个独立维度 -- 余额决定"还剩多少钱可用"，额度上限决定"最多允许消费多少"。
子用户登录后的仪表盘只展示自己的用量概览，并在 API 密钥页顶部有只读的「子用户额度卡片」展示其额度上限。子用户额度与组织余额的关系见 三级账户体系。
三、按时间 / 用户维度看使用记录
「使用记录」页支持按时间范围和用户维度查看调用明细：
| 维度 | 说明 |
|---|---|
| 时间范围 | 按所选时间窗口筛选调用记录 |
| 用户维度 | 组织可按名下子用户筛选，定位"谁在花" |
典型用法：
- 月度成本分摊：选定本月时间范围，按子用户维度查看各自消费，分摊到部门。
- 定位高消耗子用户：按消费排序，锁定 Top 消耗的子用户，核对是否合理。
- 排查异常调用：发现某子用户用量异常偏高，结合时间分布判断是否存在 Key 泄漏或未授权脚本。如确认 Key 异常，可在 API 密钥页处置。
删除子用户后，其历史用量会归集到所属组织，不再单独保留在该子用户维度下。这一点在做历史对账时需留意。
四、"今日"口径与时间筛选
4.1 全局时间范围筛选
仪表盘顶部提供全局时间范围筛选器（日期区间选择），可按所选时间窗口查看消费、模型分布、用户排行等统计。切换时间范围后，仪表盘图表随之刷新到该区间口径。
4.2 "今日"与"累计/区间"口径
仪表盘部分统计带有「今日」标识（badge），用于区分今日数据与所选时间区间/累计数据。看数时先确认某个数字是"今日"还是"所选区间"，避免把当日消费误读为总消费、或反之。
实务建议：做精确对账时，优先以"使用记录"明细按明确时间范围筛选后的结果为准，仪表盘卡片作为趋势与概览参考。
五、数据说明
- 实际消费：真实扣减组织余额的金额，是对账的依据。
- 数据新鲜度：为优化大数据量查询，部分统计可能来自预聚合快照，存在分钟级延迟；界面会标注数据更新时间。
- 明细 vs 汇总：仪表盘看"趋势与分布"，使用记录看"逐条/逐项明细"，两者数据源一致但视角不同。
六、常见问题
Q：组织能看到子用户的用量吗？ A：能。组织在仪表盘可看名下子用户的分布与排行，在"使用记录"可按子用户维度筛选明细。子用户之间互相看不到，子用户只能看自己的。
Q：仪表盘上的数字是"今日"还是"总共"？ A：仪表盘顶部有全局时间范围筛选器，可选定区间；带「今日」badge 的数字为当日口径，其余按所选区间。精确对账请以"使用记录"按时间范围筛选的结果为准。
Q：为什么今日数据和实际感觉有延迟？ A：部分统计使用预聚合快照以提升查询性能，可能有分钟级延迟，属正常现象。
Q：删除了一个子用户，它之前的用量去哪了？ A：归集到所属组织，不再在该子用户维度单独保留。
Q：仪表盘数据和余额对得上吗？ A：数据源一致，但仪表盘是聚合视角（趋势/分布/排行），余额是逐笔资金变动。对账时以实际消费明细为准。
联系我们
- 电子邮箱：support_cloudrouter@clouditera.com
- QQ 社群：712273971
- 平台网址：cloudrouter.online