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
<a name="coding-agents-codex-bearer-token"></a>

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](CloudWatch-OTLP-MetricsBearerTokenAuth.md) Organizations yang mengfederasi identitas melalui SSO perusahaan harus menggunakan peluncuran perusahaan sebagai gantinya. Lihat [Siapkan OpenAI Codex untuk peluncuran perusahaan](coding-agents-codex-enterprise.md).

## Prasyarat
<a name="coding-agents-codex-bearer-token-prereqs"></a>
+ 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](https://developers.openai.com/codex/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, lihat[Menyiapkan otentikasi token pembawa untuk Metrik](CloudWatch-OTLP-MetricsBearerTokenAuth.md).

## Konfigurasikan pengekspor metrik
<a name="coding-agents-codex-bearer-token-configure"></a>

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
<a name="coding-agents-codex-bearer-token-attributes"></a>

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
<a name="coding-agents-codex-bearer-token-verify"></a>

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).

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

1. Secara opsional, kueri metrik secara langsung dengan PromQL. Untuk informasi selengkapnya, lihat [Kueri PromQL](CloudWatch-PromQL-Querying.md).

Untuk panduan lengkap yang terus diperbarui, lihat [panduan untuk Codex di Amazon Bedrock di](https://github.com/openai-on-aws/guidance-codex). GitHub