View a markdown version of this page

Controles de observabilidade e custos - Amazon Bedrock AgentCore
ObservabilidadeCloudTrailControle o custo com limitesTags

Controles de observabilidade e custos

Esta página aborda o monitoramento de seu equipamento, o controle dos custos de execução e o gerenciamento de tags de recursos.

Observabilidade

Cada invocação do harness gera automaticamente rastreamentos, registros e métricas por meio AgentCore do Observability in. CloudWatch Chamadas de modelo, invocações de ferramentas, operações de memória, comandos de shell: cada etapa aparece com detalhes de tempo e carga útil. Sem configuração extra. Os traços estão disponíveis a partir da primeira invocação.

exemplo
AWS CLI/boto3

Rastreamentos, registros e métricas fluem CloudWatch por meio da função de execução do harness. Visualize-os no painel do AgentCore Observability ou consulte-os programaticamente por meio dos CloudWatch registros e das APIs. X-Ray

Antes de ver os rastreamentos, ative a Pesquisa de transações CloudWatch (uma vez por conta). Consulte Introdução ao AgentCore Observability para obter detalhes de configuração.

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

Saiba mais: Visão geral da observabilidade · métricas · telemetria

CloudTrail

As operações do chicote são registradas AWS CloudTrail como eventos de gerenciamento (plano de controle) e eventos de dados (plano de dados). Em CloudTrail, os recursos do arnês aparecem sob o tipo de AWS::BedrockAgentCore::Runtime recurso, em vez de um tipo específico do arnês. Harness é uma abstração gerenciada do AgentCore Runtime, e os CloudTrail eventos refletem o recurso de tempo de execução subjacente para fins de consistência.

Todos os CloudTrail eventos de arnês usam resources.type =AWS::BedrockAgentCore::Runtime. Os nomes dos eventos são:

  • CreateHarness,UpdateHarness,DeleteHarness,GetHarness, ListHarnesses (eventos de gerenciamento)

  • InvokeAgentRuntime, InvokeAgentRuntimeCommand (eventos de dados)

nota

As operações do plano de dados aparecem como InvokeAgentRuntime e InvokeAgentRuntimeCommand dentro CloudTrail, correspondendo à API Runtime subjacente. O resources.ARN campo contém o ARN do chicote para eventos do plano de controle e o ARN do tempo de execução para eventos do plano de dados.

Controle o custo com limites

Defina limites rígidos para que um agente fugitivo não consiga gastar recursos:

  • maxIterations- reasoning/action ciclos por invocação. Padrão 75.

  • timeoutSeconds- Tempo limite do relógio de parede para uma única invocação. Padrão 3600.

  • maxTokens- orçamento simbólico por invocação. Padrão N/A.

  • idleRuntimeSessionTimeout- por quanto tempo uma microVM inativa permanece aquecida. Padrão 900.

  • maxLifetime- vida útil máxima de uma sessão de microVM. Padrão 28800.

Todos os limites são opcionais; omita-os para usar padrões de serviço. Como o harness é apoiado pelo AgentCore Runtime, as invocações do harness também estão sujeitas às cotas do serviço Runtime. Para obter mais informações, consulte AgentCore aproveitar as Cotas de Serviço e as Cotas de Serviço de Tempo de AgentCore Execução.

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

Ou substitua uma única invocação passando ou maxIterations entrandotimeoutSeconds. maxTokens invoke_harness

AgentCore CLI

Defina os padrões:

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

A --truncation-strategy bandeira aceita sliding_window ousummarization. As --max-lifetime bandeiras --idle-timeout e definem os limites do ciclo de vida em segundos.

Substituir em uma única chamada:

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

Tags

Aplique etiquetas em seu arnês para alocação de custos e controle de acesso.

exemplo
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

Defina as tags emharness.json:

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

Corra agentcore deploy para se inscrever.

As tags fluem para os CloudFormation recursos implantados.

Tópicos relacionados