Metrik runtime observabilitas Metrik dan log penggunaan sumber daya Data rentang yang disediakan Data log aplikasi Jenis kesalahan

AgentCore data pengamatan runtime yang dihasilkan

Metrik runtime yang disediakan oleh AgentCore memberi Anda visibilitas ke tingkat aktivitas eksekusi agen, latensi pemrosesan, pemanfaatan sumber daya, dan tingkat kesalahan. AgentCore juga menyediakan metrik agregat untuk total pemanggilan dan sesi.

Metrik runtime observabilitas

Daftar berikut menjelaskan metrik runtime yang disediakan oleh AgentCore. Metrik runtime dikelompokkan pada interval satu menit. Untuk mempelajari selengkapnya tentang melihat metrik runtime, lihat Melihat data pengamatan untuk agen Amazon Bedrock AgentCore Anda.

Invokasi: Menampilkan jumlah total permintaan yang dibuat ke Data Plane API. Setiap panggilan API dihitung sebagai satu pemanggilan, terlepas dari ukuran payload permintaan atau status respons.
Pemanggilan (agregat): Menampilkan jumlah total pemanggilan di semua sumber daya
Pembatasan: Menampilkan jumlah permintaan yang dibatasi oleh layanan karena melebihi batas TPS (Transaksi Per Detik) atau kuota yang diizinkan. Permintaan ini kembali ThrottlingException dengan kode status HTTP 429. Pantau metrik ini untuk menentukan apakah Anda perlu meninjau kuota layanan atau mengoptimalkan pola permintaan.
Kesalahan Sistem: Menunjukkan jumlah kesalahan sisi server yang ditemui AgentCore selama pemrosesan permintaan. Tingkat kesalahan sisi server yang tinggi dapat menunjukkan potensi masalah infrastruktur atau layanan yang memerlukan penyelidikan. Lihat Jenis kesalahan untuk daftar kemungkinan kode kesalahan.
Kesalahan Pengguna: Merupakan jumlah kesalahan sisi klien yang dihasilkan dari permintaan yang tidak valid. Ini membutuhkan tindakan pengguna untuk menyelesaikannya. Tingkat kesalahan sisi klien yang tinggi dapat menunjukkan masalah dengan pemformatan permintaan atau izin yang perlu ditangani. Lihat Jenis kesalahan untuk daftar kemungkinan kode kesalahan.
Latensi: Total waktu yang berlalu antara menerima permintaan dan mengirim token respons akhir. Merupakan waktu pemrosesan permintaan ujung ke ujung yang lengkap.
Total Kesalahan: Jumlah total kesalahan sistem dan pengguna. Di AgentCore konsol Amazon Bedrock, metrik ini menampilkan jumlah kesalahan sebagai persentase dari jumlah total pemanggilan.
Jumlah Sesi: Menunjukkan jumlah sesi agen baru yang dibuat dalam periode pelaporan. Setiap sesi dihitung satu kali pada waktu pembuatan; pemanggilan berikutnya ke sesi yang sama tidak menambah metrik ini. Ini adalah penghitung kumulatif, bukan ukuran sesi aktif saat ini. Berguna untuk memantau penggunaan platform secara keseluruhan, tren tingkat pembuatan sesi, dan memahami pola keterlibatan pengguna.
Sesi (agregat): Menampilkan jumlah total sesi baru yang dibuat di semua sumber daya dalam periode pelaporan.
ActiveSessionCount: Menampilkan jumlah sesi yang saat ini aktif untuk akun Anda. Berbeda SessionCount dengan metrik (penghitung kumulatif), metrik ini adalah pengukur waktu nyata yang menunjukkan berapa banyak sesi yang berjalan pada saat tertentu. Amazon Bedrock AgentCore menerbitkan metrik ini sekali per menit per jenis layanan. Gunakan untuk memantau pemanfaatan kapasitas saat ini, mengatur alarm untuk lonjakan penggunaan yang tidak terduga, dan memahami konsumsi kuota sesi Anda. Gunakan Service dimensi — dengan nilaiAgentCore.Runtime,AgentCore.CodeInterpreter, atau AgentCore.Browser — untuk memfilter metrik ini berdasarkan jenis beban kerja. Amazon Bedrock AgentCore menerbitkan metrik ini langsung ke AWS akun Anda di AWS/Bedrock-AgentCore namespace.
ActiveStreamingConnections: (WebSocket hanya) Menunjukkan jumlah WebSocket koneksi aktif per agen saat ini. Pantau metrik ini untuk memahami penggunaan koneksi dan mendeteksi penurunan atau lonjakan koneksi untuk perencanaan kapasitas. Satu-satunya statistik yang berarti adalah jumlah 1 menit.
InboundStreamingBytesProcessed: (WebSocket hanya) Menampilkan jumlah total byte yang berhasil diproses dalam WebSocket bingkai yang diterima dari klien ke wadah agen. Gunakan metrik ini untuk memantau throughput data dan mengidentifikasi pola penggunaan.
OutboundStreamingBytesProcessed: (WebSocket hanya) Men unjukkan jumlah total byte yang berhasil diproses dalam WebSocket frame yang dikirim dari wadah agen ke klien. Pantau metrik ini untuk memahami pola respons agen dan memastikan transmisi data berhasil.

