Installa e gestisci l'agente operativo utilizzando le policy di VM Extension Manager

Puoi installare e gestire l'Ops Agent su un parco risorse di VM Compute Engine a livello globale o all'interno di una zona specifica utilizzando le policy di gestore di estensioni VM. Ad esempio, puoi utilizzare queste policy per eseguire attività come le seguenti:

  • Installazione a livello di flotta: installa Ops Agent su:

    • Tutte le VM in una o più zone del tuo progetto Google Cloud .
    • Tutte le VM a livello globale (nel tuo progetto Google Cloud ).
    • Un sottoinsieme di VM in una zona, identificate dalle etichette.
    • Un sottoinsieme di macchine virtuali distribuite nelle zone del tuo progetto Google Cloud , identificate tramite etichette.

  • Controllo della versione:

    • Mantieni l'Ops Agent aggiornato all'ultima versione.
    • Blocca la versione dell'Ops Agent su una release specifica.

  • Gestione della configurazione: applica una configurazione personalizzata a Ops Agent su tutte le VM gestite da un criterio.

Con Gestore di estensioni VM, crei policy che dichiarano le estensioni che vuoi installare sulle VM. Ops Agent è una delle estensioni disponibili. Le policy del gestore di estensioni VM possono gestire Ops Agent versione 2.58.0 o successive, quando Ops Agent è stato installato utilizzando il gestore di estensioni VM. Questi criteri non possono gestire le versioni di Ops Agent precedenti alla versione 2.58.0, le istanze di Ops Agent installate con altri mezzi o qualsiasi versione dell'agente Monitoring o dell'agente Logging legacy.

Puoi creare e gestire policy di estensione VM a livello di zona utilizzando la consoleGoogle Cloud o Google Cloud CLI, gcloud. Puoi creare e gestire le policy di estensione delle VM globali utilizzando gcloud.

Prima di iniziare

Prima di iniziare a utilizzare le policy di estensione di gestore di estensioni VM, esegui le seguenti operazioni:

Esaminare i sistemi operativi supportati

Prima di tentare di utilizzare le policy di gestore di estensioni VM per gestire Ops Agent, verifica che il sistema operativo di destinazione sia compatibile sia con Ops Agent sia con gestore di estensioni VM.

Il gestore di estensioni VM supporta tutti i sistemi operativi supportati da Ops Agent, ad eccezione di SUSE Linux Enterprise Server (SLES) e Ubuntu. Per saperne di più sui sistemi operativi supportati da Ops Agent, consulta Sistemi operativi.

Se il tuo sistema operativo è supportato sia da Ops Agent sia da gestore di estensioni VM, segui le istruzioni riportate nel resto di questo documento.

Abilita le API richieste per utilizzare l'Ops Agent

Per utilizzare Ops Agent per scrivere log e metriche, devi abilitare l'API Cloud Logging e l'API Cloud Monitoring nel tuo progetto Google Cloud .

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente disponi già di questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.

Abilita le API

Concedi i ruoli necessari per utilizzare l'Ops Agent

Per ottenere le autorizzazioni necessarie per utilizzare l'Ops Agent per scrivere log e metriche, chiedi all'amministratore di concederti i seguenti ruoli IAM sul tuo account di servizio:

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Per saperne di più sui ruoli e sull'Ops Agent, consulta Autorizzare l'Ops Agent.

Concedi i ruoli necessari per utilizzare VM Extension Manager

Per ottenere le autorizzazioni necessarie per creare, visualizzare, modificare ed eliminare le policy di estensione VM, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per creare, visualizzare, modificare ed eliminare le policy di estensione VM. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per creare, visualizzare, modificare ed eliminare le policy di estensione VM sono necessarie le seguenti autorizzazioni:

  • Per creare policy di estensione: compute.vmExtensionPolicies.create
  • Per visualizzare le policy di estensione: compute.vmExtensionPolicies.list
  • Per visualizzare i dettagli di una policy di estensione: compute.vmExtensionPolicies.get
  • Per modificare le policy delle estensioni: compute.vmExtensionPolicies.update
  • Per eliminare le policy di estensione: compute.vmExtensionPolicies.delete

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Per ulteriori informazioni sui ruoli e le autorizzazioni IAM in Compute Engine, consulta Ruoli e autorizzazioni di Compute Engine.

Installa Google Cloud CLI

Puoi creare e gestire i criteri di estensione VM utilizzando la console Google Cloud o Google Cloud CLI, gcloud. Per utilizzare gcloud, devi prima installare Google Cloud CLI.

Per visualizzare i componenti installati, esegui questo comando:

gcloud components list

Per verificare di avere l'ultima versione, esegui questo comando:

gcloud components update

Disinstalla tutti gli agenti di osservabilità

Prima di creare una policy di gestore di estensioni VM per gestire Ops Agent su una VM, assicurati che sulla VM non siano già presenti istanze di Ops Agent o degli agenti di monitoraggio e agente Logging legacy. L'esecuzione dell'Ops Agent e degli agenti legacy sulla stessa VM può causare l'importazione di log duplicati o conflitti nell'importazione delle metriche.

Se utilizzi una policy di estensione per installare Ops Agent su una VM in cui è già installato un altro agente di osservabilità, la policy installa l'agente, ma l'agente non viene eseguito perché viene rilevato un conflitto.

La modalità di rimozione degli agenti esistenti dipende dalla modalità di installazione.

Installa l'Ops Agent creando policy di estensione VM

Crea policy di estensione VM per installare e gestire automaticamente Ops Agent su un parco risorse di macchine virtuali (VM) Compute Engine. Definendo una policy, puoi assicurarti che estensioni specifiche, come Ops Agent, vengano installate e gestite su tutte le VM che corrispondono ai criteri specificati, ad esempio le etichette VM.

Conflitti e priorità delle norme

