View a markdown version of this page

Controles de observabilidad y costos - Amazon Bedrock AgentCore
ObservabilidadCloudTrailControle los costes con límitesTags

Controles de observabilidad y costos

Esta página trata sobre la supervisión de su infraestructura, el control de los costes de ejecución y la gestión de las etiquetas de recursos.

Observabilidad

Cada invocación de arneses genera automáticamente trazas, registros y métricas a través de AgentCore Observability in. CloudWatch Llamadas de modelos, invocaciones de herramientas, operaciones de memoria y comandos de shell: cada paso aparece con detalles sobre el tiempo y la carga útil. Sin configuración adicional. Los rastros están disponibles desde la primera invocación.

ejemplo
AWS CLI/boto3

Los rastreos, los registros y las métricas fluyen a CloudWatch través de la función de ejecución del arnés. Véalos en el panel de AgentCore observabilidad o realice consultas mediante programación a través de los CloudWatch registros y las API. X-Ray

Antes de ver los rastros, habilita la búsqueda de transacciones CloudWatch (una vez por cuenta). Consulta los AgentCore primeros pasos de Observability para obtener más información sobre la configuración.

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

Más información: Descripción general de la observabilidad · métricas · telemetría

CloudTrail

Las operaciones del arnés se registran AWS CloudTrail como eventos de gestión (plano de control) y eventos de datos (plano de datos). En CloudTrail, los recursos de arnés aparecen debajo del tipo AWS::BedrockAgentCore::Runtime de recurso en lugar de en un tipo específico de arnés. Harness es una abstracción gestionada sobre AgentCore Runtime, y los CloudTrail eventos reflejan el recurso de tiempo de ejecución subyacente para garantizar la coherencia.

Todos los CloudTrail eventos de arnés utilizan resources.type =AWS::BedrockAgentCore::Runtime. Los nombres de los eventos son:

  • CreateHarness,UpdateHarness, DeleteHarnessGetHarness, ListHarnesses (eventos de gestión)

  • InvokeAgentRuntime, InvokeAgentRuntimeCommand (eventos de datos)

nota

Las operaciones del plano de datos aparecen tal InvokeAgentRuntime y como InvokeAgentRuntimeCommand están CloudTrail, y coinciden con la API de tiempo de ejecución subyacente. El resources.ARN campo contiene el ARN del arnés para los eventos del plano de control y el ARN de tiempo de ejecución para los eventos del plano de datos.

Controle los costes con límites

Establezca límites estrictos para que un agente fugitivo no pueda consumir recursos:

  • maxIterations- reasoning/action ciclos por invocación. Predeterminado 75.

  • timeoutSeconds- Se ha agotado el tiempo de espera del reloj de pared para una sola invocación. 3600 por defecto.

  • maxTokens- presupuesto simbólico por invocación. Predeterminado N/A.

  • idleRuntimeSessionTimeout- cuánto tiempo permanece caliente una microVM inactiva. 900 por defecto.

  • maxLifetime- duración máxima de una sesión de microVM. El valor predeterminado es 28800.

Todos los límites son opcionales; omítalos para usar los valores predeterminados del servicio. Como el arnés está respaldado por AgentCore Runtime, las invocaciones de arneses también están sujetas a las cuotas de servicio de Runtime. Para obtener más información, consulte AgentCore Aprovechar Service Quotas y AgentCore Runtime Service Quotas.

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

O bien, anule una sola invocación pasándola o maxIterations timeoutSeconds maxTokens ingresándola. invoke_harness

AgentCore CLI

Establece los valores predeterminados:

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 bandera acepta sliding_window o. summarization Los --max-lifetime indicadores --idle-timeout y establecen los límites del ciclo de vida en segundos.

Anular en una sola llamada:

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

Tags

Aplique etiquetas a su arnés para asignar los costos y controlar el acceso.

ejemplo
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 las etiquetas enharness.json:

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

Ejecuta agentcore deploy para aplicar.

Las etiquetas fluyen hasta los CloudFormation recursos desplegados.

Temas relacionados