Cette page a été traduite par l'API Cloud Translation.
Switch to English

Installer l'agent Cloud Logging sur une seule VM

L'agent Logging diffuse les journaux de vos instances de VM et des packages logiciels tiers sélectionnés vers Cloud Logging. Il est recommandé d'exécuter l'agent Logging sur toutes vos instances de VM.

Les images de VM pour Compute Engine et Amazon Elastic Compute Cloud (EC2) n'incluent pas l'agent Logging. Vous devez donc suivre ces étapes pour l'installer sur ces instances. Il s'exécute sous Linux et Windows.

Si vos VM s'exécutent dans Google Kubernetes Engine ou App Engine, l'agent est déjà inclus dans l'image de la VM. Vous pouvez donc ignorer cette étape.

Si vous exécutez des charges de travail de journalisation spécialisées qui nécessitent un débit plus élevé et/ou une meilleure efficacité en termes de ressources par rapport à l'agent Cloud Logging standard, envisagez d'utiliser l'agent Ops.

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).

    • Une mémoire minimale de 250 Mio est requise pour l'installation de l'agent Logging, mais il est recommandé de disposer de 1 Gio.

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

  • Un espace de travail surveillant le compte AWS qui contient l'instance de VM. Pour en savoir plus sur la tarification, accédez à la page Tarifs de la suite des opérations Google Cloud.

  • 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 :

    • 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.

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 de connecteur AWS associé à votre compte AWS.

Le projet de connecteur AWS est créé lorsque vous associez votre compte AWS à un espace de travail. Pour identifier le projet de connecteur AWS, accédez à l'onglet Paramètres de l'espace de travail. Le projet de connecteur est répertorié sous l'en-tête AWS Accounts (Comptes AWS). La colonne ID du projet affiche les projets Google Cloud associés à votre espace de travail.

Pour plus d'informations sur les projets de connecteur AWS, consultez la page Espace de travail.

VM sans accès au package distant

L'installation de l'agent Logging requiert l'accès aux dépôts de packages distants pour le package d'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 eux-mêmes sont accessibles à l'aide de 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.

Installer l'agent sur une VM Compute Engine

Vous pouvez installer l'agent Logging sur une seule VM à partir du tableau de bord Instances de VM Monitoring préconfiguré.

Pour accéder à ce tableau de bord, procédez comme suit :

  1. Dans Cloud Console, sélectionnez votre projet Google Cloud.
    Accéder à Cloud Console
  2. Dans le volet de navigation, sélectionnez Surveillance.

    Si vous n'avez jamais utilisé Cloud Monitoring, la première fois que vous y accédez dans Google Cloud Console, un espace de travail est automatiquement créé et votre projet lui est associé. Sinon, si votre projet n'est pas associé à un espace de travail, une boîte de dialogue s'affiche. Vous pouvez soit créer un espace de travail, soit ajouter le projet à un espace de travail existant. Nous vous recommandons de créer un espace de travail. Après avoir effectué votre sélection, cliquez sur Ajouter.

  3. Dans le volet de navigation "Surveillance", sélectionnez Tableaux de bord.
  4. Dans le tableau des tableaux de bord, recherchez l'entrée Instances de VM, puis cliquez sur le nom.

L'onglet Inventaire du tableau de bord Instances de VM répertorie toutes les VM et contient une colonne d'état pour l'agent, comme illustré dans la capture d'écran suivante :

Le tableau de bord "Instances de VM" dans Monitoring indique l'état des agents.

Si l'agent n'est pas détecté sur une instance Compute Engine, vous pouvez cliquer sur le lien "Not detected" (Non détecté) pour afficher un workflow d'installation dans le tableau de bord. Vous pouvez également utiliser la technique d'installation de la ligne de commande décrite dans la section Installer l'agent sur une seule VM.

Installer l'agent sur une seule VM

Pour installer l'agent, suivez les instructions ci-après.

