# 明细查询与审计

来源: https://docs.aicentos.com/enterprise/usage-audit

Language: zh-CN

> 调用明细的查询维度、审计记录覆盖的事件范围，以及导出与留存方式

## 调用明细

控制台可按以下维度查询每一笔调用：用户 / API 密钥、模型与分组、时间范围、渠道、请求 ID 与上游请求 ID。每笔调用的 token 数与费用逐条可追溯，可按密钥做成本归因。

## 审计记录

除用量之外，系统**独立记录操作与访问审计**，覆盖四类事件：

| 类别 | 覆盖事件                     |
| -- | ------------------------ |
| 登录 | 登录、登出、二次验证               |
| 安全 | 密钥、密码、权限相关变更             |
| 操作 | 管理端写操作（新增接口自动留痕，不依赖人工埋点） |
| 令牌 | API 密钥的签发与使用             |

每条记录包含：**谁**（账号，以及事件发生时的角色）、**何时**、**从哪个 IP**、**使用哪个密钥**、**调用了哪个接口**、**成功与否**、请求 ID。

密钥以**指纹**形式记录，不保存密钥明文。

有一点需要说清楚：**审计记录的是操作与访问行为，不包含调用内容**。请求与响应的正文不写入任何日志表——上面的字段能回答“谁在什么时候用哪个密钥做了什么事”，不能回答“这次调用说了什么”。

## 留存

**审计记录独立于用量日志的清理策略保留**：用量日志可能按周期清理，审计记录不受影响，适合需要长期留档的场景。

需要自定义留存周期、或把记录同步到内部审计系统，可在合同中约定，采用[私有化部署](https://docs.aicentos.com/enterprise/deployment)时留存策略完全由你设定。

## 权限

* 审计查询权限可**单独授予某个账号**，用于给财务或合规岗开通只读审计视图，不涉及其他管理功能
* 每个成员也可以查询自己名下的调用记录

## 导出与对接

导出的能力取决于部署形态：

|          | 公有云（aicentos.com）           | [私有化部署](https://docs.aicentos.com/enterprise/deployment) |
| -------- | --------------------------- | -------------------------------------------------------- |
| 控制台查询与检索 | ✅ 自助                        | ✅ 自助                                                     |
| 导出为文件    | ✖ 目前不提供自助导出，正式对账单由客服按合同周期整理 | ✅ 明细与审计在你的数据库，可用 SQL、BI 或备份流程自行导出                        |
| 对接内部系统   | 需人工配合                       | ✅ 直接对接 SIEM、数据仓库或报表平台                                    |

如果你需要把用量或审计记录定期落到内部系统，私有化是更合适的形态——数据本来就在你的库里，不需要经过我们。

公有云形态下如确有导出需求，可在商务沟通中说明，见[服务与支持](https://docs.aicentos.com/enterprise/support)。

## 与合同的关系

对公客户的账单口径以合同约定为准，见[合同与对公结算](https://docs.aicentos.com/enterprise/billing-contract)。