View a markdown version of this page

Registros y métricas de Vended - AWS DevOps Agente

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.

Registros y métricas de Vended

Puedes monitorear tus espacios de agente y tus operaciones de servicio mediante CloudWatch métricas y registros vendidos de Amazon. En este tema se describen las CloudWatch métricas que el AWS DevOps agente publica automáticamente en tu cuenta y los registros de ventas que puedes configurar para realizar entregas en los destinos que prefieras.

Métricas vendidas CloudWatch

AWS DevOps El agente publica automáticamente las métricas CloudWatch en Amazon en tu cuenta. Estas métricas están disponibles sin ninguna configuración. Puede utilizarlos para supervisar el uso, realizar un seguimiento de la actividad operativa y crear alarmas.

Rol vinculado a servicio

Para que CloudWatch las métricas de Amazon se publiquen en su cuenta para este servicio, el AWS DevOps agente creará automáticamente el rol vinculado al servicio AWSServiceRoleForAIDevOps Service-Linked Role para usted. Si el rol de IAM que invoca la API no tiene el permiso adecuado, la creación del recurso fallará con un. InvalidParameterException

importante

Los clientes que hayan creado su rol AgentSpace antes del 13 de marzo de 2026 deberán crear manualmente el rol vinculado al servicio de AWSServiceRoleForAIDevoperaciones para que CloudWatch las métricas del AWS DevOps agente se publiquen en su cuenta.

Cree manualmente un rol vinculado al servicio (para clientes existentes)

Realice una de las siguientes acciones:

  • En la consola de IAM, cree el rol AWSServiceRoleForAIDevOps en el servicio de agente.AWS DevOps

  • Desde la AWS CLI, ejecute el siguiente comando:

aws iam create-service-linked-role --aws-service-name aidevops.amazonaws.com

Namespace

Todas las métricas se publican en el espacio de AWS/AIDevOps nombres.

Dimensiones

Todas las métricas incluyen la siguiente dimensión.

Dimensión Description (Descripción)
AgentSpaceUUID El identificador único del espacio de agentes. Para agregar métricas en todos los espacios de agentes de su cuenta, utilice expresiones CloudWatch matemáticas u omita el filtro de dimensiones.

Referencia de métricas

Nombre de métrica Description (Descripción) Unidad Frecuencia de publicación Estadísticas útiles
ConsumedChatRequests El número de solicitudes de chat que ha consumido el espacio de un agente. Para obtener el recuento total de tu cuenta, usa la SUM estadística en todas las AgentSpaceUUID dimensiones. Recuento Cada 5 minutos Suma, media
ConsumedInvestigationTime El tiempo dedicado a realizar investigaciones en un espacio de agentes. Segundos Cada 5 minutos Suma, media, máxima
ConsumedEvaluationTime El tiempo dedicado a ejecutar las evaluaciones en un espacio de agentes. Segundos Cada 5 minutos Suma, media y máxima
TopologyCompletionCount El número de procesamientos topológicos finalizados. AWS DevOps El agente emite esta métrica cuando una topología termina de procesarse, ya sea desde la creación inicial durante la incorporación, una actualización manual o una actualización diaria programada. Recuento Basado en eventos (se emite cada vez que se completa) Suma, SampleCount

Visualización de las métricas en la CloudWatch consola

  1. Abra la consola de CloudWatch .

  2. En el panel de navegación, elija Metrics (Métricas) y, a continuación, All metrics (Todas las métricas).

  3. Elija el espacio de nombres AWS AIDev/Ops.

  4. Seleccione Por AgentSpace para ver las métricas de sus espacios de agentes.

nota

Puede crear CloudWatch alarmas en estas métricas para recibir notificaciones cuando el uso supere un umbral. Por ejemplo, crea una alarma ConsumedChatRequests para controlar el consumo de solicitudes de chat.

Requisitos previos

Antes de configurar la entrega de registros, asegúrese de tener lo siguiente:

  • Una AWS cuenta activa con acceso a la consola del AWS DevOps agente

  • Un director de IAM con permisos para la entrega de CloudWatch registros APIs

  • (Opcional) Un bucket de Amazon S3 o una transmisión de entrega de Amazon Data Firehose, si piensa utilizarlos como destinos de registro

Registros proporcionados

AWS DevOps El agente admite registros vendidos que proporcionan visibilidad de los eventos que procesan los espacios de agente y los registros de servicios. Los registros vendidos utilizan la infraestructura de Amazon CloudWatch Logs para entregar los registros a su destino preferido.

