Installer l'agent

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

Les images de VM pour Compute Engine et AWS EC2 n'incluant pas l'agent Logging, vous devez l'installer sur ces instances. Il s'exécute sous Linux et Windows.

Avant de commencer

Vérifiez que l'agent Stackdriver Logging est compatible avec votre instance de VM et obtenez des informations sur les espaces de travail. Pour en savoir plus sur les exigences et les environnements compatibles, consultez la section À propos de l'agent Stackdriver Logging.

Instances de VM compatibles

Certains types d'instances de VM contiennent déjà l'agent Logging ou un logiciel similaire. Pour les autres, vous devez installer l'agent en suivant les instructions spécifiées sur cette page :

Une mémoire minimale de 250 Mo est requise pour l'installation de l'agent Stackdriver Logging, mais il est recommandé de disposer de 1 Go.

Facturation de Stackdriver

Si vous utilisez des instances de VM AWS, vous devez associer votre compte AWS à un espace de travail pour utiliser l'agent Stackdriver Logging.

Pour plus d'informations, consultez la rubrique Créer un 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 la règle de sécurité de votre hôte 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.

Effectuer l'installation sous Linux et Windows

Pour installer l'agent sur des instances de VM exécutant Linux ou Microsoft Windows, suivez les instructions ci-dessous.

Si vous souhaitez activer la journalisation structurée, reportez-vous aux instructions d'installation pour la journalisation structurée.

Instance Linux

  1. Ouvrez une connexion de terminal à votre instance de VM à l'aide de SSH ou d'un outil similaire.

  2. Téléchargez le script d'installation de l'agent Logging en exécutant la commande suivante sur votre instance de VM :

    curl -sSO https://dl.google.com/cloudagents/install-logging-agent.sh
    
  3. Exécutez le script d'installation avec la commande suivante :

    sudo bash install-logging-agent.sh
    

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

Instance Windows

  1. Ouvrez une connexion de terminal à votre instance à l'aide de RDP ou d'un outil similaire, et connectez-vous à Windows.

  2. Si vous utilisez un proxy HTTP, exécutez la commande suivante à partir d'une invite de commande administrateur. Cela définit la variable d'environnement https_proxy de sorte que l'agent puisse envoyer des données à Stackdriver Logging à l'aide du protocole HTTPS sortant :

    setx https_proxy https://[YOUR_PROXY_SERVER_URI] /m
    
  3. Ouvrez un terminal PowerShell, puis exécutez les trois commandes PowerShell suivantes. Vous n'avez pas besoin de droits d'administrateur.

    cd $env:UserProfile;
    Invoke-WebRequest https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-9.exe -OutFile StackdriverLogging-v1-9.exe;
    .\StackdriverLogging-v1-9.exe
    

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

    .\StackdriverLogging-v1-9.exe /S
    

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

    .\StackdriverLogging-v1-9.exe /S /D="C:\Stackdriver\Logging\"
    

Pour vérifier ou tester votre installation de l'agent Stackdriver Logging, consultez la section Vérifier l'installation de l'agent.

Si vous rencontrez des problèmes lors de l'installation, consultez la section Dépanner l'agent Logging.

Tâches supplémentaires

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 le journal des événements Windows par défaut. Si vous souhaitez ajuster la configuration de l'agent, consultez la section Configurer l'agent Logging.

Cette section décrit comment effectuer des tâches de maintenance courantes, telles que : déterminer la version de l'agent, redémarrer, mettre à niveau et désinstaller l'agent.

Déterminer la version

Pour identifier la version de l'agent Logging et de ses composants de configuration, exécutez la commande suivante :

Instance Linux

Exécutez la commande suivante sur votre instance :

# For Debian and Ubuntu systems:
dpkg-query --show --showformat \
    '${Package;-45} ${Version;-10} ${Architecture;-8} ${Status;-25}\n' \
    google-fluentd \
    google-fluentd-catch-all-config \
    google-fluentd-catch-all-config-structured

