View a markdown version of this page

Observabilitas dan kontrol biaya - Batuan Dasar Amazon AgentCore
ObservabilitasCloudTrailKontrol biaya dengan batasTag

Observabilitas dan kontrol biaya

Halaman ini mencakup pemantauan harness Anda, mengendalikan biaya eksekusi, dan mengelola tag sumber daya.

Observabilitas

Setiap pemanggilan harness secara otomatis menghasilkan jejak, log, dan metrik melalui Observability in. AgentCore CloudWatch Panggilan model, pemanggilan alat, operasi memori, perintah shell: setiap langkah muncul dengan detail waktu dan muatan. Tidak ada konfigurasi tambahan. Jejak tersedia dari doa pertama.

contoh
AWS CLI/boto3

Jejak, log, dan metrik mengalir CloudWatch melalui peran eksekusi harness. Lihat di dasbor AgentCore Observability, atau kueri secara terprogram melalui CloudWatch Log dan API. X-Ray

Sebelum Anda melihat jejak, aktifkan Pencarian Transaksi di CloudWatch (satu kali per akun). Lihat AgentCore Observabilitas memulai untuk detail penyiapan.

AgentCore CLI
# Stream logs
agentcore logs --harness research-agent

# Filter
agentcore logs --harness research-agent --since 1h --level error

# List recent traces
agentcore traces list --harness research-agent

# Get a specific trace
agentcore traces get <trace-id> --harness research-agent

Pelajari lebih lanjut: Ikhtisar observabilitas · metrik · telemetri

CloudTrail

Operasi harness dicatat AWS CloudTrail sebagai peristiwa manajemen (bidang kontrol) dan peristiwa data (bidang data). Di CloudTrail, sumber daya harness muncul di bawah tipe AWS::BedrockAgentCore::Runtime sumber daya daripada tipe khusus harness. Harness adalah abstraksi terkelola selama AgentCore Runtime, dan CloudTrail peristiwa mencerminkan sumber daya runtime yang mendasarinya untuk konsistensi.

Semua CloudTrail acara harness menggunakan resources.type =AWS::BedrockAgentCore::Runtime. Nama-nama acara tersebut adalah:

  • CreateHarness,UpdateHarness,DeleteHarness,GetHarness, ListHarnesses (acara manajemen)

  • InvokeAgentRuntime, InvokeAgentRuntimeCommand (peristiwa data)

catatan

Operasi bidang data muncul sebagai InvokeAgentRuntime dan InvokeAgentRuntimeCommand di CloudTrail, cocok dengan Runtime API yang mendasarinya. resources.ARNBidang berisi ARN harness untuk peristiwa bidang kontrol dan ARN runtime untuk peristiwa bidang data.

Kontrol biaya dengan batas

Atur tutup keras sehingga agen pelarian tidak dapat membakar sumber daya:

  • maxIterations- reasoning/action siklus per doa. Standar 75.

  • timeoutSeconds- batas waktu jam dinding untuk satu doa. Standar 3600.

  • maxTokens- anggaran token per doa. Default N/A.

  • idleRuntimeSessionTimeout- berapa lama microVM idle tetap hangat. Default 900.

  • maxLifetime- Masa pakai maksimum sesi microVM. Standar 28800.

Semua batas bersifat opsional; hilangkan mereka untuk menggunakan default layanan. Karena harness didukung oleh AgentCore Runtime, pemanggilan harness juga tunduk pada kuota layanan Runtime. Untuk informasi selengkapnya, lihat AgentCore memanfaatkan Service Quotas AgentCore dan Runtime Service Quotas.

contoh
AWS CLI/boto3
aws bedrock-agentcore-control update-harness \
  --harness-id "MyHarness-UuFdkQoXSL" \
  --max-iterations 50 \
  --timeout-seconds 1800 \
  --max-tokens 8192

Atau ganti pada satu doa dengan melewatimaxIterations,timeoutSeconds, atau masuk. maxTokens invoke_harness

AgentCore CLI

Tetapkan default:

agentcore add harness --name bounded-agent \
  --max-iterations 50 --timeout 1800 --max-tokens 8192 \
  --truncation-strategy sliding_window \
  --idle-timeout 600 --max-lifetime 14400
agentcore deploy

--truncation-strategyBendera menerima sliding_window atausummarization. --max-lifetimeBendera --idle-timeout dan menetapkan batas siklus hidup dalam hitungan detik.

Ganti pada satu panggilan:

agentcore invoke --harness bounded-agent --max-iterations 20 --harness-timeout 600 \
  "Quick lookup: what's the weather in Seattle?"

Tag

Terapkan tag ke harness Anda untuk alokasi biaya dan kontrol akses.

contoh
AWS CLI/boto3
aws bedrock-agentcore-control create-harness \
  --harness-name "MyHarness" \
  --execution-role-arn "arn:aws:iam::123456789012:role/MyHarnessRole" \
  --tags '{"team": "platform", "environment": "staging"}'
AgentCore CLI

Tetapkan tag diharness.json:

{
  "tags": {
    "team": "platform",
    "environment": "staging"
  }
}

Jalankan agentcore deploy untuk melamar.

Tag mengalir ke CloudFormation sumber daya yang digunakan.

Topik terkait