Installazione dell'agente operativo su singole VM

L'agente operativo raccoglie log e metriche sulle istanze di Compute Engine, inviando i log a Cloud Logging e le metriche a Cloud Monitoring.

Prima di iniziare

Per installare l'agente, assicurati di disporre dei seguenti elementi:

Installazione dell'agente utilizzando la riga di comando

Per installare l'agente utilizzando la riga di comando, segui le istruzioni riportate di seguito.

Installazione della versione più recente dell'agente

Per installare la versione più recente dell'agente, completa i seguenti passaggi.

Linux

  1. Apri una connessione del terminale alla tua istanza VM tramite SSH o uno strumento simile e assicurati di avere l'accesso sudo.

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

  3. Esegui:

    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
    

Windows

  1. Connettiti all'istanza utilizzando RDP o uno strumento simile ed esegui l'accesso a Windows.

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

  3. Esegui i seguenti comandi di 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 del terminale alla tua istanza VM tramite SSH o uno strumento simile e assicurati di avere l'accesso sudo.

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

  3. Scarica lo script di installazione dell'agente:

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

    Durante l'esecuzione dello 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: consente di impostare la versione dell'agente per lo script da installare.
    • --uninstall: disinstalla l'agente.
    • --remove-repo: rimuove il repository dei pacchetti dell'agente corrispondente dopo aver installato o disinstallato l'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 di logging precedente (StackdriverLogging).
    • --uninstall-standalone-monitoring-agent: disinstalla l'agente Monitoring legacy (StackdriverMonitoring).

    Consulta i commenti sullo script per ulteriori informazioni ed esempi di utilizzo.

  4. Aggiungi il repository del pacchetto dell'agente e installalo:

    1. Per elencare le versioni dell'agente disponibili e selezionare la versione da installare, consulta Elencare tutte le versioni degli agenti.

    2. Per ambienti di produzione potresti voler fissare una versione principale per evitare di installare versioni principali che potrebbero includere modifiche incompatibili con le versioni precedenti. Per bloccare su una versione principale, esegui:

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

      Ad esempio, per bloccare l'elemento 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
      

Lo script di installazione può essere eliminato solo dopo l'esecuzione.

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

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

    Lo stato dell'agente deve essere OK.

In caso di problemi durante l'installazione, consulta la pagina Risoluzione dei problemi.

Windows

  1. Connettiti all'istanza utilizzando RDP o uno strumento simile ed esegui l'accesso a Windows.

  2. Apri un terminale PowerShell con i privilegi di amministratore facendo clic con il pulsante 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")
    

    Durante l'esecuzione dello 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: consente di impostare la versione dell'agente per lo script da installare.
    • -Uninstall: disinstalla l'agente.
    • -RemoveRepo: rimuove il repository dei pacchetti dell'agente corrispondente dopo aver installato o disinstallato l'agente.
    • -WhatIf: attiva solo una prova dell'esecuzione dello script e stampa i comandi che dovrebbe eseguire.
    • -UninstallStandaloneLoggingAgent: disinstalla l'agente di logging precedente (StackdriverLogging).
    • -UninstallStandaloneMonitoringAgent: disinstalla l'agente Monitoring legacy (StackdriverMonitoring).

    Consulta i commenti sullo script per ulteriori informazioni ed esempi di utilizzo.

  4. Aggiungi il repository del pacchetto dell'agente e installalo:

    1. Per elencare le versioni dell'agente disponibili e selezionare la versione da installare, consulta Elencare tutte le versioni degli agenti.

    2. Per ambienti di produzione potresti voler fissare una versione principale per evitare di installare versioni principali che potrebbero includere modifiche incompatibili con le versioni precedenti. Per bloccare su una versione principale, esegui:

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

      Ad esempio, per bloccare l'elemento sulla dimensione 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"
      

Lo script di installazione può essere eliminato solo dopo l'esecuzione.

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

    Get-Service google-cloud-ops-agent
    

    Lo stato dell'agente deve essere Running.

In caso di problemi durante l'installazione, consulta la pagina Risoluzione dei problemi.

Installazione dell'agente con Google Cloud Console

Puoi installare l'agente su una singola VM Linux utilizzando Cloud Console dalle pagine di Cloud Monitoring o Compute Engine.

Cloud Monitoring

  1. In Cloud Console, seleziona il tuo progetto Google Cloud.

    Vai a Cloud Console

  2. Nel riquadro di navigazione, seleziona Monitoraggio.

  3. Nel riquadro di navigazione di Monitoring, seleziona Dashboard.

  4. Nella tabella delle dashboard, individua la voce Istanze VM, quindi fai clic sul nome.

La scheda Inventario nella dashboard Istanze VM elenca tutte le VM e include una colonna di stato per l'agente, come illustrato nel seguente screenshot:

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