AMAZON LINUX AMI/CENTOS/RHEL

  1. Ouvrez une connexion de terminal à votre instance de VM à l'aide de SSH ou d'un outil similaire, et assurez-vous que vous disposez 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. Ajoutez le dépôt de packages de l'agent :

    curl -sSO https://dl.google.com/cloudagents/add-logging-agent-repo.sh
    sudo bash add-logging-agent-repo.sh
    
  4. Installez l'agent :

    1. Répertoriez les versions disponibles de l'agent afin de sélectionner la version à installer :

      sudo yum list --showduplicates google-fluentd
      
    2. Pour les environnements de production, il peut être judicieux d'épingler l'agent à une version majeure afin d'éviter de récupérer 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 yum install -y google-fluentd-major-version.*
      

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

      sudo yum install -y google-fluentd-1.*
      
    3. Si vous ne souhaitez pas épingler l'agent à une version majeure, vous pouvez sélectionner l'une des autres options d'installation :

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

          sudo yum install -y google-fluentd-version-number
        
      2. Pour installer la dernière version de l'agent, exécutez la commande suivante :

          sudo yum install -y google-fluentd
        
  5. Installez les fichiers de configuration.

    1. Pour mettre en place une journalisation non structurée, exécutez la commande suivante :

      sudo yum install -y google-fluentd-catch-all-config
      
    2. Pour mettre en place une journalisation structurée, exécutez la commande suivante :

      sudo yum install -y google-fluentd-catch-all-config-structured
      

      Pour en savoir plus sur la journalisation structurée, consultez le guide de Journalisation structurée.

  6. Redémarrez le service de l'agent.

    Un redémarrage est nécessaire pour que les configurations installées par les packages collecteurs ci-dessus prennent effet.

    sudo service google-fluentd restart
    

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 google-fluentd 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 :

    tail /var/log/google-fluentd/google-fluentd.log
    

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

DEBIAN/UBUNTU

  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. Ajoutez le dépôt de packages de l'agent :

    curl -sSO https://dl.google.com/cloudagents/add-logging-agent-repo.sh
    sudo bash add-logging-agent-repo.sh
    sudo apt-get update
    
  4. Installez l'agent :

    1. Répertoriez les versions disponibles de l'agent afin de sélectionner la version à installer :

      sudo apt-cache madison google-fluentd
      
    2. Pour les environnements de production, il peut être judicieux d'épingler l'agent à une version majeure afin d'éviter de récupérer 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 apt-get install -y 'google-fluentd=major-version.*'
      

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

      sudo apt-get install -y 'google-fluentd=1.*'
      
    3. Si vous ne souhaitez pas épingler l'agent à une version majeure, vous pouvez sélectionner l'une des autres options d'installation :

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

          sudo apt-get install -y google-fluentd=version-number
        
      2. Pour installer la dernière version de l'agent, exécutez la commande suivante :

          sudo apt-get install google-fluentd
        
  5. Installez les fichiers de configuration.

    1. Pour mettre en place une journalisation non structurée, exécutez la commande suivante :

      sudo apt-get install -y google-fluentd-catch-all-config
      
    2. Pour mettre en place une journalisation structurée, exécutez la commande suivante :

      sudo apt-get install -y google-fluentd-catch-all-config-structured
      

      Pour en savoir plus sur la journalisation structurée, consultez le guide de Journalisation structurée.

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

    sudo service google-fluentd 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 google-fluentd 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 :

    tail /var/log/google-fluentd/google-fluentd.log
    

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

SLES/SUSE

  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. Ajoutez le dépôt de packages de l'agent :

    curl -sSO https://dl.google.com/cloudagents/add-logging-agent-repo.sh
    sudo bash add-logging-agent-repo.sh
    
  4. Installez l'agent :

    1. Répertoriez les versions disponibles de l'agent afin de sélectionner la version à installer :

      sudo zypper search -s google-fluentd
      
    2. Pour les environnements de production, il peut être judicieux d'épingler l'agent à une version majeure afin d'éviter de récupérer 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 zypper install -y 'google-fluentd<major-version.0.0'
      

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

      sudo zypper install -y 'google-fluentd<2.0.0'
      
    3. Si vous ne souhaitez pas épingler l'agent à une version majeure, vous pouvez sélectionner l'une des autres options d'installation :

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

          sudo zypper install -y google-fluentd=version-number
        
      2. Pour installer la dernière version de l'agent, exécutez la commande suivante :

          sudo zypper install google-fluentd
        
  5. Installez les fichiers de configuration.

    1. Pour mettre en place une journalisation non structurée, exécutez la commande suivante :

      sudo zypper install -y google-fluentd-catch-all-config
      
    2. Pour mettre en place une journalisation structurée, exécutez la commande suivante :

      sudo zypper install -y google-fluentd-catch-all-config-structured
      

      Pour en savoir plus sur la journalisation structurée, consultez le guide de Journalisation structurée.

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

    sudo service google-fluentd 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 google-fluentd 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 :

    tail /var/log/google-fluentd/google-fluentd.log
    

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

WINDOWS

