管理中心：使用统计、审计日志与接口健康 · 操作手册

更新时间：2026-10-27

页面入口：左侧菜单「管理中心」下的「使用统计」（/admin/usage）、「审计日志」（/admin/audit-logs）、「运行监控 → 接口健康」（/admin/monitor?tab=api）。

仅管理员可见。

这三处回答三类不同的问题，别混着看：

想知道	去哪看
平台用得怎么样：谁在用、哪些功能用得多、AI 调了多少	使用统计
某个人在什么时间对什么做了什么（登录、改设置、删项目、导出……）	审计日志
系统接口是否健康：哪里报错、哪里慢、某次请求发生了什么	运行监控 → 接口健康

原来的「请求日志」页面已取消，旧链接会自动跳到「接口健康」。

一、使用统计

页头下方可选日期范围（默认最近 30 天）和用户。三个标签：

概览：活跃用户、新建项目、上传文件、导出成果、业务任务（含失败数）、AI 调用（含成功率），以及每日趋势。

• 项目、上传、导出来自审计日志里的操作记录；
• 业务任务来自任务中心；
• AI 调用来自每次 AI 调用的记录。

功能使用：按图纸解析、表格复核、料单导出、图纸一致性核对、质保书核对统计任务次数、成功、失败、取消、成功率、涉及项目数、使用人数；点行首箭头看各环节（例如图纸解析下的分区基线、区域解析）。下方「按用户」表列出每人各功能用了多少次。

由脚本、助手自动触发等对不上账号的任务，统一记在「系统 / 自动」名下。成功率只算已结束的任务，不含取消和进行中的。

AI 用量：调用次数、成功率、平均与 P95 耗时、Token；可按场景 / 模型 / 用户 / 项目切换分布表，下方是每日调用。

Token 只有模型服务返回用量时才有。部分中转服务不返回，此时显示「未上报」，不代表用量为 0。

二、审计日志

记录人的关键操作：登录与退出、账号和角色变更、项目和成员变更、系统设置修改、成果导出等。AI 运行失败、后台任务出错这类系统事件不在这里，请到任务中心或运行监控查看。

• 筛选：日期、用户、分类（登录安全 / 账号权限 / 项目与成员 / 系统设置 / 数据导出 / 业务操作）、动作、结果；「更多条件」里可按对象类型、对象 ID、请求 ID、IP 精确查。
• 详情：点「查看」打开。修改类操作会列出「字段 / 修改前 / 修改后」；密码、密钥等敏感字段一律显示为 [redacted]。
• 请求 ID：详情里点请求 ID，会跳到「接口健康」并打开这次请求的追查结果。
• 导出 CSV：按当前筛选导出，最多 5 万行，Excel 可直接打开。
• 保留期：默认保留 365 天（部署变量 AUDIT_LOG_RETENTION_DAYS），过期自动清理。

三、运行监控 → 接口健康

可选近 1 小时 / 24 小时 / 7 天。

• 顶部指标：请求数、5xx、4xx、慢请求（≥ 3 秒）、平均与 P95 耗时，并给一句健康结论。
• 接口排行：按错误、耗时或流量排序；点接口名，下方明细只看这个接口。「未匹配路由」指还没进入具体接口就被拦下的请求，例如未登录、无权限或地址不存在。
• 请求明细：可切换「5xx 与慢请求 / 5xx / 4xx / 慢请求 / 写操作」。点请求 ID 可看这次请求和它产生的审计记录。
• 追查某次请求：右上角输入请求 ID 回车。

为避免日志无限增长，普通成功的查询请求只计入统计，不单独留明细；写操作、出错和慢请求才留明细。统计和明细默认保留 14 天（部署变量 API_REQUEST_LOG_RETENTION_DAYS）。