View a markdown version of this page

AgentCore menghasilkan data observabilitas memori - Batuan Dasar Amazon AgentCore
Metrik memori yang disediakanData rentang yang disediakanData log yang disediakan

AgentCore menghasilkan data observabilitas memori

Untuk jenis sumber daya AgentCore memori, AgentCore output metrik ke Amazon secara CloudWatch default. AgentCore juga mengeluarkan satu set rentang dan log default, jika Anda mengaktifkannya. Lihat Mengaktifkan observabilitas untuk AgentCore runtime, memori, gateway, alat bawaan, dan sumber daya identitas untuk mempelajari lebih lanjut tentang mengaktifkan rentang dan log.

Lihat bagian berikut untuk mempelajari lebih lanjut tentang data observabilitas yang disediakan untuk penyimpanan memori agen Anda.

Metrik memori yang disediakan

Jenis sumber daya AgentCore memori menyediakan metrik berikut secara default.

Latensi

Total waktu berlalu antara menerima permintaan dan mengirim token respons akhir. Merupakan pemrosesan permintaan end-to-end yang lengkap.

Invokasi

Jumlah total permintaan API yang dibuat ke bidang data dan bidang kontrol. Metrik ini juga melacak jumlah peristiwa konsumsi memori.

Kesalahan Sistem

Jumlah pemanggilan yang menghasilkan kesalahan sisi AWS server.

Kesalahan Pengguna

Jumlah pemanggilan yang menghasilkan kesalahan sisi klien.

Kesalahan

Jumlah total kesalahan yang terjadi saat memproses permintaan API di bidang data dan bidang kontrol. Metrik ini juga melacak kesalahan total yang terjadi selama konsumsi memori.

Pembatasan

Jumlah pemanggilan yang dibatasi oleh sistem. Permintaan yang dibatasi dihitung sebagai pemanggilan, kesalahan, dan kesalahan pengguna.

Jumlah Penciptaan

Menghitung jumlah peristiwa memori yang dibuat dan catatan memori.

Data rentang yang disediakan

Untuk meningkatkan observabilitas, AgentCore berikan rentang terstruktur yang melacak hubungan antara peristiwa dan ingatan yang mereka hasilkan atau akses. Untuk mengaktifkan data rentang ini, Anda perlu menginstruksikan kode agen Anda. Lihat Menambahkan observabilitas ke AgentCore sumber daya Amazon Bedrock Anda untuk mempelajari lebih lanjut.

Data rentang ini tersedia secara lengkap di CloudWatch Log dan Sinyal CloudWatch Aplikasi. Untuk mempelajari selengkapnya tentang melihat data observabilitas, lihat Melihat data observabilitas untuk agen Amazon Bedrock AgentCore Anda.

Tabel berikut mendefinisikan operasi yang bentang dibuat dan atribut untuk setiap rentang yang ditangkap.

Nama operasi Atribut rentang Deskripsi

CreateEvent

memory.id , session.id , event.id , actor.id , throttled , error , fault

Membuat acara baru dalam sesi memori

GetEvent

memory.id , session.id , event.id , actor.id , throttled , error , fault

Mengambil peristiwa memori yang ada

ListEvents

memory.id , session.id , event.id , actor.id , throttled , error , fault

Daftar acara dalam sesi

DeleteEvent

memory.id , session.id , event.id , actor.id , throttled , error , fault

Menghapus peristiwa dari memori

RetrieveMemoryRecords

memory.id , namespace , throttled , error , fault

Mengambil catatan memori untuk namespace tertentu

ListMemoryRecords

memory.id , namespace , throttled , error , fault

Daftar catatan memori yang tersedia

Data log yang disediakan

AgentCore menyediakan log terstruktur yang membantu Anda memantau dan memecahkan masalah proses sumber daya AgentCore Memori kunci. Untuk mengaktifkan data log ini, Anda perlu menginstruksikan kode agen Anda. Lihat Menambahkan observabilitas ke AgentCore sumber daya Amazon Bedrock Anda untuk mempelajari lebih lanjut.

AgentCore dapat mengeluarkan CloudWatch log ke aliran Log, Amazon S3, atau Firehose. Jika Anda menggunakan tujuan CloudWatch Log, log ini disimpan di bawah grup log default /aws/vendedlogs/bedrock-agentcore/memory/APPLICATION_LOGS/{memory_id} atau di bawah grup log kustom yang dimulai dengan/aws/vendedlogs/. Lihat Mengaktifkan observabilitas untuk AgentCore runtime, memori, gateway, alat bawaan, dan sumber daya identitas untuk mempelajari lebih lanjut.

Ketika DeleteMemory operasi dipanggil, log dihasilkan untuk memulai dan menyelesaikan proses penghapusan. Setiap log kesalahan penghapusan terkait akan diberikan wawasan tentang mengapa panggilan gagal.

Kami juga menyediakan log untuk berbagai tahapan dalam proses pembuatan memori jangka panjang, yaitu ekstraksi dan konsolidasi. Ketika peristiwa memori jangka pendek baru disediakan, AgentCore ekstrak konsep-konsep kunci dari respons untuk memulai pembentukan catatan memori jangka panjang yang baru. Setelah ini dibuat, mereka terintegrasi dengan catatan memori yang ada untuk membuat penyimpanan memori yang berbeda.

Lihat rincian berikut untuk mempelajari bagaimana setiap alur kerja membantu Anda memantau pembentukan memori baru:

Log ekstraksi

  • Mulai dan selesaikan pemrosesan ekstraksi

  • Jumlah kenangan yang berhasil diekstraksi

  • Setiap kesalahan dalam deserialisasi atau pemrosesan peristiwa masukan

Log konsolidasi:

  • Mulai dan selesaikan pemrosesan konsolidasi

  • Jumlah memori yang membutuhkan konsolidasi

  • Success/failure penambahan memori dan pembaruan

  • Status pengambilan memori terkait

Tabel berikut memberikan rincian yang lebih rinci tentang bagaimana alur kerja sumber daya memori yang berbeda menggunakan bidang log di samping badan log itu sendiri untuk memberikan informasi spesifik permintaan.

Nama alur kerja Bidang log Deskripsi

Ekstraksi

resource_arn, event_timestamp, memory_strategy_id, namespace, actor_id, session_id, event_id, requestid, isError

Menganalisis percakapan yang masuk untuk menghasilkan ingatan baru

Konsolidasi

resource_arn, event_timestamp, memory_strategy_id, namespace, session_id, requestid, isError

Menggabungkan ingatan yang diekstraksi dengan ingatan yang ada