Metrik dan log penggunaan sumber daya

Amazon Bedrock AgentCore runtime menyediakan telemetri penggunaan sumber daya yang komprehensif, termasuk metrik konsumsi CPU dan memori untuk sumber daya runtime Anda.

catatan

Data penggunaan sumber daya mungkin tertunda hingga 60 menit dan presisi mungkin berbeda antar metrik.

Metrik yang dijual

AgentCore Runtime Amazon Bedrock secara otomatis menyediakan metrik penggunaan sumber daya di level akun, runtime agen, dan titik akhir agen. Metrik ini dipublikasikan pada resolusi 1 menit. A CloudWatch gregasi Amazon dan retensi data metrik akan mengikuti kebijakan retensi CloudWatch data Amazon standar. Untuk informasi selengkapnya, lihat https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html #Metric.

Berikut adalah kumpulan dimensi dan metrik yang tersedia untuk memantau sumber daya Anda:

Nama	Dimensi	Deskripsi
CPUUsed-vCPUHours	Layanan; Layanan, Sumber Daya; Layanan, Sumber Daya, Nama	Jumlah total CPU virtual yang dikonsumsi dalam CPU-Hours unit v, tersedia di tingkat sumber daya dan akun. Berguna untuk pelacakan sumber daya dan perkiraan visibilitas penagihan.
MemoryUsed-GBHours	Layanan; Layanan, Sumber Daya; Layanan, Sumber Daya, Nama	Jumlah total memori yang dikonsumsi dalam GB-Hours unit, tersedia di tingkat sumber daya dan akun. Berguna untuk pelacakan sumber daya dan perkiraan visibilitas penagihan.

Penjelasan dimensi

Layanan - AgentCore.Runtime
Sumber Daya - Agen Arn
Nama - Nama Titik Akhir Agen, dalam format AgentName:: EndpointName

Metrik tingkat akun tersedia di Amazon CloudWatch Bedrock AgentCore Observability Console di bawah tab Runtime. Dasbor menampilkan grafik penggunaan Memori dan CPU yang dihasilkan dari metrik ini, yang mewakili total penggunaan sumber daya di semua agen di akun Anda di wilayah tersebut.

Metrik level Agent Endpoint tersedia di AgentEndpoint halaman Amazon CloudWatch Bedrock AgentCore Observability Console. Dasbor menampilkan grafik penggunaan Memori dan CPU yang dihasilkan dari metrik ini, yang mewakili total penggunaan sumber daya di semua sesi yang dipanggil oleh Titik Akhir Agen yang ditentukan.

catatan

Data telemetri disediakan untuk tujuan pemantauan. Penagihan aktual dihitung berdasarkan data penggunaan terukur dan mungkin berbeda dari nilai telemetri karena waktu agregasi, proses rekonsiliasi, dan presisi pengukuran. Lihat pernyataan tag AWS ihan Anda untuk biaya otoritatif.

Log yang dipasok

Bedrock AgentCore Runtime menyediakan log yang dijual untuk metrik penggunaan tingkat sesi pada perincian 1 detik. Setiap catatan log berisi data konsumsi sumber daya termasuk penggunaan CPU (agent.runtime.vcpu.hours.used) dan konsumsi memori (agent.runtime.memory.gb_hours.used).

Setiap catatan log akan memiliki skema berikut:

Jenis log	Bidang log	Deskripsi
LOG_PENGGUNAAN	event_timestamp, resource_arn, service.name, cloud.provider, cloud.region, account.id, wilayah, resource.id, session.id, agent.nama, elapsed_time_seconds, agent.runtime.vcpu.hours.used, agent.runtime.memory.gb_hours.used	Log Penggunaan Sumber Daya untuk pelacakan sumber daya tingkat sesi.