Il gestore di estensioni VM associa una priorità a ogni nuova policy, con numeri più bassi che indicano priorità più elevate; la priorità predefinita è 1000. Una VM può essere coperta da più policy per un'estensione come Ops Agent, ma solo una policy per l'estensione Ops Agent è efficace sulla VM.

Il gestore di estensioni VM utilizza le priorità per risolvere i conflitti tra le policy applicate a una VM. Per saperne di più sulla procedura di risoluzione, consulta Priorità e risoluzione dei conflitti tra policy.

Piani di implementazione delle policy globali

Le policy globali del gestore di estensioni VM utilizzano un piano di implementazione per determinare come una policy viene distribuita alle VM di destinazione. Esistono due tipi di piani di implementazione:

  • Piani di implementazione predefiniti. Esistono due piani di implementazione predefiniti, scelti in base al valore utilizzato con l'opzione --rollout-predefined-plan per i comandi gcloud CLI.

    • Implementazione lenta, che esegue il deployment dell'Ops Agent gradualmente in diverse zone in un determinato periodo di tempo. Questo piano di implementazione è consigliato.

      Specifica questo piano di rollout utilizzando l'opzione --rollout-predefined-plan=slow_rollout.

    • Implementazione rapida, che esegue il deployment dell'Ops Agent su tutte le VM di destinazione in tutte le zone e le regioni immediatamente.

      Specifica questo piano di rollout utilizzando l'opzione --rollout-predefined-plan=fast_rollout.

  • Piani di implementazione personalizzati, specificati utilizzando l'opzione --rollout-custom-plan per i comandi gcloud CLI.

    Crea piani di implementazione personalizzati aggiungendoli al set di piani di implementazione nel tuo progetto Google Cloud . Per ulteriori informazioni, consulta il metodo dell'API Compute Engine rolloutPlans.insert.

Per saperne di più sui piani di implementazione, vedi Piani di implementazione per le policy globali.

Installa l'ultima versione di Ops Agent su tutte le VM

Per creare una policy che installi l'ultima versione di Ops Agent su tutte le VM in una zona o a livello globale e aggiorni Ops Agent quando viene rilasciata una nuova versione, procedi nel seguente modo:

Console

Per creare una policy a livello di zona, puoi utilizzare la console Google Cloud .

  1. Nella console Google Cloud , vai alla pagina Policy delle estensioni:

    Vai a Criteri estensione

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

  2. Fai clic su + Crea.
  3. Nel campo Nome, inserisci un nome per la policy.
  4. (Facoltativo) Nel campo Descrizione, inserisci una descrizione della policy.
  5. Nel campo Priority (Priorità), specifica un numero di priorità per risolvere i conflitti tra le policy. I numeri più bassi indicano una priorità più alta. Il valore predefinito è 1000.

  6. Nell'elenco Zona, seleziona la zona in cui vuoi applicare questa policy.

  7. Nella sezione Gestisci estensioni, fai clic su Aggiungi estensione e segui questi passaggi:

    1. Nell'elenco Estensione, seleziona Google Cloud's Extension for Ops Agent.
    2. Lascia vuoto il campo Version (Versione).

  8. Fai clic su Crea.

gcloud

Per creare una policy zonale o globale, puoi utilizzare gcloud CLI.

A livello di zona

Utilizza il seguente comando gcloud compute zone-vm-extension-policies create per creare la policy:

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent

Sostituisci le seguenti variabili nel comando:

  • POLICY_NAME: un nome per la policy di estensione VM.
  • PROJECT_ID: l'identificatore del progetto.
  • ZONE: la zona di destinazione, ad esempio us-central1-f

gcloud compute zone-vm-extension-policies create accetta un'opzione --version. Se ometti l'opzione --version, la policy installa l'ultima versione e aggiorna Ops Agent quando viene rilasciata una nuova versione.

Globale

Utilizza il seguente comando gcloud compute global-vm-extension-policies create per creare la policy:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout

Sostituisci le seguenti variabili nel comando:

  • POLICY_NAME: un nome per la policy di estensione VM.
  • PROJECT_ID: l'identificatore del progetto.

gcloud compute global-vm-extension-policies create accetta un'opzione --version. Se ometti l'opzione --version, la policy installa l'ultima versione e aggiorna Ops Agent quando viene rilasciata una nuova versione.

Fissare l'Ops Agent a una versione specifica su tutte le VM

Per creare una policy che installa una versione specifica di Ops Agent su tutte le VM in una zona o a livello globale:

Console

Per creare una policy a livello di zona, puoi utilizzare la console Google Cloud .

  1. Nella console Google Cloud , vai alla pagina Policy delle estensioni:

    Vai a Criteri estensione

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

  2. Fai clic su + Crea.
  3. Nel campo Nome, inserisci un nome per la policy.
  4. (Facoltativo) Nel campo Descrizione, inserisci una descrizione della policy.
  5. Nel campo Priority (Priorità), specifica un numero di priorità per risolvere i conflitti tra le policy. I numeri più bassi indicano una priorità più alta. Il valore predefinito è 1000.

  6. Nell'elenco Zona, seleziona la zona in cui vuoi applicare questa policy.

  7. Nella sezione Gestisci estensioni, fai clic su Aggiungi estensione e segui questi passaggi:

    1. Nell'elenco Estensione, seleziona Google Cloud's Extension for Ops Agent.
    2. Nell'elenco Versione, seleziona la versione da installare. Utilizza la versione 2.58.0 o successive.

  8. Fai clic su Crea.

gcloud

Per creare una policy zonale o globale, puoi utilizzare gcloud CLI.

A livello di zona

Utilizza il seguente comando gcloud compute zone-vm-extension-policies create per creare la policy:

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent  \
  --version=ops-agent=VERSION

