Installer l'agent Cloud Monitoring sur des VM individuelles

Il s'agit d'un ancien agent. Bien que cet agent soit toujours compatible avec Linux, nous vous déconseillons de l'utiliser pour les nouvelles charges de travail Google Cloud.

Nous vous recommandons plutôt d'utiliser l'Agent Ops pour les nouvelles charges de travail Google Cloud, puis de migrer vos VM Compute Engine existantes afin qu'elles utilisent l'Agent Ops. L'Agent Ops, qui combine la collecte de métriques et la journalisation dans un seul agent, remplace à terme les agents existants.

L'Agent Ops est en cours de développement actif, mais il peut arriver qu'il ne soit pas compatible. Si l'Agent Ops n'est pas compatible avec votre cas d'utilisation, vous pouvez toujours utiliser l'agent Monitoring sous Linux.

L'ancien agent Monitoring ne permet pas de développer de nouvelles fonctionnalités ni de prendre en charge de nouveaux systèmes d'exploitation.

Nous vous déconseillons vivement d'utiliser l'ancien agent Monitoring sous Windows. L'ancien agent Monitoring sous Windows n'est pas compatible et toutes ses fonctionnalités sont disponibles dans l'Agent Ops. Nous vous recommandons vivement d'utiliser l'Agent Ops pour surveiller les instances Windows. Toutefois, si vous devez exécuter l'ancien agent Logging sous Windows et collecter des métriques, vous devez utiliser l'ancien agent Monitoring. Vous ne pouvez pas exécuter l'Agent Ops et un ancien agent sur la même machine.

L'agent Cloud Monitoring collecte des métriques du système et des applications à partir de vos instances de VM, puis les envoie à Monitoring. Vous pouvez également configurer l'agent de surveillance pour surveiller les applications tierces.

Ce guide explique comment installer l'agent Cloud Monitoring sur les VM Compute Engine et Amazon Elastic Compute Cloud (EC2) pour assurer leur surveillance. L'utilisation de cet agent n'est pas obligatoire pour les instances de VM Compute Engine, mais elle est recommandée. Même sans cet agent, Monitoring peut accéder à certaines métriques de l'hyperviseur de VM de Compute Engine, telles que celles concernant l'utilisation du processeur, le trafic disque, le trafic réseau et la disponibilité. Par contre, pour les VM Amazon Elastic Compute Cloud (EC2), l'utilisation de l'agent est obligatoire.

Sur les instances exécutant Microsoft Windows, l'agent enregistre des données relatives à l'utilisation du processeur et à la mémoire, au fichier d'échange et à l'utilisation du volume. Si vous exécutez IIS ou SQL Server, l'agent collecte par défaut les métriques de ces services.

Remarque : L'agent Cloud Monitoring est conçu pour ingérer des métriques de télémétrie système, tierces, définies par l'utilisateur et d'agent. Certaines de ces métriques sont payantes. Pour en savoir plus sur les tarifs, consultez la section Tarifs de Monitoring.

Avant de commencer

Pour installer l'agent, assurez-vous de disposer des éléments suivants :

• Une instance de VM compatible dans un projet Google Cloud ou un compte Amazon Web Services (AWS).

  • Un minimum de 250 Mio de mémoire résidente (RSS) est recommandé pour exécuter l'agent Monitoring.

  Vérifiez également que votre VM utilise un système d'exploitation compatible.

• Les identifiants d'instance de VM qui autorisent la communication avec Cloud Logging ou Cloud Monitoring. Les identifiants valides sont généralement configurés par défaut sur les instances de VM Compute Engine. Si vous vous trouvez dans l'une des situations suivantes, il se peut que vous ne disposiez pas des identifiants corrects. Vous devez donc suivre les procédures décrites sur la page Autoriser l'agent Monitoring :

  • Vous exécutez des instances de VM AWS EC2 : vous devez installer les identifiants d'autorisation sur vos VM avant d'installer l'agent.

  • Vous exécutez des instances Compute Engine très anciennes ou des instances Compute Engine créées sans les identifiants par défaut.

  Pour vérifier si vous disposez des identifiants corrects, exécutez les procédures décrites à la section Valider les identifiants Compute Engine.

• Pour les utilisateurs d'AWS, procédez comme suit :

  1. Connectez votre compte AWS à Google Cloud. Pour en savoir plus sur ce processus, consultez la section Collecter des métriques à partir de comptes AWS.

     Remarque : Lorsque vous connectez votre compte AWS à Google Cloud, vous créez un projet AWS Connector. Pour faciliter l'identification de ces projets, nous vous recommandons de respecter une convention de nommage pour vos projets AWS Connector.

  2. Pour en savoir plus, consultez la section Projets Google Cloud pour les instances de VM AWS EC2.

