Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
AgentCore herramientas integradas generadas, datos de observabilidad
Temas
Herramientas de observabilidad y métricas
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 la herramienta se agrupan en lotes en intervalos de un minuto. Para obtener más información sobre AgentCore las herramientas, consulte Ejecutar código y analizar datos mediante Amazon Bedrock AgentCore Code Interpreter e Interactuar con aplicaciones web mediante Amazon Bedrock AgentCore Browser.
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 restringidas por el servicio debido a que se superan los límites permitidos de TPS (transacciones por segundo) o de cuota. Estas solicitudes se devuelven ThrottlingException con el código de estado HTTP 429.
- SystemErrors
-
El número de errores del lado del servidor que se han producido 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 poder 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 restringidas por el servicio debido a que se superan los límites permitidos de TPS (transacciones por segundo) o de cuota. Estas solicitudes se devuelven ThrottlingException con el código de estado HTTP 429.
- SystemErrors
-
El número de errores del lado del servidor que se han producido 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 poder 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 control por parte del usuario del navegador:
- TakerOverCount
-
El número total de usuarios que toman el relevo
- TakerOverReleaseCount
-
El número total de usuarios que liberan el control
- TakerOverDuration
-
La duración de la toma de control por parte del usuario
Métricas y registros de uso de recursos
Amazon Bedrock AgentCore Built-in Tools proporciona una telemetría integral del uso de los recursos, que incluye métricas de consumo de CPU y memoria para sus recursos de tiempo de ejecución.
nota
Los datos sobre el uso de los recursos pueden retrasarse 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 en GB-Hours la unidad, disponible a nivel de recursos y de cuenta. Útil para el seguimiento de los recursos y la visibilidad estimada de la facturación. |
Explicación de la dimensión
-
Servicio - AgentCore.CodeInterpreter o AgentCore.Browser
-
Recurso: identificador Built-in de herramienta
Las métricas a nivel de cuenta están disponibles en la consola de AgentCore observación 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 la memoria y un gráfico de uso de la 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 de 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 la memoria y un gráfico de uso de la 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 medidos 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. Consulta tu extracto de AWS facturación para ver los cargos fidedignos.
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 un nivel de detalle de 1 segundo. Cada registro contiene un dato de uso de recursos de 1 segundo. Las métricas admitidas actualmente incluyen:
-
El código del intérprete de código Interpreter.vcpu.hours.used y el código _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.
Interprete 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 recursos a nivel de sesión. |
Para obtener más información sobre cómo habilitar los registros, consulte Añadir la observabilidad a los 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 de sesión de Built-in herramientas de la consola de AgentCore observabilidad de Amazon CloudWatch Bedrock, puede ver las métricas de uso de los recursos generadas a partir de estos registros. Para optimizar su experiencia de visualización de métricas, seleccione el intervalo de tiempo que desee con el selector de la esquina superior derecha para centrarse en datos específicos sobre el 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 medidos 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. Consulta tu extracto de AWS facturación para ver los cargos fidedignos.
Datos de intervalo proporcionados
Para mejorar la observabilidad, AgentCore proporciona intervalos estructurados que permiten ver las API de las herramientas integradas. Para habilitar este intervalo de datos, debes habilitar la observabilidad en tu recurso de herramientas integrado. Consulte Añadir la observabilidad a sus AgentCore recursos de Amazon Bedrock para ver los pasos y obtener más información. Los datos de este intervalo están disponibles en su totalidad en AWS CloudWatch los registros del grupo de aws/spans registros. En la tabla siguiente se define la operación para la que se crean los intervalos y los atributos de cada intervalo capturado.
Interpretador de código
| Nombre de operación | Atributos de 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 el 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 |
Expira una sesión de intérprete de código si no se llama 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 finalice
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 de 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 |
Expira una sesión de intérprete de código si no se llama 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 de los agentes 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 los recursos de su agente. Consulte Añadir la observabilidad a sus AgentCore recursos de Amazon Bedrock para ver los pasos y obtener más información. AgentCore puede enviar los 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, response_payload |
Registros de InvokeCodeInterpreter aplicaciones con campos de seguimiento y cargas útiles de solicitudes y respuestas |
