Fehlerbehebung bei VM Extension Manager-Richtlinien für den Ops-Agenten

Wenn Sie Probleme mit VM Extension Manager-Richtlinien diagnostizieren möchten, die den Ops-Agent verwalten, verwenden Sie die in diesem Dokument beschriebenen Techniken zur Fehlerbehebung. Informationen zur Fehlerbehebung beim Ops-Agent finden Sie unter Fehlerbehebung beim Ops-Agent.

gcloud compute zone-vm-extension-policies-Befehle schlagen fehl

Wenn ein gcloud compute zone-vm-extension-policies-Befehl fehlschlägt, enthält die Antwort Vorschläge zur Fehlerbehebung. Korrigieren Sie alle Fehler in den Befehls-Flags oder -Argumenten, die in der Fehlermeldung vorgeschlagen werden.

Wenn in der Ausgabe des Befehls unzureichende IAM-Berechtigungen erwähnt werden, prüfen Sie die erforderlichen Rollen und Berechtigungen, die unter Erforderliche Rollen für die Verwendung von VM Extension Manager gewähren beschrieben sind.

Die Erweiterungsrichtlinie wurde erstellt, aber der Status des Ops-Agent ist „Nicht erkannt“.

Sie haben eine Erweiterungsrichtlinie erstellt, aber der Ops-Agent zeigt auf der VM den Status „Nicht erkannt“ an.

Der Ops-Agent wird möglicherweise als „nicht erkannt“ angezeigt, wenn einer der folgenden Fälle eintritt:

  • Die Installation des Ops-Agent über die Erweiterungsrichtlinie schlägt fehl.
  • Bei einem installierten Ops-Agent tritt ein Fehler auf, der die Ausführung verhindert.

In den folgenden Abschnitten wird beschrieben, wie Sie diese Fälle diagnostizieren.

Prüfen, ob der Ops-Agent von der Richtlinie installiert wurde

VM Extension Manager-Richtlinien verwenden den Compute Engine-Gast-Agent, um den Ops-Agent als VM-Erweiterung zu verwalten.

Wenn Sie feststellen möchten, ob der Ops-Agent von der Erweiterungsrichtlinie installiert wurde, können Sie mit einer der folgenden Methoden nach Logeinträgen des Gast-Agents suchen:

Log-Explorer

  1. Rufen Sie in der Google Cloud Console das und die Seite Log-Explorer auf:

    Zum Log-Explorer

    Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

  2. Geben Sie die folgende Abfrage ein und klicken Sie auf Abfrage ausführen:

    log_id("GCEGuestAgentManager")

Linux

Führen Sie den folgenden Befehl auf der Compute Engine-VM aus:

journalctl -u google-guest-agent-manager

Windows

Führen Sie den folgenden Befehl auf der Compute Engine-VM aus:

Get-Eventlog -Source google_guest_agent_manager -LogName Application

Wenn Sie Logs mit einem String wie Failed to install plugin "ops-agent-plugin" ... sehen oder die Abfrage keine Logs zurückgibt, konnte die Erweiterungsrichtlinie den Ops-Agent nicht installieren. Weitere Informationen finden Sie unter Ops-Agent kann aufgrund der Erweiterungsrichtlinie nicht installiert werden.

Wenn Sie Logs mit einem String wie Successfully installed plugin "ops-agent_nnnnnnnn" sehen, wurde der Ops-Agent durch die Erweiterungsrichtlinie erfolgreich installiert. Weitere Informationen finden Sie unter Installierter Ops-Agent wird nicht erkannt.

Ops-Agent kann aufgrund der Erweiterungsrichtlinie nicht installiert werden

Eine Erweiterungsrichtlinie ist möglicherweise in folgenden Fällen unwirksam:

Installierter Ops-Agent hat den Status „Nicht erkannt“

Der Ops-Agent kann den Status „Nicht erkannt“ haben, wenn eine der folgenden Bedingungen zutrifft:

