AgentCore datos de observabilidad generados por herramientas integradas
Temas
métricas de herramientas de observabilidad
AgentCore proporciona las siguientes métricas integradas para el intérprete de código y las herramientas del navegador. Built-in las métricas de las herramientas se agrupan en lotes a intervalos de un minuto. Para obtener más información sobre AgentCore las herramientas, consulte Ejecutar código y analizar datos con Amazon Bedrock AgentCore Code Interpreter e Interactuar con aplicaciones web con Amazon Bedrock Browser AgentCore .
Herramienta de invocación:
- Invocations
-
El número total de solicitudes realizadas a la API de Data Plane. Cada llamada a la API cuenta como una invocación, independientemente del tamaño de la carga útil de la solicitud o del estado de la respuesta.
- Limitaciones
-
El número de solicitudes limitadas por el servicio por superar los límites de cuota o de TPS (transacciones por segundo) permitidos. Estas solicitudes se devuelven ThrottlingException con el código de estado HTTP 429.
- SystemErrors
-
El número de errores del servidor detectados durante el procesamiento de la solicitud.
- UserErrors
-
El número de errores del lado del cliente derivados de solicitudes no válidas. Esto requiere la acción del usuario para resolverlo.
- Latencia
-
El tiempo transcurrido entre el momento en que el servicio recibe la solicitud y el momento en que comienza a enviar el primer token de respuesta. Importante para medir el tiempo de respuesta inicial.
Crear sesión de herramientas:
- Invocations
-
El número total de solicitudes realizadas a la API de Data Plane. Cada llamada a la API cuenta como una invocación, independientemente del tamaño de la carga útil de la solicitud o del estado de la respuesta.
- Limitaciones
-
El número de solicitudes limitadas por el servicio por superar los límites de cuota o de TPS (transacciones por segundo) permitidos. Estas solicitudes se devuelven ThrottlingException con el código de estado HTTP 429.
- SystemErrors
-
El número de errores del servidor detectados durante el procesamiento de la solicitud.
- UserErrors
-
El número de errores del lado del cliente derivados de solicitudes no válidas. Esto requiere la acción del usuario para resolverlo.
- Latencia
-
El tiempo transcurrido entre el momento en que el servicio recibe la solicitud y el momento en que comienza a enviar el primer token de respuesta. Importante para medir el tiempo de respuesta inicial.
- Duración
-
La duración de la sesión de la herramienta (la operación pasa a ser CodeInterpreterSession/BrowserSession).
Toma de posesión por parte del usuario del navegador:
- TakerOverCount
-
El número total de usuarios que asumen el control
- TakerOverReleaseCount
-
El número total de usuarios que liberan el control
- TakerOverDuration
-
La duración de la toma del control por parte del usuario
Estadísticas y registros de uso de recursos
Amazon Bedrock AgentCore Built-in Tools proporciona una completa telemetría de uso de recursos, que incluye métricas de consumo de CPU y memoria para sus recursos de tiempo de ejecución.
nota
Los datos de uso de recursos pueden demorarse hasta 60 minutos y la precisión puede variar según las métricas.
Métricas vendidas
De forma predeterminada, Bedrock AgentCore Built-in Tools vende las métricas a nivel de cuenta y de herramienta con una resolución de 1 minuto. CloudWatch La agregación y la retención de datos métricos de Amazon siguen las políticas de retención de CloudWatch datos estándar de Amazon. Para obtener más información, consulte https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Metric.
| Name | Dimensiones | Description (Descripción) |
|---|---|---|
|
CPUUsed-vCPUHours |
Servicio; servicio, recurso |
La cantidad total de CPU virtual consumida en la CPU-Hours unidad v, disponible a nivel de recurso y cuenta. Útil para el seguimiento de los recursos y la visibilidad estimada de la facturación. |
|
MemoryUsed-GBHours |
Servicio; servicio, recurso |
La cantidad total de memoria consumida por GB-Hours unidad, disponible en los niveles de recursos y cuentas. Útil para el seguimiento de los recursos y la visibilidad estimada de la facturación. |
Explicación de las dimensiones
-
Servicio: AgentCore.CodeInterpreter o AgentCore.Browser
-
Recurso: ID Built-in de la herramienta
Las métricas a nivel de cuenta están disponibles en la consola de AgentCore observabilidad de Amazon CloudWatch Bedrock, en la pestaña Built-in Herramientas. El panel de control de la consola contendrá un gráfico de uso de memoria y un gráfico de uso de CPU generados a partir de las métricas de uso. Estos gráficos representan el uso total de recursos en todas las herramientas del tipo de herramienta seleccionado en la cuenta de la región.
Las métricas a nivel de herramienta están disponibles en la página Herramientas de la consola de AgentCore observabilidad de Amazon CloudWatch Bedrock. El panel de control de la consola contendrá un gráfico de uso de memoria y un gráfico de uso de CPU generados a partir de las métricas de uso. Los gráficos representan el uso total de recursos en todas las sesiones de la herramienta seleccionada.
nota
Los datos de telemetría se proporcionan con fines de supervisión. La facturación real se calcula en función de los datos de uso medido y puede diferir de los valores de telemetría debido al tiempo de agregación, los procesos de conciliación y la precisión de la medición. Consulte su estado de cuenta para AWS ver los cargos autorizados.
Registros vendidos
Amazon Bedrock AgentCore Built-in Tools ofrece la posibilidad de habilitar los registros vendidos para la telemetría de uso a nivel de sesión con una granularidad de 1 segundo. Cada registro contiene un dato de uso de recursos de 1 segundo. Entre las métricas admitidas actualmente se incluyen las siguientes:
-
Code Interpreter code Interpreter.vcpu.hours.used y code _hours.used Interpreter.memory.gb
-
Navegadores browser.vcpu.hours.used y browser.memory.gb_hours.used
Cada dato de uso de recursos utilizará el siguiente esquema en el registro de registro.
intérprete de código
| Tipo de registro | Campos de registro | Description (Descripción) |
|---|---|---|
|
USAGE_LOGS |
event_timestamp, resource_arn, service.name, cloud.provider, cloud.region, account.id, region, resource.id, session.id, elapsed_time_seconds, code, code _hours.used Interpreter.vcpu.hours.used Interpreter.memory.gb |
Registros de uso de recursos para el seguimiento de los recursos a nivel de sesión. |
Navegador
| Tipo de registro | Campos de registro | Description (Descripción) |
|---|---|---|
|
USAGE_LOGS |
event_timestamp, resource_arn, service.name, cloud.provider, cloud.region, account.id, region, resource.id, session.id, elapsed_time_seconds, browser.vcpu.hours.used, browser.memory.gb_hours.used |
Registros de uso de recursos para el seguimiento de los recursos a nivel de sesión. |
Para obtener más información sobre cómo habilitar los registros, consulte Añadir observabilidad a sus recursos de Amazon Bedrock AgentCore . A continuación, estos registros se muestran en el destino tal como están configurados (AWS LogGroupAmazon S3 o Amazon Kinesis Firehose).
En la página Sesión de Built-in herramientas de la consola de AgentCore observabilidad de Amazon CloudWatch Bedrock, puede ver las métricas de uso de recursos generadas a partir de estos registros. Para optimizar su experiencia de visualización de métricas, seleccione el intervalo de tiempo que desee utilizando el selector situado en la parte superior derecha para centrarse en los datos específicos de uso de la CPU y la memoria.
nota
Los datos de telemetría se proporcionan con fines de supervisión. La facturación real se calcula en función de los datos de uso medido y puede diferir de los valores de telemetría debido al tiempo de agregación, los procesos de conciliación y la precisión de la medición. Consulte su estado de cuenta para AWS ver los cargos autorizados.
Datos de intervalo proporcionados
Para mejorar la observabilidad, AgentCore proporciona intervalos estructurados que proporcionan visibilidad de las API de las herramientas integradas. Para habilitar estos datos de intervalo, debe habilitar la observabilidad en el recurso de herramientas integrado. Consulte Añadir observabilidad a sus AgentCore recursos de Amazon Bedrock para ver los pasos y los detalles. Estos datos de intervalo están disponibles en su totalidad en AWS CloudWatch los registros del grupo de aws/spans registros. En la siguiente tabla se define la operación para la que se crean los intervalos y los atributos de cada intervalo capturado.
intérprete de código
| Nombre de operación | Atributos del intervalo | Description (Descripción) |
|---|---|---|
|
StartCodeInterpreterSession |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type |
Inicia una sesión de intérprete de código. |
|
StopCodeInterpreterSession |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type, session_duration_s |
Detiene una sesión de intérprete de código. |
|
InvokeCodeInterpreter |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type |
Invoca un intérprete de código con código de entrada. |
|
CodeInterpreterSessionExpire |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type, session_duration_s |
Una sesión de intérprete de código caduca si no se llama a ella y StopCodeInterpreterSession se agota el tiempo de espera de la sesión. |
-
toolsession.id: el identificador de la sesión de la herramienta
-
session_duration_s: la duración de la sesión en segundos antes de que finalizara
Navegador
| Nombre de operación | Atributos de intervalo | Description (Descripción) |
|---|---|---|
|
StartBrowserSession |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type |
Inicia una sesión de navegador. |
|
StopBrowserSession |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type, session_duration_s |
Detiene una sesión del navegador. |
|
ConnectBrowserAutomationStream |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type |
Conéctese a una transmisión de automatización del navegador. |
|
BrowserSessionExpire |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type, session_duration_s |
Una sesión de intérprete de código caduca si no se llama a ella y StopBrowserSession se agota el tiempo de espera de la sesión. |
Datos de registro de la aplicación
AgentCore proporciona registros de aplicaciones estructurados que le ayudan a obtener visibilidad de las invocaciones del agente en tiempo de ejecución y del consumo de recursos a nivel de sesión. Estos datos de registro se proporcionan cuando se habilita la observabilidad en su recurso de agente. Consulte Añadir observabilidad a sus AgentCore recursos de Amazon Bedrock para ver los pasos y los detalles. AgentCore puede enviar CloudWatch registros a Logs, Amazon S3 o Firehose Stream. Si utiliza un destino de CloudWatch registros, estos registros se almacenan en los registros de la aplicación de su agente o en su propio grupo de registros personalizado.
| Tipo de registro | Campos de registro | Description (Descripción) |
|---|---|---|
|
APPLICATION_LOGS |
timestamp, resource_arn, event_timestamp, account_id, request_id, session_id, trace_id, span_id, service_name, operation, request_payload |
La aplicación registra InvokeCodeInterpreter con campos de rastreo y cargas útiles de solicitud y respuesta |
