Installazione dell'agente operativo su singole VM

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

Prima di iniziare

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

Installa automaticamente l'agente durante la creazione della VM

Per ulteriori informazioni, vedi Installa Ops Agent durante la creazione della VM.

Installa l'agente dalla riga di comando

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

Installa la 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 accesso a sudo.

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

  3. Scarica ed esegui lo script di installazione dell'agente utilizzando il seguente codice :

    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 sul 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 del terminale all'istanza VM utilizzando SSH o uno strumento simile e assicurati di avere accesso a sudo.

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

  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 il valore i seguenti flag:

    • --verbose: attiva il logging dettagliato durante l'esecuzione dello script.
    • --also-install: installa l'agente dopo aver aggiunto il pacchetto dell'agente repository Git.
    • --version: imposta la versione dell'agente da installare dello script. Per informazioni sulla versione, vedi Elencare tutte le versioni dell'agente.
    • --uninstall: disinstalla l'agente.
    • --remove-repo: rimuove il repository di pacchetti dell'agente corrispondente dopo installando o disinstallando l'agente.
    • --dry-run: attiva solo una prova dell'esecuzione dello script e stampa i comandi che dovrebbe eseguire.
    • --uninstall-standalone-logging-agent: disinstalla la versione precedente Agente Logging (StackdriverLogging).
    • --uninstall-standalone-monitoring-agent: disinstalla la versione precedente Agente di monitoraggio (StackdriverMonitoring).

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

  4. Aggiungi il repository di pacchetti dell'agente e installa l'agente:

    1. Per elencare le versioni dell'agente disponibili, consulta Elenca tutte le versioni dell'agente.

    2. Per gli ambienti di produzione, potresti voler aggiungere a una versione principale evitare di installare versioni principali che potrebbero includere applicazioni modifiche. Per bloccare una versione principale, esegui:

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

      Ad esempio, per bloccare il componente 1.x.x del 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 eseguita correttamente l'esecuzione, puoi eliminare lo script di installazione.

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

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

    Verifica che i componenti "Agente Logging" e "Metrics Agent" in esecuzione.

In caso di problemi con l'installazione, consulta 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 sul 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 il valore i seguenti flag:

    • -Verbose: attiva il logging dettagliato durante l'esecuzione dello script.
    • -AlsoInstall: installa l'agente dopo aver aggiunto il pacchetto dell'agente repository Git.
    • -Version: imposta la versione dell'agente da installare dello script. Per informazioni sulla versione, vedi Elencare tutte le versioni dell'agente.
    • -Uninstall: disinstalla l'agente.
    • -RemoveRepo: rimuove il repository di pacchetti dell'agente corrispondente dopo installando o disinstallando l'agente.
    • -WhatIf: attiva solo una prova dell'esecuzione dello script e stampa i comandi che dovrebbe eseguire.
    • -UninstallStandaloneLoggingAgent: disinstalla la versione precedente Agente Logging (StackdriverLogging).
    • -UninstallStandaloneMonitoringAgent: disinstalla la versione precedente Agente di monitoraggio (StackdriverMonitoring).

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

  4. Aggiungi il repository di pacchetti dell'agente e installa l'agente:

    1. Per elencare le versioni dell'agente disponibili, consulta Elenca tutte le versioni dell'agente.

    2. Per gli ambienti di produzione, potresti voler aggiungere a una versione principale evitare di installare versioni principali che potrebbero includere applicazioni modifiche. 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 l'agente 1.x.x, 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 eseguita correttamente l'esecuzione, puoi eliminare lo script di installazione.

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

Installa l'agente utilizzando la console Google Cloud

Puoi installare Ops Agent su una o più VM di Compute Engine utilizzando Console Google Cloud dalle pagine di Cloud Monitoring o Compute Engine.

Cloud Monitoring

Nella console Google Cloud, vai alla pagina della dashboard delle istanze VM:

Vai alla dashboard delle istanze VM

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

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 delle istanze VM in Monitoring mostra lo stato di e gli agenti interessati.

La colonna Agent riporta i seguenti valori:

  • Non rilevato: non hai installato un agente oppure è in corso non in esecuzione. Se non sai con certezza se hai installato un agente, può eseguire query per la versione installata. Se hai installato L'agente, dopodiché potrai riavviarlo. Se hai installato e avviato Ops Agent, ma lo stato rimane Non rilevato, è possibile che l'agente non si sia avviato correttamente o che non è in grado di inviare metriche.

    Per risolvere i problemi di avvio, vedi L'agente è installato ma non in esecuzione. Per risolvere i problemi di importazione delle metriche, consulta la sezione Risoluzione dei problemi relativi ai dati. importazione. Informazioni generali script di diagnostica dell'agente e i controlli di integrità potrebbe essere utile.

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

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

  • In attesa: Ops Agent è in fase di installazione o upgrade.

    Se l'installazione dell'agente rimane In attesa per più di 10 minuti, potrebbe esserci un problema di applicazione del criterio di sistema operativo Ops Agent avviare l'agente. Per la risoluzione dei problemi le informazioni, vedi Strumento di diagnostica dell'agente per i criteri di installazione automatica.

  • Agente legacy: stai eseguendo la versione precedente di Monitoring o l'agente Agente Logging. Consulta Migrazione dagli agenti legacy a Ops Agente per informazioni sulla transizione a Ops Agent.

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

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

