View a markdown version of this page

Lihat data observabilitas untuk agen Amazon Bedrock AgentCore Anda - Batuan Dasar Amazon AgentCore
Lihat data menggunakan observabilitas AI generatif di Amazon CloudWatchLihat data lainnya di CloudWatch

Lihat data observabilitas untuk agen Amazon Bedrock AgentCore Anda

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

Lihat data menggunakan observabilitas AI generatif di Amazon CloudWatch

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

Dengan observabilitas AI generatif CloudWatch, Anda dapat melihat dasbor yang disesuaikan dengan grafik dan visualisasi lain dari data Anda, serta kerusakan kesalahan, visualisasi jejak, dan banyak lagi. Untuk mempelajari lebih lanjut tentang penggunaan observabilitas AI generatif di CloudWatch, termasuk cara melihat sesi individual agen Anda dan melacak data, lihat agen Amazon Bedrock AgentCore 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 dihasilkan kode agen instrumentasi 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 kolom pencarian untuk menemukan grup log untuk agen, memori, atau sumber daya 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>

      • Berisi: Kesalahan runtime, log aplikasi, pernyataan debugging

      • Contoh Penggunaan:

        • print (“Permintaan pemrosesan...”) # Muncul di log standar

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

    • Log terstruktur OTEL - 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 Bentang

Jejak 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 Penelusuran CloudWatch Transaksi

  • Persyaratan: Pencarian CloudWatch Transaksi harus diaktifkan

Jejak secara otomatis menangkap:

  • Urutan pemanggilan agen

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

  • Panggilan dan tanggapan LLM

  • Pemanggilan dan hasil alat

  • Jalur kesalahan dan pengecualian

Untuk penelusuran 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 menginstrumentasi kode agen Anda seperti yang dijelaskan dalam Mengaktifkan AgentCore observabilitas, agen Anda secara otomatis membuat metrik OTEL, yang dikirim ke CloudWatch menggunakan Enhanced Metric Format (EMF):

  • Namespace: bedrock-agentcore

  • Akses melalui: CloudWatch Konsol metrik

  • 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, layanan ini menerbitkan metrik AgentCore layanan standar ke. CloudWatch Lihat data observabilitas runtime yang AgentCore dihasilkan untuk daftar metrik ini.