Configuration de l' CloudWatch agent pour collecter les métriques du cluster

Pour créer un espace de noms pour CloudWatch

• Entrez la commande suivante.

  kubectl apply -f https://raw.githubusercontent.com/aws-samples/amazon-cloudwatch-container-insights/latest/k8s-deployment-manifest-templates/deployment-mode/daemonset/container-insights-monitoring/cloudwatch-namespace.yaml

À utiliser kubectl pour créer un compte de service pour l' CloudWatchagent

• Entrez la commande suivante.

  kubectl apply -f https://raw.githubusercontent.com/aws-samples/amazon-cloudwatch-container-insights/latest/k8s-deployment-manifest-templates/deployment-mode/daemonset/container-insights-monitoring/cwagent/cwagent-serviceaccount.yaml

Pour créer un ConfigMap pour l' CloudWatch agent

1. Téléchargez le ConfigMap fichier YAML sur votre hôte kubectl client en exécutant la commande suivante :

   curl -O https://raw.githubusercontent.com/aws-samples/amazon-cloudwatch-container-insights/latest/k8s-deployment-manifest-templates/deployment-mode/daemonset/container-insights-monitoring/cwagent/cwagent-configmap-enhanced.yaml

2. Modifiez le fichier YAML téléchargé comme suit :

   • cluster_name – Dans la section kubernetes, remplacez {{cluster_name}} par le nom de votre cluster. Supprimez les caractères {{}}. Sinon, si vous utilisez un cluster Amazon EKS, vous pouvez supprimer le champ "cluster_name" et sa valeur. Si c'est le cas, l' CloudWatch agent détecte le nom du cluster dans les EC2 balises Amazon.

3. (Facultatif) Apportez d'autres modifications au ConfigMap en fonction de vos besoins de surveillance, comme suit :

   • metrics_collection_interval – Dans la section kubernetes, vous pouvez spécifier à quelle fréquence l'agent collecte les métriques. Le durée par défaut est de 60 secondes. Dans kubelet, l'intervalle de collecte par défaut (via cadvisor) est de 15 secondes, vous ne devez donc pas définir cette valeur sur moins de 15 secondes.

   • endpoint_override — Dans la logs section, vous pouvez spécifier le point de terminaison CloudWatch Logs si vous souhaitez remplacer le point de terminaison par défaut. Vous pouvez effectuer cette opération si vous publiez à partir d'un cluster dans un VPC et souhaitez que les données soient transmises à un point de terminaison d'un VPC.

   • force_flush_interval — Dans logs cette section, vous pouvez spécifier l'intervalle de traitement par lots des événements du journal avant leur publication dans Logs. CloudWatch Le durée par défaut est 5 secondes.

   • region – Par défaut, l'agent a publié les métriques dans la région où se trouve le composant master. Pour contourner ce problème; vous pouvez ajouter un champ region dans la section agent : par exemple, "region":"us-west-2".

   • section statsd — Si vous souhaitez que l'agent CloudWatch Logs s'exécute également en tant qu'écouteur StatsD dans chaque nœud de travail de votre cluster, vous pouvez ajouter statsd une section à metrics la section, comme dans l'exemple suivant. Pour plus d'informations sur les autres options StatsD pour cette section, consultez Récupération de métriques personnalisées avec StatsD.

     "metrics": {
       "metrics_collected": {
         "statsd": {
           "service_address":":8125"
         }
       }
     }

     Voici un exemple complet de la section de code JSON. Si vous utilisez un fichier kubeconfig pour l’authentification, ajoutez le paramètre kube_config_path pour spécifier le chemin d’accès à votre fichier kubeconfig.

     {
         "agent": {
             "region": "us-east-1"
         },
         "logs": {
             "metrics_collected": {
                 "kubernetes": {
                     "cluster_name": "MyCluster",
                     "metrics_collection_interval": 60,
                     "kube_config_path": "/path/to/your/kubeconfig" //if using kubeconfig for authentication
                 }
             },
             "force_flush_interval": 5,
             "endpoint_override": "logs.us-east-1.amazonaws.com"
         },
         "metrics": {
             "metrics_collected": {
                 "statsd": {
                     "service_address": ":8125"
                 }
             }
         }
     }

4. Créez le ConfigMap dans le cluster en exécutant la commande suivante.

   kubectl apply -f cwagent-configmap-enhanced.yaml

Pour déployer l' CloudWatch agent en tant que DaemonSet

1. • Si vous ne souhaitez pas utiliser StatsD sur le cluster, entrez la commande suivante.

     kubectl apply -f https://raw.githubusercontent.com/aws-samples/amazon-cloudwatch-container-insights/latest/k8s-deployment-manifest-templates/deployment-mode/daemonset/container-insights-monitoring/cwagent/cwagent-daemonset.yaml

   • Si vous souhaitez utiliser StatsD, procédez comme suit :

     1. Téléchargez le DaemonSet fichier YAML sur votre hôte kubectl client en exécutant la commande suivante.

        curl -O  https://raw.githubusercontent.com/aws-samples/amazon-cloudwatch-container-insights/latest/k8s-deployment-manifest-templates/deployment-mode/daemonset/container-insights-monitoring/cwagent/cwagent-daemonset.yaml

     2. Supprimez la mise en commentaire de la section port dans le fichier cwagent-daemonset.yaml comme dans l'exemple suivant :

        ports:
          - containerPort: 8125
            hostPort: 8125
            protocol: UDP
        

     3. Déployez l' CloudWatch agent dans votre cluster en exécutant la commande suivante.

        kubectl apply -f cwagent-daemonset.yaml

     4. Déployez l' CloudWatch agent sur les nœuds Windows de votre cluster en exécutant la commande suivante. L'écouteur StatsD n'est pas pris en charge par l' CloudWatch agent sous Windows.

        kubectl apply -f cwagent-daemonset-windows.yaml

2. Assurez-vous que l'agent est déployé en exécutant la commande suivante.

   kubectl get pods -n amazon-cloudwatch