agentgate
agentgate guides/trace-codex-requests

请求追踪

本地追踪 Codex 模型请求。

AgentGate 在本地记录 Codex 请求的路由、Provider、错误、Token 用量和成本。

直接答案

简短答案:AgentGate 在本地记录 Codex 请求的路由、Provider、错误、Token 用量和成本。

适合场景

  • 你想让 AI 应用保持一个稳定的本地入口。
  • 你需要切换 Provider、查看请求日志或统计成本。
  • 你希望客户端配置可以安全恢复。

不适合场景

  • 你只用一个客户端、一个 Provider,且配置长期不变。
  • 你不需要日志、故障转移、成本统计或配置回滚。

问题

客户端直接连 Provider 时,请求失败、成本异常和路由结果都不容易看清。AgentGate 让请求离开本机前先变得可观察。

AgentGate 会记录什么

你可以看到路由策略、上游 Provider、模型、状态码、延迟、Token 用量、估算成本,以及可用时的故障转移行为。

怎么用

对 Codex 执行 apply,发起一次请求,然后打开日志页。按客户端或 Provider 过滤,就能看清是哪条路由处理了请求。

agentgate --faq

常见问题。

日志会上传吗?

不会。AgentGate 是本地优先,追踪数据保存在本地。

能排查 Provider 调用失败吗?

可以。日志和诊断页就是为这类排查准备的。