• Pour en savoir plus sur la tarification, consultez la page Tarifs de l'observabilité Google Cloud.

• Si vous utilisez des VM qui n'ont pas accès aux dépôts de packages distants, consultez la section VM sans accès au package distant pour plus d'informations.

Installer l'agent à partir de la ligne de commande

Remarque : Vérifiez d'abord que toutes les conditions sont remplies dans la section Avant de commencer.

Procédez comme suit pour installer l'agent à l'aide de la ligne de commande.

Installer la dernière version de l'agent

Pour installer la dernière version de l'agent, procédez comme suit :

Linux

1. Ouvrez une connexion de terminal à votre instance de VM à l'aide de SSH ou d'un outil similaire, et assurez-vous de disposer d'un accès sudo.

2. Accédez à un répertoire auquel vous avez accès en écriture, par exemple votre répertoire d'accueil.

3. Téléchargez et exécutez le script d'installation de l'agent à l'aide des commandes suivantes :

   curl -sSO https://dl.google.com/cloudagents/add-monitoring-agent-repo.sh
   sudo bash add-monitoring-agent-repo.sh --also-install
   

   Une fois installé, l'agent est démarré automatiquement.

Windows

1. Connectez-vous à votre instance via RDP ou un outil similaire, et connectez-vous à Windows.

2. Ouvrez un terminal PowerShell avec des droits d'administrateur en effectuant un clic droit sur l'icône PowerShell, puis en sélectionnant Exécuter en tant qu'administrateur.

3. Exécutez les commandes PowerShell suivantes :

   (New-Object Net.WebClient).DownloadFile("https://repo.stackdriver.com/windows/StackdriverMonitoring-GCM-46.exe", "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe")
   & "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe"
   

Installer une version spécifique de l'agent

Pour installer une version spécifique de l'agent, procédez comme suit :

Linux

1. Ouvrez une connexion de terminal à votre instance de VM à l'aide de SSH ou d'un outil similaire, et assurez-vous de disposer d'un accès sudo.

2. Accédez à un répertoire auquel vous avez accès en écriture, par exemple votre répertoire d'accueil.

3. Téléchargez le script d'installation de l'agent :

   curl -sSO https://dl.google.com/cloudagents/add-monitoring-agent-repo.sh
   

   Lors de l'exécution du script add-monitoring-agent-repo.sh, vous pouvez également définir les options suivantes :

   • --verbose : active la journalisation détaillée lors de l'exécution du script.
   • --also-install : installe l'agent après l'ajout du dépôt de packages de l'agent.
   • --version : définit la version de l'agent que le script doit installer.
   • --uninstall : désinstalle l'agent.
   • --remove-repo : supprime le dépôt de packages de l'agent correspondant après l'installation ou la désinstallation de l'agent.
   • --dry-run : déclenche uniquement un test à blanc de l'exécution du script et affiche les commandes qu'il est censé exécuter.

   Consultez les commentaires sur le script pour en savoir plus et obtenir des exemples d'utilisation.

4. Ajoutez le dépôt de packages de l'agent et installez l'agent :

   1. Pour répertorier les versions de l'agent disponibles afin de sélectionner la version à installer, consultez la section Répertorier toutes les versions de l'agent.

   2. Pour les environnements de production, il peut être judicieux d'épingler l'agent à une version majeure afin d'éviter d'installer des versions majeures susceptibles d'inclure des modifications incompatibles avec les versions antérieures. Pour épingler l'agent à une version majeure, exécutez la commande suivante :

      sudo bash add-monitoring-agent-repo.sh --also-install \
        --version=MAJOR_VERSION.*.*
      

      Par exemple, pour épingler à la version 6.xx de l'agent, exécutez la commande suivante :

      sudo bash add-monitoring-agent-repo.sh --also-install \
        --version=6.*.*
      

   3. Pour installer une version spécifique de l'agent, exécutez la commande suivante :

      sudo bash add-monitoring-agent-repo.sh --also-install \
        --version=MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION
      

5. Démarrez le service de l'agent :

   sudo service stackdriver-agent start
   

Vous pouvez supprimer le script d'installation après son exécution.

• Pour vérifier que l'agent fonctionne comme prévu, exécutez la commande suivante :

  sudo service stackdriver-agent status
  

  L'agent doit être dans l'état OK.

