Risolvi i problemi relativi alle policy di Gestore di estensioni VM per Ops Agent

Per diagnosticare i problemi relativi alle policy di Gestore di estensioni VM che gestiscono Ops Agent, utilizza le tecniche di risoluzione dei problemi descritte in questo documento. Per informazioni sulla risoluzione dei problemi relativi a Ops Agent, consulta Risolvi i problemi relativi a Ops Agent.

gcloud compute zone-vm-extension-policies comandi non riusciti

Quando un comando gcloud compute zone-vm-extension-policies non va a buon fine, la risposta include suggerimenti per la risoluzione dei problemi. Correggi eventuali errori nei flag o negli argomenti del comando suggeriti dal messaggio di errore.

Se l'output del comando indica autorizzazioni IAM insufficienti, esamina i ruoli e le autorizzazioni necessari descritti in Concedi i ruoli richiesti per utilizzare il gestore di estensioni VM.

La policy di estensione viene creata, ma lo stato di Ops Agent è "Non rilevato"

Hai creato correttamente una policy di estensione, ma Ops Agent mostra lo stato "non rilevato" sulla VM.

Ops Agent potrebbe essere visualizzato come "non rilevato" se si verifica una delle seguenti condizioni:

  • La policy di estensione non riesce a installare Ops Agent.
  • Un Ops Agent installato rileva una condizione di errore che ne impedisce l'esecuzione.

Le sezioni seguenti descrivono come diagnosticare questi casi.

Verifica che Ops Agent sia stato installato dalla policy

Le policy di gestore di estensioni VM utilizzano l'agente guest di Compute Engine per gestire Ops Agent come estensione VM.

Per determinare se Ops Agent è stato installato dalla policy di estensione, utilizza uno dei seguenti metodi per cercare le voci di log dell'agente guest:

Esplora log

  1. Nella console Google Cloud , vai alla pagina Esplora log:

    Vai a Esplora log

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.

  2. Inserisci la seguente query e fai clic su Esegui query:

    log_id("GCEGuestAgentManager")

Linux

Esegui questo comando sulla VM di Compute Engine:

journalctl -u google-guest-agent-manager

Windows

Esegui questo comando sulla VM di Compute Engine:

Get-Eventlog -Source google_guest_agent_manager -LogName Application

Se vedi log contenenti una stringa come Failed to install plugin "ops-agent-plugin" ... o se la query non restituisce log, significa che la policy delle estensioni non è riuscita a installare Ops Agent. Per i passaggi successivi, consulta La policy delle estensioni non riesce a installare Ops Agent.

Se vedi log contenenti una stringa come Successfully installed plugin "ops-agent_nnnnnnnn", significa che la policy delle estensioni ha installato correttamente Ops Agent. Per i passaggi successivi, consulta Ops Agent installato "non rilevato".

La policy di estensione non riesce a installare Ops Agent

Una policy di estensione potrebbe non essere efficace se si verifica una delle seguenti condizioni:

  • L'agente guest non è installato sulla VM. Per diagnosticare e risolvere questa condizione, segui questi passaggi:

    1. Verifica che la VM utilizzi uno dei sistemi operativi supportati per l'ambiente guest di Compute Engine.

    2. Visualizza i pacchetti installati sulla VM per verificare che google-guest-agent sia incluso.

    3. Se google-guest-agent non è installato, installa l'agente guest.

  • L'agente guest è installato, ma non è aggiornato. Per diagnosticare e risolvere questa condizione, segui questi passaggi:

    1. Convalida l'ambiente guest per determinare la versione del pacchetto google-guest-agent. Il gestore di estensioni VM richiede la versione 20241209.01 o una versione successiva.

    2. Se la versione di google-guest-agent è precedente alla 20241209.01, aggiorna l'ambiente guest.

  • Il sistema operativo della VM non è supportato dal gestore di estensioni VM. Per saperne di più, consulta Esamina i sistemi operativi supportati.

Ops Agent installato ha lo stato "Non rilevato"

Ops Agent può avere lo stato "Non rilevato" se si verifica una delle seguenti condizioni:

Verifica che la configurazione di Ops Agent sia valida

Hai fornito una configurazione personalizzata a Ops Agent creando o aggiornando una policy di estensione, ma lo stato dell'agente è "non rilevato". Il problema potrebbe essere un errore nella configurazione personalizzata. Utilizza i log di debug dell'agente guest per cercare errori di configurazione.

Attiva il logging di debug dell'agente guest

Per informazioni sull'attivazione del log di debug per l'agente guest, consulta Visualizza i log di debug per l'agente guest.

Esamina i log di debug

Esplora log

  1. Nella console Google Cloud , vai alla pagina Esplora log:

    Vai a Esplora log

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.

  2. Inserisci la seguente query e fai clic su Esegui query:

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

Linux

Esegui questo comando sulla VM Compute Engine Linux:

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

Windows

Esegui questo comando sulla VM Compute Engine Windows:

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

Se vedi log contenenti la stringa The agent config file is not valid, la configurazione personalizzata di Ops Agent fornita durante la creazione o l'aggiornamento della policy di estensione non è valida.

Per risolvere il problema, segui questi passaggi:

  • Correggi la configurazione facendo riferimento a Configura Ops Agent. Per informazioni sulla struttura di un file di configurazione di Ops Agent.

  • Aggiorna la policy di estensione con la configurazione corretta.

I comandi Linux systemctl status e Windows Get-Service non funzionano con Ops Agent

Esegui un comando come sudo systemctl status google-cloud-ops-agent"*", ma non vengono restituite informazioni.

Quando Ops Agent viene installato e gestito dal gestore di estensioni VM, non viene gestito dal servizio di gestione del sistema operativo, ovvero systemd su Linux o Gestione servizi di Windows su Windows.

Per trovare le informazioni sullo stato di un Ops Agent gestito dal gestore di estensioni VM, consulta quanto segue:

I comandi Linux systemctl restart e Windows Restart-Service non funzionano con Ops Agent

Esegui un comando come sudo systemctl restart google-cloud-ops-agent, ma Ops Agent non viene riavviato.

Quando Ops Agent viene installato e gestito dal gestore di estensioni VM, non viene gestito dal servizio di gestione del sistema operativo, ovvero systemd su Linux o Gestione servizi di Windows su Windows. Pertanto, non puoi arrestare o avviare Ops Agent manualmente e i comandi come i seguenti non funzionano con Ops Agent:

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

Per arrestare o riavviare un Ops Agent gestito dal gestore di estensioni VM, devi disinstallare l'agente eliminando la policy di estensione. Per saperne di più sull'arresto o sul riavvio di Ops Agent, consulta Riavvia un Ops Agent installato da una policy di estensione.

Ulteriori informazioni per la risoluzione dei problemi

Per ulteriori informazioni sulla risoluzione dei problemi relativi alla creazione e all'utilizzo delle policy di gestore di estensioni VM, consulta Risolvi i problemi relativi alle estensioni VM.

Per saperne di più sulla risoluzione dei problemi di Ops Agent, consulta Risolvi i problemi di Ops Agent.