Résoudre les problèmes liés aux règles VM Extension Manager pour l'agent Ops

Pour diagnostiquer les problèmes liés aux règles VM Extension Manager qui gèrent l'agent Ops, utilisez les techniques de dépannage décrites dans ce document. Pour en savoir plus sur le dépannage de l'agent Ops, consultez Résoudre les problèmes liés à l'agent Ops.

Échec des commandes gcloud compute zone-vm-extension-policies

Lorsqu'une commande gcloud compute zone-vm-extension-policies échoue, la réponse inclut des suggestions de dépannage. Corrigez les erreurs dans les options ou les arguments de commande suggérés par le message d'erreur.

Si le résultat de la commande indique des autorisations IAM insuffisantes, consultez les rôles et autorisations nécessaires décrits dans Attribuer les rôles requis pour utiliser VM Extension Manager.

La règle d'extension est créée, mais l'état de l'agent Ops est "non détecté"

Vous avez créé une règle d'extension, mais l'agent Ops affiche l'état "Non détecté" sur la VM.

L'Agent Ops peut s'afficher comme "non détecté" dans les cas suivants :

  • La règle d'extension ne parvient pas à installer l'agent Ops.
  • Un agent Ops installé rencontre une condition d'erreur qui l'empêche de s'exécuter.

Les sections suivantes expliquent comment diagnostiquer ces cas.

Vérifier que l'Agent Ops a été installé par la règle

Les règles VM Extension Manager utilisent l'agent invité Compute Engine pour gérer l'agent Ops en tant qu'extension de VM.

Pour déterminer si l'agent Ops a été installé par la règle d'extension, utilisez l'une des méthodes suivantes pour rechercher les entrées de journal de l'agent invité :

Explorateur de journaux

  1. Dans la console Google Cloud , accédez à la pageExplorateur de journaux :

    Accéder à l'explorateur de journaux

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Logging.

  2. Saisissez la requête suivante, puis cliquez sur Exécuter la requête :

    log_id("GCEGuestAgentManager")

Linux

Exécutez la commande suivante sur la VM Compute Engine :

journalctl -u google-guest-agent-manager

Windows

Exécutez la commande suivante sur la VM Compute Engine :

Get-Eventlog -Source google_guest_agent_manager -LogName Application

Si vous voyez des journaux contenant une chaîne telle que Failed to install plugin "ops-agent-plugin" ... ou si la requête ne renvoie aucun journal, cela signifie que la règle d'extension n'a pas réussi à installer l'agent Ops. Pour connaître les étapes suivantes, consultez La règle d'extension ne parvient pas à installer l'agent Ops.

Si vous voyez des journaux contenant une chaîne telle que Successfully installed plugin "ops-agent_nnnnnnnn", cela signifie que la règle d'extension a bien installé l'agent Ops. Pour connaître les étapes suivantes, consultez L'agent Ops installé n'est pas détecté.

La règle d'extension ne parvient pas à installer l'agent Ops

Une règle d'extension peut être inefficace si l'une des conditions suivantes est remplie :

L'agent Ops installé est à l'état "Non détecté"

L'agent Ops peut avoir l'état "Non détecté" si l'une des conditions suivantes est remplie :

Vérifier que la configuration de l'agent Ops est valide

Vous avez fourni une configuration personnalisée à l'agent Ops en créant ou en mettant à jour une règle d'extension, mais l'état de l'agent est "non détecté". Le problème peut être dû à une erreur dans votre configuration personnalisée. Utilisez les journaux de débogage de l'agent invité pour rechercher les erreurs de configuration.

Activer la journalisation du débogage de l'agent invité

Pour en savoir plus sur l'activation de la journalisation de débogage pour l'agent invité, consultez Afficher les journaux de débogage de l'agent invité.

Examiner les journaux de débogage

Explorateur de journaux

  1. Dans la console Google Cloud , accédez à la pageExplorateur de journaux :

    Accéder à l'explorateur de journaux

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Logging.

  2. Saisissez la requête suivante, puis cliquez sur Exécuter la requête :

    severity>=DEBUG log_id("GCEGuestAgentManager") "The agent config file is not valid"

Linux

Exécutez la commande suivante sur la VM Compute Engine Linux :

journalctl -u google-guest-agent-manager | grep "The agent config file is not valid"

Windows

Exécutez la commande suivante sur la VM Compute Engine Windows :

Get-Eventlog -Source google_guest_agent_manager -LogName Application | Where-Object {$_.Message -like "*The agent config file is not valid*"}

Si vous voyez des journaux contenant la chaîne The agent config file is not valid, cela signifie que la configuration personnalisée de l'agent Ops que vous avez fournie lors de la création ou de la mise à jour de la règle d'extension n'est pas valide.

Pour résoudre ce problème, procédez comme suit :

  • Corrigez la configuration en vous reportant à Configurer l'agent Ops. Informations sur la structure d'un fichier de configuration de l'agent Ops.

  • Mettez à jour la règle d'extension avec la configuration corrigée.

Les commandes Linux systemctl status et Windows Get-Service ne fonctionnent pas avec l'agent Ops

Vous exécutez une commande telle que sudo systemctl status google-cloud-ops-agent"*", mais elle ne renvoie aucune information.

Lorsque l'agent Ops est installé et géré par VM Extension Manager, il n'est pas géré par le service de gestion du système d'exploitation, c'est-à-dire systemd sous Linux ou le gestionnaire de services Windows sous Windows.

Pour trouver les informations d'état d'un agent Ops géré par VM Extension Manager, consultez les sections suivantes :

Les commandes Linux systemctl restart et Windows Restart-Service ne fonctionnent pas avec l'agent Ops

Vous exécutez une commande telle que sudo systemctl restart google-cloud-ops-agent, mais l'agent Ops ne redémarre pas.

Lorsque l'agent Ops est installé et géré par VM Extension Manager, il n'est pas géré par le service de gestion du système d'exploitation, c'est-à-dire systemd sous Linux ou le gestionnaire de services Windows sous Windows. Par conséquent, vous ne pouvez pas arrêter ni démarrer l'agent Ops manuellement, et les commandes telles que les suivantes ne fonctionnent pas avec l'agent Ops :

  • Linux : sudo systemctl [stop|start|restart]
  • Windows : Stop-Service, Start-Service, Restart-Service

Pour arrêter ou redémarrer un agent Ops géré par VM Extension Manager, vous devez désinstaller l'agent en supprimant la règle d'extension. Pour en savoir plus sur l'arrêt ou le redémarrage de l'agent Ops, consultez Redémarrer un agent Ops installé par une règle d'extension.

Informations de dépannage supplémentaires

Pour en savoir plus sur le dépannage de la création et de l'utilisation des règles du VM Extension Manager, consultez Dépanner les extensions de VM.

Pour en savoir plus sur le dépannage de l'agent Ops, consultez Résoudre les problèmes liés à l'agent Ops.