Configurer l’agent CloudWatch 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

Pour utiliser kubectl afin de créer un compte de service pour l’agent 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/cwagent/cwagent-serviceaccount.yaml

Pour créer une ConfigMap pour l'agent CloudWatch

1. Téléchargez le fichier YAML de ConfigMap vers votre hôte client kubectl 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. Dans ce cas, l'agent CloudWatch détecte le nom du cluster à partir des balises Amazon EC2.

3. (En option) Apportez des modifications supplémentaires à la ConfigMap en fonction de vos exigences en matière 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 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 section logs, 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 la section logs, vous pouvez spécifier l'intervalle pour les événements de journaux de traitement par lot avant qu'ils ne soient publiés sur CloudWatch Logs. 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 que système d'écoute StatsD dans chaque composant master de votre cluster, vous pouvez ajouter une section statsd à la section metrics, 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 la ConfigMap dans le cluster en exécutant la commande suivante.

   kubectl apply -f cwagent-configmap-enhanced.yaml

Pour déployer l'agent CloudWatch 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 fichier YAML de DaemonSet vers votre hôte client kubectl 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'agent CloudWatch dans votre cluster en exécutant la commande suivante.

        kubectl apply -f cwagent-daemonset.yaml

     4. Déployez l’agent CloudWatch 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’agent CloudWatch 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