Para utilizar los registros vendidos, debe configurar un destino de entrega. Se admiten los siguientes destinos:

  • Amazon CloudWatch Logs: un grupo de registros en tu cuenta

  • Amazon S3: un bucket de S3 en su cuenta

  • Amazon Data Firehose: un flujo de entrega de Firehose en tu cuenta

Tipos de registro admitidos

Se admite un solo tipo de registro:. APPLICATION_LOGS Este tipo de registro cubre todos los eventos operativos que emite el servicio.

Registra los tipos de eventos

En la siguiente tabla se resumen los eventos que el AWS DevOps agente registra.

Event Description (Descripción) Nivel de registro
El agente recibió un evento entrante Un agente es activado por una fuente integrada y recibe un evento entrante (por ejemplo, un evento de PagerDuty incidente). INFO
Se descarta el evento entrante del agente Se descartó un evento entrante antes de que el agente lo procesara. El registro incluye el motivo (por ejemplo, datos con formato incorrecto). POR DETERMINAR
Fallo en la comunicación saliente del agente Se produjo un error en la comunicación saliente con una integración de terceros. El registro incluye el identificador de la tarea y el identificador de destino (por ejemplo, un error de autenticación). POR DETERMINAR
Creación de topología en cola Se puso en cola un trabajo de creación de topología para su procesamiento. INFO
Se inició la creación de la topología Se inició el procesamiento de un trabajo de creación de topología. INFO
Finalizó la creación de la topología Se completó el procesamiento de un trabajo de creación de topología. Este evento se aplica a la creación inicial, a las actualizaciones y a las actualizaciones diarias. INFO
Falló el descubrimiento de recursos Se produjo un error en la detección de recursos durante la creación de la topología. ERROR
Falló el registro del servicio El registro del servicio presenta un error irrecuperable ERROR
La validación de Webhook falla Cuando el webhook recibido por el agente de Devops no coincide con el esquema esperado ERROR
Se actualiza el estado de validación de la asociación Cuando se asocia un espacio de agentes (una primary/secondary cuenta típica), el estado de la validación cambia de válido a no válido y viceversa (por ejemplo, debido a un rol mal diseñado, que el servicio no puede asumir). ERROR/INFORMACIÓN

Permisos

AWS DevOps El agente usa registros CloudWatch vendidos (permisos V2) para entregar los registros. Para configurar la entrega de registros, la función de IAM que configura la entrega debe tener los siguientes permisos:

  • aidevops:AllowVendedLogDeliveryForResource— Necesario para permitir la entrega de registros para el recurso de espacio del agente.

  • Permisos para la entrega de CloudWatch registros APIs (logs:PutDeliverySourcelogs:PutDeliveryDestination,logs:CreateDelivery, y operaciones relacionadas).

  • Permisos específicos para el destino de entrega elegido.

Para ver la política de IAM completa que se requiere para cada tipo de destino, consulte los siguientes temas de la Guía del usuario de Amazon CloudWatch Logs:

Configurar la entrega de registros (consola)

AWS DevOps El agente proporciona dos ubicaciones en la consola AWS de administración para configurar la entrega de registros:

  • Página de configuración de registro del servicio: configure la entrega de registros para los eventos de nivel de servicio. Estos registros utilizan el ARN del servicio (arn:aws:aidevops:<region>:<account-id>:service/<account-id>) como recurso.

  • Página Agent Space: configure la entrega de registros para los eventos específicos de un espacio de agente individual. Estos registros utilizan el ARN (arn:aws:aidevops:<region>:<account-id>:agentspace/<agent-space-id>) del espacio de agentes como recurso.

Para configurar la entrega de registros para el registro de un servicio

  1. Abra la consola del AWS DevOps agente en la consola AWS de administración.

  2. En el panel de navegación, seleccione Configuración.

  3. En la pestaña Proveedores de capacidades > Registros, seleccione Configurar.

  4. En Tipo de destino, elija una de las siguientes opciones:

  5. CloudWatch Registros: seleccione o cree un grupo de registros.

  6. Amazon S3: introduzca el ARN del bucket S3.

  7. Amazon Data Firehose: selecciona o crea una transmisión de entrega de Firehose.

  8. Para la configuración adicional (opcional), puede especificar las siguientes opciones:

    1. En Selección de campos, seleccione los nombres de los campos de registro que desea entregar en su destino. Puede seleccionar campos de registro de acceso y un subconjunto de campos de registro de acceso en tiempo real.

    2. (Solo Amazon S3) En Partición, especifique la ruta para particionar los datos del archivo de registro.

    3. (Solo Amazon S3) En Formato de archivo compatible con Hive, puede seleccionar la casilla de verificación para utilizar rutas de S3 compatibles con Hive. Esto ayuda a simplificar la carga de nuevos datos en las herramientas compatibles con Hive.

    4. En Formato de salida, especifique el formato que prefiera.

    5. En Delimitador de campo, especifique cómo separar los campos de registro.

  9. Seleccione Save.

  10. Compruebe que el estado de la entrega sea Activo.