Sostituisci le seguenti variabili nel comando:

  • POLICY_NAME: un nome per la policy di estensione VM.
  • PROJECT_ID: l'identificatore del progetto.
  • ZONE: la zona di destinazione, ad esempio us-central1-f

  • VERSION: la versione di Ops Agent da installare. Utilizza la versione 2.58.0 o successive.

    Se ometti l'opzione --version, il criterio installa l'ultima versione e aggiorna Ops Agent quando viene rilasciata una nuova versione, come mostrato nell'esempio che installa l'ultima versione.

Globale

Utilizza il seguente comando gcloud compute global-vm-extension-policies create per creare la policy:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --version=ops-agent=VERSION

Sostituisci le seguenti variabili nel comando:

  • POLICY_NAME: un nome per la policy di estensione VM.
  • PROJECT_ID: l'identificatore del progetto.

  • VERSION: la versione di Ops Agent da installare. Utilizza la versione 2.58.0 o successive.

    Se ometti l'opzione --version, il criterio installa l'ultima versione e aggiorna Ops Agent quando viene rilasciata una nuova versione, come mostrato nell'esempio che installa l'ultima versione.

Per un elenco delle versioni dell&#Ops Agent, consulta la pagina delle release dell'Ops Agent su GitHub.

Installa l'Ops Agent sulle VM con un'etichetta specifica

Per creare una policy che installi l'ultima versione di Ops Agent sulle VM in una zona o a livello globale che hanno un'etichetta specifica, procedi nel seguente modo:

Console

Per creare una policy a livello di zona, puoi utilizzare la console Google Cloud .

  1. Nella console Google Cloud , vai alla pagina Policy delle estensioni:

    Vai a Criteri estensione

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

  2. Fai clic su + Crea.
  3. Nel campo Nome, inserisci un nome per la policy.
  4. (Facoltativo) Nel campo Descrizione, inserisci una descrizione della policy.
  5. Nel campo Priority (Priorità), specifica un numero di priorità per risolvere i conflitti tra le policy. I numeri più bassi indicano una priorità più alta. Il valore predefinito è 1000.

  6. Nell'elenco Zona, seleziona la zona in cui vuoi applicare questa policy.

  7. Nella sezione Estensioni, fai clic su Aggiungi estensione e segui questi passaggi:

    1. Nell'elenco Estensione, seleziona Google Cloud's Extension for Ops Agent.
    2. Lascia vuoto il campo Version (Versione).

  8. Nella sezione Istanze VM di destinazione, seleziona le VM per la policy. Per selezionare le VM con etichette specifiche, fai clic su Aggiungi etichette e aggiungi la coppia chiave-valore.

  9. Fai clic su Crea.

gcloud

Per creare una policy zonale o globale, puoi utilizzare gcloud CLI.

A livello di zona

Utilizza l'opzione --inclusion-labels per il comando gcloud compute zone-vm-extension-policies create per specificare un elenco separato da virgole di coppie chiave-valore:

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent 
  --inclusion-labels=KEY1=VALUE1,KEY2=VALUE2

Sostituisci le seguenti variabili nel comando:

  • POLICY_NAME: un nome per la policy di estensione VM.
  • PROJECT_ID: l'identificatore del progetto.
  • ZONE: la zona di destinazione, ad esempio us-central1-f

  • KEY1=VALUE1,KEY2=VALUE2: un elenco separato da virgole di coppie chiave-valore che definiscono le etichette di inclusione per un selettore. Le VM devono avere tutte le etichette specificate in un selettore (AND logico) per essere incluse. Se specifichi l'opzione --inclusion_labels più volte, la policy ha come target le VM che corrispondono a tutte le etichette in uno qualsiasi dei selettori (operatore logico OR). Se ometti questa opzione, la policy ha come target tutte le VM nella zona specificata.

Globale

Utilizza l'opzione --inclusion-labels per il comando gcloud compute global-vm-extension-policies create per specificare un elenco separato da virgole di coppie chiave-valore:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --inclusion-labels=KEY1=VALUE1,KEY2=VALUE2

Sostituisci le seguenti variabili nel comando:

  • POLICY_NAME: un nome per la policy di estensione VM.
  • PROJECT_ID: l'identificatore del progetto.

  • KEY1=VALUE1,KEY2=VALUE2: un elenco separato da virgole di coppie chiave-valore che definiscono le etichette di inclusione per un selettore. Le VM devono avere tutte le etichette specificate in un selettore (AND logico) per essere incluse. Se specifichi l'opzione --inclusion_labels più volte, la policy ha come target le VM che corrispondono a tutte le etichette in uno qualsiasi dei selettori (operatore logico OR). Se ometti questa opzione, la policy ha come target tutte le VM nella zona specificata.

Installare l'Ops Agent con una configurazione personalizzata su tutte le VM

Per creare una policy che installi l'ultima versione di Ops Agent su tutte le VM in una zona o a livello globale e fornisca una configurazione personalizzata per Ops Agent, procedi nel seguente modo:

Console

Per creare una policy a livello di zona, puoi utilizzare la console Google Cloud .

  1. Nella console Google Cloud , vai alla pagina Policy delle estensioni:

    Vai a Criteri estensione

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

  2. Fai clic su + Crea.
  3. Nel campo Nome, inserisci un nome per la policy.
  4. (Facoltativo) Nel campo Descrizione, inserisci una descrizione della policy.
  5. Nel campo Priority (Priorità), specifica un numero di priorità per risolvere i conflitti tra le policy. I numeri più bassi indicano una priorità più alta. Il valore predefinito è 1000.

  6. Nell'elenco Zona, seleziona la zona in cui vuoi applicare questa policy.

  7. Nella sezione Estensioni, fai clic su Aggiungi estensione e segui questi passaggi:

    1. Nell'elenco Estensione, seleziona Google Cloud's Extension for Ops Agent.
    2. Lascia vuoto il campo Version (Versione).
    3. Nel campo Contenuto del file di configurazione, inserisci la stringa di configurazione YAML per Ops Agent.

  8. Fai clic su Crea.

