CodexManager请求日志与费用统计详解：如何追踪Token消耗、缓存命中率与请求耗时-开发者社区

CodexManager请求日志与费用统计详解：如何追踪Token消耗、缓存命中率与请求耗时

【免费下载链接】Codex-Manager一个Codex cli 账号管理与切换工具。为 Codex cli提供本地网关转发。项目地址: https://gitcode.com/gh_mirrors/co/Codex-Manager

CodexManager 是一款面向 Codex CLI 的账号管理与切换工具，内置本地网关转发。它会把每一次经过网关的请求完整记录到请求日志中，并自动完成 Token 消耗、费用统计、缓存命中率与请求耗时的追踪，让你随时掌握每个账号、每条 API Key 的真实开销与性能表现。

请求日志记录了什么？

CodexManager 的日志页面会对每一次转发请求落库一条记录，核心字段定义在 apps/src/types/request-log.ts 中。对普通用户来说，最常用的是这几类信息：

类别	关键字段	说明
路由信息	`model`、`upstreamModel`、`routeStrategy`	请求实际命中的模型与路由策略，方便排查“为什么走了这个账号”
Token 消耗	`inputTokens`、`outputTokens`、`cachedInputTokens`、`reasoningOutputTokens`	输入/输出/缓存输入/推理输出 Token 明细
费用	`estimatedCostUsd`	按价格规则估算的本次请求费用（美元）
性能	`durationMs`、`firstResponseMs`	请求总耗时与首响应耗时
结果	`statusCode`、`error`	上游返回状态码与错误信息

其中耗时与首响应字段的底层存储分别由 031_request_logs_duration_ms.sql 和 051_request_logs_first_response_ms.sql 提供；缓存与推理 Token 则来自 021_request_logs_cached_reasoning_tokens.sql。

如何看懂 Token 消耗统计

日志列表顶部会自动汇总当前筛选条件下的统计信息，定义见RequestLogFilterSummary：总条数、成功数、错误数、Token 总量与费用总量。

理解 Token 数据时有两个口径需要注意：

inputTokens是包含缓存命中的总输入 Token，cachedInputTokens是其中的子集。也就是说，未命中缓存的“新输入”= 输入 Token − 缓存输入 Token。详细口径说明见模型目录V2一次性迁移方案-2026-07-10.md。
推理型模型（如 GPT-5 系列）会单独记录reasoningOutputTokens，它包含在outputTokens中，用于区分“思考消耗”与“正文消耗”。

日志页面还支持按时间范围、状态（成功/失败）、关键词检索过滤，并在页面上自动刷新：有活跃筛选时约 10 秒一次，无筛选约 5 秒一次，实现见 apps/src/app/logs/page.tsx。

缓存命中率为什么重要？如何追踪

Codex 上游的 Prompt 缓存可以显著降低成本与首响应延迟，缓存命中率因此成为核心观测指标。管理员仪表盘会直接展示选定时间范围内的缓存命中率（百分比），相关实现位于 apps/src/app/page.tsx，计算基于cachedInputTokens / inputTokens汇总。

CodexManager 仪表盘概览

如果命中率明显偏低，最常见的原因并不是网关本身，而是反向代理把上游会话锚点请求头吞掉了，导致后端退化为不稳定会话、无法复用缓存。项目内有一份专门说明：Nginx反向代理导致缓存命中偏低说明.md，可对照排查代理层配置。

请求耗时怎么看

每条日志都有两个时间指标：

durationMs（总耗时）：从网关收到请求到上游完整响应结束的毫秒数，适合评估整条链路（含账号切换、重试）的端到端表现。
firstResponseMs（首响应耗时）：上游返回第一个字节/数据的时间，直接决定流式输出的“出字速度”，是体验感知最强的指标。

结合statusCode与error字段，你可以快速定位是“上游慢”“代理慢”还是“路由重试导致变慢”。

费用统计是如何计算的

CodexManager 内置模型价格规则表（见 055_model_price_rules.sql），按模型分别配置输入、输出、缓存命中等价格，对每条请求估算estimatedCostUsd。因此日志汇总栏的“总费用”就是当前筛选下所有请求费用之和，可按天、按 Key、按账号维度观察花费趋势。

计费字段的完整口径（含缓存命中/刷新价格）可参考额度管理中心设计方案.md，计费 V2 的加固说明见 113_model_billing_v2_hardening.sql。