• Vous pouvez également examiner les journaux et vous assurer qu'il n'y a pas d'erreurs :

  sudo grep collectd /var/log/{syslog,messages} | tail
  

Si vous rencontrez des problèmes lors de l'installation, consultez la page Dépannage.

Windows

1. Connectez-vous à votre instance via RDP ou un outil similaire, et connectez-vous à Windows.

2. Ouvrez un terminal PowerShell avec des droits d'administrateur en effectuant un clic droit sur l'icône PowerShell, puis en sélectionnant Exécuter en tant qu'administrateur.

   Remarque : Seule la dernière version de l'agent est compatible avec les instances de VM exécutant Windows. Il est déconseillé d'installer des versions précédentes.

   1. Exécutez les commandes PowerShell suivantes :

      (New-Object Net.WebClient).DownloadFile("https://repo.stackdriver.com/windows/StackdriverMonitoring-GCM-46.exe", "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe")
      & "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe"
      

   Vous pouvez également accéder à l'URL suivante pour télécharger et exécuter le programme d'installation de l'agent :

   https://repo.stackdriver.com/windows/StackdriverMonitoring-GCM-46.exe

   Attention : Vous devez télécharger le programme d'installation dans un répertoire autre qu'un répertoire système, tel que C:\Users\[USERNAME]. Pour des raisons de sécurité, le programme d'installation ne s'exécute pas à partir des répertoires système, y compris le répertoire C:\.
   Si vous téléchargez le programme d'installation dans un répertoire système, déplacez-le vers un autre répertoire avant de l'exécuter.
   Remarque : Le programme d'installation de l'agent est également compatible avec une option "silencieuse", (/S), qui peut être utilisée dans le script d'installation.

   Pour installer l'agent en mode silencieux, ajoutez l'option /S à l'appel du programme d'installation :

   & "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe" /S
   

   Attention : L'installation silencieuse est une opération asynchrone. Lorsque la commande d'installation se ferme, l'agent n'est pas encore installé. Pour vérifier si l'installation a réussi, recherchez le service StackdriverMonitoring.
   Remarque : Le programme d'installation place l'agent dans le répertoire C:\Program Files (x86)\Stackdriver\MonitoringAgent par défaut. Vous pouvez modifier ce répertoire pendant l'installation.

   En mode "silencieux", utilisez l'option /D pour spécifier le répertoire d'installation, par exemple :

   & "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe" /S /D="C:\Stackdriver\Monitoring\"
   

   Vous pouvez supprimer le programme d'installation une fois terminé.

   Si vous rencontrez des problèmes lors de l'installation, consultez la page Dépannage.

Afficher les informations sur l'agent à l'aide de la console Google Cloud

Vous pouvez trouver des informations sur l'état de l'agent dans le tableau de bord des instances de VM Monitoring préconfiguré. Pour accéder à ce tableau de bord, procédez comme suit :

Dans le panneau de navigation de la console Google Cloud, sélectionnez Monitoring, sélectionnez  Tableaux de bord, puis Instances de VM :

Accéder au tableau de bord des instances de VM

La vue Liste de l'onglet Inventaire du tableau de bord répertorie toutes les VM et inclut une colonne concernant l'état de votre agent, comme illustré dans la capture d'écran suivante :

La colonne Agent indique les valeurs suivantes :

• Non détecté : vous n'avez pas installé d'agent ou il n'est pas en cours d'exécution. Si vous n'êtes pas sûr d'avoir installé un agent, vous pouvez interroger la version installée. Si vous avez installé l'agent, vous pouvez le redémarrer.

• Agent Ops : vous exécutez l'Agent Ops. Si vous ne voyez pas de coche verte à côté de l'entrée, cela signifie qu'une mise à niveau de l'agent est disponible, en fonction du système d'exploitation détecté sur votre VM.

  Lorsque vous passez la souris sur l'indicateur de l'agent Ops dans la table, des informations concernant la version de l'agent Ops s'affichent. Si vous exécutez une ancienne version, une recommandation de mise à niveau s'affiche également.

• En attente : l'agent Ops est en cours d'installation ou de mise à jour.

• Ancien agent : vous exécutez l'ancien agent Monitoring ou Logging. Consultez la section Migrer des anciens agents vers l'agent Ops pour en savoir plus sur la transition vers l'agent Ops.

• Non applicable : cette VM n'est pas une plate-forme compatible pour l'exécution de l'agent.

• Inconnu : la VM n'est pas en cours d'exécution. L'état de l'agent n'est donc pas connu.

Pour installer l'Agent Ops, procédez comme suit :

