Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

AgentCore data pengamatan gateway yang dihasilkan

Bagian berikut menjelaskan metrik gateway, log, dan keluaran rentang oleh AgentCore Amazon CloudWatch. Metrik ini tidak tersedia di halaman pengam CloudWatch atan AI generatif. Metrik gateway dikelompokkan pada interval satu menit. Untuk mempelajari selengkapnya tentang melihat metrik gateway, lihat Melihat data pengamatan 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 memberi tahu 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 Panduan CloudWatch Pengguna Amazon. Prosedur berikut menunjukkan cara melihat metrik untuk gateway Anda:

Untuk melihat metrik gateway di konsol

Menyiapkan CloudWatch alarm

Anda dapat menggunakan operasi PutMetricAlarm API untuk mengatur CloudWatch alarm agar 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 dipicu 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 proses sumber daya AgentCore gateway utama. Untuk mengaktifkan data log ini, Anda perlu membuat tujuan log.

AgentCore dapat menampilkan log ke CloudWatch Log, Amazon S3, atau aliran Firehose. Jika Anda menggunakan tujuan Log, log ini disimpan di bawah grup log default /aws/vendedlogs/bedrock-agentcore/gateway/APPLICATION_LOGS/{gateway_id} atau di bawah grup log kustom dimulai dengan/aws/vendedlogs/. CloudWatch 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 bentang yang dijual 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

Contoh log:

{
    "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"
}

Contoh log 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"
}

Rentang yang disediakan

AgentCore mendukung rentang penjualan 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.