Configuración de inicio rápido para Información de contenedores en Amazon EKS y Kubernetes

importante

Si va a instalar Información de contenedores en un clúster de Amazon EKS, recomendamos que utilice el complemento observabilidad de EKS de Amazon CloudWatch para la instalación, en lugar de seguir las instrucciones de esta sección. Además, para recuperar las redes de computación acelerada, debe usar el complemento de EKS Observabilidad de Amazon CloudWatch. Para obtener más información e instrucciones, consulte Instalación del complemento de observabilidad de EKS de Amazon CloudWatch.

Para completar la configuración de Información de contenedores, puede seguir las instrucciones de inicio rápido de esta sección. Si instala Información de contenedores en un clúster de Amazon EKS y sigue las instrucciones de esta sección a partir del 6 de noviembre de 2023, se instalará con observabilidad mejorada para Amazon EKS en el clúster.

importante

Antes de completar los pasos de esta sección, debe haber verificado los prerrequisitos incluidos los permisos de IAM. Para obtener más información, consulte Verificación de los requisitos previos de Información de contenedores en CloudWatch.

También puede seguir las instrucciones de las dos secciones siguientes: Configuración del agente de CloudWatch para recopilar las métricas del clúster y Envíe los registros a CloudWatch Logs. Estas secciones proporcionan más detalles sobre cómo funciona el agente de CloudWatch con Amazon EKS y con Kubernetes, pero se requiere que realice más pasos de instalación.

Con la versión original de Información de contenedores, las métricas recopiladas y los registros incorporados se cobran como métricas personalizadas. Con Información de contenedores, con una observabilidad mejorada para Amazon EKS, las métricas y los registros de Información de contenedores se cobran por observación en lugar de cobrarse por métrica almacenada o registro incorporado. Para obtener más información sobre los precios de CloudWatch, consulte Precios de Amazon CloudWatch.

nota

Amazon ha lanzado recientemente Fluent Bit como la solución de registro predeterminada para Información de contenedores con importantes mejoras de rendimiento. Se recomienda que utilice Fluent Bit en lugar de Fluentd.

Inicio rápido con el operador del agente de CloudWatch y Fluent Bit

Hay dos configuraciones para Fluent Bit: una versión optimizada y una versión que proporciona una experiencia más similar a Fluentd. La configuración de inicio rápido utiliza la versión optimizada. Para obtener más detalles sobre la configuración compatible con Fluentd, consulte Configure Fluent Bit como DaemonSet para enviar registros a CloudWatch Logs.

El operador del agente de CloudWatch es un contenedor adicional que se instala en un clúster de Amazon EKS. Sigue el modelo del operador OpenTelemetry para Kubernetes. El operador administra el ciclo de vida de los recursos de Kubernetes en un clúster. Instala el agente deCloudWatch, DCGM Exporter (NVIDIA) y AWS Neuron Monitor en un clúster de Amazon EKS y los administra. Fluent Bit y el agente de CloudWatch para Windows se instalan directamente en un clúster de Amazon EKS sin que el operador los administre.

Si busca una solución de autoridad de certificación más segura y con más características, el operador del agente de CloudWatch necesita cert-manager, una solución ampliamente adoptada para la administración de certificados TLS en Kubernetes. El uso de cert-manager simplifica el proceso de obtención, renovación, administración y uso de estos certificados. Asegura que los certificados sean válidos y estén actualizados, e intenta renovarlos en un momento configurado antes de que caduquen. Además, cert-manager también facilita la emisión de certificados desde una variedad de orígenes compatibles, como AWS Certificate Manager Private Certificate Authority.

Implementación de Información de contenedores mediante el inicio rápido

1. Instale cert-manager si aún no está instalado en el clúster. Para obtener más información, consulte cert-manager Installation.

2. Introduzca el siguiente comando para instalar las definiciones de recursos personalizados (CRDS).

   curl https://raw.githubusercontent.com/aws-samples/amazon-cloudwatch-container-insights/main/k8s-quickstart/cwagent-custom-resource-definitions.yaml | kubectl apply --server-side -f -

3. Introduzca el siguiente comando para instalar el operador. En este comando, my_cluster_name es el nombre del clúster de Amazon EKS o el de Kubernetes y my_cluster_region es el nombre de la región en la que se publican los registros. Le recomendamos que utilice la misma región en la que implemente el clúster para reducir los costes de transferencia de datos salientes de AWS.

   ClusterName=my-cluster-name
   RegionName=my-cluster-region
   curl https://raw.githubusercontent.com/aws-samples/amazon-cloudwatch-container-insights/main/k8s-quickstart/cwagent-operator-rendered.yaml | sed 's/{{cluster_name}}/'${ClusterName}'/g;s/{{region_name}}/'${RegionName}'/g' | kubectl apply -f -

   Por ejemplo, para implementar Información de contenedores en el clúster denominado MyCluster y publicar los registros y las métricas en el Oeste de EE. UU (Oregón), ingrese el siguiente comando.

   ClusterName='MyCluster'
   RegionName='us-west-2'
   curl https://raw.githubusercontent.com/aws-samples/amazon-cloudwatch-container-insights/main/k8s-quickstart/cwagent-operator-rendered.yaml | sed 's/{{cluster_name}}/'${ClusterName}'/g;s/{{region_name}}/'${RegionName}'/g' | kubectl apply -f -

Migración desde Información de contenedores

Si ya tiene Información de contenedores configurado en un clúster de Amazon EKS y desea migrar a Información de contenedores con observabilidad mejorada para Amazon EKS, consulte Actualización a Información de contenedores con observabilidad mejorada para Amazon EKS en CloudWatch

Eliminación de Información de contenedores

Si desea eliminar Información de contenedores después de utilizar la configuración de inicio rápido, escriba los siguientes comandos.

ClusterName=my-cluster-name 
RegionName=my-cluster-region
curl https://raw.githubusercontent.com/aws-samples/amazon-cloudwatch-container-insights/main/k8s-quickstart/cwagent-operator-rendered.yaml | sed 's/{{cluster_name}}/'${ClusterName}'/g;s/{{region_name}}/'${RegionName}'/g' | kubectl delete -f -
curl https://raw.githubusercontent.com/aws-samples/amazon-cloudwatch-container-insights/main/k8s-quickstart/cwagent-custom-resource-definitions.yaml | kubectl delete -f -