Codex を全社に広げると、情報システム部門やセキュリティ担当から「Codex が端末の上で何をしたのかを社内のログ基盤で見たい」という声が出てきます。管理画面の分析や Compliance API で分かることもありますが、どのツールの実行が承認されたか、どれだけ時間がかかったか、といった端末側の動きを社内の監視の仕組みに集めたい場面もあります。

そのための仕組みが OpenTelemetry(OTel) です。Codex は OTel の形式でイベントを出力でき、社内で用意したコレクターへ送れます。既定ではオフで、設定ファイルで明示的に有効にします。

この記事では、config.toml の [otel] の書き方、送られるイベントとメトリクス、プロンプトや出力を扱うときの注意、管理者が requirements.toml で全員に固定する方法、社内での進め方を整理します。製品の内容は、2026年11月20日に OpenAI の公式ドキュメント「Agent approvals and security」「Advanced configuration」「Managed configuration」と「Changelog」で確かめた範囲に絞りました。

結論: 送り先は自社のコレクター・プロンプトは伏せたまま・全員分は requirements.toml

先に要点をまとめます。

  1. OTel は 既定でオフ。[otel] を設定ファイルに書いて有効にする。書く場所は利用者ごとの ~/.codex/config.toml で、リポジトリの .codex/config.toml に書いても無視される
  2. 送り方は exporter で選ぶ。none(記録するが送らない)・otlp-http・otlp-grpc の3つ
  3. 送られるのは会話の開始・API の呼び出し・承認の判断・ツールの実行結果などのイベントと、件数と所要時間のメトリクス
  4. log_user_prompt は 既定で false。プロンプトの本文は伏せられ、長さだけが記録される
  5. 全員に守らせたいときは、Codex CLI 0.166.0 以降の requirements.toml の [otel] で管理者が固定する。管理側の値が手元の設定より優先される

管理画面の分析・Compliance API・OTel の違い

Codex の利用状況を把握する道具はいくつかあり、目的が違います。OTel の位置づけを先に押さえておくと、何をどこで見るか迷いません。

道具 主に見えるもの 向いている使い方
管理画面の分析 利用者数や利用の傾向 社内への普及の度合いを見る
Compliance API ワークスペースの監査向けの記録 監査や調査のために記録を取り出す
OpenTelemetry 端末で動く Codex のイベントとメトリクス 社内のログ基盤や監視ツールに集めて見る
ローカルの履歴 各自の PC に残る会話の記録 本人が作業を振り返る

分析画面と Compliance API の詳しい違いは管理者が Codex の利用状況を把握する方法にまとめています。この記事では OTel の設定に絞って説明します。

設定の書き方

公式ドキュメントでは、~/.codex/config.toml に [otel] の表を書くと説明されています。基本の形は次のとおりです。

[otel]
environment = "staging"   # 既定は "dev"
exporter = "none"         # 送るときは otlp-http か otlp-grpc にする
log_user_prompt = false   # プロンプトの本文は伏せる

それぞれの項目の意味を表にします。

項目 意味 公式ドキュメントでの説明
environment 送るデータに付ける環境の名前 dev・staging・prod のように分けるための名前。既定は dev
exporter ログの送り方 none・otlp-http・otlp-grpc のどれか
log_user_prompt プロンプトの本文を送るか 既定は false。本文は伏せられる
metrics_exporter メトリクスの送り方 none にするとメトリクスの送信も止められる

environment を付けておくと、試験導入のチームと本番の利用者のデータを分けて見られます。公式ドキュメントによると、送られるイベントには環境の名前のほか、呼び出し元(service.name)と CLI のバージョンが付きます。

社内のコレクターへ送る

実際に送るときは exporter に送り先を書きます。HTTP で送る場合の例です。COLLECTOR_URL は社内のコレクターのアドレスに置き換えてください。

[otel]
environment = "prod"
log_user_prompt = false
exporter = { otlp-http = {
  endpoint = "COLLECTOR_URL/v1/logs",
  protocol = "binary",
  headers = { "x-otlp-api-key" = "${OTLP_TOKEN}" }
}}

