Ops Agent 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 avere quanto segue:
Un'istanza VM supportata in un progetto Google Cloud.
Credenziali sull'istanza VM che autorizzano la comunicazione con Cloud Logging e Cloud Monitoring. Le istanze VM di Compute Engine in genere dispongono delle credenziali corrette per impostazione predefinita. Se stai eseguendo istanze Compute Engine molto vecchie o se hai creato istanze di Compute Engine senza le credenziali predefinite, potresti non disporre delle credenziali corrette. Devi completare le procedure di autorizzazione di Ops Agent.
Assicurati di aver abilitato i servizi sia per l'API Cloud Logging sia per l'API Cloud Monitoring.
Assicurati che sulla VM non sia installato l'agente Cloud Logging o l'agente Cloud Monitoring legacy. Ciò può causare l'importazione di log duplicati o un conflitto nell'importazione delle metriche. Inoltre, questo agente utilizza nuovi file di configurazione che non sono compatibili con gli agenti precedenti.
Se hai installato gli agenti precedenti, salva i file di configurazione personalizzati per l'agente Cloud Monitoring e i file di configurazione personalizzata per l'agente Cloud Logging, quindi completa i passaggi di disinstallazione dell'agente Cloud Monitoring e i passaggi di disinstallazione dell'agente Cloud Logging.
Per ulteriori informazioni, consulta la sezione VM senza accesso ai pacchetti remoto per gli utenti con VM che non hanno accesso ai repository di pacchetti remoti.
Installazione automatica dell'agente durante la creazione della VM
Per maggiori informazioni, consulta Installare Ops Agent durante la creazione delle VM.
Installazione dell'agente dalla 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 in corso...
Per installare la versione più recente dell'agente, completa i seguenti passaggi.
Linux
Apri una connessione terminale con l'istanza VM tramite SSH o uno strumento simile e assicurati di avere accesso a
sudo
.Passa a una directory a cui hai accesso in scrittura, ad esempio la tua home directory.
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
Dopo l'installazione, l'agente viene avviato automaticamente.
Windows
Connettiti all'istanza utilizzando RDP o uno strumento simile e accedi a Windows.
Apri un terminale PowerShell con privilegi di amministratore facendo clic con il pulsante destro del mouse sull'icona di PowerShell e selezionando Esegui come amministratore.
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 passaggi riportati di seguito.
Linux
Apri una connessione terminale con l'istanza VM tramite SSH o uno strumento simile e assicurati di avere accesso a
sudo
.Passa a una directory a cui hai accesso in scrittura, ad esempio la tua home directory.
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 impostare anche 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 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 Logging legacy (StackdriverLogging
).--uninstall-standalone-monitoring-agent
: disinstalla l'agente Monitoring legacy (StackdriverMonitoring
).
Consulta i commenti dello script per ulteriori informazioni ed esempi di utilizzo.
Aggiungi il repository di pacchetti dell'agente e installa l'agente:
Per elencare le versioni dell'agente disponibili al fine di selezionare quella da installare, consulta Elenco di tutte le versioni dell'agente.
Per gli ambienti di produzione, è consigliabile 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:
sudo bash add-google-cloud-ops-agent-repo.sh --also-install \ --version=MAJOR_VERSION.*.*
Ad esempio, per bloccare l'errore 1.x.x dell'agente, esegui:
sudo bash add-google-cloud-ops-agent-repo.sh --also-install \ --version=1.*.*
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 essere 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.
In caso di problemi con l'installazione, consulta la pagina Risoluzione dei problemi.
Windows
Connettiti all'istanza utilizzando RDP o uno strumento simile e accedi a Windows.
Apri un terminale PowerShell con privilegi di amministratore facendo clic con il pulsante destro del mouse sull'icona di PowerShell e selezionando Esegui come amministratore.
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 impostare anche 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 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 Logging legacy (StackdriverLogging
).-UninstallStandaloneMonitoringAgent
: disinstalla l'agente Monitoring legacy (StackdriverMonitoring
).
Consulta i commenti dello script per ulteriori informazioni ed esempi di utilizzo.
Aggiungi il repository di pacchetti dell'agente e installa l'agente:
Per elencare le versioni dell'agente disponibili al fine di selezionare quella da installare, consulta Elenco di tutte le versioni dell'agente.
Per gli ambienti di produzione, è consigliabile 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:
Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version MAJOR_VERSION.*.*"
Ad esempio, per bloccare l'errore 1.x.x dell'agente, esegui:
Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version 1.*.*"
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 essere 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
.
In caso di problemi con l'installazione, consulta la pagina Risoluzione dei problemi.
Installazione dell'agente mediante la console Google Cloud
Puoi installare Ops Agent su una o più VM di Compute Engine utilizzando la console Google Cloud dalle pagine di Cloud Monitoring o Compute Engine.
Cloud Monitoring
Nel pannello di navigazione della console Google Cloud, seleziona Monitoring, seleziona Dashboard e quindi Istanze VM:
Vai alla dashboard delle istanze VM
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 hai installato un agente o l'agente non è in esecuzione. Se non sai se hai installato un agente, puoi eseguire una query sulla versione installata. Se hai installato l'agente, puoi riavviarlo. Se hai installato e avviato Ops Agent, ma lo stato rimane Non rilevato, l'agente potrebbe non essere stato avviato correttamente o non è in grado di inviare 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 relativi all'importazione dei dati. Potrebbero essere utili anche lo script di diagnostica degli agenti e i controlli di integrità generali.
Ops Agent: stai eseguendo Ops Agent. Se non vedi un segno di spunta verde accanto alla voce, significa che è disponibile un upgrade dell'agente in base al sistema operativo della VM rilevato.
Quando passi il mouse sopra l'indicatore Ops Agent nella tabella, visualizzi informazioni sulla versione di Ops Agent. Se esegui una versione precedente, viene visualizzato anche un suggerimento 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 durante l'applicazione del criterio del sistema operativo di Ops Agent o l'avvio dell'agente. Per informazioni sulla risoluzione dei problemi, consulta Strumento di diagnostica degli agenti per i criteri di installazione automatica.
Agente legacy: stai eseguendo l'agente legacy di Monitoring o Logging. Consulta Migrazione dagli agenti legacy a Ops Agent 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 è sconosciuto.
Puoi installare Ops Agent nel modo seguente:
- 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 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 fornisce una serie di comandi da eseguire in Cloud Shell.
Ops Agent raccoglie sia le metriche che i log per impostazione predefinita. Puoi modificare questo comportamento predefinito configurando Ops Agent.
Compute Engine
-
Nel pannello di navigazione della console Google Cloud, seleziona Compute Engine e poi Istanze VM:
Fai clic sul nome della VM su cui vuoi installare l'agente.
Fai clic sulla scheda Osservabilità.
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 fornisce una serie di comandi da eseguire in Cloud Shell.
Ops Agent raccoglie sia le metriche che i 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 durante l'applicazione del criterio del sistema operativo di Ops Agent o l'avvio dell'agente. Per informazioni sulla risoluzione dei problemi, consulta Strumento di diagnostica degli agenti per i criteri di installazione automatica.
Verifica che Ops Agent sia in esecuzione
Esistono due modi per verificare che Ops Agent funzioni correttamente:
Verifica che tutti i controlli di integrità siano stati superati.
-
Nel pannello di navigazione della console Google Cloud, seleziona Monitoring, seleziona Dashboard e quindi Istanze VM:
Vai alla dashboard delle istanze VM
Verifica quindi che la colonna Agent per questa VM indichi Ops Agent.
Attività facoltative
Questa sezione descrive come eseguire le attività di manutenzione più comuni.
Configurazione di un proxy HTTP
Se utilizzi un proxy HTTP per eseguire il proxy delle richieste alle API Logging e Monitoring, segui questi passaggi:
Linux
Modifica il seguente file di configurazione (crea il file se non esiste già):
/etc/systemd/system.conf
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.
Ricarica le variabili di ambiente:
sudo systemctl daemon-reload
Riavvia l'agente eseguendo questo comando sull'istanza VM:
sudo systemctl restart google-cloud-ops-agent"*"
Windows
Se utilizzi un proxy HTTP, esegui questo comando dal prompt dei comandi dell'amministratore. In questo modo vengono impostate le variabili di ambiente
HTTP_PROXY
eHTTPS_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
Per determinare la versione di Ops Agent sul tuo sistema, esegui i comandi seguenti sull'istanza VM:
Console Google Cloud
Per visualizzare la versione del tuo Ops Agent su una VM:
Individua la voce relativa alla VM nella tabella Istanze nella pagina Istanze VM in Monitoring. Per informazioni sulla navigazione, consulta Installazione dell'agente mediante la console Google Cloud.
Passa il mouse sopra l'indicatore Ops Agent nella voce della tabella.
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
FINESTRE
Esegui questo comando su Windows:
googet installed google-cloud-ops-agent
Riavvio dell'agente in corso...
Per recuperare le modifiche ai file di configurazione, devi riavviare Ops Agent. Per riavviare l'agente, segui le istruzioni riportate di seguito.
LINUX
Esegui questo comando sull'istanza:
sudo systemctl restart google-cloud-ops-agent
Windows
Connettiti all'istanza utilizzando RDP o uno strumento simile e accedi a Windows.
Apri un terminale PowerShell con privilegi di amministratore facendo clic con il pulsante destro del mouse sull'icona di PowerShell e selezionando Esegui come amministratore.
Esegui il seguente comando PowerShell:
Restart-Service google-cloud-ops-agent -Force
Upgrade dell'agente in corso...
Per eseguire l'upgrade di Ops Agent alla release più recente, segui queste istruzioni:
Console Google Cloud
Puoi eseguire l'upgrade di Ops Agent utilizzando le istruzioni di installazione di Cloud Monitoring. Per ulteriori informazioni, consulta Installazione dell'agente mediante la 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:
Connettiti all'istanza utilizzando RDP o uno strumento simile e accedi a Windows.
Apri un terminale PowerShell con 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"
Esegui i seguenti comandi di 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
Elenco di 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
FINESTRE
Elenca le versioni disponibili dell'agente:
googet available google-cloud-ops-agent
Disinstallazione dell'agente
Per rimuovere Ops Agent e i relativi file di configurazione, segui le istruzioni riportate di seguito.
Dopo la disinstallazione dell'agente, la console Google Cloud potrebbe impiegare fino a un'ora per segnalare la modifica.
Linux
Esegui questo comando:
sudo bash add-google-cloud-ops-agent-repo.sh --uninstall
Facoltativamente, per rimuovere il repository oltre a disinstallare l'agente, aggiungi --remove-repo
al comando precedente.
Windows
Per disinstallare Ops Agent, segui questi passaggi:
Connettiti all'istanza utilizzando RDP o uno strumento simile e accedi a Windows.
Apri un terminale PowerShell con privilegi di amministratore facendo clic con il pulsante destro del mouse sull'icona di PowerShell e selezionando Esegui come amministratore.
Esegui il seguente comando PowerShell:
googet -noconfirm remove google-cloud-ops-agent
VM senza accesso ai pacchetti remoto
L'installazione di Ops Agent richiede l'accesso ai repository di pacchetti remoti, sia per il pacchetto agente sia (su Linux) le sue dipendenze.
Se utilizzi VPC-SC o una rete privata, la configurazione di rete potrebbe influire anche sulla capacità di installare le dipendenze degli agenti dai repository a monte. I pacchetti dell'agente sono accessibili mediante l'accesso privato Google. Questa opzione può essere configurata in base ad Abilita l'accesso privato Google.
Se il criterio di sicurezza dell'host della VM nega l'accesso ai repository dei 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
Scopri di più sui log che l'agente invia a Cloud Logging utilizzando la configurazione predefinita.
Per informazioni sulla visualizzazione dei log, consulta Utilizzo di Esplora log.