Puoi installare Ops Agent seguendo 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 Ops Agent la pagina Dettagli VM per una VM specifica.

Se possibile, l'agente viene installato utilizzando un criterio di sistema operativo Ops Agent. Per ulteriori informazioni, vedi Gestisci le VM coperte dal criterio del sistema operativo Ops Agent. I criteri del sistema operativo di Ops Agent non sono supportati in tutte le versioni dei sistemi operativi sistemi diversi. In questo caso, se fai clic su Installa/Aggiorna Ops Agent, una serie di comandi da eseguire in Cloud Shell.

Ops Agent raccoglie sia le metriche sia i log per impostazione predefinita. Puoi modificare questo comportamento predefinito di durante la configurazione di Ops Agent.

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 di sistema operativo Ops Agent. Per ulteriori informazioni, vedi Gestisci le VM coperte dal criterio del sistema operativo Ops Agent. I criteri del sistema operativo di Ops Agent non sono supportati in tutte le versioni dei sistemi operativi sistemi diversi. In questo caso, se fai clic su Installa/Aggiorna Ops Agent, una serie di comandi da eseguire in Cloud Shell.

    Ops Agent raccoglie sia le metriche sia i log per impostazione predefinita. Puoi modificare questo comportamento predefinito di durante la configurazione di Ops Agent.

    Se l'installazione dell'agente rimane In attesa per più di 10 minuti, potrebbe esserci un problema di applicazione del criterio di sistema operativo Ops Agent avviare l'agente. Per la risoluzione dei problemi le informazioni, vedi 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 in tutto il parco risorse VM. Tuttavia, lo stato potrebbe non essere preciso se alla VM mancano gli ambiti di accesso necessari o se l'account di servizio associato ha ruoli IAM insufficienti.

  • gcpdiag: gcpdiag fornisce informazioni più affidabili e affidabili rispetto alla dashboard Istanze VM, verificando sia l'installazione dell'agente sia la trasmissione dei dati di telemetria dalla VM. L'uso di gcpdiag prevede prerequisiti, ma offre un modo migliore per monitorare lo stato dell'agente.

Utilizza la dashboard delle istanze VM

Nella console Google Cloud, vai alla pagina della dashboard delle istanze VM:

Vai alla dashboard delle istanze VM

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

Poi controlla che la colonna Agent per questa VM indichi Ops Agent.

Utilizza gcpdiag

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

Attività facoltative

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

configura un proxy HTTP

Se utilizzi un proxy HTTP per il proxy delle richieste ai server di accesso Monitoring, segui questi passaggi:

Linux

  1. Modifica il file di configurazione seguente (crea il file, se non è già presente esistenti):

     /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 sull'istanza VM:

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

Windows

  1. Se utilizzi un proxy HTTP, esegui questo comando da un al prompt dei comandi dell'amministratore. Questa operazione imposta HTTP_PROXY e HTTPS_PROXY variabili di ambiente 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

Determina la versione dell'agente

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

Console Google Cloud

Per vedere 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 il comando seguente 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

Riavvia l'agente

Devi riavviare Ops Agent per rilevare le modifiche in di configurazione dei deployment. Per riavviare l'agente, segui le istruzioni riportate di seguito.

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 amministrativi facendo clic con il tasto destro del mouse sul 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 alla release più recente, utilizza seguendo le istruzioni riportate di seguito:

Console Google Cloud

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

Linux

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

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

Per eseguire l'upgrade dell'agente alla release più recente di una specifica versione principale, esegui questo comando:

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 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 sul 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 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 visualizzare l'elenco delle 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

FINESTRE

Elenca le versioni disponibili dell'agente:

googet available google-cloud-ops-agent

Disinstalla l'agente

Per rimuovere Ops Agent e i relativi file di configurazione, utilizza seguendo le istruzioni.

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

Linux

Esegui questo comando:

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

Facoltativamente, per rimuovere il repository e disinstallare l'agente, aggiungi --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 sul 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 di Ops Agent richiede l'accesso a repository di pacchetti remoti, sia per il pacchetto agente sia (su Linux) delle dipendenze.

Se utilizzi VPC-SC o una rete privata, la configurazione di rete potrebbe influire sulla capacità di installare l'agente delle dipendenze da repository upstream. I pacchetti di agenti stessi accessibile tramite Private Google Accesso. Può essere configurato seguendo le istruzioni riportate in Abilita Private Google Accesso.

Se il criterio di sicurezza dell'host della VM nega l'accesso ai repository di pacchetti remoti, consigliamo di creare una VM personalizzata dell'immagine con l'agente ha preinstallato e disattivato la gestione dei pacchetti nell'immagine.

Passaggi successivi