gcloud

Per creare una policy zonale o globale, puoi utilizzare gcloud CLI.

A livello di zona

Utilizza l'opzione --config-from-file per il comando gcloud compute zone-vm-extension-policies create per specificare un file di configurazione:

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent 
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

Sostituisci le seguenti variabili nel comando:

  • POLICY_NAME: un nome per la policy di estensione VM.
  • PROJECT_ID: l'identificatore del progetto.
  • ZONE: la zona di destinazione, ad esempio us-central1-f

  • OPS_AGENT_CONFIG_PATH: il percorso di un file contenente la stringa di configurazione YAML per l'Ops Agent. Questo file deve esistere nell'ambiente in cui esegui il comando gcloud.

    Il file YAML di configurazione per Ops Agent può essere lungo. Inserire la configurazione in un file e passarlo alla gcloud CLI è molto meno soggetto a errori rispetto al tentativo di inserire YAML formattato correttamente alla riga di comando. La modifica di questo file dopo la creazione della policy non aggiorna la policy. Per aggiornare una policy, utilizza il comando gcloud compute zone-vm-extension-policies update.

Globale

Utilizza l'opzione --config-from-file per il comando gcloud compute global-vm-extension-policies create per specificare un file di configurazione:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

Sostituisci le seguenti variabili nel comando:

  • POLICY_NAME: un nome per la policy di estensione VM.
  • PROJECT_ID: l'identificatore del progetto.

  • OPS_AGENT_CONFIG_PATH: il percorso di un file contenente la stringa di configurazione YAML per l'Ops Agent. Questo file deve esistere nell'ambiente in cui esegui il comando gcloud.

    Il file YAML di configurazione per Ops Agent può essere lungo. Inserire la configurazione in un file e passarlo alla gcloud CLI è molto meno soggetto a errori rispetto al tentativo di inserire YAML formattato correttamente alla riga di comando. La modifica di questo file dopo la creazione della policy non aggiorna la policy. Per aggiornare una policy, utilizza il comando gcloud compute global-vm-extension-policies update.

Se fornisci una configurazione personalizzata per l'Ops Agent durante la creazione o l'aggiornamento di una policy di estensione, la policy esegue il deployment dell'Ops Agent con la configurazione personalizzata. Non è necessario riavviare manualmente l'agente.

La configurazione viene memorizzata con il criterio dell'estensione, quindi non includere dati sensibili come le password nella configurazione. Poiché la configurazione è memorizzata con i criteri delle estensioni, la modifica del file di configurazione non modifica la configurazione dell'agente. Devi aggiornare la configurazione memorizzata con la policy utilizzando il comando gcloud appropriato:

Quando fornisci una configurazione personalizzata per Ops Agent, il gestore di estensioni VM copia la configurazione nella posizione utilizzata da Ops Agent per i file di configurazione specificati dall'utente sulla VM di destinazione:

  • Linux: /etc/google-cloud-ops-agent/config.yaml
  • Windows: C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml

Se sulla VM è presente un file config.yaml, la policy di estensione lo sovrascrive.

Per informazioni generali sull'utilizzo della consoleGoogle Cloud e di gcloud CLI per creare criteri per le estensioni VM, consulta Installare le estensioni VM creando criteri per le estensioni .

Installa l'Ops Agent con un piano di rilascio rapido con priorità più alta (solo globale)

Per creare una policy globale che installi l'ultima versione di Ops Agent utilizzando una priorità superiore a quella predefinita e il piano di implementazione rapida, utilizza il seguente comando gcloud compute global-vm-extension-policies create:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=fast_rollout \
  --priority=500

Sostituisci le seguenti variabili nel comando:

  • POLICY_NAME: un nome per la policy di estensione VM.
  • PROJECT_ID: l'identificatore del progetto.

Installazione dell'Ops Agent su un sottoinsieme di zone in un progetto Google Cloud (solo globale)

Per creare una policy globale che si applichi solo a un sottoinsieme di zone in un progettoGoogle Cloud , devi utilizzare un piano di implementazione personalizzato che specifichi le zone in cui applicare la policy. Per informazioni sulla creazione di piani di implementazione personalizzati, consulta Informazioni sui piani di implementazione. Per specificare un insieme di zone, utilizza il campo locationSelector.includedLocations quando crei il piano di implementazione.

Per creare una policy di estensione che utilizza un piano di implementazione personalizzato, utilizza il seguente comando gcloud compute global-vm-extension-policies create:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-custom-plan=projects/PROJECT_ID/locations/global/rolloutPlans/CUSTOM_PLAN_NAME

Sostituisci le seguenti variabili nel comando:

  • POLICY_NAME: un nome per la policy di estensione VM.
  • PROJECT_ID: l'identificatore del progetto.

  • CUSTOM_PLAN_NAME: il nome associato al tuo piano di rollout personalizzato.

Gestire l'Ops Agent aggiornando le policy di estensione VM

Per modificare il modo in cui una policy gestisce l'Ops Agent, aggiorna la policy. Quando aggiorni una policy, il gestore di estensioni VM implementa le modifiche a tutte le VM applicabili, in genere entro un minuto. Se modifichi le etichette di inclusione, Ops Agent potrebbe essere installato su nuove VM o disinstallato da VM esistenti a seconda che le VM corrispondano alle etichette aggiornate.

Le sezioni seguenti mostrano come gestire Ops Agent per eseguire le seguenti operazioni:

Aggiorna la versione bloccata dell'Ops Agent su tutte le VM in una zona

Per modificare la versione bloccata di Ops Agent su tutte le VM di una zona, svolgi questi passaggi:

Console

