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](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create-service-linked-role.html) 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 ](https://console.aws.amazon.com/cloudwatch/).
1. En el panel de navegación, elija **Metrics** (Métricas) y, a continuación, **All metrics** (Todas las métricas).
1. Elija el espacio de nombres **AWS AIDev/Ops**.
1. 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)](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-vended-logs-permissions-V2.html) 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:PutDeliverySource``logs: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*:
+ [Registros enviados a CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-infrastructure-V2-CloudWatchLogs.html)
+ [Registros enviados a Amazon S3](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-infrastructure-V2-S3.html)
+ [Registros enviados a Firehose](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-infrastructure-V2-Firehose.html)
### 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:::service/`) 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:::agentspace/`) 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.
1. En el panel de navegación, seleccione **Configuración**.
1. En la pestaña **Proveedores de capacidades** **>** **Registros**, seleccione **Configurar**.
1. En **Tipo de destino**, elija una de las siguientes opciones:
1. **CloudWatch Registros**: seleccione o cree un grupo de registros.
1. **Amazon S3**: introduzca el ARN del bucket S3.
1. **Amazon Data Firehose**: selecciona o crea una transmisión de entrega de Firehose.
1. 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](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/standard-logs-reference.html#BasicDistributionFileFormat) y un subconjunto de [campos de registro de acceso en tiempo real](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/standard-logging.html#standard-logging-real-time-log-selection).
1. (Solo Amazon S3) En **Partición**, especifique la ruta para particionar los datos del archivo de registro.
1. (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.
1. En **Formato de salida**, especifique el formato que prefiera.
1. En **Delimitador de campo**, especifique cómo separar los campos de registro.
1. Seleccione **Save**.
1. 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.
1. Elija el espacio de agentes que desee configurar.
1. En la pestaña **Configuración**, elija **Configurar**.
1. En **[Tipo de destino](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-vended-logs-permissions-V2:~:text=sts%3AAssumeRole%22%0A%20%20%20%20%7D%0A%20%20%5D%0A%7D-,Logging%20that%20requires%20additional%20permissions%20%5BV2%5D,-Some%20AWS%20services)**, elija una de las siguientes opciones:
1. **CloudWatch Registros**: seleccione o cree un grupo de registros.
1. **Amazon S3**: introduzca el ARN del bucket S3.
1. **Amazon Data Firehose**: selecciona o crea una transmisión de entrega de Firehose.
1. Para **ajustes adicionales (\$1opcional)**, 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](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/standard-logs-reference.html#BasicDistributionFileFormat) y un subconjunto de [campos de registro de acceso en tiempo real](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/standard-logging.html#standard-logging-real-time-log-selection).
1. (Solo Amazon S3) En **Partición**, especifique la ruta para particionar los datos del archivo de registro.
1. (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.
1. En **Formato de salida**, especifique el formato que prefiera.
1. En **Delimitador de campo**, especifique cómo separar los campos de registro.
1. Seleccione **Save**.
1. 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 [PutDeliverySource](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html)operació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 [PutDeliveryDestination](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestination.html)operació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 [PutDeliveryDestinationPolicy](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationPolicy.html)en la cuenta de destino para autorizar la entrega.
Si quieres usar CloudFormation, puedes usar lo siguiente:
+ [Delivery](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-logs-delivery.html)
+ [DeliveryDestination](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-logs-deliverydestination.html)
+ [DeliverySource](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-logs-deliverysource.html)
El `ResourceArn` es el `AgentSpaceArn` y el `LogType` admitido debe ser `APPLICATION_LOGS`.
#### Paso 3: Crea una entrega
Utilice la [CreateDelivery](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html)operació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:
+ [AWS: :Registros:: DeliverySource](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-logs-deliverysource.html)
+ [AWS: :Registros:: DeliveryDestination](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-logs-deliverydestination.html)
+ [AWS:: Registros:: Entrega](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-logs-delivery.html)
`ResourceArn`Configú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\$1timestamp | Largo | Marca de tiempo de Unix del momento en que ocurrió el evento |
| resource\$1arn | Cadena | ARN del recurso que generó el evento |
| optional\$1account\$1id | Cadena | AWS ID de cuenta asociada al registro. |
| nivel\$1opcional | Cadena | Nivel de registro:,, INFO WARN ERROR |
| optional\$1agent\$1space\$1id | Cadena | Identificador del espacio de agentes. |
| optional\$1association\$1id | Cadena | Identificador de asociación para el registro. |
| estado\$1opcional | Cadena | Estado de la operación de topología. |
| optional\$1webhook\$1id | Cadena | Identificador de webhook. |
| optional\$1mcp\$1endpoint\$1url | Cadena | URL del punto final del servidor MCP |
| tipo\$1de\$1servicio\$1opcional | Cadena | Tipo de servicio:DYNATRACE,,,,. DATADOG GITHUB SLACK SERVICENOW |
| optional\$1service\$1endpoint\$1url | Cadena | URL de punto final para integraciones de terceros. |
| optional\$1service\$1id | Cadena | Identificador de la fuente. |
| request\$1id | Cadena | Identificador de solicitud para correlacionarlo con los tickets de soporte AWS CloudTrail o de soporte. |
| operación\$1opcional | Cadena | Nombre de la operación que se realizó. |
| tipo\$1de\$1tarea opcional | Cadena | Tipo de tarea pendiente del agente: o INVESTIGATION EVALUATION |
| optional\$1task\$1id | Cadena | Identificador de tareas pendientes de Agent Backlog Task. IDAgent |
| referencia\$1opcional | Cadena | Referencia de una tarea de un agente (por ejemplo, un ticket de Jira). |
| Tipo\$1de\$1error opcional | Cadena | Tipo de error |
| mensaje\$1de\$1error opcional | Cadena | Descripción del error cuando se produce un error en una operación. |
| detalles\$1opcionales | 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.
1. 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).
1. 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.
1. **Actualice la configuración según sea necesario y seleccione Guardar.**
**Nota:** No puedes cambiar el tipo de destino de un envío existente. Para cambiar el tipo de destino, elimina la entrega actual y crea una nueva.
#### Inhabilite la entrega de registros (consola)
1. Abra la consola del AWS DevOps agente en la consola AWS de administración.
1. 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).
1. 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.
1. **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](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DeleteDelivery.html).
1. Elimine la fuente de entrega mediante [DeleteDeliverySource](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DeleteDeliverySource.html).
1. (Opcional) Si el destino de entrega ya no es necesario, elimínelo utilizando [DeleteDeliveryDestination](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DeleteDeliveryDestination.html).
**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](https://aws.amazon.com/cloudwatch/pricing/).
Para conocer los precios específicos de cada destino, consulta lo siguiente:
+ [Precios de Amazon CloudWatch Logs](https://aws.amazon.com/cloudwatch/pricing/)
+ [Precios de Amazon S3](https://aws.amazon.com/s3/pricing/)
+ [Precios de Amazon Data Firehose](https://aws.amazon.com/kinesis/data-firehose/pricing/)