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 :
Une instance de VM compatible dans un projet Google Cloud.
Les identifiants d'instance de VM qui autorisent la communication avec Cloud Logging et Cloud Monitoring. Les identifiants valides sont généralement configurés par défaut sur les instances de VM Compute Engine. Si vous exécutez des instances Compute Engine très anciennes ou si vous avez créé des instances Compute Engine sans identifiants par défaut, vous ne disposez peut-être pas des bons identifiants. Vous devez suivre les procédures pour autoriser l'agent Ops.
Assurez-vous d'activer les services pour l'API Cloud Logging et l'API Cloud Monitoring.
Vérifiez que ni l'ancien agent Cloud Logging, ni l'ancien agent Cloud Monitoring ne sont installés sur votre VM. Cela peut entraîner l'ingestion de journaux en doublon ou créer un conflit dans l'ingestion des métriques. De plus, cet agent utilise de nouveaux fichiers de configuration non compatibles avec les anciens agents.
Si les anciens agents sont installés, enregistrez les fichiers de configuration personnalisés pour l'agent Cloud Monitoring et les fichiers de configuration personnalisés pour l'agent Cloud Logging, puis suivez les étapes de désinstallation pour l'agent Cloud Monitoring et les étapes de désinstallation pour l'agent Cloud Logging.
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 automatiquement lors de la création de la VM
Pour en savoir plus, consultez la sectionInstaller l'Agent Ops lors de la création de la VM.
Installer l'agent à partir de la ligne de commande
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
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.Accédez à un répertoire auquel vous avez accès en écriture, par exemple votre répertoire d'accueil.
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-google-cloud-ops-agent-repo.sh sudo bash add-google-cloud-ops-agent-repo.sh --also-installUne fois installé, l'agent est démarré automatiquement.
Windows
Connectez-vous à votre instance via RDP ou un outil similaire, et connectez-vous à Windows.
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.
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
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.Accédez à un répertoire auquel vous avez accès en écriture, par exemple votre répertoire d'accueil.
Téléchargez le script d'installation de l'agent :
curl -sSO https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.shLors 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. Pour en savoir plus sur les versions, consultez Répertorier toutes les versions de l'agent.--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.
Ajoutez le dépôt de packages de l'agent et installez l'agent :
Pour répertorier les versions de l'agent disponibles, consultez Répertorier toutes les versions de l'agent.
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.*.*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"*"Vérifiez que les composants "Agent Logging" et "Agent des métriques" sont en cours d'exécution.
Si vous rencontrez des problèmes lors de l'installation, consultez la page Dépannage.
Windows
Connectez-vous à votre instance via RDP ou un outil similaire, et connectez-vous à Windows.
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.
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. Pour en savoir plus sur les versions, consultez Répertorier toutes les versions de l'agent.-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.
Ajoutez le dépôt de packages de l'agent et installez l'agent :
Pour répertorier les versions de l'agent disponibles, consultez Répertorier toutes les versions de l'agent.
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.*.*"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-agentL'agent doit être dans l'état
Running.
Si vous rencontrez des problèmes lors de l'installation, consultez la page Dépannage.
Installer l'agent à l'aide de la console Google Cloud
Vous pouvez installer l'Agent Ops sur une ou plusieurs VM Compute Engine à l'aide de la console Google Cloud depuis les pages Cloud Monitoring ou Compute Engine.
Cloud Monitoring
Dans la console Google Cloud, accédez à la page Tableau de bord des instances de VM :
Accéder au tableau de bord des instances de VM
Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.
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 rechercher la version installée . Si vous avez installé l'agent, vous pouvez le redémarrer. Si vous avez installé et démarré l'Agent Ops, mais que son état reste Non détecté, il est possible que l'agent n'ait pas démarré correctement ou qu'il ne puisse pas envoyer de métriques.
Pour résoudre les problèmes de démarrage, consultez la section L'agent est installé, mais pas en cours d'exécution. Pour résoudre les problèmes d'ingestion des métriques, consultez Résoudre les problèmes liés à l'ingestion de données. Le script de diagnostic des agents et les vérifications d'état de base peuvent également être utiles.
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.
Si l'installation de l'agent reste En attente pendant plus de 10 minutes, il peut y avoir un problème lié à l'application de la règle d'OS de l'Agent Ops ou au démarrage de l'agent. Pour en savoir plus sur le dépannage, consultez la page Outil de diagnostic de l'agent pour les règles d'installation automatique.
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.
Compute Engine
-
Dans la console Google Cloud, accédez à la page Instances de VM :
Accéder à la page Instances de VM
Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Compute Engine.
Cliquez sur le nom de la VM sur laquelle vous souhaitez installer l'agent.
Cliquez sur l'onglet Observabilité.
Cliquez sur Installer l'agent Ops.
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.
Si l'installation de l'agent reste En attente pendant plus de 10 minutes, il peut y avoir un problème lié à l'application de la règle d'OS de l'Agent Ops ou au démarrage de l'agent. Pour en savoir plus sur le dépannage, consultez la page Outil de diagnostic de l'agent pour les règles d'installation automatique.
Vérifier que l'agent Ops est en cours d'exécution
Pour vérifier que l'agent Ops est en cours d'exécution, vous pouvez utiliser l'une des méthodes suivantes :
Tableau de bord Instances de VM : ce tableau de bord vous permet d'afficher l'état d'installation de l'agent sur votre parc de VM. Toutefois, l'état peut être inexact si la VM ne dispose pas des niveaux d'accès nécessaires ou si le compte de service associé ne dispose pas de suffisamment de rôles IAM.
gcpdiag : gcpdiag fournit des informations plus fiables et plus robustes sur l'état de l'agent que le tableau de bord Instances de VM, en vérifiant à la fois l'installation des agents et la transmission de la télémétrie à partir la VM. L'utilisation de gcpdiag présente certaines conditions préalables, ce qui constitue un meilleur moyen de surveiller l'état de l'agent.
Utiliser le tableau de bord Instances de VM
Dans la console Google Cloud, accédez à la page Tableau de bord des instances de VM :
Accéder au tableau de bord des instances de VM
Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.
Vérifiez ensuite que la colonne Agent de cette VM indique l'Agent Ops.
Utiliser gcpdiag
Pour en savoir plus sur l'utilisation de gcpdiag, consultez Vérifier l'état de l'agent à l'aide de gcpdiag.
Tâches 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
Modifiez le fichier de configuration suivant (créez le fichier s'il n'existe pas déjà) :
/etc/systemd/system.confAjoutez 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.Actualisez les variables d'environnement :
sudo systemctl daemon-reloadRedémarrez l'agent en exécutant la commande suivante sur votre instance de VM.
sudo systemctl restart google-cloud-ops-agent"*"
Windows
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_PROXYetHTTPS_PROXYafin 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 metadata.google.internal /m
Déterminer la version de l'agent
Pour déterminer la version de l'agent Ops sur votre système, exécutez les commandes suivantes sur votre instance de VM :
Console Google Cloud
Pour afficher la version de votre Agent Ops sur une VM, procédez comme suit :
Recherchez l'entrée de la VM dans la table Instances de la page Instances de VM de Monitoring. Pour plus d'informations concernant la navigation, consultez la section Installer l'agent à l'aide de la console Google Cloud.
Passez la souris sur l'indicateur Agent Ops dans l'entrée de la table.
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 Ops 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 systemctl restart google-cloud-ops-agent
Windows
Connectez-vous à votre instance via RDP ou un outil similaire, et connectez-vous à Windows.
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.
Exécutez la commande PowerShell suivante :
Restart-Service google-cloud-ops-agent -Force
Mettre à niveau l'agent
Procédez comme suit pour mettre à jour l'agent Ops vers la dernière version :
Console Google Cloud
Vous pouvez mettre à niveau l'Agent Ops en suivant les instructions d'installation de Cloud Monitoring. Pour en savoir plus, consultez la section Installer l'agent à l'aide de la console Google Cloud.
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 :
Connectez-vous à votre instance via RDP ou un outil similaire, et connectez-vous à Windows.
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"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
Procédez comme suit pour supprimer l'agent Ops et ses fichiers de configuration.
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 suivante :
sudo bash add-google-cloud-ops-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
Pour désinstaller l'agent Ops, procédez comme suit :
Connectez-vous à votre instance via RDP ou un outil similaire, et connectez-vous à Windows.
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.
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 Ops 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 sont eux-mêmes accessibles à l'aide de l'accès privé à Google. Vous pouvez le configurer en suivant la procédure 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.