---
head:
  - - meta
    - name: description
      content: 在 OneGateway 日志中核对 API 调用、模型、供应商、Token 用量与费用，了解用户只看本人、管理员查看当前组织所有用户日志的权限范围。
---

# 日志

**日志** 记录每一次 API 调用，用来核对费用、排查失败请求，以及确认某次调用实际使用了哪个模型和供应商。

**用户只能看到自己的使用日志；管理员可以看到当前组织下所有人的日志。** 两个入口展示的都是模型调用记录，区别在于可查看的数据范围。管理员权限不会让其他组织的日志出现在当前组织的列表中。

| 入口 | 查看范围 | 主要用途 |
| --- | --- | --- |
| 用户侧 **日志** | 当前登录用户自己的调用记录 | 核对个人费用、密钥用量与调用失败原因 |
| 管理员侧 **统计分析 → 日志** | 当前组织下所有用户的调用记录 | 排查成员反馈、核对组织费用、定位实际供应商与请求 |

调用结束后，记录约两分钟才会出现在列表中。刚发起的请求没有立即出现时，稍等片刻再刷新。

## 查找日志

页面顶部的条件栏显示当前生效的筛选条件，默认只看最近 7 天；成员视图还会自动限定为本人的记录。

列表底部可以调整每页显示的行数并翻页。列表仅保留最近 30 天的记录，需要查看更早的调用时，点击底部的 **历史数据**。

## 管理员日志

管理员的日志与用户的日志是同一套功能，列表字段和明细完全相同（见下文），区别只在于看到的范围更大：管理员切换角色后，从 **统计分析 → 日志** 查看当前组织下所有用户的调用。

- **按用户筛选**：在条件栏中选择用户，再结合时间、API Key、模型或供应商缩小范围。
- **处理成员反馈**：先确认发生时间与用户，再找到对应的 API Key 或 Request ID，展开记录核对实际使用的模型、供应商、耗时、Token 用量和计费过程。
- **核对费用**：涉及费用争议时，结合该用户的[额度与余额](/admin/quota#额度与余额)以及[管理 API Keys](/admin/tokens) 中的密钥配额一起检查；组织整体趋势与排行见[看板与统计](/user/dashboard)。

日志只记录模型调用及其用量。供应商、定价或权限等配置由谁修改，应查看对应管理页面的 **操作审计**。

## 读懂日志列表

| 列 | 含义 |
| --- | --- |
| 创建时间 | 本次调用发生的时间 |
| 供应商 | 实际承载本次调用的上游供应商 |
| 用户 | 发起调用的账号 |
| API Key | 本次调用使用的 API Key 名称 |
| 分组定价 | 本次调用适用的分组定价 |
| 模型 | 本次请求使用的模型 |
| 用时 / 首字 | 本次调用的总耗时和首字返回时间；流式请求带「流式」标记 |
| 输入 / 输出 | 输入和输出的 Token 数 |
| 花费 | 使用额度管理时显示「订阅」，表示从你的周期额度中扣减；使用兑换码充值时显示本次调用的具体金额 |
| 详情 | 本次调用适用的定价倍率和各项价格 |

同一时间的多条记录通常来自同一个应用的连续请求，可结合 API Key 和模型区分来源。

## 查看单条调用的明细

点击行首的箭头展开记录，查看这次调用的完整信息。

| 字段 | 含义 |
| --- | --- |
| 供应商信息 | 承载本次调用的供应商编号与名称 |
| Request ID | 本次请求的唯一标识；反馈问题时提供它可以快速定位 |
| 日志详情 | 本次调用适用的各项价格和定价倍率摘要 |
| 缓存 Tokens | 命中上游模型提示词缓存的 Token 数 |
| 缓存创建 Tokens | 写入上游模型提示词缓存的 Token 数 |
| 计费过程 | 逐项列出价格与计算过程 |
| 请求路径 | 本次请求访问的接口路径 |
| 流状态 | 流式响应的结束状态 |
| 请求转换 | 请求在网关中经过的协议转换 |
| 计费模式 | 费用由上游返回，还是由网关按价格表计算 |

部分字段仅在存在对应信息时显示，例如上游实际使用的模型。

启用[智能路由](/guide/intelligent-routing)后，日志中的模型是**路由后实际调用的模型**，请求 `og-auto` 这类虚拟模型的调用会记录为改写后的模型，不会出现虚拟模型名；需要核对原本请求的模型时，查看响应头 `og-route-requested-model`，或提供 Request ID 请管理员在路由监控中查询。
需要查看整体的费用与用量趋势，而不是单次调用时，成员前往[个人看板与统计](/user/my-dashboard)，管理员前往[看板与统计](/user/dashboard)。