OpenAI Codex 使用 OpenTelemetry 实现可观测性与监控

OpenAI Codex 是一款基于 AI 的编程助手，旨在通过自然语言交互协助开发者编写、理解和调试代码。它能将自然语言转化为代码，并支持多种编程语言。

本指南将带你使用 OpenTelemetry 为 OpenAI Codex 配置可观测性与监控，并将追踪和日志数据导出到 SigNoz。通过这一集成，你可以查看并跟踪 Codex AI 编程助手使用过程中的各项指标。

先决条件

拥有一个激活了数据摄入密钥的 SigNoz Cloud 账户，或一个< a href="https://signoz.io/docs/install/self-host/">自托管的 SigNoz 实例
ChatGPT Plus、Pro、Business、Edu 或 Enterprise 订阅，或者 OpenAI API 密钥（可从 OpenAI 平台获取）
网络访问权限，以便将遥测数据发送至 SigNoz 并向 OpenAI 发起 API 调用

监控 Codex

第一步：设置 Codex

有关在你的环境中快速上手 Codex 的更多信息，请参阅 Codex 快速入门指南。

IDE 扩展命令行界面

为你的 IDE 安装 Codex 扩展：

安装完成后，Codex 扩展将出现在侧边栏中，与其他扩展并列。它可能位于折叠区域中，你可以根据自己的喜好将 Codex 面板移至编辑器右侧。

使用 ChatGPT 账户或 API 密钥登录即可开始使用。

Codex 默认以 Agent 模式启动，该模式允许它读取文件、运行命令并在你的项目目录中写入更改。

由于 Codex 可能会修改你的代码库，建议在每个任务前后创建 Git 检查点，以便在需要时轻松回退更改。

Codex 命令行界面支持 macOS、Windows 和 Linux。

使用你偏好的包管理器进行安装：

npm Homebrew

使用 npm 安装：

Copy

npm install -g @openai/codex

也可以用 Homebrew 安装：

Copy

brew install codex

在终端里运行 codex 即可开始使用，系统会提示你用 ChatGPT 账号或 API key 登录。

认证完成后，就可以让 Codex 在当前目录下执行任务了。

Codex 可以修改你的代码库，因此建议在每次任务前后创建 Git 检查点，方便需要时回滚更改。

第 2 步：启用 OpenTelemetry (OTel) 导出以追踪 Codex 运行

关于 Codex 遥测配置的更多信息，请参考 Codex 可观测性指南。

Codex 的配置文件位于 ~/.codex/config.toml。

在 ~/.codex/config.toml 末尾追加以下内容：

~/.codex/config.toml

[otel]
log_user_prompt = true
exporter = { otlp-grpc = {
  endpoint = "https://ingest.<region>.signoz.cloud:443",
  headers = { "signoz-ingestion-key" = "<your-ingestion-key>" }
}}