Installazione dell'agente operativo su singole VM

Ops Agent raccoglie log e metriche sulle istanze Compute Engine, inviando i log a Cloud Logging e le metriche a Cloud Monitoring.

Prima di iniziare

Per installare l'agente, assicurati di disporre di quanto segue:

Installare l'agente automaticamente durante la creazione della VM

Per maggiori informazioni, vedi Installare l'Ops Agent durante la creazione della VM.

Installare l'agente dalla riga di comando

Per installare l'agente utilizzando la riga di comando, segui queste istruzioni.

Installare l'ultima versione dell'agente

Per installare l'ultima versione dell'agente, completa i seguenti passaggi.

Linux

  1. Apri una connessione terminale all'istanza VM utilizzando SSH o uno strumento simile e assicurati di disporre dell'accesso sudo.

  2. Passa a una directory a cui hai accesso in scrittura, ad esempio la tua home directory.

  3. Scarica ed esegui lo script di installazione dell'agente utilizzando i seguenti comandi:

    curl -sSO https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.sh
sudo bash add-google-cloud-ops-agent-repo.sh --also-install

    Una volta installato, l'agente viene avviato automaticamente.

Windows

  1. Connettiti all'istanza utilizzando RDP o uno strumento simile e accedi a Windows.

  2. Apri un terminale PowerShell con privilegi di amministratore facendo clic con il tasto destro del mouse sull'icona di PowerShell e selezionando Esegui come amministratore.

  3. Esegui i seguenti comandi PowerShell:

    (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.ps1", "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1")
Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall"

Installazione di una versione specifica dell'agente

Per installare una versione specifica dell'agente, completa i seguenti passaggi.

Linux

  1. Apri una connessione terminale all'istanza VM utilizzando SSH o uno strumento simile e assicurati di disporre dell'accesso sudo.

  2. Passa a una directory a cui hai accesso in scrittura, ad esempio la tua home directory.

  3. Scarica lo script di installazione dell'agente:

    curl -sSO https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.sh

    Quando esegui lo script add-google-cloud-ops-agent-repo.sh, puoi anche impostare i seguenti flag:

    • --verbose: attiva la registrazione dettagliata durante l'esecuzione dello script.
    • --also-install: installa l'agente dopo aver aggiunto il repository del pacchetto agente.
    • --version: imposta la versione dell'agente per lo script da installare. Per informazioni sulla versione, vedi Elencare tutte le versioni dell'agente.
    • --uninstall: disinstalla l'agente.
    • --remove-repo: rimuove il repository del pacchetto dell'agente corrispondente dopo l'installazione o la disinstallazione dell'agente.
    • --dry-run: esegue solo una prova dell'esecuzione dello script e stampa i comandi che deve eseguire.
    • --uninstall-standalone-logging-agent: disinstalla l'agente Logging legacy (StackdriverLogging).
    • --uninstall-standalone-monitoring-agent: disinstalla l'agente Monitoring legacy (StackdriverMonitoring).

    Per ulteriori informazioni ed esempi di utilizzo, consulta i commenti dello script.

  4. Aggiungi il Package Repository dell'agente e installa l'agente:

    1. Per elencare le versioni dell'agente disponibili, vedi Elenco di tutte le versioni dell'agente.

    2. Per gli ambienti di produzione, ti consigliamo di bloccare una versione principale per evitare di installare versioni principali che potrebbero includere modifiche incompatibili con le versioni precedenti. Per bloccare una versione principale, esegui questo comando:

      sudo bash add-google-cloud-ops-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.*.*

      Ad esempio, per bloccare la versione 1.x.x dell'agente, esegui:

      sudo bash add-google-cloud-ops-agent-repo.sh --also-install \
  --version=1.*.*

    3. Per installare una versione specifica dell'agente, esegui:

      sudo bash add-google-cloud-ops-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION

Puoi eliminare lo script di installazione dopo che è stato eseguito correttamente.

  • Per verificare che l'agente funzioni come previsto, esegui:

    sudo systemctl status google-cloud-ops-agent"*"

    Verifica che i componenti "Agente Logging" e "Agente Metriche" siano in esecuzione.

Se hai difficoltà con l'installazione, consulta la pagina Risoluzione dei problemi.

Windows

  1. Connettiti all'istanza utilizzando RDP o uno strumento simile e accedi a Windows.

  2. Apri un terminale PowerShell con privilegi di amministratore facendo clic con il tasto destro del mouse sull'icona di PowerShell e selezionando Esegui come amministratore.

  3. Scarica lo script di installazione dell'agente:

    (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.ps1", "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1")

    Quando esegui lo script add-google-cloud-ops-agent-repo.ps1, puoi anche impostare i seguenti flag:

    • -Verbose: attiva la registrazione dettagliata durante l'esecuzione dello script.
    • -AlsoInstall: installa l'agente dopo aver aggiunto il repository del pacchetto agente.
    • -Version: imposta la versione dell'agente per lo script da installare. Per informazioni sulla versione, vedi Elencare tutte le versioni dell'agente.
    • -Uninstall: disinstalla l'agente.
    • -RemoveRepo: rimuove il repository del pacchetto dell'agente corrispondente dopo l'installazione o la disinstallazione dell'agente.
    • -WhatIf: esegue solo una prova dell'esecuzione dello script e stampa i comandi che deve eseguire.
    • -UninstallStandaloneLoggingAgent: disinstalla l'agente Logging legacy (StackdriverLogging).
    • -UninstallStandaloneMonitoringAgent: disinstalla l'agente Monitoring legacy (StackdriverMonitoring).

    Per ulteriori informazioni ed esempi di utilizzo, consulta i commenti dello script.

  4. Aggiungi il Package Repository dell'agente e installa l'agente:

    1. Per elencare le versioni dell'agente disponibili, vedi Elenco di tutte le versioni dell'agente.

    2. Per gli ambienti di produzione, ti consigliamo di bloccare una versione principale per evitare di installare versioni principali che potrebbero includere modifiche incompatibili con le versioni precedenti. Per bloccare una versione principale, esegui questo comando:

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version MAJOR_VERSION.*.*"

      Ad esempio, per bloccare la versione 1.x.x dell'agente, esegui:

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version 1.*.*"

    3. Per installare una versione specifica dell'agente, esegui:

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version version-number"

      Ad esempio:

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version 1.0.1"

Puoi eliminare lo script di installazione dopo che è stato eseguito correttamente.

  • Per verificare che l'agente funzioni come previsto, esegui:

    Get-Service google-cloud-ops-agent

    Lo stato dell'agente deve essere Running.

Se hai difficoltà con l'installazione, consulta la pagina Risoluzione dei problemi.

Installa l'agente utilizzando la console Google Cloud

Puoi installare l'Ops Agent su una o più VM Compute Engine utilizzando la consoleGoogle Cloud dalle pagine Cloud Monitoring o Compute Engine.

Cloud Monitoring

Nella console Google Cloud , vai alla pagina Dashboard istanze VM:

Vai alla dashboard Istanze VM

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

La visualizzazione Elenco nella scheda Inventario della dashboard elenca tutte le VM e include una colonna di stato per l'agente, come mostrato nello screenshot seguente:

La dashboard Istanze VM in Monitoring mostra lo stato degli agenti.

La colonna Agente indica i seguenti valori:

  • Non rilevato: non hai installato un agente o non è in esecuzione. Se non sai se hai installato un agente, puoi eseguire una query per la versione installata. Se hai installato l'agente, puoi riavviarlo. Se hai installato e avviato Ops Agent, ma lo stato rimane Non rilevato, è possibile che l'agente non sia stato avviato correttamente o non sia in grado di inviare metriche.

    Per risolvere i problemi di avvio, consulta la sezione L'agente è installato, ma non è in esecuzione. Per risolvere i problemi di importazione delle metriche, consulta Risolvere i problemi di importazione dei dati. Potrebbero essere utili anche lo script agent-diagnostics e i controlli di integrità.

  • Ops Agent: stai eseguendo Ops Agent. Se non vedi un segno di spunta verde accanto alla voce, è disponibile un upgrade dell'agente in base al sistema operativo rilevato della VM.

    Quando passi il mouse sopra l'indicatore di Ops Agent nella tabella, vengono visualizzate informazioni sulla versione di Ops Agent. Se utilizzi una versione precedente, visualizzerai anche un consiglio per eseguire l'upgrade dell'agente.

  • In attesa: è in corso l'installazione o l'upgrade di Ops Agent.

    Se l'installazione dell'agente rimane In attesa per più di 10 minuti, potrebbe esserci un problema nell'applicazione della policy del sistema operativo Ops Agent o nell'avvio dell'agente. Per informazioni sulla risoluzione dei problemi, consulta Strumento di diagnostica dell'agente per i criteri di installazione automatica.

  • Installazione dell'agente non riuscita: l'installazione di Ops Agent non è riuscita. Per informazioni sulla risoluzione dei problemi, consulta la sezione Impossibile installare l'agente.

  • Raccolta della telemetria non in corso: l'installazione di Ops Agent è riuscita, ma l'agente non invia ancora dati di telemetria.

    Di solito sono necessari circa 10 minuti affinché la telemetria venga trasmessa da un nuovo agente. Puoi aggiornare la pagina per aggiornare lo stato. Se questo stato persiste per più di 10 minuti, potrebbe indicare un problema con l'importazione della telemetria. Per maggiori informazioni, vedi L'agente è installato, ma non è in esecuzione.

  • Agente legacy: stai eseguendo l'agente Monitoring legacy o l'agente Logging. Consulta Migrazione dagli agenti legacy all'agente operativo per informazioni sulla transizione all'Ops Agent.

  • Non applicabile: questa VM non è una piattaforma supportata per l'esecuzione dell'agente.

  • VM arrestata: la VM non è in esecuzione, quindi lo stato dell'agente non è noto.

Per installare Ops Agent:

  • Seleziona le istanze VM su cui vuoi installare gli agenti.
  • Fai clic sull'opzione Installa/Aggiorna Ops Agent nella tabella Istanze.

Puoi anche installare o aggiornare Ops Agent dalla pagina Dettagli VM per una VM specifica.

Se possibile, l'agente viene installato utilizzando una norma del sistema operativo di Ops Agent. Per maggiori informazioni, vedi Gestisci le VM coperte dalla policy del sistema operativo dell'agente Ops. Le norme del sistema operativo dell'agente Ops non sono supportate in tutte le versioni di tutti i sistemi operativi. In questo caso, se fai clic su Installa/Aggiorna Ops Agent, viene visualizzata una serie di comandi da eseguire in Cloud Shell.

Ops Agent raccoglie sia metriche che log per impostazione predefinita. Puoi modificare questo comportamento predefinito configurando Ops Agent.

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. Fai clic sul nome della VM su cui vuoi installare l'agente.

  3. Fai clic sulla scheda Osservabilità.

  4. Fai clic su Installa Ops Agent.

    Se possibile, l'agente viene installato utilizzando una norma del sistema operativo di Ops Agent. Per maggiori informazioni, vedi Gestisci le VM coperte dalla policy del sistema operativo dell'agente Ops. Le norme del sistema operativo dell'agente Ops non sono supportate in tutte le versioni di tutti i sistemi operativi. In questo caso, se fai clic su Installa/Aggiorna Ops Agent, viene visualizzata una serie di comandi da eseguire in Cloud Shell.

    Ops Agent raccoglie sia metriche che log per impostazione predefinita. Puoi modificare questo comportamento predefinito configurando Ops Agent.

    Se l'installazione dell'agente rimane In attesa per più di 10 minuti, potrebbe esserci un problema nell'applicazione della policy del sistema operativo Ops Agent o nell'avvio dell'agente. Per informazioni sulla risoluzione dei problemi, consulta Strumento di diagnostica dell'agente per i criteri di installazione automatica.

Verifica che Ops Agent sia in esecuzione

Per verificare che Ops Agent sia in esecuzione, puoi utilizzare uno dei seguenti metodi:

  • Dashboard Istanze VM: Questa dashboard consente di visualizzare lo stato di installazione dell'agente nel parco VM. Tuttavia, lo stato potrebbe essere impreciso se la VM non dispone degli ambiti di accesso necessari o se ilaccount di serviziot associato non dispone di ruoli IAM sufficienti.

  • gcpdiag: gcpdiag fornisce informazioni più affidabili e solide sullo stato dell'agente rispetto alla dashboard Istanze VM, verificando sia l'installazione dell'agente sia la trasmissione della telemetria dalla VM. L'utilizzo di gcpdiag presenta alcuni prerequisiti, ma offre un modo migliore per monitorare lo stato dell'agente.

Utilizzare la dashboard Istanze VM

Nella console Google Cloud , vai alla pagina Dashboard istanze VM:

Vai alla dashboard Istanze VM

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

La visualizzazione Elenco nella scheda Inventario della dashboard elenca tutte le VM e include una colonna di stato per l'agente.

La colonna Agente indica i seguenti valori:

  • Non rilevato: non hai installato un agente o non è in esecuzione. Se non sai se hai installato un agente, puoi eseguire una query per la versione installata. Se hai installato l'agente, puoi riavviarlo. Se hai installato e avviato Ops Agent, ma lo stato rimane Non rilevato, è possibile che l'agente non sia stato avviato correttamente o non sia in grado di inviare metriche.

    Per risolvere i problemi di avvio, consulta la sezione L'agente è installato, ma non è in esecuzione. Per risolvere i problemi di importazione delle metriche, consulta Risolvere i problemi di importazione dei dati. Potrebbero essere utili anche lo script agent-diagnostics e i controlli di integrità.

  • Ops Agent: stai eseguendo Ops Agent. Se non vedi un segno di spunta verde accanto alla voce, è disponibile un upgrade dell'agente in base al sistema operativo rilevato della VM.

    Quando passi il mouse sopra l'indicatore di Ops Agent nella tabella, vengono visualizzate informazioni sulla versione di Ops Agent. Se utilizzi una versione precedente, visualizzerai anche un consiglio per eseguire l'upgrade dell'agente.

  • In attesa: è in corso l'installazione o l'upgrade di Ops Agent.

    Se l'installazione dell'agente rimane In attesa per più di 10 minuti, potrebbe esserci un problema nell'applicazione della policy del sistema operativo Ops Agent o nell'avvio dell'agente. Per informazioni sulla risoluzione dei problemi, consulta Strumento di diagnostica dell'agente per i criteri di installazione automatica.

  • Installazione dell'agente non riuscita: l'installazione di Ops Agent non è riuscita. Per informazioni sulla risoluzione dei problemi, consulta la sezione Impossibile installare l'agente.

  • Raccolta della telemetria non in corso: l'installazione di Ops Agent è riuscita, ma l'agente non invia ancora dati di telemetria.

    Di solito sono necessari circa 10 minuti affinché la telemetria venga trasmessa da un nuovo agente. Puoi aggiornare la pagina per aggiornare lo stato. Se questo stato persiste per più di 10 minuti, potrebbe indicare un problema con l'importazione della telemetria. Per maggiori informazioni, vedi L'agente è installato, ma non è in esecuzione.

  • Agente legacy: stai eseguendo l'agente Monitoring legacy o l'agente Logging. Consulta Migrazione dagli agenti legacy all'agente operativo per informazioni sulla transizione all'Ops Agent.

  • Non applicabile: questa VM non è una piattaforma supportata per l'esecuzione dell'agente.

  • VM arrestata: la VM non è in esecuzione, quindi lo stato dell'agente non è noto.

Utilizzare gcpdiag

Per informazioni sull'utilizzo di gcpdiag, consulta Verificare lo stato dell'agente utilizzando gcpdiag.

Attività facoltative

Questa sezione descrive come eseguire le attività di manutenzione comuni.

Configura un proxy HTTP

Se utilizzi un proxy HTTP per il proxy delle richieste alle API Logging e Monitoring, procedi nel seguente modo:

Linux

  1. Modifica il seguente file di configurazione (crealo se non esiste già):

     /etc/systemd/system.conf

  2. Aggiungi quanto segue al file:

     DefaultEnvironment="HTTP_PROXY=http://proxy-ip:proxy-port" "HTTPS_PROXY=http://proxy-ip:proxy-port" "NO_PROXY=http://metadata.google.internal"  # Skip proxy for the local Metadata Server.

  3. Ricarica le variabili di ambiente:

     sudo systemctl daemon-reload

  4. Riavvia l'agente eseguendo il seguente comando sull'istanza VM:

     sudo systemctl restart google-cloud-ops-agent"*"

Windows

  1. Se utilizzi un proxy HTTP, esegui il seguente comando da un prompt dei comandi di amministratore. In questo modo vengono impostate le variabili di ambiente HTTP_PROXY e HTTPS_PROXY in modo che l'agente possa inviare dati utilizzando HTTPS in uscita:

    setx HTTP_PROXY http://proxy-ip:proxy-port /m
setx HTTPS_PROXY http://proxy-ip:proxy-port /m
setx no_proxy "metadata.google.internal,169.254.169.254" /m

Determinare la versione dell'agente

Per determinare la versione di Ops Agent sul tuo sistema, esegui i seguenti comandi sull'istanza VM:

ConsoleGoogle Cloud

Per visualizzare la versione di Ops Agent su una VM:

CENTOS / RHEL

Esegui questo comando su Red Hat o CentOS Linux:

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' google-cloud-ops-agent

DEBIAN / UBUNTU

Esegui questo comando su Debian o Ubuntu:

dpkg-query --show --showformat '${Package} ${Version} ${Architecture} ${Status}\n' google-cloud-ops-agent

SLES / SUSE

Esegui questo comando su SUSE:

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' google-cloud-ops-agent

WINDOWS

Esegui questo comando su Windows:

googet installed google-cloud-ops-agent

Riavvia l'agente

Devi riavviare Ops Agent per rilevare le modifiche nei file di configurazione. Per riavviare l'agente, segui queste istruzioni.

LINUX

Esegui questo comando sull'istanza:


     sudo systemctl restart google-cloud-ops-agent

Windows

  1. Connettiti all'istanza utilizzando RDP o uno strumento simile e accedi a Windows.

  2. Apri un terminale PowerShell con privilegi di amministratore facendo clic con il tasto destro del mouse sull'icona di PowerShell e selezionando Esegui come amministratore.

  3. Esegui il seguente comando PowerShell:

Restart-Service google-cloud-ops-agent -Force

Esegui l'upgrade dell'agente

Per eseguire l'upgrade di Ops Agent all'ultima release, segui queste istruzioni:

ConsoleGoogle Cloud

Puoi eseguire l'upgrade di Ops Agent utilizzando le istruzioni di installazione di Cloud Monitoring. Per ulteriori informazioni, consulta Installare l'agente utilizzando la consoleGoogle Cloud .

Linux

Per eseguire l'upgrade dell'agente all'ultima versione, esegui questo comando:

sudo bash add-google-cloud-ops-agent-repo.sh --also-install

Per eseguire l'upgrade dell'agente all'ultima release secondaria di una versione principale specifica, esegui questo comando:

sudo bash add-google-cloud-ops-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.*.*

Windows

Per eseguire l'upgrade all'ultima release dell'agente:

  1. Connettiti all'istanza utilizzando RDP o uno strumento simile e accedi a Windows.

  2. Apri un terminale PowerShell con privilegi di amministratore facendo clic con il tasto destro del mouse sull'icona di PowerShell e selezionando Esegui come amministratore.

    Copy-Item -Path "C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml" -Destination "C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.bak"

  3. Esegui i seguenti comandi PowerShell per rimuovere l'agente installato ed eseguire il comando di installazione:

    googet -noconfirm remove google-cloud-ops-agent
googet -noconfirm install google-cloud-ops-agent

Elenca tutte le versioni dell'agente

Per elencare le versioni disponibili dell'agente, esegui questo comando:

CENTOS / RHEL

Elenca le versioni disponibili dell'agente:

sudo yum list --showduplicates google-cloud-ops-agent

DEBIAN / UBUNTU

Elenca le versioni disponibili dell'agente:

sudo apt-cache madison google-cloud-ops-agent

SLES / SUSE

Elenca le versioni disponibili dell'agente:

sudo zypper search -s google-cloud-ops-agent

WINDOWS

Elenca le versioni disponibili dell'agente:

googet available google-cloud-ops-agent

Disinstallare l'agente

Per rimuovere Ops Agent e i relativi file di configurazione, segui le istruzioni riportate di seguito.

Dopo aver disinstallato l'agente, la console Google Cloud potrebbe impiegare fino a un'ora per segnalare questa modifica.

Linux

Esegui questo comando:

sudo bash add-google-cloud-ops-agent-repo.sh --uninstall

(Facoltativo) Per rimuovere il repository oltre a disinstallare l'agente, aggiungi --remove-repo al comando precedente.

Windows

Per disinstallare Ops Agent, segui questi passaggi:

  1. Connettiti all'istanza utilizzando RDP o uno strumento simile e accedi a Windows.

  2. Apri un terminale PowerShell con privilegi di amministratore facendo clic con il tasto destro del mouse sull'icona di PowerShell e selezionando Esegui come amministratore.

  3. Esegui il seguente comando PowerShell:

    googet -noconfirm remove google-cloud-ops-agent

VM senza accesso remoto ai pacchetti

L'installazione dell'Ops Agent richiede l'accesso ai repository di pacchetti remoti, sia per il pacchetto dell'agente sia (su Linux) per le relative dipendenze.

Se utilizzi VPC-SC o una rete privata, anche la configurazione di rete potrebbe influire sulla tua capacità di installare le dipendenze dell'agente dai repository upstream. I pacchetti degli agenti sono accessibili tramite l'accesso privato Google. Questa operazione può essere configurata seguendo la procedura descritta in Attivare l'accesso privato Google.

Se la policy di sicurezza dell'host VM nega l'accesso ai repository di pacchetti remoti, ti consigliamo di creare un'immagine VM personalizzata con l'agente preinstallato e di disabilitare la gestione dei pacchetti in questa immagine.

Passaggi successivi