Installez l' CloudWatch agent sur les nouvelles instances à l'aide de AWS CloudFormation - Amazon CloudWatch
Tutoriel : Installation à l'aide d'un AWS CloudFormation modèle intégréTutoriel : Installation de l' CloudWatch agent à l'aide AWS CloudFormation d'un magasin de paramètresRésolution des problèmes liés à l'installation de CloudWatch l'agent avec AWS CloudFormation

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Installez l' CloudWatch agent sur les nouvelles instances à l'aide de AWS CloudFormation

Cette section décrit comment installer l' CloudWatch agent sur les nouvelles EC2 instances Amazon à l'aide de AWS CloudFormation.

Note

Amazon a téléchargé plusieurs AWS CloudFormation modèles GitHub qui peuvent vous aider à installer et à mettre à jour l' CloudWatch agent sur les nouvelles EC2 instances Amazon. Pour plus d'informations sur l'utilisation AWS CloudFormation, voir Qu'est-ce que c'est AWS CloudFormation ? .

L'emplacement du modèle est Déployer l' CloudWatch agent Amazon sur les EC2 instances utilisant AWS CloudFormation. Cet emplacement inclut à la fois les répertoires inline et ssm. Chacun de ces répertoires contient des modèles pour les instances Linux et Windows.

  • La configuration de l' CloudWatch agent est intégrée aux AWS CloudFormation modèles du inline répertoire. Par défaut, les modèles Linux collectent les métriques mem_used_percent et swap_used_percent et les modèles Windows collectent Memory % Committed Bytes In Use et Paging File % Usage.

    Modifiez la section suivante du modèle afin de modifier ces modèles pour la collecte de différentes métriques. L'exemple suivant est issu du modèle pour les serveurs Linux. Respectez le format et la syntaxe du fichier de configuration de l'agent pour effectuer ces modifications. Pour de plus amples informations, consultez Création ou modification manuelle du fichier de configuration de CloudWatch l'agent.

    {
   "metrics":{
      "append_dimensions":{
         "AutoScalingGroupName":"${!aws:AutoScalingGroupName}",
         "ImageId":"${!aws:ImageId}",
         "InstanceId":"${!aws:InstanceId}",
         "InstanceType":"${!aws:InstanceType}"
      },
      "metrics_collected":{
         "mem":{
            "measurement":[
               "mem_used_percent"
            ]
         },
         "swap":{
            "measurement":[
               "swap_used_percent"
            ]
         }
      }
   }
}
    Note

    Dans les modèles en ligne, toutes les variables d'espace réservé doivent commencer par un point d'exclamation (!) comme caractère d'échappement. Vous pouvez le constater dans l'exemple de modèle. Si vous ajoutez d'autres variables d'espace réservé, veillez à ajouter un point d'exclamation avant le nom.

  • Les modèles dans le répertoire ssm chargent un fichier de configuration d'agent à partir du Parameter Store. Pour utiliser ces modèles, vous devez d'abord créer un fichier de configuration et le charger dans le Parameter Store. Ensuite, vous indiquez le nom du Parameter Store du fichier dans le modèle. Vous pouvez créer le fichier de configuration manuellement ou à l'aide de l'assistant. Pour de plus amples informations, veuillez consulter Création du fichier de configuration de CloudWatch l'agent.

Vous pouvez utiliser les deux types de modèles pour installer l' CloudWatch agent et pour mettre à jour la configuration de l'agent.

Tutoriel : Installation et configuration de l' CloudWatch agent à l'aide d'un AWS CloudFormation modèle intégré

Ce didacticiel explique comment AWS CloudFormation installer l' CloudWatch agent sur une nouvelle EC2 instance Amazon. Ce didacticiel s'installe sur une nouvelle instance exécutant Amazon Linux 2 à l'aide des modèles intégrés, qui ne nécessitent pas l'utilisation du fichier de JSON configuration ou du Parameter Store. Le modèle en ligne inclut la configuration de l'agent dans le modèle. Dans ce tutoriel, vous utilisez la configuration de l'agent par défaut contenue dans le modèle.

Après la procédure d'installation de l'agent, le tutoriel vous explique comment mettre à jour l'agent.