• Sélectionnez les instances de VM sur lesquelles vous souhaitez installer les agents.
• Cliquez sur l'option Installer/Mettre à jour l'Agent Ops dans la table Instances.

Vous pouvez également installer ou mettre à jour l'Agent Ops à partir de la page Informations sur la VM d'une VM spécifique.

Si possible, l'agent est installé à l'aide d'une règle d'OS de l'Agent Ops. Pour en savoir plus, consultez la section Gérer les versions de l'Agent Ops sur les VM couvertes par la règle d'OS de l'Agent Ops. Les règles d'OS de l'Agent Ops ne sont pas compatibles avec toutes les versions de tous les systèmes d'exploitation. Dans ce cas, lorsque vous cliquez sur Installer/Mettre à jour l'Agent Ops, une série de commandes s'affiche pour s'exécuter dans Cloud Shell.

Par défaut, l'agent Ops collecte les métriques et les journaux. Vous pouvez modifier ce comportement par défaut en configurant l'Agent Ops.

Tâches facultatives

Cette section décrit comment effectuer des tâches de maintenance courantes.

Configurer l'agent Monitoring

Pour ajuster la configuration de l'agent, consultez la section Configurer l'agent Monitoring.

Configurer un proxy HTTP

Si vous faites transiter les requêtes aux API Logging et Monitoring à travers un proxy HTTP, procédez comme suit :

Linux

1. Modifiez le fichier de configuration suivant (créez le fichier s'il n'existe pas déjà) :

   • Pour les versions d'agent 6.0.0 et ultérieures, modifiez :

     /etc/default/stackdriver-agent
     

   • Pour les versions d'agent antérieures à 6.0.0, modifiez le fichier approprié pour votre système d'exploitation :

     Pour Debian et Ubuntu, modifiez :

     /etc/default/stackdriver-agent
     

     Pour CentOS et SLES, modifiez :

     /etc/default/stackdriver-collectd
     

     Remarque : Si ce fichier n'existe pas, créez-le.

2. Ajoutez ce qui suit au fichier :

    export http_proxy="http://proxy-ip:proxy-port"
    export https_proxy="http://proxy-ip:proxy-port"
    export no_proxy=169.254.169.254  # Skip proxy for the local Metadata Server.
   

3. Redémarrez l'agent en exécutant la commande suivante sur votre instance de VM.

    sudo service stackdriver-agent restart
   

Windows

1. Si vous utilisez un proxy HTTP, exécutez la commande suivante à partir d'une invite de commande administrateur. Cela permet de définir les variables d'environnement HTTP_PROXY et HTTPS_PROXY afin que l'agent puisse envoyer des données à l'aide du protocole HTTPS sortant :

   setx HTTP_PROXY http://proxy-ip:proxy-port /m
   setx HTTPS_PROXY http://proxy-ip:proxy-port /m
   setx no_proxy 169.254.169.254 /m
   

Déterminer la version de l'agent

Pour déterminer la version de l'agent Monitoring sur votre système, exécutez les commandes suivantes sur votre instance de VM :

AMAZON LINUX AMI/CENTOS/RHEL

Exécutez la commande suivante sur Amazon Linux, Red Hat ou CentOS Linux :

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' stackdriver-agent

Debian/Ubuntu

Exécutez la commande suivante sur Debian ou Ubuntu :

dpkg-query --show --showformat '${Package} ${Version} ${Architecture} ${Status}\n' stackdriver-agent

SLES/SUSE

Exécutez la commande suivante sur SUSE :

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' stackdriver-agent

WINDOWS

Il n'existe actuellement aucun moyen de déterminer la version de l'agent de surveillance exécutée sous Windows.

Redémarrer l'agent

Vous devez redémarrer l'agent de surveillance pour appliquer les modifications dans les fichiers de configuration. Suivez pour ce faire les instructions suivantes.

LINUX

Exécutez la commande suivante sur votre instance :

     sudo service stackdriver-agent restart

Windows

1. Connectez-vous à votre instance via RDP ou un outil similaire, et connectez-vous à Windows.

2. Ouvrez un terminal PowerShell avec des droits d'administrateur en effectuant un clic droit sur l'icône PowerShell, puis en sélectionnant Exécuter en tant qu'administrateur.

3. Exécutez la commande PowerShell suivante :

Restart-Service -Name StackdriverMonitoring

Mettre à jour l'agent

Pour mettre à jour l'agent de surveillance vers la dernière version, suivez les instructions ci-dessous :

