通过 Logfire 导出会话遥测

安装 logfire-exporter@pydantic-skills,通过 Stop 钩子导出遥测。LOGFIRE_TOKEN 写入 config.env,正文采集模式默认 full。

Logfire 官方 Codex 追踪:marketplace add pydantic/skills,再 plugin add logfire-exporter@pydantic-skills。这是把 Codex 会话追踪发送到 Logfire,不是去查应用遥测,也不是 Codex 内置那套 OTEL 日志。官方导出器页和技能页都写了 marketplace;清单 .agents/plugins/marketplace.json 的 name 是 pydantic-skills,展示名 Pydantic,插件 name 是 logfire-exporter,所以是 logfire-exporter@pydantic-skills。源是 ./plugins/logfire-exporter。导出器只在 Codex 上有,Claude 那份 marketplace 没有该服务。

官方 Codex 主路径(技能页带 --ref main):

codex plugin marketplace add pydantic/skills --ref main
codex plugin add logfire-exporter@pydantic-skills
codex plugin list

codex plugin list 应看到 logfire-exporter@pydantic-skills 为 installed, enabled。加完先看当前会话;当前会话 /plugins 没有再新开。也可以在插件浏览器的 Pydantic 栏开 Logfire Exporter。IDE 扩展没有 /plugins,用 CLI 加。网页 Cloud 不读本机 marketplace。

钩子要单独打开并信任。现行键是 hooks不要手写 plugin_hooks

[features]
hooks = true

[plugins."logfire-exporter@pydantic-skills"]
enabled = true

新开会话后若出现 Hooks need review,打开 /hooks,审过 SessionStart / UserPromptSubmit / PostToolUse / Stop 再信任。只开插件不够。Codex 按钩子哈希记信任;插件升级改了命令要再审一次。导出发生在 Stop:回合没跑完、被打断没到 Stop,就不会出 span。没有长生命周期的 session 根 span。

写令牌不要进 config.tomlenv 表。放到启动 Codex 的进程环境,或:

${XDG_CONFIG_HOME:-~/.config}/logfire-exporter/config.env
LOGFIRE_TOKEN=pylf_...
LOGFIRE_BASE_URL=https://logfire-us.pydantic.dev

仓库 README 默认 API 主机是 https://logfire-api.pydantic.dev;官方导出器示例写 logfire-us.pydantic.dev。欧盟换成 https://logfire-eu.pydantic.dev。旧名 LOGFIRE_URL 还能用,但 LOGFIRE_BASE_URL 优先。本机实例才 http://localhost:3000。默认请求头是 Authorization 加令牌本身,要 Bearer 才设 CODEX_LOGFIRE_AUTH_SCHEME=Bearer。该服务不是 MCP,不要 codex mcp login

默认 CODEX_LOGFIRE_CONTENT_CAPTURE_MODE=full,会带脱敏后的 prompt、助手回复、工具入参/出参和工具错误。团队策略收紧时改 no_tool_contentmetadata_only。含密钥或客户数据的会话不要开 full。POSIX 钩子要能找到 python3;pyenv 卡住才钉 CODEX_LOGFIRE_PYTHON。排错看 ~/.local/state/logfire-exporter/logs/,TUI 日志搜 logfire-exporter

查应用遥测、打开 Logfire UI 是另一台插件:

codex plugin add logfire@pydantic-skills

它会登记托管 MCP,默认美区。欧盟要先卸再换主机:

codex mcp remove logfire
codex mcp add logfire --url https://logfire-eu.pydantic.dev/mcp
codex mcp login logfire

不要把导出器和查询插件混用。也不要把 npx skills add pydantic/skills 当该导出器的安装器——那只拷 SKILL.md,不装 Stop 钩子。

配置说明:

  • 不要 codex mcp add logfire-exporter,也不要对导出器 mcp login
  • 不要把写令牌写进 config.tomlenv 表,也不要拼进 URL。
  • 不要一上来 --yolo

升级用清单名,再重新 plugin add

codex plugin marketplace upgrade pydantic-skills
codex plugin add logfire-exporter@pydantic-skills

网页 Cloud 不读这份插件。改完彻底重启,跑完一轮短任务,到 Logfire 看 Stop 之后的 turn span。

来源