gRPC で送る場合は otlp-grpc を使い、endpoint と headers を書きます。公式の例でも、認証用のヘッダーの値は ${OTLP_TOKEN} のように環境変数から読む形になっています。鍵そのものを設定ファイルに書かないようにしてください。鍵の扱い全般は鍵・環境変数を Codex に触らせない設定が参考になります。

なお、2026年11月18日の Codex CLI 0.170.0 の変更履歴には、OpenTelemetry の HTTP エクスポーターの認証ヘッダーに関する改善が載っています。送信がうまくいかないときは、まず CLI のバージョンを確かめると切り分けが早くなります。

書く場所に注意する

公式ドキュメントでは、otel はリポジトリの .codex/config.toml では 無視され、起動時に警告が出る 項目の1つとされています。送り先を勝手に変えられないようにするための決まりで、テレメトリーの設定は利用者ごとの ~/.codex/config.toml に書くよう案内されています。チームで共通にしたいときは、後で説明する管理者の設定を使います。

何が送られるのか

公式ドキュメントに載っている主なイベントは次のとおりです。

イベント 中身
codex.conversation_starts 使ったモデル・推論の設定・サンドボックスと承認の設定
codex.api_request 試行回数・成否・所要時間・エラーの内容
codex.sse_event ストリームのイベントの種類・成否・所要時間。完了時はトークン数
codex.websocket_request / codex.websocket_event WebSocket の要求の所要時間やメッセージごとの成否
codex.user_prompt プロンプトの長さ。本文は明示的に有効にしない限り伏せられる
codex.tool_decision 承認されたか拒否されたか。判断が設定によるものか利用者によるものか
codex.tool_result 所要時間・成否・出力の一部

メトリクスとしては、API の呼び出し・ストリーム・WebSocket・ツールの実行について、件数と所要時間が出力されます。メトリクスには認証の方式・呼び出し元・セッションの種類・モデル・アプリのバージョンといった既定のタグが付きます。

セキュリティ担当にとって特に使いやすいのは codex.conversation_starts と codex.tool_decision です。「どのサンドボックスの設定で使われているか」「設定で自動承認された実行と、本人が承認した実行がどれくらいあるか」を社内のログ基盤で集計できます。

送られないもの

一方で、公式ドキュメントは次の点も明記しています。

  • 送られるのは Codex の OTel モジュールが作るデータだけ
  • イベントはまとめて送られ、終了時に書き出される
  • ネットワークをオフにして CLI を動かしている場合は、コレクターに届かない

ネットワークを止めている場合について、公式ドキュメントは workspace-write のモードでコレクターへの通信だけを許可するか、Codex のクラウド環境から送る場合はコレクターのドメインを許可の一覧に入れる方法を挙げています。通信の許可範囲の決め方はネットワークアクセスの許可範囲の決め方をご覧ください。

プロンプトと出力の扱い

OTel を入れるときに最も気を付けたいのは、ログ基盤に何が残るかです。公式ドキュメントは次のように案内しています。

  1. プロンプトは伏せたままにする: プロンプトにはソースコードや機密情報が入りうるため、社内規程で保存を認めた場合を除き log_user_prompt = false のままにする
  2. ツールの引数と出力も機密として扱う: codex.tool_result には出力の一部が入る。必要に応じてコレクターや SIEM の側で伏せる処理を入れる
  3. 送り先は自社が管理するコレクターだけにする: 保存期間と閲覧できる人を決めたうえで送る

あわせて、各自の PC に残る会話の履歴は OTel とは別の設定で決まります。公式ドキュメントによると、Codex は既定で ~/.codex/history.jsonl などに会話の記録を保存します。[history] の persistence = "none" で保存を止められ、max_bytes で大きさの上限を決めると古い記録から削られます。ログ基盤に送るものと PC に残るものを分けて社内に説明できるようにしておくと、問い合わせに答えやすくなります。社員向けの説明の作り方は入力データの扱いを社内に説明する FAQが参考になります。

管理者が全員に固定する

利用者の ~/.codex/config.toml に書いた設定は、本人が書き換えられます。全員に同じ送り先を守らせたいときは、管理者の設定を使います。

公式ドキュメントでは、Codex CLI 0.166.0 以降は requirements.toml の [otel] で、ログ・トレース・メトリクスの送り先をそれぞれ設定し、環境の名前を付け、何を送るかを決められると説明されています。