Untuk mengaktifkan jenis log USAGE_LOG untuk agen Anda, lihat Men ambahkan observabilitas ke sumber daya Amazon Bedrock Anda. AgentCore Log kemudian ditampilkan di tujuan yang dikonfigurasi (AWS LogGroup, Amazon S3 atau Amazon Kinesis Firehose) seperti yang dikonfigurasi.

Di halaman Sesi Agen di Amazon CloudWatch Bedrock AgentCore Observability Console, Anda dapat melihat metrik penggunaan sumber daya yang dihasilkan dari log ini. Untuk mengoptimalkan pengalaman menonton metrik Anda, pilih rentang waktu yang Anda inginkan menggunakan pemilih di kanan atas untuk fokus pada CPU dan data Penggunaan Memori tertentu.

catatan

Data rentang yang disediakan

Untuk meningkatkan pengamatan, AgentCore menyediakan rentang terstruktur yang memberikan visibilitas ke dalam pemanggilan runtime agen. Untuk mengaktifkan data rentang ini, Anda perlu mengaktifkan observabilitas pada sumber daya agen Anda. Lihat Menambahkan observabilitas ke AgentCore sumber daya Amazon Bedrock Anda untuk langkah-langkah dan detail. Data rentang ini tersedia di Amazon CloudWatch Logs. Rentang muncul di grup log agen (/aws/bedrock-agentcore/runtimes/<agent_id>-<endpoint_name>), atau 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. Tabel berikut mendefinisikan operasi di mana rentang dibuat dan atribut untuk setiap rentang yang ditangkap.

Nama operasi	Atribut rentang	Deskripsi
InvokeAgentRuntime	aws.operation.name, aws.resource.arn, aws.request_id, aws.agent.id, aws.endpoint.name, aws.account.id, session.id, latency_ms, tipe kesalahan, aws.resource.type, aws.xray.origin, aws.region	Memanggil runtime agen.

aws.operation.name - nama operasi () InvokeAgentRuntime
aws.resource.arn - nama sumber daya Amazon untuk runtime agen
aws.request_id - ID permintaan untuk pemanggilan
aws.agent.id - pengenal unik untuk runtime agen
aws.endpoint.name - nama titik akhir yang digunakan untuk memanggil runtime agen
aws.account.id - id akun pelanggan
session.id - ID sesi untuk pemanggilan
latency_ms - latensi permintaan dalam milidetik
error_type - baik throttle, sistem, atau pengguna (hanya ada jika kesalahan)
aws.resource.type - jenis sumber daya CFN
aws.xray.origin - jenis sumber daya CFN yang digunakan oleh x-ray untuk mengidentifikasi layanan
aws.region - wilayah tempat sumber daya pelanggan ada

Data log aplikasi

AgentCore menyediakan log Aplikasi terstruktur yang membantu Anda mendapatkan visibilitas ke dalam pemanggilan runtime agen dan konsumsi sumber daya tingkat sesi. Data log ini disediakan saat mengaktifkan observabilitas pada sumber daya agen Anda. Lihat Menambahkan observabilitas ke AgentCore sumber daya Amazon Bedrock Anda untuk langkah-langkah dan detail. AgentCore dapat menampilkan log ke CloudWatch Log, Amazon S3, atau aliran Firehose. Jika Anda menggunakan tujuan Log, log ini disimpan di bawah log aplikasi agen Anda atau di bawah grup log kustom Anda sendiri. CloudWatch

Jenis log	Bidang log	Deskripsi
LOG_APLIKASI	stempel waktu, resource_arn, event_timestamp, account_id, request_id, session_id, trace_id, span_id, nama_layanan, operasi, request_payload, response_payload	Log aplikasi untuk InvokeRuntimeOperation dengan bidang pelacakan, permintaan, dan muatan respons

request_payload - payload permintaan dari pemanggilan agen
response_payload - respons dari pemanggilan agen

Jenis kesalahan

Daftar berikut mendefinisikan kemungkinan jenis kesalahan untuk kesalahan pengguna, sistem, dan pembatasan.

Kode kesalahan pengguna

InvocationError.Validation- Klien memberikan masukan yang tidak valid (400)
InvocationError.ResourceNotFound- Sumber daya yang diminta tidak ada (404)
InvocationError.AccessDenied- Klien tidak memiliki izin (403)
InvocationError.Conflict- Konflik sumber daya (409)

Kode kesalahan sistem

InvocationError.Internal- Kesalahan server internal (500)

Kode kesalahan pelambatan

InvocationError.Throttling- Pembatasan tingkat (429)
InvocationError.ServiceQuota- Service-side quota/limit mencapai (402)

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

AgentCore data pengamatan yang dihasilkan

Data pengamatan memori