> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moxus.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 控制台与用量

> 本文档说明控制台看板（Dashboard）与用量日志（Usage Logs）的使用。两者分别用于宏观监控与逐条排查。

本文档说明控制台看板（Dashboard）与用量日志（Usage Logs）的使用。两者分别用于宏观监控与逐条排查。

## 控制台看板

控制台看板是登录后的首页，用于宏观掌握账户使用情况。通常包含以下信息：

### 余额与消费概览

* 当前余额：账户剩余可用额度。
* 消费趋势：近期（如最近 7 天或 30 天）的花费曲线，可直观观察消费变化。

### 用量统计

* 调用次数：一段时间内发起的请求总数。
* Token 用量：消耗的输入与输出 Token 总量。
* 模型分布：各模型的用量占比排行，可用于识别主力模型与高消耗来源。

看板适用于回答宏观问题，如整体花费情况、主要使用的模型及消费是否出现异常波动。

## 用量日志

用量日志是最重要的排查工具，逐条记录每次调用的详细信息，是排查扣费异常与调用失败的第一现场。

### 日志内容

每条记录通常包含以下字段：

| 字段       | 含义              |
| -------- | --------------- |
| 时间       | 调用发生的时刻         |
| 模型       | 所用模型名称          |
| 输入 Token | 请求内容的 Token 数   |
| 输出 Token | 模型返回内容的 Token 数 |
| 消耗额度     | 本次调用扣减的费用       |
| 状态       | 成功或失败           |
| 失败原因     | 失败时的错误信息        |
| 使用的密钥    | 发起调用的密钥标识       |

### 使用场景

**场景一：扣费异常**
按时间查找对应调用，查看输入与输出 Token 数。通常为上下文过长（历史消息多）或输出过长所致。

**场景二：调用失败**
查找失败记录，读取「失败原因」字段。该字段通常直接说明问题原因（如余额不足、模型无权限、参数错误或上游故障）。

**场景三：疑似盗刷**
如发现未经授权的调用或某密钥用量异常，可能为密钥泄露。应立即在密钥页面删除并重新创建。

**场景四：核对账单**
将某段时间内的每次消耗汇总，与钱包中的消费记录核对。

## 配合使用

建议的监控习惯：

1. 定期查看看板，观察消费趋势。如发现某日消费异常飙升，进入用量日志按时间定位具体调用。
2. 针对高消耗调用，考虑优化措施（如更换较低价格的模型、缩短上下文、限制输出长度）。
3. 调用出错时，第一时间查阅用量日志中的失败原因，比盲目试错更高效。

## 相关文档

* [付款与账单](/zh/platform/billing)：充值、余额与账单。
* [模型与定价](/zh/overview/models-and-pricing)：费用计算规则。
* [账户与 API 密钥](/zh/platform/account-and-keys)：密钥管理与安全。