Installazione dell'agente operativo su singole VM

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

L'agente operativo raccoglie i log e le 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 avere quanto segue:

Installazione dell'agente dalla riga di comando

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

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 all'istanza VM utilizzando 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 alla tua istanza utilizzando RDP o uno strumento simile e accedi a Windows.

  2. Per aprire un terminale PowerShell con privilegi di amministratore, fai clic con il tasto destro del mouse sull'icona di PowerShell e seleziona Esegui come amministratore.

  3. Esegui questi 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 all'istanza VM utilizzando 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

    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 per l'installazione dello script.
    • --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 precedente (StackdriverLogging).
    • --uninstall-standalone-monitoring-agent: Disinstalla l'agente Monitoring legacy (StackdriverMonitoring).

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

  4. Aggiungi il repository dei pacchetti dell'agente e installalo:

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

    2. Per ambienti di produzione, consigliamo di limitare l'aggiornamento a 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 il codice 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

Una volta completata correttamente, puoi eliminare lo script di installazione.

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

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

    Lo stato dell'agente deve essere OK.

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

Windows

  1. Connettiti alla tua istanza utilizzando RDP o uno strumento simile e accedi a Windows.

  2. Per aprire un terminale PowerShell con privilegi di amministratore, fai clic con il tasto destro del mouse sull'icona di PowerShell e seleziona 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 per l'installazione dello script.
    • -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 precedente (StackdriverLogging).
    • -UninstallStandaloneMonitoringAgent: Disinstalla l'agente Monitoring legacy (StackdriverMonitoring).

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

  4. Aggiungi il repository dei pacchetti dell'agente e installalo:

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

    2. Per ambienti di produzione, consigliamo di limitare l'aggiornamento a 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 il codice 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"

Una volta completata correttamente, puoi eliminare lo script di installazione.

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

    Get-Service google-cloud-ops-agent

    Lo stato dell'agente deve essere Running.

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

Installare l'agente utilizzando la console Google Cloud

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

Cloud Monitoring

  1. Nella console Google Cloud, seleziona il tuo progetto Google Cloud.

    Vai alla console Google Cloud

  2. Nel riquadro di navigazione, seleziona Monitoring.

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

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

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

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

La colonna Agente indica i seguenti valori:

  • Non rilevato: nessun agente installato. Se Cloud Monitoring non rileva agenti installati nell'istanza di Compute Engine, puoi installare un agente nel seguente modo:

    • Seleziona le istanze VM su cui vuoi installare gli agenti.

    • Fai clic sull'opzione Installa/aggiorna agenti nella tabella Istanze, che mostra un flusso di lavoro di installazione nella dashboard, e segui le istruzioni.

      Puoi anche installare o aggiornare gli agenti dalla pagina Dettagli VM per una VM specifica.

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

  • Agente operativo: stai eseguendo l'agente operativo. 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 dell'agente Ops nella tabella, vengono visualizzate le informazioni sulla versione dell'agente Ops. Se stai utilizzando una versione precedente, viene visualizzato anche un consiglio per l'upgrade dell'agente.

  • Pending (In attesa): l'agente Ops è in fase di installazione o upgrade.

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

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

Compute Engine

  1. Vai alla pagina Istanze VM nella console Google Cloud.

    Istanze VM

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

  3. Fai clic sulla scheda Osservabilità. Si apre la pagina Osservabilità.

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

  5. Fai clic su Esegui in Cloud Shell. Cloud Shell si 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 viene visualizzata 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, segui questi passaggi:

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 il comando seguente sulla tua istanza VM:

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

Windows

  1. Se utilizzi un proxy HTTP, esegui questo comando dal prompt dei comandi dell'amministratore. Questa operazione imposta le variabili di ambiente HTTP_PROXY e HTTPS_PROXY in modo che l'agente possa inviare dati tramite 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

Per determinare la versione dell'agente Ops sul sistema, esegui questi comandi sull'istanza VM:

console Google Cloud

Per visualizzare la versione dell'agente Ops su una VM:

  • Individua la voce della VM nella tabella Istanze nella pagina Monitoraggio di istanze VM. Per informazioni sulla navigazione, consulta la pagina relativa all'installazione dell'agente tramite la console Google Cloud.

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

CENTOS / RHEL

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

FINESTRE

Esegui questo comando su Windows:

googet installed google-cloud-ops-agent

Riavvio dell'agente in corso...

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

LINUX

Esegui questo comando sulla tua istanza:

 sudo service google-cloud-ops-agent restart

Windows

  1. Connettiti alla tua istanza utilizzando RDP o uno strumento simile e accedi a Windows.

  2. Per aprire un terminale PowerShell con privilegi di amministratore, fai clic con il tasto destro del mouse sull'icona di PowerShell e seleziona 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 Ops alla release più recente, segui queste istruzioni:

console Google Cloud

Puoi eseguire l'upgrade dell'agente Ops utilizzando le istruzioni di installazione di Cloud Monitoring. Per ulteriori informazioni, consulta la pagina relativa all'installazione dell'agente utilizzando la console Google Cloud.

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 punto 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 alla release più recente dell'agente:

  1. Connettiti alla tua istanza utilizzando RDP o uno strumento simile e accedi a Windows.

  2. Per aprire un terminale PowerShell con privilegi di amministratore, fai clic con il tasto destro del mouse sull'icona di PowerShell e seleziona 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 questi comandi PowerShell per rimuovere l'agente installato e per 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 disponibili dell'agente, 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 Ops e i relativi file di configurazione, segui queste istruzioni.

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

Windows

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

  1. Connettiti alla tua istanza utilizzando RDP o uno strumento simile e accedi a Windows.

  2. Per aprire un terminale PowerShell con privilegi di amministratore, fai clic con il tasto destro del mouse sull'icona di PowerShell e seleziona 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'agente Ops richiede l'accesso per rimuovere i repository di pacchetti da remoto, sia per il pacchetto dell'agente sia per le dipendenze (su Linux).

Se utilizzi VPC-SC o una rete privata, la configurazione della rete potrebbe influire anche sulla possibilità di installare le dipendenze degli agenti dai repository a monte. I pacchetti degli agenti sono accessibili utilizzando l'accesso privato Google. Questa configurazione può essere configurata seguendo Abilita accesso privato Google.

Se il criterio di sicurezza dell'host della VM rifiuta 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 quell'immagine.

Passaggi successivi