Per creare una policy a livello di zona, puoi utilizzare la console Google Cloud .

  1. Nella console Google Cloud , vai alla pagina Policy delle estensioni:

    Vai a Criteri estensione

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

  2. Seleziona il criterio che vuoi aggiornare.
  3. Fai clic su Modifica.
  4. Nella sezione Gestisci estensioni, segui questi passaggi:
    1. Seleziona Google Cloud's Extension for Ops Agent.
    2. Modifica il campo Versione. Utilizza la versione 2.58.0 o successive.
    3. Fai clic su Fine.
  5. Fai clic su Salva.

gcloud

Per creare una policy zonale o globale, puoi utilizzare gcloud CLI.

A livello di zona

Utilizza il comando gcloud compute zone-vm-extension-policies update con l'opzione --version per modificare la versione dell'agente bloccata.

Quando aggiorni una norma utilizzando gcloud, la richiesta funge da sostituzione completa. Tutti i campi facoltativi che ometti vengono ripristinati ai valori predefiniti anziché conservare i valori esistenti del criterio modificato.

Per modificare la versione di Ops Agent installata su tutte le VM in una zona in base a un criterio, utilizza il seguente comando:

gcloud compute zone-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent 
  --version=ops-agent=VERSION

Sostituisci le seguenti variabili nel comando:

  • POLICY_NAME: un nome per la policy di estensione VM.
  • PROJECT_ID: l'identificatore del progetto.
  • ZONE: la zona di destinazione, ad esempio us-central1-f

  • VERSION: la versione di Ops Agent da installare. Utilizza la versione 2.58.0 o successive. Per un elenco delle versioni, consulta la pagina delle release di Ops Agent su GitHub.

    Se ometti l'opzione --version, il criterio installa l'ultima versione e aggiorna Ops Agent quando viene rilasciata una nuova versione, come mostrato nell'esempio che installa l'ultima versione.

Globale

Utilizza il comando gcloud compute global-vm-extension-policies update con l'opzione --version per modificare la versione dell'agente bloccata.

Quando aggiorni una norma utilizzando gcloud, la richiesta funge da sostituzione completa. Tutti i campi facoltativi che ometti vengono ripristinati ai valori predefiniti anziché conservare i valori esistenti del criterio modificato.

Per modificare la versione di Ops Agent installata su tutte le VM in base a un criterio globale, utilizza il seguente comando:

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --version=ops-agent=VERSION

Sostituisci le seguenti variabili nel comando:

  • POLICY_NAME: un nome per la policy di estensione VM.
  • PROJECT_ID: l'identificatore del progetto.

  • VERSION: la versione di Ops Agent da installare. Utilizza la versione 2.58.0 o successive. Per un elenco delle versioni, consulta la pagina delle release di Ops Agent su GitHub.

    Se ometti l'opzione --version, il criterio installa l'ultima versione e aggiorna Ops Agent quando viene rilasciata una nuova versione, come mostrato nell'esempio che installa l'ultima versione.

Modifica la configurazione dell'Ops Agent su tutte le VM

Per modificare la configurazione di Ops Agent, segui questi passaggi:

Console

Per creare una policy a livello di zona, puoi utilizzare la console Google Cloud .

  1. Nella console Google Cloud , vai alla pagina Policy delle estensioni:

    Vai a Criteri estensione

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

  2. Seleziona il criterio che vuoi aggiornare.
  3. Fai clic su Modifica.
  4. Nella sezione Gestisci estensioni, segui questi passaggi:
    1. Seleziona Google Cloud's Extension for Ops Agent.
    2. Modifica il campo Contenuti del file di configurazione.
    3. Fai clic su Fine.
  5. Fai clic su Salva.

gcloud

Per creare una policy zonale o globale, puoi utilizzare gcloud CLI.

A livello di zona

Utilizza gcloud compute zone-vm-extension-policies update con l'opzione --config-from-file o l'opzione --config per specificare una nuova configurazione.

Quando aggiorni una norma utilizzando gcloud, la richiesta funge da sostituzione completa. Tutti i campi facoltativi che ometti vengono ripristinati ai valori predefiniti anziché conservare i valori esistenti del criterio modificato.

Per modificare la configurazione di Ops Agent installato su tutte le VM in una zona tramite una policy, utilizza il seguente comando:

gcloud compute zone-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent 
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

Sostituisci le seguenti variabili nel comando:

  • POLICY_NAME: un nome per la policy di estensione VM.
  • PROJECT_ID: l'identificatore del progetto.
  • ZONE: la zona di destinazione, ad esempio us-central1-f

  • OPS_AGENT_CONFIG_PATH: il percorso di un file contenente la stringa di configurazione YAML per l'Ops Agent. Questo file deve esistere nell'ambiente in cui esegui il comando gcloud.

    Il file YAML di configurazione per Ops Agent può essere lungo. Inserire la configurazione in un file e passarlo alla gcloud CLI è molto meno soggetto a errori rispetto al tentativo di inserire YAML formattato correttamente alla riga di comando.

Globale

Utilizza gcloud compute global-vm-extension-policies update con l'opzione --config-from-file o l'opzione --config per specificare una nuova configurazione.

Quando aggiorni una norma utilizzando gcloud, la richiesta funge da sostituzione completa. Tutti i campi facoltativi che ometti vengono ripristinati ai valori predefiniti anziché conservare i valori esistenti del criterio modificato.

Per modificare la configurazione di Ops Agent installato su tutte le VM tramite una policy, utilizza il seguente comando:

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

Sostituisci le seguenti variabili nel comando:

  • POLICY_NAME: un nome per la policy di estensione VM.
  • PROJECT_ID: l'identificatore del progetto.

  • OPS_AGENT_CONFIG_PATH: il percorso di un file contenente la stringa di configurazione YAML per l'Ops Agent. Questo file deve esistere nell'ambiente in cui esegui il comando gcloud.

    Il file YAML di configurazione per Ops Agent può essere lungo. Inserire la configurazione in un file e passarlo alla gcloud CLI è molto meno soggetto a errori rispetto al tentativo di inserire YAML formattato correttamente alla riga di comando.