Procédez comme suit pour installer l'agent sur une instance de VM exécutant Windows :

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

  2. Ouvrez un terminal PowerShell, puis exécutez les commandes PowerShell suivantes. Vous n'avez pas besoin de droits d'administrateur.

    (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-13.exe", "${env:UserProfile}\StackdriverLogging-v1-13.exe")
    & "${env:UserProfile}\StackdriverLogging-v1-13.exe"
    

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

    https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-13.exe

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

    .\StackdriverLogging-v1-13.exe /S
    

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

    .\StackdriverLogging-v1-13.exe /S /D="C:\Google Cloud's operations suite\Logging\"
    

    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.

Opérations facultatives

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

Configurer l'agent

L'agent est préconfiguré pour surveiller certains emplacements de journaux connus. Sous Linux, ces emplacements sont décrits dans le package google-fluentd-catch-all-config, qui est automatiquement extrait par le script d'installation. Sous Windows, l'agent surveille par défaut le journal des événements Windows. Si vous souhaitez ajuster la configuration de l'agent, consultez la section Configurer l'agent Logging.

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 s'il n'existe pas) :

     /etc/default/google-fluentd
    
  2. Ajoutez les lignes suivantes :

     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 Logging en exécutant la commande suivante sur votre instance de VM.

     sudo service google-fluentd 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 à Logging à 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 Logging 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' \
     google-fluentd 
google-fluentd-catch-all-config
google-fluentd-catch-all-config-structured

Debian/Ubuntu

Exécutez la commande suivante sur Debian ou Ubuntu :

dpkg-query --show --showformat \
    '${Package} ${Version} ${Architecture} ${Status}\n' \
     google-fluentd 
google-fluentd-catch-all-config
google-fluentd-catch-all-config-structured

SLES/SUSE

Exécutez la commande suivante sur SUSE :

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' \
     google-fluentd 
google-fluentd-catch-all-config
google-fluentd-catch-all-config-structured

WINDOWS

Exécutez la commande suivante sous Windows :

reg query HKLM\Software\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall\GoogleStackdriverLoggingAgent\ /v Version

Redémarrer l'agent

Vous devez redémarrer l'agent Logging 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 google-fluentd restart

Après avoir redémarré l'agent Logging, vous pouvez envoyer un message de test.

WINDOWS

Droits d'administrateur requis : pour redémarrer l'agent, exécutez la commande suivante dans un terminal PowerShell :

Restart-Service -Name StackdriverLogging

Mettre à jour l'agent

Procédez comme suit pour mettre à jour l'agent Logging vers la dernière version :

AMAZON LINUX AMI/CENTOS/RHEL

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

sudo yum upgrade google-fluentd

La commande précédente ne modifie pas le fichier de configuration de l'agent. Pour obtenir la dernière configuration par défaut et les derniers fichiers de configuration "catch-all", exécutez les commandes suivantes sur votre instance :

sudo yum upgrade google-fluentd google-fluentd-catch-all-config

Debian/Ubuntu

Exécutez les commandes suivantes sur Debian ou Ubuntu :

sudo apt-get update
sudo apt-get install --only-upgrade google-fluentd

Les commandes précédentes ne modifient pas le fichier de configuration de l'agent. Pour obtenir la dernière configuration par défaut et les derniers fichiers de configuration "catch-all", exécutez les commandes suivantes sur votre instance :

sudo apt-get install --only-upgrade -o Dpkg::Options::="--force-confnew" google-fluentd-catch-all-config
sudo apt-get install --only-upgrade google-fluentd

SLES/SUSE

Exécutez la commande suivante sur SUSE :

sudo zypper update google-fluentd

La commande précédente ne modifie pas le fichier de configuration de l'agent. Pour obtenir la dernière configuration par défaut et les derniers fichiers de configuration "catch-all", exécutez les commandes suivantes sur votre instance :

sudo zypper update google-fluentd google-fluentd-catch-all-config

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 Linux et Windows. Le programme d'installation vous invite à désinstaller la version précédente de l'agent.

Désinstaller l'agent

Procédez comme suit pour supprimer l'agent Logging et ses fichiers de configuration.

AMAZON LINUX AMI/CENTOS/RHEL

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

sudo service google-fluentd stop
sudo yum remove google-fluentd google-fluentd-catch-all-config

Debian/Ubuntu

Exécutez la commande suivante sur Debian ou Ubuntu :

sudo service google-fluentd stop
sudo apt-get remove google-fluentd google-fluentd-catch-all-config

SLES/SUSE

Exécutez la commande suivante sur SUSE Linux :

sudo service google-fluentd stop
sudo zypper remove google-fluentd google-fluentd-catch-all-config

WINDOWS

Dans le panneau de configuration de Windows, sélectionnez Désinstaller un programme. L'agent Logging doit apparaître dans la liste des programmes que vous pouvez désinstaller.