View a markdown version of this page

Acceso a los registros del controlador de Capacidades de EKS - Amazon EKS
Tipos de registro admitidosConfiguración de entrega de registrosEjemplo: consulta de registros con Información de registros de CloudWatchVisualización de los registrosPrecios

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 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.

  2. Seleccione el nombre del clúster.

  3. Elija la pestaña Capacidades y, a continuación, seleccione su capacidad.

  4. En la sección Entrega de registros, elija Agregar.

  5. Seleccione el tipo de registro que mejor se adapte a su capacidad y elija un destino.

  6. 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.

  2. 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.

  3. 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.

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.

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 para obtener más detalles.