AgentCore menghasilkan data observabilitas alat bawaan
Topik
Metrik alat observabilitas
AgentCore menyediakan metrik bawaan berikut untuk penerjemah kode dan alat browser. Built-in metrik alat dikumpulkan pada interval satu menit. Untuk mempelajari lebih lanjut tentang AgentCore alat, lihat Mengeksekusi kode dan menganalisis data menggunakan Amazon Bedrock AgentCore Code Interpreter dan Berinteraksi dengan aplikasi web menggunakan Amazon Bedrock AgentCore Browser.
Alat panggil:
- Invokasi
-
Jumlah total permintaan yang dibuat ke Data Plane API. Setiap panggilan API dihitung sebagai satu pemanggilan, terlepas dari ukuran payload permintaan atau status respons.
- Pembatasan
-
Jumlah permintaan yang dibatasi oleh layanan karena melebihi TPS yang diizinkan (Transaksi Per Detik) atau batas kuota. Permintaan ini kembali ThrottlingException dengan kode status HTTP 429.
- SystemErrors
-
Jumlah kesalahan sisi server yang ditemui selama pemrosesan permintaan.
- UserErrors
-
Jumlah kesalahan sisi klien yang dihasilkan dari permintaan yang tidak valid. Ini membutuhkan tindakan pengguna untuk menyelesaikannya.
- Latensi
-
Waktu berlalu antara ketika layanan menerima permintaan dan ketika mulai mengirim token respons pertama. Penting untuk mengukur waktu respons awal.
Buat sesi alat:
- Invokasi
-
Jumlah total permintaan yang dibuat ke Data Plane API. Setiap panggilan API dihitung sebagai satu pemanggilan, terlepas dari ukuran payload permintaan atau status respons.
- Pembatasan
-
Jumlah permintaan yang dibatasi oleh layanan karena melebihi TPS yang diizinkan (Transaksi Per Detik) atau batas kuota. Permintaan ini kembali ThrottlingException dengan kode status HTTP 429.
- SystemErrors
-
Jumlah kesalahan sisi server yang ditemui selama pemrosesan permintaan.
- UserErrors
-
Jumlah kesalahan sisi klien yang dihasilkan dari permintaan yang tidak valid. Ini membutuhkan tindakan pengguna untuk menyelesaikannya.
- Latensi
-
Waktu berlalu antara ketika layanan menerima permintaan dan ketika mulai mengirim token respons pertama. Penting untuk mengukur waktu respons awal.
- Durasi
-
Durasi sesi alat (Operasi menjadi CodeInterpreterSession/BrowserSession).
Pengambilalihan pengguna browser:
- TakerOverCount
-
Jumlah total pengguna yang mengambil alih
- TakerOverReleaseCount
-
Jumlah total kontrol rilis pengguna
- TakerOverDuration
-
Durasi pengguna mengambil alih
Metrik dan log penggunaan sumber daya
Amazon Bedrock AgentCore Built-in Tools 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 di seluruh metrik.
Metrik yang dijual
Secara default, Bedrock AgentCore Built-in Tools menjual metrik untuk level Akun dan level Alat pada resolusi 1 menit. CloudWatch Agregasi Amazon dan retensi data metrik mengikuti kebijakan penyimpanan CloudWatch data Amazon standar. Untuk informasi lebih lanjut, lihat https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Metric.
| Nama | Dimensi | Deskripsi |
|---|---|---|
|
CPUUsed-vCPUHours |
Layanan; Layanan, Sumber Daya |
Jumlah total CPU virtual yang dikonsumsi dalam CPU-Hours unit v, tersedia di tingkat sumber daya dan akun. Berguna untuk melacak sumber daya dan estimasi visibilitas penagihan. |
|
MemoryUsed-GBHours |
Layanan; Layanan, Sumber Daya |
Jumlah total memori yang dikonsumsi dalam GB-Hours unit, tersedia di tingkat sumber daya dan akun. Berguna untuk melacak sumber daya dan estimasi visibilitas penagihan. |
Penjelasan dimensi
-
Layanan - AgentCore.CodeInterpreter atau AgentCore.Browser
-
Sumber daya - Built-in alat Id
Metrik level akun tersedia di Amazon CloudWatch Bedrock AgentCore Observability Console di bawah Built-in tab Alat. Dasbor di konsol akan berisi grafik penggunaan Memori dan grafik penggunaan CPU yang dihasilkan dari metrik penggunaan. Grafik ini mewakili total penggunaan sumber daya di semua alat dari jenis alat yang dipilih di akun di wilayah tersebut.
Metrik tingkat alat tersedia di halaman Alat di Amazon CloudWatch Bedrock AgentCore Observability Console. Dasbor di konsol akan berisi grafik penggunaan Memori dan grafik penggunaan CPU yang dihasilkan dari metrik penggunaan. Grafik mewakili total penggunaan sumber daya di semua sesi alat yang dipilih.
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 laporan AWS penagihan Anda untuk biaya otoritatif.
Log Terjual
Amazon Bedrock AgentCore Built-in Tools menyediakan kemampuan untuk mengaktifkan log vended untuk telemetri penggunaan tingkat sesi pada granularitas 1 detik. Setiap catatan log berisi 1 detik Data Penggunaan Sumber Daya. Metrik yang didukung saat ini meliputi:
-
Kode Interprefer kode Interpreter.vcpu.hours.used dan kode _hours.used Interpreter.memory.gb
-
Browser browser.vcpu.hours.used dan browser.memory.gb_hours.used
Setiap datum penggunaan sumber daya akan menggunakan skema berikut dalam catatan log.
Penerjemah Kode
| Jenis log | Bidang log | Deskripsi |
|---|---|---|
|
USAGE_LOGS |
event_timestamp, resource_arn, service.name, cloud.provider, cloud.region, account.id, region, resource.id, session.id, elapsed_time_seconds, kode, kode _hours.used Interpreter.vcpu.hours.used Interpreter.memory.gb |
Log Penggunaan Sumber Daya untuk pelacakan sumber daya tingkat sesi. |
Browser
| Jenis log | Bidang log | Deskripsi |
|---|---|---|
|
USAGE_LOGS |
event_timestamp, resource_arn, service.name, cloud.provider, cloud.region, account.id, wilayah, resource.id, session.id, elapsed_time_seconds, browser.vcpu.hours.used, browser.memory.gb_hours.used |
Log Penggunaan Sumber Daya untuk pelacakan sumber daya tingkat sesi. |
Untuk informasi selengkapnya tentang mengaktifkan log, lihat Menambahkan observabilitas ke sumber daya Amazon Bedrock AgentCore Anda. Log ini ditampilkan di tujuan seperti yang dikonfigurasi (AWS LogGroup, Amazon S3, atau Amazon Kinesis Firehose.
Di halaman Sesi Built-in Alat 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 data CPU dan Penggunaan Memori tertentu.
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 laporan AWS penagihan Anda untuk biaya otoritatif.
Data rentang yang disediakan
Untuk meningkatkan observabilitas, AgentCore sediakan bentang terstruktur yang memberikan visibilitas ke dalam API alat bawaan. Untuk mengaktifkan data rentang ini, Anda perlu mengaktifkan observabilitas pada sumber daya alat bawaan Anda. Lihat Menambahkan observabilitas ke AgentCore sumber daya Amazon Bedrock untuk mengetahui langkah dan detailnya. Data rentang ini tersedia secara lengkap di AWS CloudWatch Log di grup aws/spans log. Tabel berikut mendefinisikan operasi yang bentang dibuat dan atribut untuk setiap rentang yang ditangkap.
Penerjemah kode
| Nama operasi | Atribut rentang | Deskripsi |
|---|---|---|
|
StartCodeInterpreterSession |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type |
Memulai sesi interpreter kode. |
|
StopCodeInterpreterSession |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type, session_duration_s |
Menghentikan sesi penerjemah kode. |
|
InvokeCodeInterpreter |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type |
Memanggil interpreter kode dengan kode input. |
|
CodeInterpreterSessionExpire |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type, session_duration_s |
Kedaluwarsa sesi interpreter kode jika tidak StopCodeInterpreterSession dipanggil dan waktu sesi habis. |
-
toolsession.id - id sesi alat
-
session_duration_s - durasi sesi dalam hitungan detik sebelum berakhir
Browser
| Nama operasi | Atribut rentang | Deskripsi |
|---|---|---|
|
StartBrowserSession |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type |
Memulai sesi browser. |
|
StopBrowserSession |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type, session_duration_s |
Menghentikan sesi browser. |
|
ConnectBrowserAutomationStream |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type |
Connect ke aliran otomatisasi browser. |
|
BrowserSessionExpire |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type, session_duration_s |
Kedaluwarsa sesi interpreter kode jika tidak StopBrowserSession dipanggil dan waktu sesi habis. |
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 untuk mengetahui langkah dan detailnya. AgentCore dapat mengeluarkan CloudWatch log ke aliran Log, Amazon S3, atau Firehose. Jika Anda menggunakan tujuan CloudWatch Log, log ini disimpan di bawah log aplikasi agen Anda atau di bawah grup log kustom Anda sendiri.
| Jenis log | Bidang log | Deskripsi |
|---|---|---|
|
APPLICATION_LOGS |
stempel waktu, resource_arn, event_timestamp, account_id, request_id, session_id, trace_id, span_id, service_name, operasi, request_payload, response_payload |
Log aplikasi InvokeCodeInterpreter dengan bidang penelusuran, permintaan, dan muatan respons |
