Installer l'agent Ops sur une seule VM

L'agent Ops collecte les journaux et les métriques sur les instances Compute Engine, puis envoie vos journaux à Cloud Logging et vos métriques à Cloud Monitoring.

Avant de commencer

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

Installer l'agent sur une seule VM

Pour installer l'agent, suivez les instructions suivantes.

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. Exécutez la commande suivante :

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

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://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.ps1", "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1")
    Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall"
    

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-google-cloud-ops-agent-repo.sh
    

    Lors de l'exécution du script add-google-cloud-ops-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.
    • --uninstall-standalone-logging-agent: désinstalle l'ancien agent Logging (StackdriverLogging).
    • --uninstall-standalone-monitoring-agent: désinstalle l'ancien agent Monitoring (StackdriverMonitoring).

    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-google-cloud-ops-agent-repo.sh --also-install \
        --version=MAJOR_VERSION.*.*
      

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

      sudo bash add-google-cloud-ops-agent-repo.sh --also-install \
        --version=1.*.*
      
    3. Pour installer une version spécifique de l'agent, exécutez la commande suivante :

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

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 systemctl status google-cloud-ops-agent"*"
    

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

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.

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

    (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.ps1", "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1")
    

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

    • -Verbose : active la journalisation détaillée lors de l'exécution du script.
    • -AlsoInstall : 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.
    • -RemoveRepo : supprime le dépôt de packages de l'agent correspondant après l'installation ou la désinstallation de l'agent.
    • -WhatIf : déclenche uniquement un test à blanc de l'exécution du script et affiche les commandes qu'il est censé exécuter.
    • -UninstallStandaloneLoggingAgent: désinstalle l'ancien agent Logging (StackdriverLogging).
    • -UninstallStandaloneMonitoringAgent: désinstalle l'ancien agent Monitoring (StackdriverMonitoring).

    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 :

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version MAJOR_VERSION.*.*"
      

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

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version 1.*.*"
      
    3. Pour installer une version spécifique de l'agent, exécutez la commande suivante :

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version version-number"
      

      Exemple :

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version 1.0.1"
      

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 :

    Get-Service google-cloud-ops-agent
    

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

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 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à):

     /etc/systemd/system.conf
    
  2. Ajoutez ce qui suit au fichier :

     DefaultEnvironment="HTTP_PROXY=http://proxy-ip:proxy-port" "HTTPS_PROXY=http://proxy-ip:proxy-port" "NO_PROXY=http://metadata.google.internal"  # Skip proxy for the local Metadata Server.
    
  3. Actualisez les variables d'environnement:

     sudo systemctl daemon-reload
    
  4. Redémarrez l'agent en exécutant la commande suivante sur votre instance de VM:

     sudo systemctl restart google-cloud-ops-agent.target
    

Windows

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

    setx HTTP_PROXY http://proxy-ip:proxy-port /m
    setx HTTPS_PROXY http://proxy-ip:proxy-port /m
    setx no_proxy metadata.google.internal /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 :

CENTOS/RHEL

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

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' \
     google-cloud-ops-agent

DEBIAN/UBUNTU

Exécutez la commande suivante sur Debian ou Ubuntu :

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

SLES/SUSE

Exécutez la commande suivante sur SUSE :

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' \
     google-cloud-ops-agent

WINDOWS

Exécutez la commande suivante sous Windows :

googet installed google-cloud-ops-agent

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 google-cloud-ops-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 google-cloud-ops-agent -Force

Mettre à jour l'agent

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

Linux

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

sudo bash add-google-cloud-ops-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-google-cloud-ops-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.*.*

Windows

Pour effectuer la mise à niveau vers la dernière version de l'agent, procédez comme suit :

  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.

    .
    Copy-Item -Path "C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml" -Destination "C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.bak"
    
  3. Exécutez les commandes PowerShell suivantes pour supprimer l'agent installé et exécuter la commande d'installation :

    googet -noconfirm remove google-cloud-ops-agent
    googet -noconfirm install google-cloud-ops-agent
    

Répertorier toutes les versions de l'agent

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

CENTOS/RHEL

Répertoriez les versions disponibles de l'agent :

sudo yum list --showduplicates google-cloud-ops-agent

DEBIAN/UBUNTU

Répertoriez les versions disponibles de l'agent :

sudo apt-cache madison google-cloud-ops-agent

SLES/SUSE

Répertoriez les versions disponibles de l'agent :

sudo zypper search -s google-cloud-ops-agent

WINDOWS

Répertoriez les versions disponibles de l'agent :

googet available google-cloud-ops-agent

Désinstaller l'agent

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

Une fois l'agent désinstallé, Google Cloud Console peut mettre jusqu'à une heure pour signaler cette modification.

Linux

Exécutez la commande suivante :

sudo bash add-google-cloud-ops-agent-repo.sh --uninstall

Windows

Pour désinstaller l'agent Ops, procédez comme suit :

  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 :

    googet -noconfirm remove google-cloud-ops-agent
    

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.

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.

Étape suivante