View a markdown version of this page

Penyiapan Kode Claude metrik di Amazon CloudWatch 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.

Penyiapan Kode Claude metrik di Amazon CloudWatch dengan token pembawa

Pada jalur ini, Claude Code mengirimkan metrik OpenTelemetry (oTel) langsung ke titik akhir metrik OTLP CloudWatch asli Amazon dan mengotentikasi dengan token pembawa (kunci API CloudWatch metrik). 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 kredensi jangka panjang. Kami merekomendasikan mereka hanya jika kre AWS denSIAL jangka pendek tidak layak, seperti laptop pengembang di luar AWS. Untuk pertukaran keamanan dan panduan rotasi kunci, lihat. Menyiapkan otentikasi token pembawa untuk Metrik Organisasi 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 Claude Code untuk memanggil model untuk inferensi. Pengaturan telemetri ini tidak bergantung pada inferensi, sehingga Anda dapat menggunakan akun Anthropic (penyedia Claude Code default) atau Amazon Bedrock. Untuk menggunakan Amazon Bedrock untuk inferensi, lihat Kode Claude di Amazon Bedrock di dokumentasi Kode Claude.

  • K CloudWatch unci API metrik (token pembawa), dibuat dari pengguna IAM yang memiliki izin CloudWatch 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 CloudWatch metrik dengan token pembawa Anda di Authorization header. 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 memasukkannya ke kontrol sumber atau profil shell yang dibagikan atau dicadangkan secara tidak aman. Putar kunci secara berkala seperti yang dijelaskan dalamMenyiapkan otentikasi token pembawa untuk Metrik.

Tambahkan identitas dan atribut organisasi

Dasbor Coding Agent Insights mengelompokkan penggunaan berdasarkan pengembang, tim, departemen, dan dimensi organisasi lainnya. Berikan ini sebagai atribut sumber daya oTel melalui variabel OTEL_RESOURCE_ATTRIBUTES lingkungan. Tetapkan nilai-nilai dari identitas pengembang Anda 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-datapoint) cocok dengan bentuk yang diharapkan dasbor, sehingga Anda dapat mengelompokkan berdasarkan@resource.team.id,@resource.department, dan label serupa. Claude Code mencap dimensi tingkat metrik seperti model dan type pada metrik secara otomatis.

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 Observability GenAI, 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 aktif. GitHub