La colonna Agente riporta i seguenti valori:

  • Non rilevato: non hai installato un agente. Se Cloud Monitoring non rileva alcun agente installato sull'istanza di Compute Engine, puoi installare un agente procedendo nel seguente modo:

    • Seleziona le istanze VM su cui vuoi installare gli agenti.
    • Fai clic sull'opzione Installa agenti nella tabella Istanze, che visualizza un flusso di lavoro di installazione nella dashboard, e segui le istruzioni. L'agente operativo è l'agente predefinito che viene installato, ma il flusso di lavoro di installazione fornisce un link per installare gli agenti legacy.

      L'agente operativo raccoglie sia le metriche che i log per impostazione predefinita. Puoi cambiare questo comportamento predefinito configurando l'agente operativo.

  • Agente operativo: stai eseguendo l'agente operativo.

  • Agente legacy: stai eseguendo l'agente Monitoring o l'agente Logging precedente. Per informazioni sulla transizione all'agente operativo, consulta la sezione Migrazione dagli agenti legacy all'agente operativo.

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

Compute Engine

  1. Vai alla pagina Istanze VM in Cloud Console.

    Istanze VM

  2. Fai clic sul nome della VM su cui vuoi installare l'agente. Viene visualizzata la pagina Dettagli.

  3. Fai clic sulla scheda Osservabilità. Viene visualizzata la pagina Osservabilità.

  4. Fai clic su Install Ops Agent (Installa agente operativo).

  5. Fai clic su Esegui in Cloud Shell. Cloud Shell apre e incolla il comando di installazione.

  6. Premi Invio sulla tastiera per eseguire il comando.

  7. Fai clic su Autorizza per consentire a Cloud Shell di installare l'agente. L'installazione è riuscita se vedi una riga in Cloud Shell simile alla seguente:

    Instance: projects/example-project/zones/us-west1-a/instances/example-vm successfully runs ops-agent
    

Attività facoltative

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

Configurazione di un proxy HTTP

Se utilizzi un proxy HTTP per il proxy delle richieste alle API Logging e Monitoring, procedi come segue:

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. Riavvia l'agente eseguendo questo comando sulla tua istanza VM:

     sudo systemctl restart google-cloud-ops-agent.target
    

Windows

  1. Se utilizzi un proxy HTTP, esegui il comando seguente da un prompt dei comandi dell'amministratore. Imposta 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
    

Determinazione della versione dell'agente in corso...

Per determinare la versione dell'agente operativo sul sistema, esegui i comandi seguenti nella tua istanza VM:

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

Finestre

Esegui il seguente comando su Windows:

googet installed google-cloud-ops-agent

Riavvio dell'agente in corso...

Devi riavviare l'agente operativo per raccogliere le modifiche nei file di configurazione. Per riavviare l'agente, segui le istruzioni riportate di seguito.

LINUX

Esegui il seguente comando sulla tua istanza:

 sudo service google-cloud-ops-agent restart

Windows

  1. Connettiti all'istanza utilizzando RDP o uno strumento simile ed esegui l'accesso a Windows.

  2. Apri un terminale PowerShell con i privilegi di amministratore facendo clic con il pulsante 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

Upgrade dell'agente in corso...

Per eseguire l'upgrade dell'agente operativo all'ultima release, segui le istruzioni seguenti:

Linux

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

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

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

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 ed esegui l'accesso a Windows.

  2. Apri un terminale PowerShell con i privilegi di amministratore facendo clic con il pulsante 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 comandi PowerShell seguenti 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
    

Elenco di tutte le versioni dell'agente

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

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

Finestre

Elenca le versioni disponibili dell'agente:

googet available google-cloud-ops-agent

Disinstallazione dell'agente

Per rimuovere l'agente operativo e i relativi file di configurazione, segui le istruzioni riportate di seguito.

Dopo aver disinstallato l'agente, potrebbe essere necessaria fino a un'ora per segnalare la modifica in Google Cloud Console.

Linux

Esegui questo comando:

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

Windows

Per disinstallare l'agente operativo, procedi nel seguente modo:

  1. Connettiti all'istanza utilizzando RDP o uno strumento simile ed esegui l'accesso a Windows.

  2. Apri un terminale PowerShell con i privilegi di amministratore facendo clic con il pulsante 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 al pacchetto remoto

L'installazione dell'agente operativo richiede l'accesso per rimuovere i repository dei pacchetti, sia per il pacchetto dell'agente sia per le dipendenze.

Se utilizzi VPC-SC o una rete privata, la configurazione della rete potrebbe influire anche sulla tua capacità di installare dipendenze degli agenti da repository upstream. I pacchetti di agenti stessi sono accessibili mediante l'accesso privato Google.

Se il tuo criterio di sicurezza dell'host della VM nega l'accesso ai repository di pacchetti remoti, ti consigliamo di creare un'immagine VM personalizzata con l'agente preinstallato e la disattivazione della gestione dei pacchetti in quell'immagine.

Passaggi successivi