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 Anda.

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:

Metrik invokasi

Metrik ini memberikan informasi tentang pemanggilan API, kinerja, dan kesalahan.

Untuk metrik ini, dimensi berikut digunakan:

Metrik penggunaan

Metrik ini memberikan informasi tentang bagaimana gateway Anda digunakan.

Lihat CloudWatch metrik gateway

Untuk informasi selengkapnya tentang melihat CloudWatch metrik, lihat Melihat metrik yang tersedia di CloudWatch Panduan Pengguna Amazon. Prosedur berikut menunjukkan cara melihat metrik untuk gateway Anda:

Untuk melihat metrik gateway di konsol

Menyiapkan CloudWatch alarm

Anda dapat menggunakan operasi PutMetricAlarmAPI 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 untuk mempelajari lebih lanjut.

AgentCore mencatat informasi berikut untuk sumber daya gateway:

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 topik lanjutan untuk Amazon Bedrock Gateway. AgentCore

Log sampel:

{
    "resource_arn": "arn:aws:bedrock-agentcore:us-east-1:123456789012:gateway/<gatewayid>",
    "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/<gatewayid>",
    "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:

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.