1.3 KiB
1.3 KiB
usage 模块
职责
- 记录代理调用日志
- 提供日志查询与筛选
- 执行日志保留策略
接口定义
GET /api/usage使用日志查询
行为规范
- 代理调用统一写入
usage_logs(含无可用渠道/冷却提前返回) - 使用日志可通过
USAGE_QUEUE异步写入(可能存在短暂延迟) - 队列写入受
usage_queue_daily_limit限制,超限后自动回退为 Worker 直写 - 流式 usage 解析被跳过或超限时会记录
usage_skipped/usage_missing以便排查 - 保留天数可配置,查询时触发清理
GET /api/usage支持短时缓存(TTL 可配置,版本化失效)- 查询结果附带渠道与令牌名称
GET /api/usage支持offset/limit分页并返回total- 支持按
model/channel/token/status关键词搜索(保留channel_id/token_id精确过滤,新增channel_ids/token_ids/models/statuses多选过滤) - usage_logs 记录输入/输出 tokens、首 token 延迟、流式标记与推理强度
- 推理强度来自请求体
reasoning/reasoning_effort字段 - usage_logs 记录上游失败详情(status/code/message),日志列表仅展示上游状态码,缺失时显示“未知”,详情弹窗包含元信息与错误摘要
依赖关系
usage_logs表settings模块