Configuration Quick Start pour Container Insights sur Amazon EKS et Kubernetes

Important

Si vous installez Container Insights sur un cluster Amazon EKS, nous vous recommandons d'utiliser le module complémentaire Amazon CloudWatch Observability EKS pour l'installation, au lieu de suivre les instructions de cette section. En outre, pour récupérer des réseaux informatiques accélérés, vous devez utiliser le module complémentaire Amazon CloudWatch Observability EKS. Pour en savoir plus et des instructions, consultez Installez le module complémentaire Amazon CloudWatch Observability EKS.

Pour terminer la configuration de Container Insights, vous pouvez suivre les instructions de démarrage rapide de cette section. Si vous effectuez une installation dans un cluster Amazon EKS et que vous suivez les instructions de cette section le 6 novembre 2023 ou après cette date, vous installez Container Insights avec observabilité améliorée pour Amazon EKS dans le cluster.

Important

Avant d'exécuter la procédure indiquée dans cette section, vous devez satisfaire aux prérequis, y compris les autorisations IAM. Pour plus d'informations, consultez . Vérifiez les conditions préalables.

Sinon, vous pouvez suivre les instructions des deux sections suivantes, Configurer l' CloudWatch agent pour collecter les métriques du cluster et Envoyer des journaux à CloudWatch Logs. Ces sections fournissent des informations de configuration supplémentaires sur le fonctionnement de l' CloudWatch agent avec Amazon EKS et Kubernetes, mais vous demandent d'effectuer d'autres étapes d'installation.

Dans la version originale de Container Insights, les métriques collectées et les logs ingérés sont facturés en tant que métriques personnalisées. Grâce à Container Insights avec observabilité améliorée pour Amazon EKS, les métriques et les journaux de Container Insights sont facturés par observation au lieu d'être facturés par métrique stockée ou par journal ingéré. Pour plus d'informations sur CloudWatch les tarifs, consultez Amazon CloudWatch Pricing.

Note

Amazon a maintenant lancé Fluent Bit comme solution de journal par défaut pour Container Insights avec des gains de performances importants. Nous vous recommandons d'utiliser Fluent Bit au lieu de Fluentd.

Démarrage rapide avec l'opérateur de l' CloudWatch agent et Fluent Bit

Il existe deux configurations pour Fluent Bit : une version optimisée et une version qui offre une expérience plus similaire à Fluentd. La configuration Quick Start utilise la version optimisée. Pour plus d'informations sur la configuration compatible Fluentd, consultez Configurer Fluent Bit comme un DaemonSet pour envoyer des CloudWatch journaux à Logs.

L'opérateur de l' CloudWatch agent est un conteneur supplémentaire qui est installé sur un cluster Amazon EKS. Il est calqué sur l' OpenTelemetry opérateur pour Kubernetes. L'opérateur gère le cycle de vie des ressources Kubernetes dans un cluster. Il installe l' CloudWatch agent, le DCGM Exporter (NVIDIA) et le AWS Neuron Monitor sur un cluster Amazon EKS et les gère. Fluent Bit et l' CloudWatch agent pour Windows sont installés directement sur un cluster Amazon EKS sans que l'opérateur ne les gère.

Pour une solution d'autorité de certification plus sécurisée et riche en fonctionnalités, l'opérateur de l' CloudWatch agent a besoin de cert-manager, une solution largement adoptée pour la gestion des certificats TLS dans Kubernetes. L'utilisation de cert-manager simplifie le processus d'obtention, de renouvellement, de gestion et d'utilisation de ces certificats. Il garantit la validité et la mise à jour des certificats et tente de les renouveler à une heure définie avant leur expiration. cert-manager facilite également l'émission de certificats provenant de diverses sources prises en charge, notamment AWS Certificate Manager Private Certificate Authority.

Pour déployer Container Insights à l'aide du démarrage rapide

1. Installez cert-manager s'il n'est pas déjà installé dans le cluster. Pour plus d'informations, consultez la section Installation de cert-manager.

2. Installez les définitions de ressources personnalisées (CRD) en saisissant la commande suivante.

   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. Installez l'opérateur en saisissant la commande suivante. my-cluster-nameRemplacez-le par le nom de votre cluster Amazon EKS ou Kubernetes, puis par le nom my-cluster-regionde la région dans laquelle les journaux sont publiés. Nous vous recommandons d'utiliser la même région que celle dans laquelle votre cluster est déployé afin de réduire les coûts de transfert de données AWS sortants.

   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 -

   Par exemple, pour déployer Container Insights sur le cluster nommé MyCluster et publier les journaux et les métriques dans USA Ouest (Oregon), entrez la commande suivante.

   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 -

Migration depuis Container Insights

Si Container Insights est déjà configuré dans un cluster Amazon EKS et que vous souhaitez migrer vers Container Insights avec une meilleure observabilité pour Amazon EKS, voir Mise à niveau vers Container Insights avec observabilité améliorée pour Amazon EKS

Suppression de Container Insights

Si vous souhaitez supprimer Container Insights après avoir utilisé la configuration de démarrage rapide, entrez les commandes suivantes.

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 -