Para configurar la entrega de registros para un espacio de agentes

  1. Abra la consola del AWS DevOps agente en la consola AWS de administración.

  2. Elija el espacio de agentes que desee configurar.

  3. En la pestaña Configuración, elija Configurar.

  4. En Tipo de destino, elija una de las siguientes opciones:

  5. CloudWatch Registros: seleccione o cree un grupo de registros.

  6. Amazon S3: introduzca el ARN del bucket S3.

  7. Amazon Data Firehose: selecciona o crea una transmisión de entrega de Firehose.

  8. Para ajustes adicionales (*opcional), puede especificar las siguientes opciones:

    1. En Selección de campos, seleccione los nombres de los campos de registro que desea entregar en su destino. Puede seleccionar campos de registro de acceso y un subconjunto de campos de registro de acceso en tiempo real.

    2. (Solo Amazon S3) En Partición, especifique la ruta para particionar los datos del archivo de registro.

    3. (Solo Amazon S3) En Formato de archivo compatible con Hive, puede seleccionar la casilla de verificación para utilizar rutas de S3 compatibles con Hive. Esto ayuda a simplificar la carga de nuevos datos en las herramientas compatibles con Hive.

    4. En Formato de salida, especifique el formato que prefiera.

    5. En Delimitador de campo, especifique cómo separar los campos de registro.

  9. Seleccione Save.

  10. Comprueba que el estado de la entrega sea Activo.

Configure la entrega de registros (CloudWatch API)

También puede usar la API de CloudWatch registros para configurar la entrega de registros mediante programación. La entrega de un registro funcional consta de tres elementos:

  • A DeliverySource: representa el recurso de espacio de AWS DevOps agentes que genera los registros.

  • A DeliveryDestination: Representa el destino donde se escriben los registros.

  • Una entrega: conecta una fuente de entrega con un destino de entrega.

Paso 1: Crear una fuente de entrega

Utilice la PutDeliverySourceoperación para crear una fuente de entrega. Pase el ARN de su recurso de espacio de AWS DevOps agente y especifíquelo APPLICATION_LOGS como tipo de registro.

El siguiente ejemplo crea una fuente de entrega para un espacio de agentes:

{ "name": "my-agent-space-delivery-source", "resourceArn": "arn:aws:aidevops:us-east-1:123456789012:agentspace/my-agent-space-id", "logType": "APPLICATION_LOGS" }

El siguiente ejemplo crea una fuente de entrega para el servicio:

{ "name": "my-service-delivery-source", "resourceArn": "arn:aws:aidevops:us-east-1:123456789012:service", "logType": "APPLICATION_LOGS" }

Paso 2: Crear un destino de entrega

Utilice la PutDeliveryDestinationoperación para configurar dónde se almacenan los registros. Puede elegir Amazon CloudWatch Logs, Amazon S3 o Amazon Data Firehose.

En el siguiente ejemplo, se crea un destino de CloudWatch Logs:

{ "name": "my-cwl-destination", "deliveryDestinationConfiguration": { "destinationResourceArn": "arn:aws:logs:us-east-1:123456789012:log-group:/aws/aidevops/my-agent-space" }, "outputFormat": "json" }

El siguiente ejemplo crea un destino de Amazon S3:

{ "name": "my-s3-destination", "deliveryDestinationConfiguration": { "destinationResourceArn": "arn:aws:s3:::my-aidevops-logs-bucket" }, "outputFormat": "json" }

El siguiente ejemplo crea un destino Amazon Data Firehose:

{ "name": "my-firehose-destination", "deliveryDestinationConfiguration": { "destinationResourceArn": "arn:aws:firehose:us-east-1:123456789012:deliverystream/my-aidevops-log-stream" }, "outputFormat": "json" }
nota

Si entrega registros entre cuentas, debe utilizarlos PutDeliveryDestinationPolicyen la cuenta de destino para autorizar la entrega.

Si quieres usar CloudFormation, puedes usar lo siguiente:

El ResourceArn es el AgentSpaceArn y el LogType admitido debe ser APPLICATION_LOGS.

Paso 3: Crea una entrega

Utilice la CreateDeliveryoperación para vincular la fuente de entrega con el destino de entrega.

{ "deliverySourceName": "my-agent-space-delivery-source", "deliveryDestinationArn": "arn:aws:logs:us-east-1:123456789012:delivery-destination:my-cwl-destination" }