Se fornisci una configurazione personalizzata per l'Ops Agent durante la creazione o l'aggiornamento di una policy di estensione, la policy esegue il deployment dell'Ops Agent con la configurazione personalizzata. Non è necessario riavviare manualmente l'agente.

La configurazione viene memorizzata con il criterio dell'estensione, quindi non includere dati sensibili come le password nella configurazione. Poiché la configurazione è memorizzata con i criteri delle estensioni, la modifica del file di configurazione non modifica la configurazione dell'agente. Devi aggiornare la configurazione memorizzata con la policy utilizzando il comando gcloud appropriato:

Quando fornisci una configurazione personalizzata per Ops Agent, il gestore di estensioni VM copia la configurazione nella posizione utilizzata da Ops Agent per i file di configurazione specificati dall'utente sulla VM di destinazione:

  • Linux: /etc/google-cloud-ops-agent/config.yaml
  • Windows: C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml

Se sulla VM è presente un file config.yaml, la policy di estensione lo sovrascrive.

Per informazioni generali sull'utilizzo dellaGoogle Cloud console e della gcloud CLI per gestire le policy di estensione delle VM, vedere Modificare le estensioni aggiornando una policy di estensione della VM.

Estendere una norma globale esistente per includere nuove zone (solo globale)

Quando le VM vengono create in nuove zone dopo la creazione e l'implementazione di una policy globale, il gestore di estensioni VM non applica automaticamente la policy alle VM nelle nuove zone. Per includere le VM nelle nuove zone, è necessario riavviare l'implementazione dei criteri globali.

Per riavviare l'implementazione di una policy globale, utilizza il comando gcloud compute global-vm-extension-policies update e fornisci l'opzione --rollout-retry-uuid=UUID.

Ad esempio, supponiamo di aver creato e implementato una policy globale utilizzando il seguente comando:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --version=ops-agent=2.61.0 \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="/usr/ops-agent-config.yaml"

Per estendere il criterio alle VM create in zone inutilizzate in precedenza, riavvia l'implementazione utilizzando il seguente comando:

gcloud compute global-vm-extension-policies update test-policy POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --version=ops-agent=2.61.0 \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="/usr/ops-agent-config.yaml" \
  --rollout-retry-uuid=UUID

Sostituisci le seguenti variabili nel comando:

  • POLICY_NAME: un nome per la policy di estensione VM.
  • PROJECT_ID: l'identificatore del progetto.

  • UUID: un identificatore univoco universale (UUID) che identifica la richiesta di ripetizione. Puoi utilizzare qualsiasi generatore di UUID per crearne uno. Per saperne di più, consulta Riprovare un'implementazione .

Aggiorna una policy globale per escludere un insieme di zone (solo globale)

Per aggiornare le zone a cui si applica una policy globale che esclude alcune zone in un progettoGoogle Cloud , devi utilizzare un nuovo piano di implementazione personalizzato che specifichi le zone in cui applicare la policy. Per informazioni sulla creazione di piani di implementazione personalizzati, consulta Informazioni sui piani di implementazione. Per specificare un insieme di zone, utilizza il campo locationSelector.includedLocations quando crei il piano di implementazione.

Per aggiornare un criterio di estensione che utilizza un piano di implementazione personalizzato, utilizzare quanto segue:gcloud compute global-vm-extension-policies update comando:

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-custom-plan=projects/PROJECT_ID/locations/global/rolloutPlans/NEW_CUSTOM_PLAN_NAME \
  --rollout-retry-uuid=UUID

Sostituisci le seguenti variabili nel comando:

  • POLICY_NAME: un nome per la policy di estensione VM.
  • PROJECT_ID: l'identificatore del progetto.

  • NEW_CUSTOM_PLAN_NAME: Il nome associato al tuo piano di implementazione personalizzato aggiornato.
  • UUID: un identificatore univoco universale (UUID) che identifica la richiesta di ripetizione. Puoi utilizzare qualsiasi generatore di UUID per crearne uno. Per saperne di più, consulta Riprovare un'implementazione .

Disinstalla l'Ops Agent eliminando le policy di estensione VM

Per disinstallare Ops Agent, elimina la policy di estensione VM che gestisce l'agente. Se a una VM si applica un'altra policy attiva a priorità inferiore che gestisce anche Ops Agent, l'agente rimane installato sulla VM in base alla policy a priorità inferiore.

Il gestore di estensioni VM rimuove Ops Agent da tutte le VM accessibili entro un minuto dall'eliminazione della policy. Se una VM non è accessibile, il gestore di estensioni VM salta l'eliminazione dell'agente. Se la VM torna disponibile, il gestore di estensioni VM rimuove l'agente in quel momento.

Console

  1. Nella console Google Cloud , vai alla pagina Policy delle estensioni:

    Vai a Criteri estensione

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

  2. Seleziona la policy che vuoi eliminare.
  3. Fai clic su Elimina.
  4. Nella finestra di dialogo di conferma, fai clic su Elimina.

gcloud

A livello di zona

Per eliminare la policy di estensione VM che gestisce Ops Agent, utilizza il comando gcloud compute zone-vm-extension-policies delete:

gcloud compute zone-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

Sostituisci le seguenti variabili nel comando:

  • POLICY_NAME: un nome per la policy di estensione VM.
  • PROJECT_ID: l'identificatore del progetto.
  • ZONE: la zona di destinazione, ad esempio us-central1-f

Globale

Per eliminare la policy di estensione VM globale che gestisce Ops Agent, utilizza il comando gcloud compute global-vm-extension-policies delete:

gcloud compute global-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --rollout-predefined-plan=slow_rollout

Sostituisci le seguenti variabili nel comando:

  • POLICY_NAME: un nome per la policy di estensione VM.
  • PROJECT_ID: l'identificatore del progetto.

