View a markdown version of this page

Osservabilità e controllo dei costi - Amazon Bedrock AgentCore
OsservabilitàCloudTrailControlla i costi con limitiTag

Osservabilità e controllo dei costi

Questa pagina tratta del monitoraggio dell'imbracatura, del controllo dei costi di esecuzione e della gestione dei tag delle risorse.

Osservabilità

Ogni chiamata al cablaggio genera automaticamente tracce, log e metriche tramite Observability in. AgentCore CloudWatch Chiamate di modelli, invocazioni di strumenti, operazioni di memoria, comandi di shell: ogni passaggio viene visualizzato con dettagli sulla tempistica e sul payload. Nessuna configurazione aggiuntiva. Le tracce sono disponibili dalla prima invocazione.

Esempio
AWS CLI/boto3

Le tracce, i log e le metriche CloudWatch passano al ruolo di esecuzione di Harness. Visualizzali nella dashboard di AgentCore Observability o esegui query a livello di codice tramite i log e le API. CloudWatch X-Ray

Prima di visualizzare le tracce, abilita Transaction Search in CloudWatch (una tantum per account). Per i dettagli sulla configurazione, consulta la sezione Guida introduttiva a AgentCore Observability.

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

Ulteriori informazioni: Panoramica sull'osservabilità · metriche · telemetria

CloudTrail

Le operazioni di cablaggio vengono registrate AWS CloudTrail come eventi di gestione (piano di controllo) ed eventi relativi ai dati (piano dati). In CloudTrail, le risorse del cablaggio vengono visualizzate sotto il tipo di AWS::BedrockAgentCore::Runtime risorsa anziché in un tipo specifico del cablaggio. Harness è un'astrazione gestita su AgentCore Runtime e CloudTrail gli eventi riflettono la risorsa di runtime sottostante per garantire la coerenza.

Tutti gli CloudTrail eventi di cablaggio utilizzano =. resources.type AWS::BedrockAgentCore::Runtime I nomi degli eventi sono:

  • CreateHarness,UpdateHarness,DeleteHarness,GetHarness, ListHarnesses (eventi di gestione)

  • InvokeAgentRuntime, InvokeAgentRuntimeCommand (eventi relativi ai dati)

Nota

Le operazioni del piano dati vengono visualizzate come InvokeAgentRuntime e InvokeAgentRuntimeCommand inserite CloudTrail, corrispondenti all'API Runtime sottostante. Il resources.ARN campo contiene l'ARN del cablaggio per gli eventi del piano di controllo e l'ARN di runtime per gli eventi del piano dati.

Controlla i costi con limiti

Stabilisci dei limiti massimi in modo che un agente in fuga non possa esaurire le risorse:

  • maxIterations- reasoning/action cicli per invocazione. Valore predefinito 75.

  • timeoutSeconds- timeout dell'orologio da parete per una singola chiamata. 3600 predefinito.

  • maxTokens- budget di token per chiamata. Predefinito. N/A

  • idleRuntimeSessionTimeout- per quanto tempo una microVM inattiva rimane calda. Valore predefinito 900.

  • maxLifetime- durata massima di una sessione MicroVM. 28800 predefinito.

Tutti i limiti sono opzionali; omettili per utilizzare le impostazioni predefinite del servizio. Poiché l'harness è supportato da AgentCore Runtime, anche le chiamate al harness sono soggette alle quote del servizio Runtime. Per ulteriori informazioni, vedere AgentCore Harness Service Quotas AgentCore e Runtime Service Quotas.

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

Oppure esegui l'override su una singola chiamata passando o inserendo. maxIterations timeoutSeconds maxTokens invoke_harness

AgentCore CLI

Imposta i valori predefiniti:

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

La --truncation-strategy bandiera accetta sliding_window o. summarization I --max-lifetime flag --idle-timeout and impostano i limiti del ciclo di vita in secondi.

Sostituisci su una singola chiamata:

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

Tag

Applica i tag al tuo dispositivo per l'allocazione dei costi e il controllo degli accessi.

Esempio
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

Imposta i tag in: harness.json

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

Esegui agentcore deploy per applicare.

I tag vengono trasmessi alle CloudFormation risorse distribuite.

Argomenti correlati