Prüfen, ob die Ops-Agent-Konfiguration gültig ist

Sie haben dem Ops-Agent eine benutzerdefinierte Konfiguration bereitgestellt, indem Sie eine Erweiterungsrichtlinie erstellt oder aktualisiert haben, aber der Agentenstatus ist „Nicht erkannt“. Das Problem könnte ein Fehler in Ihrer benutzerdefinierten Konfiguration sein. Suchen Sie in den Debugging-Logs des Gast-Agents nach Konfigurationsfehlern.

Debugging-Logging für Gast-Agent aktivieren

Informationen zum Aktivieren des Debugging-Logs für den Gast-Agent finden Sie unter Debugging-Logs für den Gast-Agent ansehen.

Debugging-Logs prüfen

Log-Explorer

  1. Rufen Sie in der Google Cloud Console das und die Seite Log-Explorer auf:

    Zum Log-Explorer

    Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

  2. Geben Sie die folgende Abfrage ein und klicken Sie auf Abfrage ausführen:

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

Linux

Führen Sie den folgenden Befehl auf der Linux-Compute Engine-VM aus:

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

Windows

Führen Sie den folgenden Befehl auf der Windows-Compute Engine-VM aus:

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

Wenn Sie Logs mit dem String The agent config file is not valid sehen, ist die benutzerdefinierte Konfiguration für den Ops-Agent, die Sie beim Erstellen oder Aktualisieren der Erweiterungsrichtlinie angegeben haben, ungültig.

So beheben Sie das Problem:

  • Korrigieren Sie die Konfiguration anhand der Informationen unter Ops-Agent konfigurieren. Informationen zur Struktur einer Ops-Agent-Konfigurationsdatei.

  • Aktualisieren Sie die Erweiterungsrichtlinie mit der korrigierten Konfiguration.

Linux-systemctl status- und Windows-Get-Service-Befehle funktionieren nicht mit dem Ops-Agenten

Sie führen einen Befehl wie sudo systemctl status google-cloud-ops-agent"*" aus, aber es werden keine Informationen zurückgegeben.

Wenn der Ops-Agent vom VM Extension Manager installiert und verwaltet wird, wird er nicht vom Systemverwaltungsdienst des Betriebssystems verwaltet, d. h. nicht von systemd unter Linux oder vom Windows Service Manager unter Windows.

So rufen Sie die Statusinformationen für einen Ops-Agenten auf, der von VM Extension Manager verwaltet wird:

Linux-systemctl restart- und Windows-Restart-Service-Befehle funktionieren nicht mit dem Ops-Agenten

Sie führen einen Befehl wie sudo systemctl restart google-cloud-ops-agent aus, aber der Ops-Agent wird nicht neu gestartet.

Wenn der Ops-Agent vom VM Extension Manager installiert und verwaltet wird, wird er nicht vom Systemverwaltungsdienst des Betriebssystems verwaltet, d. h. nicht von systemd unter Linux oder vom Windows Service Manager unter Windows. Daher können Sie den Ops-Agenten nicht manuell beenden oder starten. Befehle wie die folgenden funktionieren nicht mit dem Ops-Agenten:

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

Wenn Sie einen vom VM Extension Manager verwalteten Ops-Agent beenden oder neu starten möchten, müssen Sie den Agenten deinstallieren. Löschen Sie dazu die Erweiterungsrichtlinie. Weitere Informationen zum Beenden oder Neustarten des Ops-Agents finden Sie unter Ops-Agent neu starten, der von einer Erweiterungsrichtlinie installiert wurde.

Weitere Informationen zur Fehlerbehebung

Weitere Informationen zur Fehlerbehebung beim Erstellen und Verwenden von VM Extension Manager-Richtlinien finden Sie unter Fehlerbehebung bei VM-Erweiterungen.

Weitere Informationen zur Fehlerbehebung beim Ops-Agenten finden Sie unter Fehlerbehebung beim Ops-Agenten.