Per accelerare un'operazione di eliminazione già avviata, emettere un nuovo comando di eliminazione che utilizzi il piano fast_rollout. Devi anche specificare l'opzione --rollout-retry-uuid=UUID:

gcloud compute global-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --rollout-predefined-plan=fast_rollout \
  --rollout-retry-uuid=UUID

Sostituisci le seguenti variabili nel comando:

  • POLICY_NAME: un nome per la policy di estensione VM.
  • PROJECT_ID: l'identificatore del progetto.

  • UUID: un identificatore univoco universale (UUID) che identifica la richiesta di ripetizione. Puoi utilizzare qualsiasi generatore di UUID per crearne uno. Per saperne di più, consulta Riprovare un'implementazione .

Recupera informazioni sulle policy di estensione VM

Puoi recuperare le seguenti informazioni sulle policy di estensione VM esistenti:

  • Un elenco di tutte le policy nel tuo progetto Google Cloud .
  • Informazioni di configurazione su una policy specifica.

Console

  1. Nella console Google Cloud , vai alla pagina Policy delle estensioni:

    Vai a Criteri estensione

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

    Questa pagina elenca tutte le policy di estensione VM nel progetto.
  2. Per visualizzare i dettagli di una policy di estensione specifica, fai clic sul nome della policy.

gcloud

A livello di zona

Elenca le policy di estensione VM

Per elencare le informazioni su tutte le policy di estensione VM in una zona, utilizza gcloud compute zone-vm-extension-policies list:

gcloud compute zone-vm-extension-policies list \
  --project=PROJECT_ID \
  --zone=ZONE \
  --page-size=PAGE_SIZE_INTEGER

Sostituisci le seguenti variabili nel comando:

  • PROJECT_ID: l'identificatore del progetto.
  • ZONE: la zona di destinazione, ad esempio us-central1-f
  • PAGE_SIZE_INTEGER: il numero di policy da elencare per pagina, ad esempio 2. Per saperne di più sulle opzioni di ordinamento e filtro, consulta gcloud compute zone-vm-extension-policies list.

Descrivi una policy di estensione VM denominata

Per recuperare la configurazione di una policy denominata in una zona, utilizza il comando gcloud compute zone-vm-extension-policies describe:

gcloud compute zone-vm-extension-policies describe POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

Sostituisci le seguenti variabili nel comando:

  • POLICY_NAME: un nome per la policy di estensione VM.
  • PROJECT_ID: l'identificatore del progetto.
  • ZONE: la zona di destinazione, ad esempio us-central1-f

Globale

Elenca le policy di estensione VM globali

Per elencare le informazioni sulle policy di estensione VM globali, utilizza gcloud compute global-vm-extension-policies list:

gcloud compute global-vm-extension-policies list \
  --project=PROJECT_ID \
  --page-size=PAGE_SIZE_INTEGER

Sostituisci le seguenti variabili nel comando:

Descrivi una policy di estensione VM globale denominata

Per recuperare la configurazione di una policy denominata in una zona, utilizza il comando gcloud compute global-vm-extension-policies describe:

gcloud compute global-vm-extension-policies describe POLICY_NAME \
  --project=PROJECT_ID

Sostituisci le seguenti variabili nel comando:

  • POLICY_NAME: un nome per la policy di estensione VM.
  • PROJECT_ID: l'identificatore del progetto.

Per informazioni generali sull'utilizzo della consoleGoogle Cloud e di gcloud CLI per recuperare informazioni sulle policy delle estensioni VM, consulta Visualizzare le policy delle estensioni.

Verificare l'installazione di Ops Agent

Questa sezione descrive come:

Verificare lo stato o la versione di un'installazione di Ops Agent

Per determinare lo stato o la versione di Ops Agent, utilizza una delle seguenti pagine della consoleGoogle Cloud :

Compute Engine

  1. Nella Google Cloud console, vai alla pagina Istanze VM.

    Vai a Istanze VM

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

  2. Seleziona una VM dall'elenco.
  3. Fai clic sulla scheda Osservabilità.

Cloud Monitoring

  1. Nella console Google Cloud , vai alla pagina Istanze VM:

    Vai a Istanze VM

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

  2. Seleziona la visualizzazione Elenco.

Quando Ops Agent è stato installato sulla VM e raccoglie log e metriche, il suo stato è contrassegnato da un segno di spunta verde accanto all'etichetta Ops Agent.

Per determinare la versione dell'agente installato, passa il mouse sopra l'etichetta Ops Agent nella dashboard di Compute Engine o Monitoring.

Verifica che Ops Agent stia raccogliendo dati di telemetria

Se Ops Agent è stato installato correttamente ed è in esecuzione, invia le metriche a Cloud Monitoring e i log a Cloud Logging.

Riavvia un Ops Agent installato da una policy di estensione

Quando Ops Agent è installato e gestito da Gestore di estensioni VM, Ops Agent non è gestito dal servizio di gestione del sistema operativo, ovvero systemd su Linux o Windows Service Manager su Windows. Pertanto, i comandi Linux systemctl e Windows *-Service non funzionano con un Ops Agent installato da una policy di estensione.

