Installazione dell'agente operativo su singole VM

Linux

1. Apri una connessione da 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 amministrativi 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"
   

Linux

1. Apri una connessione da 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 il logging dettagliato durante l'esecuzione dello script.
   • --also-install: installa l'agente dopo aver aggiunto il repository del pacchetto dell'agente.
   • --version: imposta la versione dell'agente da installare per lo script. Per informazioni sulle versioni, vedi Elenco di tutte le versioni degli agenti.
   • --uninstall: disinstalla l'agente.
   • --remove-repo: rimuove il repository del pacchetto dell'agente corrispondente dopo l'installazione o la disinstallazione dell'agente.
   • --dry-run: attiva solo una prova dell'esecuzione dello script e stampa i comandi che dovrebbe 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 repository dei pacchetti dell'agente e installa l'agente:

   1. Per elencare le versioni dell'agente disponibili, consulta 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 non compatibili con le versioni precedenti. Per bloccare una versione principale, esegui:

      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 averlo eseguito correttamente.

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

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

  Verifica che i componenti "Agente di log" e "Agente di misurazione" siano in esecuzione.

Se hai problemi 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 amministrativi 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 il logging dettagliato durante l'esecuzione dello script.
   • -AlsoInstall: installa l'agente dopo aver aggiunto il repository del pacchetto dell'agente.
   • -Version: imposta la versione dell'agente da installare per lo script. Per informazioni sulle versioni, vedi Elenco di tutte le versioni degli agenti.
   • -Uninstall: disinstalla l'agente.
   • -RemoveRepo: rimuove il repository del pacchetto dell'agente corrispondente dopo l'installazione o la disinstallazione dell'agente.
   • -WhatIf: attiva solo una prova dell'esecuzione dello script e stampa i comandi che dovrebbe 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 repository dei pacchetti dell'agente e installa l'agente:

   1. Per elencare le versioni dell'agente disponibili, consulta 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 non compatibili con le versioni precedenti. Per bloccare una versione principale, esegui:

      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 averlo 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 problemi con l'installazione, consulta la pagina Risoluzione dei problemi.

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 colonna Agente riporta i seguenti valori:

• Non rilevato: non è installato alcun agente o non è in esecuzione. Se non sai con certezza se hai installato un agente, puoi eseguire una query per la versione installata. Se hai installato l'agente, puoi riavviare l'agente. 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 le metriche.

  Per risolvere i problemi di avvio, consulta 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 di diagnostica dell'agente e i controlli di integrità.

• Agente operativo: l'Ops Agent è in esecuzione. Se non vedi un segno di spunta verde accanto alla voce, significa che è 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 dell'agente operativo. Se utilizzi una versione precedente, viene visualizzato 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 stato Pending (In attesa) per più di 10 minuti, potrebbe esserci un problema con l'applicazione del criterio del sistema operativo di Ops Agent o con l'avvio dell'agente. Per informazioni sulla risoluzione dei problemi, consulta lo strumento di diagnostica dell'agente per i criteri di installazione automatica.

• Agente legacy: stai eseguendo l'agente Monitoring o Logging legacy. Consulta la sezione Eseguire la 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.

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

Per installare Ops Agent, segui questi passaggi:

• 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 l'Ops Agent dalla pagina Dettagli VM di una VM specifica.

Se possibile, l'agente viene installato utilizzando un criterio del sistema operativo di Ops Agent. Per ulteriori informazioni, consulta Gestire le VM coperte dal criterio del sistema operativo di Ops Agent. I criteri del sistema operativo di Ops Agent non sono supportati su tutte le versioni di tutti i sistemi operativi. In questo caso, facendo clic su Installa/aggiorna Ops Agent viene visualizzata una serie di comandi da eseguire in Cloud Shell.

Per impostazione predefinita, Ops Agent raccoglie sia le metriche sia i log. Puoi modificare questo comportamento predefinito configurando l'agente operativo.

Compute Engine

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 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 un criterio del sistema operativo di Ops Agent. Per ulteriori informazioni, consulta Gestire le VM coperte dal criterio del sistema operativo di Ops Agent. I criteri del sistema operativo di Ops Agent non sono supportati su tutte le versioni di tutti i sistemi operativi. In questo caso, facendo clic su Installa/aggiorna Ops Agent viene visualizzata una serie di comandi da eseguire in Cloud Shell.

   Per impostazione predefinita, Ops Agent raccoglie sia le metriche sia i log. Puoi modificare questo comportamento predefinito configurando l'agente operativo.

   Se l'installazione dell'agente rimane in stato Pending (In attesa) per più di 10 minuti, potrebbe esserci un problema con l'applicazione del criterio del sistema operativo di Ops Agent o con l'avvio dell'agente. Per informazioni sulla risoluzione dei problemi, consulta lo strumento di diagnostica dell'agente per i criteri di installazione automatica.

Linux

1. Modifica il seguente file di configurazione (crea il file 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. Riavviare l'agente eseguendo il seguente comando nell'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 amministrativo. 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 /m
   

Console Google Cloud

Per visualizzare la versione di Ops Agent su una VM:

• Individua la voce relativa alla VM nella tabella Istanze della pagina monitoraggio Istanze VM. Per informazioni sulla navigazione, consulta Installare l'agente utilizzando la console Google Cloud.

• Passa il mouse sopra l'indicatore Ops Agent nella voce della tabella.

CENTOS / RHEL

Esegui il seguente comando su Red Hat o CentOS Linux:

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

DEBIAN / UBUNTU

Esegui il seguente comando su Debian o Ubuntu:

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

SLES / SUSE

Esegui il seguente comando su SUSE:

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

WINDOWS

Esegui il seguente comando su Windows:

googet installed google-cloud-ops-agent

LINUX

Esegui il seguente 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 amministrativi 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

Console Google 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 console Google Cloud.

Linux

Per eseguire l'upgrade dell'agente alla versione più recente, esegui il seguente comando:

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

Per eseguire l'upgrade dell'agente all'ultima release point di una versione principale specifica, esegui il seguente comando:

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

Windows

Per eseguire l'upgrade alla versione più recente dell'agente:

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

2. Apri un terminale PowerShell con privilegi amministrativi 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
   

CENTOS / RHEL

Elenca le versioni dell'agente disponibili:

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

DEBIAN / UBUNTU

Elenca le versioni dell'agente disponibili:

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

SLES / SUSE

Elenca le versioni dell'agente disponibili:

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

WINDOWS

Elenca le versioni dell'agente disponibili:

googet available google-cloud-ops-agent

Linux

Esegui questo comando:

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

Se vuoi, puoi rimuovere il repository oltre a disinstallare l'agente aggiungendo --remove-repo al comando precedente.

Windows

Per disinstallare Ops Agent:

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

2. Apri un terminale PowerShell con privilegi amministrativi 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