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

Puoi installare e gestire Ops Agent su un gruppo di VM di Compute Engine all'interno di una zona specifica utilizzando le policy di VM Extension Manager. Ad esempio, puoi utilizzare queste policy per eseguire attività come le seguenti:

  • Installazione a livello di parco risorse: installa l'agente operativo su tutte le VM in una zona o su un insieme di sottoinsieme di VM identificate dalle etichette in una zona.

  • Controllo della versione:

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

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

Con il gestore di estensioni VM, crei policy che dichiarano le estensioni che vuoi installare sulle VM. Ops Agent è una delle estensioni disponibili. Le policy di VM Extension Manager possono gestire Ops Agent versione 2.58.0 o successive, quando Ops Agent è stato installato utilizzando VM Extension Manager. 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 i criteri di estensione VM utilizzando la console Google Cloud o Google Cloud CLI, gcloud.

Prima di iniziare

Prima di iniziare a utilizzare le policy di estensione di VM Extension Manager, esegui le seguenti operazioni:

Esamina i sistemi operativi supportati

Prima di tentare di utilizzare le policy di VM Extension Manager per gestire l'agente operativo, verifica che il sistema operativo di destinazione sia compatibile sia con l'agente operativo sia con VM Extension Manager.

VM Extension Manager 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 che da VM Extension Manager, segui le istruzioni riportate nel resto di questo documento.

Abilita le API richieste per utilizzare l'agente Ops

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 .

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Concedi i ruoli necessari per utilizzare l'agente Ops

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

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'agente operativo, consulta Autorizzare l'agente operativo.

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 di estensione: 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 installarlo eseguendo i seguenti passaggi:

  1. Se non l'hai ancora fatto, installa Google Cloud CLI.

    Le norme per le estensioni descritte in questo documento utilizzano il gruppo di comandi beta.

  1. Se non l'hai ancora fatto, installa il componente beta di gcloud CLI eseguendo il seguente comando:

    gcloud components install beta

    Per verificare se è installato il componente beta, esegui il seguente comando:

    gcloud components list

    Se hai già installato il componente beta, verifica di avere l'ultima versione:

    gcloud components update

Disinstalla tutti gli agenti di osservabilità

Prima di creare una policy di VM Extension Manager per gestire l'agente Ops su una VM, assicurati che sulla VM non siano già presenti istanze dell'agente Ops o degli agenti di monitoraggio e logging legacy. L'esecuzione dell'agente operativo 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'agente operativo 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 un criterio, puoi assicurarti che estensioni specifiche, come Ops Agent, vengano installate e gestite su qualsiasi VM che corrisponda ai criteri specificati, ad esempio le etichette VM.

Conflitti e priorità delle norme

VM Extension Manager 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 l'agente operativo, ma sulla VM è efficace una sola policy per l'estensione dell'agente operativo.

VM Extension Manager 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 le policy.

Installa l'agente operativo più recente su tutte le VM di una zona

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

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. 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

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

gcloud beta 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.

L'opzione gcloud beta 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.

Bloccare l'agente operativo su una versione specifica su tutte le VM di una zona

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

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. 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

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

gcloud beta 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.

Per un elenco delle versioni di Ops Agent, consulta la pagina delle release di Ops Agent su GitHub.

Installare l'agente operativo sulle VM in una zona con un'etichetta specifica

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

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. 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

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

gcloud beta 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.

Installare l'agente operativo con una configurazione personalizzata su tutte le VM di una zona

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

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. 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

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

gcloud beta 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'agente Ops. 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 CLI gcloud è molto meno soggetto a errori rispetto al tentativo di inserire YAML formattato correttamente nella 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 beta compute zone-vm-extension-policies update.

Se fornisci una configurazione personalizzata per l'agente operativo durante la creazione o l'aggiornamento di una policy di estensione, la policy esegue il deployment dell'agente operativo 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 è archiviata con il criterio di estensione, la modifica del file di configurazione non modifica la configurazione dell'agente. Devi aggiornare la configurazione memorizzata con la policy utilizzando il comando gcloud beta compute zone-vm-extension-policies update.

