# AgentCore data observabilitas gateway yang dihasilkan
Bagian berikut menjelaskan metrik gateway, log, dan rentang output ke AgentCore Amazon. CloudWatch Metrik ini tidak tersedia di halaman observabilitas AI CloudWatch generatif. Metrik gateway dikumpulkan pada interval satu menit. Untuk mempelajari selengkapnya tentang melihat metrik gateway, lihat [Melihat data observabilitas untuk agen Amazon Bedrock AgentCore ](observability-view.md) Anda.
**catatan**
Untuk mengaktifkan log yang disediakan layanan untuk AgentCore gateway, Anda perlu mengonfigurasi sumber daya yang diperlukan. CloudWatch Lihat [Mengaktifkan observabilitas untuk AgentCore runtime, memori, gateway, alat bawaan, dan sumber daya identitas](observability-configure.md#observability-configure-cloudwatch) untuk mempelajari lebih lanjut.
**Topics**
+ [Metrik yang disediakan](#observability-gateway-metrics-provided)
+ [Data log yang disediakan](#observability-gateway-logs-provided)
+ [Bentang yang disediakan](#observability-gateway-vended-spans)
## Metrik yang disediakan
Gateway menerbitkan metrik pemanggilan dan penggunaan ke. CloudWatch Anda dapat melihat metrik ini dan juga mengatur alarm untuk mengingatkan Anda ketika metrik tertentu melebihi ambang batas. Untuk mempelajari lebih lanjut, pilih topik:
**Topics**
+ [Metrik invokasi](#gateway-metrics-invocation)
+ [Metrik penggunaan](#gateway-metrics-usage)
+ [Lihat CloudWatch metrik gateway](#gateway-metrics-view-console)
+ [Menyiapkan CloudWatch alarm](#gateway-advanced-observability-alarms)
### Metrik invokasi
Metrik ini memberikan informasi tentang pemanggilan API, kinerja, dan kesalahan.
Untuk metrik ini, dimensi berikut digunakan:
+ **Operasi** — Nama operasi API (mis. InvokeGateway).
+ **Protokol** — Nama protokol (mis. MCP).
+ **Metode** - Merupakan operasi MCP yang dipanggil (mis. tools/list).
+ **Sumber daya** - Merupakan pengidentifikasi sumber daya (mis. gateway ARN).
+ **Nama** - Merupakan nama alat.
| Metrik | Deskripsi | Statistik | Unit |
| --- | --- | --- | --- |
| Invokasi | Jumlah total permintaan yang dibuat untuk setiap API Data Plane. Setiap panggilan API dihitung sebagai satu pemanggilan terlepas dari status responsnya. | Jumlah | Hitungan |
| Pembatasan | Jumlah permintaan dibatasi (kode status 429) oleh layanan. | Jumlah | Hitungan |
| SystemErrors | Jumlah permintaan yang gagal dengan kode status 5xx. | Jumlah | Hitungan |
| UserErrors | Jumlah permintaan yang gagal dengan kode status 4xx kecuali 429. | Jumlah | Hitungan |
| Latensi | Waktu berlalu antara ketika layanan menerima permintaan dan ketika mulai mengirim token respons pertama. Dengan kata lain, waktu respons awal. | Rata-rata, Minimum, Maksimum, p50, p90, p99 | Milidetik |
| Durasi | Total waktu berlalu antara menerima permintaan dan mengirim token respons akhir. Merupakan waktu pemrosesan end-to-end yang lengkap dari permintaan. | Rata-rata, Minimum, Maksimum, p50, p90, p99 | Milidetik |
| TargetExecutionTime | Total waktu yang dibutuhkan untuk mengeksekusi target melalui Lambda/OpenAPI/dll. Ini membantu menentukan kontribusi target terhadap Latensi total. | Rata-rata, Minimum, Maksimum, p50, p90, p99 | Milidetik |
### Metrik penggunaan
Metrik ini memberikan informasi tentang bagaimana gateway Anda digunakan.
| Metrik | Deskripsi | Statistik | Unit |
| --- | --- | --- | --- |
| TargetType | Jumlah total permintaan yang dilayani oleh setiap jenis target (MCP, Lambda, OpenAPI). | Jumlah | Hitungan |
### Lihat CloudWatch metrik gateway
Untuk informasi selengkapnya tentang melihat CloudWatch metrik, lihat [Melihat metrik yang tersedia](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html) di [ CloudWatch Panduan Pengguna Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/). Prosedur berikut menunjukkan cara melihat metrik untuk gateway Anda:
**Untuk melihat metrik gateway di konsol**
1. Buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Di panel navigasi kiri, pilih **Semua metrik di bawah bagian **Metrik****.
1. Di bawah **Browse**, dari menu tarik-turun yang menampilkan AWS Wilayah saat ini, pilih Wilayah yang Anda inginkan metriknya.
1. Pilih **AWS/Bedrock-AgentCore**namespace.
1. Pilih dimensi (mis. **Operasi**) atau kombinasi dimensi (mis. **Metode, Operasi, Protokol**) untuk melihat metrik untuk itu.
1. Untuk menambahkan metrik ke CloudWatch grafik, pilih kotak centang di sebelahnya.
### Menyiapkan CloudWatch alarm
Anda dapat menggunakan operasi [PutMetricAlarm](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html)API untuk mengatur CloudWatch alarm untuk mengingatkan Anda ketika metrik tertentu melebihi ambang batas. Misalnya, Anda mungkin ingin diberi tahu ketika tingkat kesalahan melebihi 5% atau ketika latensi melebihi 1 detik.
Contoh berikut menunjukkan cara membuat alarm untuk tingkat kesalahan tinggi menggunakan AWS CLI:
```
aws cloudwatch put-metric-alarm \
--alarm-name "HighErrorRate" \
--alarm-description "Alarm when error rate exceeds 5%" \
--metric-name "SystemErrors" \
--namespace "AWS/Bedrock-AgentCore" \
--statistic "Sum" \
--dimensions "Name=Resource,Value=my-gateway-arn" \
--period 300 \
--evaluation-periods 1 \
--threshold 5 \
--comparison-operator "GreaterThanThreshold" \
--alarm-actions "arn:aws:sns:us-west-2:123456789012:my-topic"
```
Alarm ini akan terpicu ketika jumlah kesalahan sistem melebihi 5 dalam periode 5 menit. Ketika alarm dipicu, itu akan mengirim pemberitahuan ke topik SNS yang ditentukan.
## Data log yang disediakan
AgentCore menyediakan log yang membantu Anda memantau dan memecahkan masalah AgentCore proses sumber daya gateway utama. Untuk mengaktifkan data log ini, Anda perlu membuat tujuan log.
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/gateway/APPLICATION_LOGS/{gateway_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](observability-configure.md#observability-configure-cloudwatch) untuk mempelajari lebih lanjut.
AgentCore mencatat informasi berikut untuk sumber daya gateway:
+ Mulai dan selesaikan pemrosesan permintaan gateway
+ Pesan galat untuk konfigurasi Target
+ Permintaan MCP dengan header otorisasi yang hilang atau salah
+ Permintaan MCP dengan parameter permintaan yang salah (alat, metode)
Anda juga dapat melihat badan permintaan dan respons sebagai bagian dari integrasi Vended Logs Anda ketika salah satu Operasi MCP dilakukan di Gateway. Mereka dapat melakukan analisis lebih lanjut pada log ini, menggunakan `trace_id` bidang `span_id` dan untuk menghubungkan rentang penjual dan log yang dipancarkan. Untuk informasi selengkapnya tentang mengenkripsi gateway Anda dengan kunci KMS yang dikelola pelanggan, lihat [Fitur dan](gateway-advanced.md) topik lanjutan untuk Amazon Bedrock Gateway. AgentCore
Log sampel:
```
{
"resource_arn": "arn:aws:bedrock-agentcore:us-east-1:123456789012:gateway/",
"event_timestamp": 1759370851622,
"body": {
"isError": false,
"log": "Started processing request with requestId: 1",
"requestBody": "{id=1, jsonrpc=2.0, method=tools/call, params={name=target-quick-start-f9scus___LocationTool, arguments={location=seattle}}}",
"id": "1"
},
"account_id": "123456789012",
"request_id": "12345678-1234-1234-1234-123456789012",
"trace_id": "160fc209c3befef4857ab1007d041db0",
"span_id": "81346de89c725310"
}
```
Log sampel dengan badan respons:
```
{
"resource_arn": "arn:aws:bedrock-agentcore:us-east-1:123456789012:gateway/",
"event_timestamp": 1759370853807,
"body": {
"isError": false,
"responseBody": "{jsonrpc=2.0, id=1, result={isError=false, content=[{type=text, text=\"good\"}]}}",
"log": "Successfully processed request with requestId: 2",
"id": "1"
},
"account_id": "123456789012",
"request_id": "12345678-1234-1234-1234-123456789012",
"trace_id": "160fc209c3befef4857ab1007d041db0",
"span_id": "81346de89c725310"
}
```
## Bentang yang disediakan
AgentCore mendukung rentang vended yang sesuai dengan OTEL yang dapat Anda gunakan untuk melacak pemanggilan di berbagai primitif yang sedang digunakan.
Contoh Rentang yang dijual untuk Pemanggilan Alat:
+ `kind:SERVER`- melacak detail eksekusi keseluruhan, alat yang dipanggil, detail gateway, ID AWS permintaan, ID jejak dan rentang.
+ `kind:CLIENT`- mencakup target spesifik yang dipanggil dan detail di sekitarnya seperti jenis target, waktu eksekusi target, waktu mulai dan akhir eksekusi target, dll.
Untuk pemanggilan metode MCP lainnya, hanya `kind:SERVER` rentang yang dipancarkan.
Sementara rentang ini memancarkan metrik, untuk menyelidiki mengapa kegagalan terjadi untuk rentang tertentu, pengguna Gateway harus memeriksa log yang dijual. Berbagai bidang, misalnya, `spanId` atau `aws.request.id` dapat membantu dalam menjahit bentang dan log ini bersama-sama.
| Operasi | Atribut rentang | Deskripsi |
| --- | --- | --- |
| Daftar Alat | aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, gateway.id, aws.xray.origin, aws.resource.type, aws.region, latency\_ms, error\_type, jsonrpc.error.code, http.method, http.response.status\_code, gateway.name, url.path, overhead\_latency\_ms | Buat daftar alat yang dilampirkan ke gateway |
| Alat Panggilan | aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, gateway.id, aws.xray.origin, aws.resource.type, aws.region, latency\_ms, error\_type, jsonrpc.error.code, http.method, http.response.status\_code, gateway.name, url.path, overhead\_latency\_ms, tool.name | Panggil alat tertentu. Dua bentang dipancarkan: 1. `kind:SERVER`yang melacak detail eksekusi keseluruhan (berhasil/tidak), alat yang dipanggil, detail gateway, ID AWS permintaan, ID jejak dan rentang. `kind:CLIENT`yang mencakup target spesifik yang dipanggil dan detail di sekitarnya seperti jenis target, waktu eksekusi target, waktu mulai dan akhir eksekusi target, dll. |
| Alat Pencarian | aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, gateway.id, aws.xray.origin, aws.resource.type, aws.region, latency\_ms, error\_type, jsonrpc.error.code, http.method, http.response.status\_code, gateway.name, url.path, overhead\_latency\_ms, tool.name | Cari sepuluh alat paling relevan yang diberikan kueri masukan |