Per riavviare un Ops Agent installato da una policy di estensione, esegui una delle seguenti operazioni:

  • Ricrea la policy.

    1. Elimina la policy. L'eliminazione della policy interrompe e disinstalla l&#39Ops Agents.

    2. Crea una nuova policy. La nuova policy installa Ops Agent e lo avvia.

  • Utilizza un criterio temporaneo con priorità più alta. Se la policy originale interessa un numero elevato di VM, ma vuoi riavviare Ops Agent solo su un numero ridotto, aggiungi un'etichetta a queste VM e configura la nuova policy in modo che filtri in base all'etichetta.

    Ad esempio, se una policy con priorità 1000 non è riuscita ad avviare Ops Agent su una VM, puoi aggiungere un'etichetta come status=failed alla VM. Poi crea una nuova policy con una priorità più alta, ad esempio 500. Ad esempio, un comando Google Cloud CLI potrebbe essere simile al seguente:

    A livello di zona 

    gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent  \
  --inclusion-labels=status=failed \
  --priority=500 \
  --config-from-file=ops-agent=/usr/ops-agent-config.yaml

    Sostituisci le seguenti variabili nel comando:

    • POLICY_NAME: un nome per la policy di estensione VM.
    • PROJECT_ID: l'identificatore del progetto.
    • ZONE: la zona di destinazione, ad esempio us-central1-f

    Globale 

    gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --inclusion-labels=status=failed \
  --priority=500 \
  --config-from-file=ops-agent=/usr/ops-agent-config.yaml \
  --rollout-predefined-plan=fast_rollout

    Sostituisci le seguenti variabili nel comando:

    • POLICY_NAME: un nome per la policy di estensione VM.
    • PROJECT_ID: l'identificatore del progetto.

    Dopo che la nuova policy ha installato correttamente l'Ops Agent, elimina la policy e rimuovi l'etichetta dalle VM. Ops Agent rimane installato sulla VM perché il criterio originale è ancora attivo.

Abilita il log di debug dell'agente guest sulla VM

Le policy di gestore di estensioni VM utilizzano l'agente guest di Compute Engine per gestire Ops Agent come estensione VM. Per informazioni sull'attivazione della registrazione di debug per l'agente guest, vedi Visualizzare i log di debug per l'agente guest.

Risolvere i problemi relativi alle policy di estensione

Questa sezione fornisce informazioni sulla risoluzione dei problemi relativi all'utilizzo delle policy di estensione per gestire l'Ops Agent:

Per informazioni sulla risoluzione dei problemi dell'Ops Agent, vedi Risoluzione dei problemi dell'Ops Agent.

I comandi gcloud compute zone-vm-extension-policies non vanno a buon fine

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 menziona autorizzazioni IAM insufficienti, rivedi i ruoli e le autorizzazioni necessari descritti in Concedere i ruoli richiesti per utilizzare il gestore di estensioni VM.

La policy di estensione è stata creata, ma lo stato di Ops Agent è "non rilevato"

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

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

  • Il criterio di estensione non riesce a installare l'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 dal criterio

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 il comando seguente nella VM di Compute Engine:

journalctl -u google-guest-agent-manager

Windows

Esegui il comando seguente nella VM di Compute Engine:

Get-Eventlog -Source google_guest_agent_manager -LogName Application

Se visualizzi log contenenti una stringa come Failed to install plugin "ops-agent-plugin" ... o se la query non restituisce log, significa che l'installazione di Ops Agent non è riuscita a causa della policy di estensione. Per i passaggi successivi, vedi L'installazione di Ops Agent non riesce a causa dei criteri delle estensioni.

Se visualizzi log contenenti una stringa come Successfully installed plugin "ops-agent_nnnnnnnn", significa che la policy di estensione ha installato correttamente l&#39Ops Agents. Per i passaggi successivi, consulta L'agente Ops installato non viene rilevato.

La policy di estensione non riesce a installare Ops Agent

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

  • L'agente guest non è installato sulla VM. Per diagnosticare e risolvere questo problema, 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 obsoleto. Per diagnosticare e risolvere questo problema, 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 successive.

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

  • Il sistema operativo della VM non è supportato da VM Extension Manager. Per saperne di più, consulta Sistemi operativi supportati.

Ops Agent installato ha lo stato "non rilevato"

L'agente Ops può avere lo stato "Non rilevato" se una delle seguenti condizioni è vera:

Verifica che la configurazione dell'Ops Agent sia valida

Hai fornito una configurazione personalizzata a Ops Agent creando o aggiornando un criterio 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.

Abilitare il logging di debug dell'agente guest

Per informazioni sull'attivazione della registrazione di debug per l'agente guest, vedi Visualizzare i log di debug per l'agente guest.

Esaminare 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 nella VM Linux di Compute Engine:

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

Windows

Esegui questo comando nella 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 visualizzi log contenenti la stringa The agent config file is not valid, la configurazione personalizzata per Ops Agent che hai fornito durante la creazione o l'aggiornamento del criterio di estensione non è valida.

Per risolvere il problema, procedi nel seguente modo:

  • Correggi la configurazione facendo riferimento a Configurazione dell'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 restituisce alcuna informazione.

Quando Ops Agent è installato e gestito da Gestore di estensioni VM, Ops Agent non è gestito dal servizio di gestione del sistema operativo, ovvero systemd su Linux o Windows Service Manager su Windows.

Per trovare le informazioni sullo stato di un Ops Agent gestito da 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 è installato e gestito da Gestore di estensioni VM, Ops Agent non è gestito dal servizio di gestione del sistema operativo, ovvero systemd su Linux o Windows Service Manager su Windows. Pertanto, non puoi arrestare o avviare Ops Agent manualmente e 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 da Gestore di estensioni VM, devi disinstallare l'agente eliminando la policy di estensione. Per maggiori informazioni sull'arresto o il riavvio di Ops Agent, vedi Riavviare un Ops Agent installato da una norma sulle estensioni.

Informazioni aggiuntive per la risoluzione dei problemi

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

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

Quota

Per informazioni sul numero di criteri di estensione che puoi creare in un progetto Google Cloud , consulta Quota.

Prezzi

Per informazioni sui costi associati all'utilizzo di gestore di estensioni VM, consulta Prezzi.

Se installi Ops Agent, è possibile che ti vengano addebitati dei costi per le metriche, i log o le tracce inviati dall'agente al tuo progetto Google Cloud . Per informazioni sui prezzi, consulta la pagina Prezzi di Google Cloud Observability.

Passaggi successivi