View a markdown version of this page

Melihat data pengamatan untuk agen Amazon Bed AgentCore rock Anda - Batu Dasar Amazon AgentCore
Lihat data menggunakan pengamatan AI generatif di Amazon CloudWatchLihat data lainnya di CloudWatch

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

Melihat data pengamatan untuk agen Amazon Bed AgentCore rock Anda

Setelah menerapkan observabilitas di agen Anda, Anda dapat melihat metrik dan jejak yang dikumpulkan di halaman pengam CloudWatch atan AI generatif konsol dan di Log. CloudWatch Lihat bagian berikut untuk mempelajari cara melihat metrik untuk agen Anda.

Lihat data menggunakan pengamatan AI generatif di Amazon CloudWatch

Halaman pengamatan AI CloudWatch generatif menampilkan semua keluaran metrik yang disediakan layanan oleh runtime AgentCore agen, serta data yang diturunkan dari rentang dan pelacakan jika Anda telah mengaktifkan instrumentasi dalam kode agen Anda. Untuk melihat dasbor observabilitas di CloudWatch, buka halaman Peng amatan Amazon CloudWatch GenAi .

Dengan pengamatan AI generatif CloudWatch, Anda dapat melihat dasbor yang disesuaikan dengan grafik dan visualisasi data lainnya, serta kerusakan kesalahan, visualisasi pelacakan, dan banyak lagi. Untuk mempelajari lebih lanjut tentang menggunakan pengamatan AI generatif di CloudWatch, termasuk cara melihat sesi individu agen Anda dan data pelacakan, lihat AgentCore agen Amazon Bedrock di panduan pengguna Amazon. CloudWatch

Lihat data lainnya di CloudWatch

Semua metrik dan rentang yang disediakan layanan juga dapat dilihat CloudWatch, bersama dengan metrik apa pun yang dikeluarkan kode agen instrumen Anda.

Untuk melihat data ini, lihat bagian berikut.

Beberapa catatan

  1. Buka konsol CloudWatch.

  2. Di panel navigasi sebelah kiri, perluas Log dan pilih Grup log

  3. Gunakan bidang pencarian untuk menemukan grup log untuk sumber daya agen, memori, atau gateway Anda.

    AgentCore grup log agen memiliki format berikut:

    • Log standar - stdout/stderr keluaran

      • Lokasi:/aws/bedrock-agentcore/runtimes/<agent_id>-<endpoint_name>/[runtime-logs] <UUID>

      • Ber isi: Kesalahan runtime, log aplikasi, pernyataan debugging

      • Contoh Penggunaan:

        • cetak (“Memproses permintaan...”) # Muncul di log standar

        • logging.info (“Permintaan berhasil diproses”) # Muncul di log standar

    • OTEL log terstruktur - Informasi operasi terperinci

      • Lokasi:/aws/bedrock-agentcore/runtimes/<agent_id>- <endpoint_name>/otel-rt-logs

      • Berisi: Detail eksekusi, pelacakan kesalahan, data kinerja

      • Pengumpulan otomatis: Tidak diperlukan kode tambahan - dihasilkan oleh instrumentasi ADOT

      • Manfaat: Dapat menyertakan ID korelasi yang menghubungkan log ke jejak yang relevan

Jejak dan Rentang

Trace memberikan visibilitas ke jalur eksekusi permintaan melalui agen Anda:

  • Lokasi: aliran spans log di grup log agen (/aws/bedrock-agentcore/runtimes/<agent_id>-<endpoint_name>), atau aliran default log di grup aws/spans log untuk agen yang menggunakan tujuan rentang bersama. Untuk informasi selengkapnya, lihat Tujuan rentang untuk agen yang dihosting di AgentCore runtime Amazon Bedrock.

  • Akses melalui: Konsol Pencarian CloudWatch Transaksi

  • Persyaratan: CloudWatch Pencarian Transaksi harus diaktifkan

Jejak secara otomatis menangkap:

  • Urutan pemanggilan agen

  • Integrasi dengan komponen kerangka kerja (LangChain, dll.)

  • Panggilan dan tanggapan LLM

  • Pemanggilan alat dan hasil

  • Jalur kesalahan dan pengecualian

Untuk pelacakan terdistribusi di seluruh layanan, Anda dapat menggunakan header HTTP standar:

  • AWS X-Ray format: X-Amzn-Trace-Id: Root=1-5759e988-bd862e3fe1be46a994272793;Parent=53995c3f42cd8ad8;Sampled=1

  • Format W3C: traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01

Untuk melihat jejak:

  • Arahkan ke CloudWatch konsol

  • Pilih Pencarian Transaksi dari navigasi kiri

  • Filter berdasarkan nama layanan atau kriteria lainnya

  • Pilih jejak untuk melihat grafik eksekusi terperinci

Metrik-metrik

Jika Anda telah mengaktifkan observabilitas dengan menginstrumentasikan kode agen Anda seperti yang dijelaskan dalam Meng aktifkan AgentCore observabilitas, agen Anda secara otomatis menghasilkan metrik OTEL, yang dikirim ke CloudWatch menggunakan Enhanced Metric Format (EMF):

  • Namespace: bedrock-agentcore

  • Akses melalui: CloudWatch Metrics console

  • Isi: Metrik khusus yang dihasilkan oleh kode agen dan kerangka kerja Anda

  • Pengumpulan otomatis: Tidak diperlukan kode tambahan - dihasilkan oleh instrumentasi ADOT

Selain metrik yang dipancarkan agen, AgentCore layanan menerbitkan metrik layanan standar ke. CloudWatch Lihat data pengamatan runtime AgentCore yang dihasilkan untuk daftar metrik ini.