AWS CloudFormation

También puede configurar la entrega de registros AWS CloudFormation mediante los siguientes recursos:

ResourceArnConfigúrelo en el espacio de AWS DevOps agente o en el ARN del servicio y configúrelo en. LogType APPLICATION_LOGS

Referencia del esquema de registro

AWS DevOps El agente usa un esquema de registro compartido en todos los tipos de eventos. No todos los eventos de registro utilizan todos los campos.

En la siguiente tabla se describen los campos del esquema de registro.

Campo Tipo Description (Descripción)
event_timestamp Largo Marca de tiempo de Unix del momento en que ocurrió el evento
resource_arn Cadena ARN del recurso que generó el evento
optional_account_id Cadena AWS ID de cuenta asociada al registro.
nivel_opcional Cadena Nivel de registro:,, INFO WARN ERROR
optional_agent_space_id Cadena Identificador del espacio de agentes.
optional_association_id Cadena Identificador de asociación para el registro.
estado_opcional Cadena Estado de la operación de topología.
optional_webhook_id Cadena Identificador de webhook.
optional_mcp_endpoint_url Cadena URL del punto final del servidor MCP
tipo_de_servicio_opcional Cadena Tipo de servicio:DYNATRACE,,,,. DATADOG GITHUB SLACK SERVICENOW
optional_service_endpoint_url Cadena URL de punto final para integraciones de terceros.
optional_service_id Cadena Identificador de la fuente.
request_id Cadena Identificador de solicitud para correlacionarlo con los tickets de soporte AWS CloudTrail o de soporte.
operación_opcional Cadena Nombre de la operación que se realizó.
tipo_de_tarea opcional Cadena Tipo de tarea pendiente del agente: o INVESTIGATION EVALUATION
optional_task_id Cadena Identificador de tareas pendientes de Agent Backlog Task. IDAgent
referencia_opcional Cadena Referencia de una tarea de un agente (por ejemplo, un ticket de Jira).
Tipo_de_error opcional Cadena Tipo de error
mensaje_de_error opcional Cadena Descripción del error cuando se produce un error en una operación.
detalles_opcionales Cadena (JSON) Carga útil de eventos específica del servicio que contiene los parámetros y resultados de la operación.

Administre e inhabilite la entrega de registros

Puede modificar o eliminar la entrega de registros en cualquier momento desde la consola de AWS DevOps agente de la consola AWS de administración o mediante la API de CloudWatch registros.

Gestione la entrega de registros (consola)

  1. Abra la consola del AWS DevOps agente en la consola AWS de administración.

  2. Diríjase a la página de configuración (para los registros de nivel de servicio) o a la página específica de Agent Space (para los registros de nivel de Agent Space).

  3. En la pestaña Configuración (para los registros a nivel de espacio de agente) o en la pestaña Proveedores de capacidades > Registros (para los registros a nivel de servicio), seleccione la entrega que desee modificar.

  4. Actualice la configuración según sea necesario y seleccione Guardar.

Inhabilite la entrega de registros (consola)

  1. Abra la consola del AWS DevOps agente en la consola AWS de administración.

  2. Diríjase a la página de configuración (para los registros de nivel de servicio) o a la página específica de Agent Space (para los registros de nivel de Agent Space).

  3. En la pestaña Configuración (para los registros a nivel de espacio de agente) o en la pestaña Proveedores de capacidades > Registros (para los registros a nivel de servicio), seleccione la entrega que desee eliminar.

  4. Seleccione Eliminar y confirme.

Inhabilite la entrega de registros (API)

Para eliminar una entrega de registros mediante la API, elimine los recursos en el siguiente orden:

  1. Elimine la entrega mediante DeleteDelivery.

  2. Elimine la fuente de entrega mediante DeleteDeliverySource.

  3. (Opcional) Si el destino de entrega ya no es necesario, elimínelo utilizando DeleteDeliveryDestination.

importante

Usted es responsable de eliminar los recursos de entrega de registros después de eliminar el recurso de espacio de agente que genera los registros (por ejemplo, después de eliminar un espacio de agente). Si no eliminas estos recursos, es posible que queden configuraciones de entrega huérfanas.

Precios

El AWS DevOps agente no cobra por habilitar los registros vendidos. Sin embargo, puede incurrir en cargos por la entrega, la ingesta, el almacenamiento o el acceso, según el destino de entrega de los registros que seleccione. Para obtener más información sobre los precios, consulta Vended Logs en la pestaña Logs de Amazon CloudWatch Pricing.

Para conocer los precios específicos de cada destino, consulta lo siguiente: