View a markdown version of this page

Siapkan Kode Claude 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 Kode Claude dengan token pembawa

Di jalur ini, Claude Code 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 Claude Code 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 menggabungkan identitas melalui SSO perusahaan harus menggunakan peluncuran perusahaan dengan gateway aplikasi Claude sebagai gantinya. Lihat Siapkan Kode Claude dengan gateway aplikasi Claude.

Prasyarat

  • Claude Code diinstal pada mesin pengembang.

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

  • 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

Claude Code mengkonfigurasi OpenTelemetry melalui variabel lingkungan. Tetapkan variabel berikut di shell yang meluncurkan Claude Code (atau di profil shell Anda) untuk mengaktifkan metrik, pilih OTLP/HTTP protokol, dan arahkan pengekspor metrik ke titik akhir metrik dengan token pembawa CloudWatch Anda di header. Authorization Sertakan /v1/metrics jalur lengkap.

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT="https://monitoring.region.amazonaws.com/v1/metrics"
export OTEL_EXPORTER_OTLP_METRICS_HEADERS="Authorization=Bearer YOUR_API_KEY"
catatan

Perlakukan token pembawa sebagai rahasia. Hindari melakukan itu ke kontrol sumber atau profil shell yang dibagikan atau dicadangkan secara tidak aman. Putar tombol secara berkala seperti yang dijelaskan dalamMenyiapkan otentikasi token pembawa untuk Metrik.

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. 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 Claude Code mencap dimensi tingkat metrik seperti model dan pada metrik secara otomatis. type

Verifikasi dan lihat

Jalankan Claude Code untuk menghasilkan metrik, lalu konfirmasikan data yang dicapai. CloudWatch

Untuk memverifikasi metrik

  1. Jalankan sesi Claude Code yang melakukan beberapa pekerjaan.

  2. Di CloudWatch konsol, pilih GenAI Observability, Coding Agent Insights, dan kemudian tab Claude Code. 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 Kode Claude dengan Amazon Bedrock di. GitHub