[otel]
exporter = { otlp-http = { endpoint = "COLLECTOR_URL/v1/logs", protocol = "binary" } }
log_user_prompt = false

管理側の設定について押さえておきたい点を表にします。

比べる点 内容
優先順位 管理側の値が手元の設定より優先される
送り先の決まり方 exporter・trace_exporter・metrics_exporter は、それを設定しているもっとも優先度の高い要件が、ヘッダーや TLS の設定も含めて定義をまるごと決める
ファイルの場所 /etc/codex/requirements.toml(Linux と macOS)、%ProgramData%\OpenAI\Codex\requirements.toml(Windows)
デスクトップアプリ macOS のデスクトップアプリ 26.1111.21308 は管理側の [otel] に対応。それより前の 26.1027.30824 は requirements.toml で [otel] を固定できない
量を減らす設定 otel.log_sse_deltas = false で、成功したストリームのイベントのうち名前が .delta で終わるものを送らない

送り先の定義が「まるごと」決まる点は大切です。管理者が exporter を設定すると、利用者が手元でヘッダーだけを足すといった部分的な上書きはできません。認証のヘッダーが必要なら、管理側の定義の中に含めておきます。

また、デスクトップアプリは版によって対応が違います。CLI だけでなくデスクトップアプリも配っている会社は、端末に入っている版を確かめてから固定してください。配布と版の管理は情シス向け Codex CLI の配布と初期設定とデスクトップアプリの更新管理にまとめています。

社内での進め方

OTel を社内に入れるときは、次の順番で進めると手戻りが少なくなります。

  1. 見たいことを決める: 「サンドボックスの設定が守られているか」「承認の拒否がどれくらいあるか」「エラーが多い端末はどこか」など、ログ基盤で答えたい問いを先に3つほど決める
  2. 保存のルールを決める: 送り先のコレクター・保存期間・閲覧できる人・プロンプトを保存しないことを、セキュリティ担当と文書にする
  3. 試験チームで exporter = "none" から始める: 記録はするが送らない状態で動きを確かめ、次に試験用の environment を付けてコレクターへ送る
  4. ログの中身を確かめる: 代表的な作業を実際に行い、届いたイベントと実際の操作を見比べる。出力の一部に機密が入っていないかを確かめ、必要ならコレクター側で伏せる
  5. 管理者の設定で固定する: 送り先と log_user_prompt = false を requirements.toml に移し、端末の CLI とデスクトップアプリの版がそろっているかを確かめる
  6. 社員に説明する: 何が送られ何が送られないかを、社内利用ガイドラインや FAQ に書いて伝える

ログを個人の評価に使うかどうかは、導入の前に決めて社員に伝えておくことをおすすめします。監視されているという受け止めが広がると、試験導入で正直な使い方が見えにくくなるためです。社内の約束ごとの文章は社内利用ガイドラインの作り方、全体の統制の考え方はセキュリティとガバナンスの記事が参考になります。

まとめ

Codex は OpenTelemetry で、会話の開始・承認の判断・ツールの実行結果などのイベントと、件数と所要時間のメトリクスを社内のコレクターへ送れます。既定ではオフで、~/.codex/config.toml の [otel] で有効にします。プロンプトの本文は既定で伏せられ、ツールの出力も機密として扱うよう案内されています。全員に守らせたいときは、Codex CLI 0.166.0 以降の requirements.toml の [otel] で管理者が固定します。ただし OTel はすべての操作の完全な記録ではありません。サンドボックスと承認の設定を土台にし、その上で動きを確かめる手段として使ってください。サンドボックスと承認の考え方はサンドボックスと承認ポリシーの記事をご覧ください。

この記事の内容は、2026年11月20日時点の OpenAI 公式ドキュメントの記載に基づいています。設定の項目名や対応する版は変わることがあるため、社内の設定に落とし込む前に最新の記載をご確認ください。デジライズでは、ログ基盤で見たいことの整理から、[otel] と requirements.toml の設計、社員への説明資料づくりまでを情報システム部門と一緒に進める Codex の法人導入支援のご相談を承っています。「まず1つのチームで試したい」という段階からでもお問い合わせください。