查询 AI Center Coding Agents…

当需要查询或对比 Claude Code、Codex、Cursor、Gemini CLI、Copilot CLI 等编码代理的使用量、成本、token、会话、工具、代码影响、用户、模型、span 或日志数据时使用。

适用场景

解决思路

1. 先识别用户要查的 agent 和分析目标；若缺少必要范围（agent、时间范围、可选过滤条件如 application/subsystem/user/model/session/repository、输出形态如快速回答/表格/趋势/Top-N/调查笔记/仅查询），先询问再查询。
2. 按 agent 选择数据源：Claude Code 指标用 `claude_code_*` 指标族；Claude Code 会话文本用 `source ai_sessions_claude` 日志；Codex 用 `service.name == 'codex_cli_rs'` 或 `'codex-app-server'` 日志；Codex 延迟用 `$l.serviceName == 'codex_cli_rs'` 或 `'codex-app-server'` span；Cursor 用 `$l.serviceName == 'cursor-agent'` span；Gemini CLI 用 `gemini_cli_*` 指标族；Copilot CLI 直连 OTel 用 `$l.serviceName == 'github-copilot'` 或 `tags['otel.scope.name'] == 'github.copilot'` span；GitHub Copilot Collector 用 `github_copilot_*` 指标族。
3. 先加载对应 agent 参考文件，再加载其依赖的共享查询语言文件：Claude Code 指标加载 `references/claude-code.md` + `references/promql-guidelines.md` + `references/metrics-querying.md`；Claude Code 会话加载 `references/claude-code.md` + `references/dataprime-reference.md` + `references/logs-querying.md`；Codex 加载 `references/codex.md` + `references/dataprime-reference.md` + `references/logs-querying.md` + `references/spans-querying.md`；Cursor 加载 `references/cursor.md` + `references/dataprime-reference.md` + `references/spans-querying.md`；Gemini CLI 加载 `references/gemini-cli.md` + `references/promql-guidelines.md` + `references/metrics-querying.md`；Copilot CLI 直连 OTel 加载 `references/copilot-cli.md` + `references/dataprime-reference.md` + `references/spans-querying.md`；GitHub Copilot Collector 加载 `references/copilot-cli.md` + `references/promql-guidelines.md` + `references/metrics-querying.md`；跨 agent 对比加载所有 agent 参考文件和所有共享参考文件。
4. 使用 CLI 命令：`cx metrics search --name '<pattern>'` 按名称查找指标；`cx metrics query '<expr>'` 做即时 PromQL 查询；`cx metrics query-range '<expr>'` 做范围 PromQL 查询（时间序列）；`cx logs '<dataprime_query>'` 查日志；`cx spans '<dataprime_query>'` 查 span；`cx dataprime query '<query>'` 执行原始 DataPrime 查询（需要显式 `source logs` 或 `source spans` 时使用）。
5. 把结果传给 agent 或做后续处理时，给任意命令追加 `-o toon`。
6. 需要跨多个 profile 同时展开查询时，使用 `-p <profile>`（可重复）。
7. 尽量使用与对应 dashboard 相同的数据源：Claude Code 指标用 `claude_code_*` 上的 PromQL；Claude Code 会话文本用 `ai_sessions_claude` 日志上的 DataPrime；Codex 用 Codex 日志上的 DataPrime 查 token、会话、模型、用户和工具，仅 `run_turn` 延迟用 span；Cursor 用 Cursor span 上的 DataPrime（Cursor 报告 prompt 长度和文件编辑，不报告 provider token 数）；Gemini CLI 用 `gemini_cli_*` 上的 PromQL；Copilot CLI 直连 OTel 用 Copilot span 上的 DataPrime；GitHub Copilot Collector 在该 collector 数据存在时用 `github_copilot_*` 组织/用户/计费指标上的 PromQL。
8. PromQL 查询（Claude Code、Gemini CLI、GitHub Copilot Collector）：对计数器在所选窗口用 `increase(metric[<range>])`；常用标签过滤模式 `{user_email="<user>",model="<model>",cx_application_name="<app>",cx_subsystem_name="<subsystem>"}`；用 `sum by (...)`、`count by (...)` 或 `topk(N, ...)` 分组；图表趋势用基于所选范围的 interval 窗口而非整个范围。
9. DataPrime 查询（Codex、Cursor、Copilot CLI 直连、Claude Code 会话）：用 `| filter ...` 子句过滤 user、model、application、subsystem、session 和 operation；类 dashboard 表格优先用 `groupby ... aggregate ...`；span 的 app/subsystem 标签是 `$l.applicationName` 和 `$l.subsystemName`（混合大小写）；日志的 app/subsystem 标签是 `$l.applicationname` 和 `$l.subsystemname`（小写）；过滤模式为 `| filter $l.applicationName == '<application>' && $l.subsystemName == '<subsystem>'`。
10. 跨 agent 对比时：先归一化单位（成本用 USD，token 分 input/output/total，运行时用毫秒，会话用不同对话数）；说明哪些信号不等价（Cursor prompt 长度不是 provider token 数；直连 Copilot CLI 用户是假名 ID `enduser.pseudo.id` 而非邮箱；GitHub Copilot Collector 用户可能是 login、姓名或邮箱）；维度不同时优先按 agent 分节而非合并成一张表；问“哪个 agent 用得最多”时先比较会话数和用户数，再带保留地比较 token 或 span 数；问“哪个 agent 成本最高”时注意 Claude Code 有一等 USD 指标，Copilot 直连 span 暴露 `github.copilot.cost`，Collector 计费指标按组织/SKU 暴露 net/gross/discount 金额，不要在不解释来源和单位差异的情况下合并 Copilot span 成本和 collector 计费。
11. 回答时始终包含：使用的 agent 和数据源、查询或精简查询片段、应用的时间范围和过滤条件、结果的自然语言解读、以及关于空数据、近似计数、假名用户、缺失标签或不可比指标的注意事项。
12. 不要臆造 agent 参考文件中未列出的字段；若用户要查某 agent 不产出的数据，说明有哪些可用数据并提出最接近的受支持查询。
13. 若用户说“GitHub Copilot Codex”，先澄清指的是 Codex 还是 Copilot CLI，因为 AI Center 有独立的 Codex 和 Copilot CLI dashboard。

适用边界 · 注意事项

• 所有查询命令（`cx metrics`、`cx logs`、`cx spans`、`cx dataprime`）都是只读的，不会修改数据，可自由运行且无需 `--yes`。
• 不要臆造 agent 参考文件中未列出的字段。
• 不要在不解释来源和单位差异的情况下合并 Copilot span 成本与 collector 计费数据。