À utiliser AWS CloudFormation pour installer l' CloudWatch agent sur une nouvelle instance

  1. Téléchargez le modèle depuis GitHub. Dans ce didacticiel, téléchargez le modèle en ligne pour Amazon Linux 2 comme suit :

    curl -O https://raw.githubusercontent.com/aws-cloudformation/aws-cloudformation-templates/main/Solutions/AmazonCloudWatchAgent/inline/amazon_linux.yaml

  2. Ouvrez la AWS CloudFormation console à l'adresse https://console.aws.amazon.com/cloudformation.

  3. Sélectionnez Créer la pile.

  4. Pour Choisir un modèle, sélectionnez Télécharger un modèle sur Amazon S3, choisissez le modèle téléchargé, puis Next (Suivant).

  5. Sur la page Spécifier les détails, renseignez les paramètres suivants, puis choisissez Next (Suivant) :

    • Nom de pile : Choisissez un nom de pile pour votre AWS CloudFormation pile.

    • IAMRole: Choisissez un IAM rôle autorisé à écrire des CloudWatch métriques, des journaux et des traces. Pour de plus amples informations, veuillez consulter Créez IAM des rôles à utiliser avec l' CloudWatch agent sur les EC2 instances Amazon.

    • Instance AMI : choisissez une AMI instance valide dans la région où vous allez lancer votre stack.

    • InstanceType: Choisissez un type d'instance valide.

    • KeyName: Pour activer SSH l'accès à la nouvelle instance, choisissez une paire de EC2 clés Amazon existante. Si vous ne possédez pas encore de paire de EC2 clés Amazon, vous pouvez en créer une dans le AWS Management Console. Pour plus d'informations, consultez Amazon EC2 Key Pairs dans le guide de EC2 l'utilisateur Amazon.

    • SSHLocation: Spécifie la plage d'adresses IP qui peut être utilisée pour se connecter à l'instance à l'aide deSSH. La valeur par défaut autorise l'accès depuis n'importe quelle adresse IP.

  6. Dans la page Options, vous pouvez étiqueter les ressources de votre pile. Choisissez Suivant.

  7. Sur la page Révision, passez en revue vos informations, reconnaissez que la pile est susceptible de créer IAM des ressources, puis choisissez Create.

    Si vous actualisez la console, vous voyez que la nouvelle pile présente l'état CREATE_IN_PROGRESS.

  8. Lorsque l'instance est créée, vous pouvez la voir dans la EC2 console Amazon. Ensuite, vous pouvez vous connecter à l'hôte et vérifier la progression.

    Utilisez la commande suivante pour confirmer que l'agent est installé :

    rpm -qa amazon-cloudwatch-agent

    Utilisez la commande suivante pour confirmer que l'agent est en cours d'exécution :

    ps aux | grep amazon-cloudwatch-agent

La procédure suivante explique comment mettre AWS CloudFormation à jour l' CloudWatch agent à l'aide d'un modèle intégré. Par défaut, le modèle en ligne collecte la métrique mem_used_percent. Dans ce tutoriel, vous modifiez la configuration de l'agent pour arrêter la collecte de cette métrique.

À utiliser AWS CloudFormation pour mettre à jour l' CloudWatch agent

  1. Dans le modèle que vous avez téléchargé lors de la procédure précédente, supprimez les lignes suivantes, puis enregistrez le modèle :

    
"mem": {
                        
     "measurement": [
         "mem_used_percent"
       ]
 },

  2. Ouvrez la AWS CloudFormation console à l'adresse https://console.aws.amazon.com/cloudformation.

  3. Sur le AWS CloudFormation tableau de bord, sélectionnez la pile que vous avez créée et choisissez Update Stack.

  4. Pour Select Template (Sélectionner un modèle), sélectionnez Télécharger un modèle sur Amazon S3, choisissez le modèle modifié, puis Next (Suivant).

  5. Sur la page Options, choisissez Next (Suivant), puis Next.

  6. Dans la page Review (Révision), passez en revue vos informations et choisissez Update (Mettre à jour).

    Après un certain temps, UPDATE_COMPLETE s'affiche.

Tutoriel : Installation de l' CloudWatch agent à l'aide AWS CloudFormation d'un magasin de paramètres

Ce didacticiel explique comment AWS CloudFormation installer l' CloudWatch agent sur une nouvelle EC2 instance Amazon. Ce didacticiel s'installe sur une nouvelle instance qui exécute Amazon Linux 2 à l'aide d'un fichier de configuration de l'agent que vous créez et enregistrez dans le Parameter Store.

Après la procédure d'installation de l'agent, le tutoriel vous explique comment mettre à jour l'agent.