Remarque :Si vous avez mis à niveau le système d'exploitation Linux de votre instance vers une nouvelle version majeure, vous devez d'abord supprimer l'agent, puis le réinstaller en suivant les procédures décrites sur cette page, au lieu d'effectuer ces procédures de mise à niveau.

Linux

Pour mettre à niveau l'agent vers la dernière version, exécutez la commande suivante :

sudo bash add-monitoring-agent-repo.sh --also-install

Pour mettre à niveau l'agent vers la version la plus récente d'une version majeure spécifique, exécutez la commande suivante :

sudo bash add-monitoring-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.*.*

Windows

Pour effectuer la mise à niveau vers la dernière version de l'agent, installez l'agent le plus récent, comme décrit sur cette page à la section Effectuer l'installation sous Windows. Le programme d'installation vous invite à désinstaller la version précédente de l'agent.

Répertorier toutes les versions de l'agent

Pour répertorier les versions disponibles de l'agent, exécutez la commande suivante :

AMAZON LINUX AMI/CENTOS/RHEL

Répertoriez les versions disponibles de l'agent :

sudo yum list --showduplicates stackdriver-agent

DEBIAN/UBUNTU

Répertoriez les versions disponibles de l'agent :

sudo apt-cache madison stackdriver-agent

SLES/SUSE

Répertoriez les versions disponibles de l'agent :

sudo zypper search -s stackdriver-agent

WINDOWS

Il n'est pas possible d'installer des versions antérieures de l'agent sous Windows.

Désinstaller l'agent

Pour supprimer l'agent de surveillance et ses fichiers de configuration, suivez les instructions ci-après.

Une fois que vous avez désinstallé l'agent, un délai d'une heure peut être nécessaire pour que Google Cloud Console signale cette modification.

Linux

Exécutez la commande ci-dessous.

sudo bash add-monitoring-agent-repo.sh --uninstall

Pour supprimer le dépôt en plus de désinstaller l'agent (facultatif), ajoutez --remove-repo à la commande précédente.

Windows

Dans le panneau de configuration de Windows, sélectionnez Désinstaller un programme. L'agent de surveillance doit figurer dans la liste des programmes que vous pouvez désinstaller. Vous pouvez également exécuter uninstall.exe à partir du répertoire dans lequel vous avez installé l'agent Monitoring.

Informations sur les projets Google Cloud pour les instances de VM AWS EC2

Lorsque la documentation fait référence au projet Google Cloud associé à votre instance de VM, pour les instances de VM EC2, cette expression fait référence au projet AWS Connector associé à votre compte AWS.

Lorsque vous associez votre compte AWS à un projet Google Cloud, vous créez un projet AWS Connector. Pour en savoir plus sur ce processus, consultez la section Collecter des métriques à partir de comptes AWS.

Pour accéder au projet AWS Connector pour un compte AWS, effectuez l'une des opérations suivantes :

• Utilisez le sélecteur de projet de la console Google Cloud pour identifier les projets correspondant aux conventions de nommage de votre projet AWS Connector, puis sélectionnez le projet spécifique pour votre compte AWS.

• Identifiez le projet Google Cloud dont le champ d'application des métriques inclut les métriques de votre compte AWS, puis sélectionnez ce projet dans le sélecteur de projet de la console Google Cloud. Pour ce projet Google Cloud, accédez à la page Surveillance, puis sélectionnez la page Paramètres. La page Paramètres répertorie les projets AWS Connector. Vous pouvez accéder au projet AWS Connector à l'aide du sélecteur de projet de la console Google Cloud.

Remarque : N'installez pas l'agent sur une instance de VM EC2 avant d'avoir connecté votre compte AWS à Google Cloud. Tant que la connexion n'est pas établie, il n'existe aucun projet Google Cloud associé et, par conséquent, aucun emplacement auquel envoyer des données.

VM sans accès au package distant

L'installation de l'agent de surveillance requiert l'accès à des dépôts de packages distants, à la fois pour le package de l'agent et (sous Linux) pour ses dépendances.

Si vous utilisez VPC-SC ou un réseau privé, la configuration réseau peut également affecter votre capacité à installer des dépendances d'agent à partir de dépôts en amont. Les packages de l'agent sont eux-mêmes accessibles à l'aide de l'accès privé à Google. Pour la configurer, suivez les instructions de la section Activer l'accès privé à Google.

Si la règle de sécurité de votre hôte de VM interdit l'accès aux dépôts de packages distants, nous vous recommandons de créer une image de VM personnalisée avec l'agent préinstallé et de désactiver la gestion des packages dans cette image.