Quando fornisci una configurazione personalizzata per Ops Agent, VM Extension Manager 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 .

Gestire l'agente operativo aggiornando le policy di estensione VM

Per modificare il modo in cui una policy gestisce l'agente Ops, aggiorna la policy. Quando aggiorni una policy, VM Extension Manager 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 l'agente Ops per:

Aggiorna la versione bloccata dell'agente operativo 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

  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

Utilizza il comando gcloud beta 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 beta 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.

Modifica la configurazione dell'agente operativo su tutte le VM di una zona

Per modificare la configurazione di Ops Agent su tutte le VM di una zona:

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 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

Utilizza gcloud beta 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 di una zona tramite una policy, utilizza il seguente comando:

gcloud beta 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'agente Ops. 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 CLI gcloud è molto meno soggetto a errori rispetto al tentativo di inserire YAML formattato correttamente nella riga di comando.

Se fornisci una configurazione personalizzata per l'agente operativo durante la creazione o l'aggiornamento di una policy di estensione, la policy esegue il deployment dell'agente operativo 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 è archiviata con il criterio di estensione, la modifica del file di configurazione non modifica la configurazione dell'agente. Devi aggiornare la configurazione memorizzata con la policy utilizzando il comando gcloud beta compute zone-vm-extension-policies update.

Quando fornisci una configurazione personalizzata per Ops Agent, VM Extension Manager 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 gestire i criteri delle estensioni VM, consulta Modifica delle estensioni aggiornando un criterio delle estensioni VM.

Disinstalla l'agente operativo 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.

VM Extension Manager rimuove Ops Agent da tutte le VM accessibili entro un minuto dall'eliminazione della policy. Se una VM non è accessibile, VM Extension Manager salta l'eliminazione dell'agente. Se la VM torna disponibile, VM Extension Manager 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

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

gcloud beta 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.

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

Elenca le policy di estensione VM

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

gcloud beta 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 norme da elencare per pagina, ad esempio 2. Per saperne di più sulle opzioni di ordinamento e filtro, consulta gcloud beta 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 beta compute zone-vm-extension-policies describe:

gcloud beta 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.

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 dell'agente operativo

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 agente operativo installato da una policy di estensione

Quando Ops Agent è installato e gestito da VM Extension Manager, 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 agente Ops 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'agente Ops.

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

  • Utilizza un criterio temporaneo con priorità più elevata. 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 un criterio con priorità 1000 non è riuscito 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:

    gcloud beta 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.

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

Attiva il log di debug dell'agente guest sulla VM

Le policy di VM Extension Manager 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 norme delle estensioni per gestire l'agente Ops:

Per informazioni sulla risoluzione dei problemi dell'agente operativo, vedi Risoluzione dei problemi dell'agente operativo.

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

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

Se l'output del comando menziona autorizzazioni IAM insufficienti, esamina i ruoli e le autorizzazioni necessari descritti in Concedere i ruoli richiesti per utilizzare VM Extension Manager.

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

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

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

  • Il criterio di estensione non riesce a installare l'agente operativo.
  • 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 VM Extension Manager utilizzano l'agente guest di Compute Engine per gestire Ops Agent come estensione VM.

Per determinare se Ops Agent è stato installato dal criterio 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'estensione non è riuscita a installare Ops Agent. 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 il criterio di estensione ha installato correttamente l'agente Ops. Per i passaggi successivi, consulta L'agente Ops installato "non viene rilevato".

La policy di estensione non riesce a installare l'agente operativo

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. VM Extension Manager richiede la versione 20241209.01 o versioni 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'agente operativo 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 il comando seguente 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 di 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'agente operativo. 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 VM Extension Manager, 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 agente Ops gestito da VM Extension Manager, 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 VM Extension Manager, 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 agente Ops gestito da VM Extension Manager, 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 di VM Extension Manager, consulta Risoluzione dei problemi delle 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 VM Extension Manager, consulta la sezione 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