À utiliser AWS CloudFormation pour installer l' CloudWatch agent sur une nouvelle instance à l'aide d'une configuration provenant du Parameter Store

  1. Si ce n'est pas déjà fait, téléchargez le package de l' CloudWatch agent sur l'un de vos ordinateurs afin de créer le fichier de configuration de l'agent. Pour plus d'informations et pour télécharger l'agent à l'aide du Parameter Store, consultez Téléchargez, configurez et exécutez l' CloudWatch agent à l'aide de SSM. Pour plus d'informations sur le téléchargement du package à l'aide de la ligne de commande, consultez Téléchargez et configurez l' CloudWatch agent à l'aide de la ligne de commande.

  2. Créez le fichier de configuration d'agent et enregistrez-le dans le Parameter Store. Pour de plus amples informations, veuillez consulter Création du fichier de configuration de CloudWatch l'agent.

  3. Téléchargez le modèle GitHub comme suit :

    curl -O https://raw.githubusercontent.com/awslabs/aws-cloudformation-templates/master/aws/solutions/AmazonCloudWatchAgent/ssm/amazon_linux.template

  4. Ouvrez la AWS CloudFormation console à l'adresse https://console.aws.amazon.com/cloudformation.

  5. Sélectionnez Créer la pile.

  6. Pour Choisir un modèle, sélectionnez Télécharger un modèle sur Amazon S3, choisissez le modèle que vous avez téléchargé, puis Next (Suivant).

  7. Sur la page Specify Details (Spécifier les détails), renseignez les paramètres suivants en conséquence, puis choisissez Next (Suivant).

    • Nom de pile : Choisissez un nom de pile pour votre AWS CloudFormation pile.

    • IAMRole: Choisissez un IAM rôle autorisé à écrire des CloudWatch métriques, des journaux et des traces. Pour de plus amples informations, veuillez consulter Créez IAM des rôles à utiliser avec l' CloudWatch agent sur les EC2 instances Amazon.

    • Instance AMI : choisissez une AMI instance valide dans la région où vous allez lancer votre stack.

    • InstanceType: Choisissez un type d'instance valide.

    • KeyName: Pour activer SSH l'accès à la nouvelle instance, choisissez une paire de EC2 clés Amazon existante. Si vous ne possédez pas encore de paire de EC2 clés Amazon, vous pouvez en créer une dans le AWS Management Console. Pour plus d'informations, consultez Amazon EC2 Key Pairs dans le guide de EC2 l'utilisateur Amazon.

    • SSHLocation: Spécifie la plage d'adresses IP qui peut être utilisée pour se connecter à l'instance à l'aide deSSH. La valeur par défaut autorise l'accès depuis n'importe quelle adresse IP.

    • SSMKey: Spécifie le fichier de configuration de l'agent que vous avez créé et enregistré dans Parameter Store.

  8. Dans la page Options, vous pouvez étiqueter les ressources de votre pile. Choisissez Suivant.

  9. Sur la page Révision, passez en revue vos informations, reconnaissez que la pile est susceptible de créer IAM des ressources, puis choisissez Create.

    Si vous actualisez la console, vous voyez que la nouvelle pile présente l'état CREATE_IN_PROGRESS.

  10. Lorsque l'instance est créée, vous pouvez la voir dans la EC2 console Amazon. Ensuite, vous pouvez vous connecter à l'hôte et vérifier la progression.

    Utilisez la commande suivante pour confirmer que l'agent est installé :

    rpm -qa amazon-cloudwatch-agent

    Utilisez la commande suivante pour confirmer que l'agent est en cours d'exécution :

    ps aux | grep amazon-cloudwatch-agent

La procédure suivante montre comment mettre AWS CloudFormation à jour l' CloudWatch agent à l'aide d'une configuration d'agent que vous avez enregistrée dans Parameter Store.

À utiliser pour mettre AWS CloudFormation à jour l' CloudWatch agent à l'aide d'une configuration dans Parameter Store

  1. Modifiez le fichier de configuration de l'agent stocké dans le Parameter Store avec la nouvelle configuration de votre choix.

  2. Dans le AWS CloudFormation modèle que vous avez téléchargé dans la Tutoriel : Installation de l' CloudWatch agent à l'aide AWS CloudFormation d'un magasin de paramètres rubrique, modifiez le numéro de version. Par exemple, vous pouvez remplacer VERSION=1.0 par VERSION=2.0.

  3. Ouvrez la AWS CloudFormation console à l'adresse https://console.aws.amazon.com/cloudformation.

  4. Sur le AWS CloudFormation tableau de bord, sélectionnez la pile que vous avez créée et choisissez Update Stack.

  5. Pour Sélectionner un modèle, sélectionnez Télécharger un modèle sur Amazon S3, sélectionnez le modèle que vous venez de modifier, puis Next (Suivant).

  6. Sur la page Options, choisissez Next (Suivant), puis Next.

  7. Dans la page Review (Révision), passez en revue vos informations et choisissez Update (Mettre à jour).

    Après un certain temps, UPDATE_COMPLETE s'affiche.

Résolution des problèmes liés à l'installation de CloudWatch l'agent avec AWS CloudFormation

Cette section vous aide à résoudre les problèmes liés à l'installation et à la mise à jour de l' CloudWatch agent à l'aide AWS CloudFormation de.

Détection de l'échec d'une mise à jour

Si vous avez l' AWS CloudFormation habitude de mettre à jour la configuration de votre CloudWatch agent et que vous utilisez une configuration non valide, l'agent arrête d'envoyer des métriques à CloudWatch. Pour vérifier rapidement si la mise à jour de la configuration d'un agent a réussi, consultez le fichier cfn-init-cmd.log. Sur un serveur Linux, le fichier se situe à l'emplacement /var/log/cfn-init-cmd.log. Sur une instance Windows, le fichier se situe à l'emplacement C:\cfn\log\cfn-init-cmd.log.

Métriques manquantes

Si vous ne voyez pas les métriques prévues après l'installation ou la mise à jour de l'agent, vérifiez que l'agent est configuré pour collecter cette métrique. Pour cela, vérifiez le fichier amazon-cloudwatch-agent.json pour vous assurer que la métrique est répertoriée, et que vous recherchez dans le bon espace de noms de métrique. Pour de plus amples informations, veuillez consulter CloudWatch fichiers et emplacements des agents.