# For Amazon Linux, Red Hat, CentOS, and SUSE systems:
rpm --query --queryformat \
    '%-45{NAME} %-10{VERSION} %-10{RELEASE} %-8{ARCH}\n' \
    google-fluentd \
    google-fluentd-catch-all-config \
    google-fluentd-catch-all-config-structured

Instance Windows

Exécutez la commande suivante :

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

La commande précédente renvoie une erreur si la version de l'agent est antérieure à 1-5. Consultez la section Mettre à niveau vers l'agent le plus récent.

Redémarrer l'agent

Vous devez redémarrer l'agent Stackdriver Logging pour appliquer les modifications dans les fichiers de configuration. Pour redémarrer l'agent Stackdriver Logging, suivez les instructions suivantes.

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

Instance Windows

Droits d'administrateur requis : Pour redémarrer l'agent, exécutez les commandes suivantes sur votre instance de VM dans une invite de commande ou via PowerShell :

# For Logging agent version v1-5 and later.
net stop  StackdriverLogging
net start StackdriverLogging

# For Logging agents before v1-5.
net stop  fluentdwinsvc
net start fluentdwinsvc

Mettre à jour l'agent

Pour mettre à niveau l'agent Stackdriver Logging vers la dernière version, suivez les instructions ci-dessous :

Instance Linux

Pour effectuer la mise à niveau vers la dernière version de l'agent, exécutez la commande suivante sur votre instance :

# For Debian and Ubuntu systems:
sudo apt-get install --only-upgrade google-fluentd

# For Amazon Linux, Red Hat and CentOS systems:
sudo yum upgrade google-fluentd

# For SUSE systems:
sudo zypper update 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 :

# For Debian and Ubuntu systems:
sudo apt-get install --only-upgrade -o Dpkg::Options::="--force-confnew" google-fluentd-catch-all-config
sudo apt-get install --only-upgrade google-fluentd

# For Amazon Linux, Red Hat and CentOS systems:
sudo yum upgrade google-fluentd google-fluentd-catch-all-config

# For SUSE systems:
sudo zypper update google-fluentd google-fluentd-catch-all-config

Vous pouvez également supprimer l'agent actuel, puis installer l'agent le plus récent. Cette approche est recommandée lors de l'exécution de mises à niveau susceptibles de provoquer des modifications de la configuration (par exemple, dans le cas d'une version majeure).

Instance Windows

Pour effectuer la mise à niveau vers la dernière version de l'agent, installez l'agent le plus récent, comme décrit à la section Effectuer l'installation sous Windows. Vous êtes invité à désinstaller la version précédente de l'agent.

Désinstaller l'agent

Pour supprimer l'agent Stackdriver Logging et ses fichiers de configuration, suivez les instructions suivantes.

Instance Linux

Désinstallez l'agent Linux actuel :

# For Debian and Ubuntu systems:
sudo service google-fluentd stop
sudo apt-get remove google-fluentd google-fluentd-catch-all-config

# For Amazon Linux, Red Hat and CentOS systems:
sudo service google-fluentd stop
sudo yum remove google-fluentd google-fluentd-catch-all-config

# For SUSE systems:
sudo service google-fluentd stop
sudo zypper remove google-fluentd google-fluentd-catch-all-config

Instance Windows

Désinstallez l'agent actuel en exécutant la commande suivante :

[AGENT_INSTALLATION_DIRECTORY]\uninstall.exe

Si vous exécutez la version 1-5 de l'agent Logging ou une version ultérieure, utilisez le répertoire que vous avez choisi lors de l'installation de l'agent. Le répertoire d'installation par défaut est le suivant :

C:\Program Files (x86)\Stackdriver\LoggingAgent\

Si vous exécutez une version de l'agent Logging antérieure à la version 1-5, le répertoire d'installation est le suivant :

C:\GoogleStackdriverLoggingAgent\

Pour en savoir plus, consultez la section Configurer l'agent Logging.

Cette page vous a-t-elle été utile ? Évaluez-la :

Envoyer des commentaires concernant…

Stackdriver Logging
Besoin d'aide ? Consultez notre page d'assistance.