View a markdown version of this page

Siapkan OpenAI Codex dengan token pembawa - Amazon CloudWatch
PrasyaratKonfigurasikan pengekspor metrikTambahkan identitas dan atribut organisasiVerifikasi dan lihat

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Siapkan OpenAI Codex dengan token pembawa

Di jalur ini, OpenAI Codex mengirimkan metrik OpenTelemetry (OTel) langsung ke titik akhir metrik OTLP CloudWatch asli Amazon dan mengautentikasi dengan token pembawa (kunci API metrik). CloudWatch Tidak diperlukan OpenTelemetry kolektor. Ini adalah cara tercepat bagi pengembang individu atau tim kecil untuk memasukkan metrik Codex ke dasbor Coding Agent Insights.

penting

Token pembawa adalah kredensil jangka panjang. Kami merekomendasikan mereka hanya jika AWS kredensi jangka pendek tidak layak, seperti laptop pengembang di luar. AWS Untuk panduan pertukaran keamanan dan rotasi kunci, lihat. Menyiapkan otentikasi token pembawa untuk Metrik Organizations yang mengfederasi identitas melalui SSO perusahaan harus menggunakan peluncuran perusahaan sebagai gantinya. Lihat Siapkan OpenAI Codex untuk peluncuran perusahaan.

Prasyarat

  • OpenAI Codex diinstal pada mesin pengembang.

  • Cara kerja bagi Codex untuk memanggil model untuk inferensi. Pengaturan telemetri ini tidak tergantung pada inferensi, sehingga Anda dapat menggunakan akun OpenAI (penyedia Codex default) atau Amazon Bedrock. Untuk menggunakan Amazon Bedrock untuk inferensi, lihat Amazon Bedrock di dokumentasi OpenAI Codex.

  • Kunci API CloudWatch metrik (token pembawa), dibuat dari pengguna IAM yang memiliki CloudWatch izin metrik. Untuk prosedur yang membuat pengguna IAM dan menghasilkan kunci, lihatMenyiapkan otentikasi token pembawa untuk Metrik.

Konfigurasikan pengekspor metrik

Codex membaca konfigurasinya dari~/.codex/config.toml. Tambahkan [otel.metrics_exporter] bagian yang menunjuk pada titik akhir OTLP CloudWatch metrik dan mengirimkan token pembawa Anda di header. Authorization Sertakan /v1/metrics jalur lengkap; Codex tidak menambahkannya untuk Anda.

[otel]
environment = "production"

[otel.metrics_exporter]
otlp-http = { endpoint = "https://monitoring.region.amazonaws.com/v1/metrics", protocol = "binary", headers = { "Authorization" = "Bearer YOUR_API_KEY" } }
catatan

Beberapa versi Codex tidak memperluas variabel lingkungan di dalam nilai header, sehingga kunci API ditampilkan sebaris. Perlakukan config.toml sebagai rahasia: batasi izin filenya (misalnya,chmod 600 ~/.codex/config.toml) dan jangan komit ke kontrol sumber.

Tambahkan identitas dan atribut organisasi

Dasbor Coding Agent Insights mengelompokkan penggunaan oleh pengembang, tim, departemen, dan dimensi organisasi lainnya. Berikan ini sebagai atribut sumber daya OTel melalui variabel OTEL_RESOURCE_ATTRIBUTES lingkungan di shell yang meluncurkan Codex. Tetapkan nilai dari identitas pengembang dan struktur organisasi Anda.

export OTEL_RESOURCE_ATTRIBUTES="\
user.id=alias,\
user.email=developer@example.com,\
user.name=Jane Doe,\
department=engineering,\
team.id=platform,\
cost_center=cc-1234,\
organization=example-corp,\
location=us-seattle,\
role=software-engineer,\
manager=manager@example.com"
catatan

Menyetel ini sebagai atribut sumber daya (bukan atribut per-titik data) cocok dengan bentuk yang diharapkan dasbor, sehingga Anda dapat mengelompokkan berdasarkan@resource.team.id,, dan label serupa. @resource.department Codex mencap dimensi tingkat metrik seperti model dan token_type pada metrik secara otomatis.

Verifikasi dan lihat

Jalankan Codex selama beberapa putaran untuk menghasilkan metrik, lalu konfirmasikan data yang dicapai. CloudWatch

Untuk memverifikasi metrik

  1. Jalankan sesi Codex yang melakukan beberapa pekerjaan (misalnya, minta untuk menjalankan perintah dan mengedit file).

  2. Di CloudWatch konsol, pilih GenAI Observability, Coding Agent Insights, dan kemudian tab Codex. Metrik biasanya muncul dalam beberapa menit.

  3. Secara opsional, kueri metrik secara langsung dengan PromQL. Untuk informasi selengkapnya, lihat Kueri PromQL.

Untuk panduan lengkap yang terus diperbarui, lihat panduan untuk Codex di Amazon Bedrock di. GitHub