**Ayude a mejorar esta página** Para contribuir a esta guía del usuario, elija el enlace **Edit this page on GitHub** que se encuentra en el panel derecho de cada página. # Acceso a los registros del controlador de Capacidades de EKS Los controladores de las Capacidades de EKS para ACK, kro y Argo CD se ejecutan en una infraestructura administrada de AWS fuera de los clústeres. Puede configurar la entrega de registros para estos controladores mediante Registros suministrados de Amazon CloudWatch, lo que le proporciona visibilidad del comportamiento del controlador para la supervisión y la solución de problemas. Los registros se entregan en formato JSON estructurado e incluyen campos operativos como el nivel de registro, el mensaje, el nombre del controlador y los identificadores de conciliación. Los metadatos de AWS internos se filtran antes de la entrega: solo recibirá el contenido del registro operativo pertinente para los controladores de capacidad. ## Tipos de registro admitidos Cada capacidad tiene uno o más tipos de registro que puede configurar de forma independiente como orígenes de entrega de Registros suministrados de CloudWatch. **ACK** + **EKS\_CAPABILITY\_ACK\_LOGS** **kro** + **EKS\_CAPABILITY\_KRO\_LOGS** **Argo CD** + **EKS\_CAPABILITY\_ARGOCD\_APPLICATION\_LOGS** + **EKS\_CAPABILITY\_ARGOCD\_APPLICATIONSET\_LOGS** + **EKS\_CAPABILITY\_ARGOCD\_COMMITSERVER\_LOGS** + **EKS\_CAPABILITY\_ARGOCD\_REPOSERVER\_LOGS** + **EKS\_CAPABILITY\_ARGOCD\_SERVER\_LOGS** ACK utiliza un único tipo de registro que cubre todos los controladores de servicio de ACK. Los registros incluyen un campo `controllerGroup` (por ejemplo, `s3.services.k8s.aws`, `rds.services.k8s.aws`) que identifica qué controlador de servicios de ACK generó el registro. Puede usar este campo para filtrar los registros de un controlador de servicio específico en Información de registros de CloudWatch u otras herramientas de consulta. Argo CD tiene cinco tipos de registros independientes, uno por componente del controlador. Esto le permite habilitar el registro solo para los controladores que necesita y dirigirlos a diferentes destinos. ## Configuración de entrega de registros Para configurar la entrega de registros del controlador de capacidad, utilice la Consola de administración de AWS o la API de Registros de Amazon CloudWatch. Para obtener instrucciones detalladas de configuración, consulte [Habilitación del registro desde servicios de AWS](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-vended-logs-permissions-V2.html) en la Guía del usuario de Registros de Amazon CloudWatch. Cada controlador de capacidad se puede configurar como un origen individual de entrega de Registros suministrados de CloudWatch, de modo que puede seleccionar qué registros desea recibir. ### Consola 1. Abra la consola de Amazon EKS en https://console.aws.amazon.com/eks/home\#/clusters. 1. Seleccione el nombre del clúster. 1. Elija la pestaña **Capacidades** y, a continuación, seleccione su capacidad. 1. En la sección **Entrega de registros**, elija **Agregar**. 1. Seleccione el tipo de registro que mejor se adapte a su capacidad y elija un destino. 1. Elija **Agregar** para crear la entrega. ### Uso de las API de Amazon CloudWatch La configuración del registro requiere tres pasos: 1. Cree un origen de entrega para la capacidad mediante la API `PutDeliverySource` de CloudWatch. Utilice el ARN de capacidad como `resourceArn` y especifique el tipo de registro deseado. 1. Cree un destino de entrega mediante `PutDeliveryDestination`. Especifique el ARN de un grupo de registro de CloudWatch, un bucket de S3 o una secuencia de entrega de Amazon Data Firehose. 1. Cree una entrega para conectar el origen y el destino mediante `CreateDelivery`. Puede recuperar el ARN de capacidad mediante el comando `describe-capability`: ``` aws eks describe-capability \ --region {{region-code}} \ --cluster-name {{my-cluster}} \ --capability-name {{my-capability}} \ --query 'capability.capabilityArn' --output text ``` Puede configurar una única capacidad (origen de entrega) para enviar registros a varios destinos mediante la creación de múltiples entregas. También puede enviar registros de varias capacidades al mismo destino. ### Permisos de IAM Según el destino seleccionado, es posible que deba configurar roles o políticas de IAM para el grupo de registro de CloudWatch, el bucket de S3 o la secuencia de entrega de Data Firehose a fin de garantizar la entrega correcta de los registros. Si envía registros entre cuentas de AWS, utilice la API `PutDeliveryDestinationPolicy` para configurar una política de IAM que permita la entrega al destino. Para obtener más información, consulte la [documentación sobre permisos de Registros suministrados de CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-logs-infrastructure-V2-CloudWatchLogs). ## Ejemplo: consulta de registros con Información de registros de CloudWatch Para ver los registros de errores de todos los controladores: ``` fields @timestamp, controller, message, error | filter level = "error" | sort @timestamp desc | limit 50 ``` Para ver más ejemplos de consultas, como el filtrado por controlador de servicio, el seguimiento de los ciclos de conciliación y el filtrado de aplicaciones de Argo CD, consulte [Uso de los registros del controlador para solucionar problemas](capabilities-troubleshooting.md). ## Visualización de los registros Después de configurar la entrega de registros, los registros se enviarán al destino especificado. El método para acceder a los registros depende del tipo de destino elegido: + **Registros de CloudWatch:** vea los registros en la consola de Registros de CloudWatch, utilice comandos de la AWS CLI o consulte con Información de registros de CloudWatch. + **Amazon S3:** acceda a los registros como objetos en el bucket de S3 mediante la consola de S3, la AWS CLI o herramientas de análisis, como Amazon Athena. + **Amazon Data Firehose:** los registros se transmiten al destino de Firehose configurado (como S3, OpenSearch Service, Redshift, etc.). ## Precios Se aplican cargos por Registros suministrados de CloudWatch por la entrega y el almacenamiento de registros según el destino de entrega seleccionado. Registros suministrados de CloudWatch permite una entrega de registros confiable y segura con autenticación y autorización integradas de AWS, a un costo reducido en comparación con los Registros de CloudWatch estándar. Consulte la sección [Registros suministrados en la página de precios de CloudWatch](https://aws.amazon.com/cloudwatch/pricing/) para obtener más detalles.