Ops Agent raccoglie log e metriche sulle istanze Compute Engine, inviando i log a Cloud Logging e le metriche a Cloud Monitoring.
Prima di iniziare
Per installare l'agente, assicurati di disporre di quanto segue:
Un'istanza VM supportata in un progetto Google Cloud.
Le credenziali nell'istanza VM che autorizzano la comunicazione con Cloud Logging e Cloud Monitoring. Istanze VM di Compute Engine in genere dispongono delle credenziali corrette per impostazione predefinita. Se stai utilizzando molto vecchio alle istanze Compute Engine o se hai creato di istanze senza le credenziali predefinite, potresti non disporre e credenziali. Devi completare le procedure di autorizzazione dell'agente operativo.
Assicurati di attivare i servizi per entrambi l'API Cloud Logging e l'API Cloud Monitoring.
Assicurati che sulla VM non sia presente la versione legacy di Cloud Logging o agente Cloud Monitoring installato. Ciò può causare l'importazione di log duplicati o un conflitto in importazione delle metriche. Inoltre, questo agente utilizza nuovi file di configurazione che non sono compatibili con i vecchi agenti.
Se hai installato gli agenti precedenti, salva i file di configurazione personalizzati l'agente Cloud Monitoring e i file di configurazione personalizzati per Cloud Logging agente prima e completare passaggi per la disinstallazione di Cloud Monitoring di Compute Engine e i passaggi di disinstallazione l'agente Cloud Logging.
Per gli utenti con VM che non hanno accesso ai repository dei pacchetti remoti, consulta la sezione VM senza accesso ai pacchetti remoti per ulteriori informazioni.
Installare l'agente automaticamente durante la creazione della VM
Per ulteriori informazioni, consulta Installare 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
Apri una connessione da terminale all'istanza VM utilizzando SSH o uno strumento simile e assicurati di disporre dell'accesso
sudo
.Passa a una directory a cui hai accesso in scrittura, ad esempio la tua home page .
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
Connettiti all'istanza utilizzando RDP o uno strumento simile e accedi a Windows.
Apri un terminale PowerShell con privilegi amministrativi facendo clic con il tasto destro del mouse sul Icona di PowerShell e selezionando Esegui come amministratore.
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
Apri una connessione da terminale all'istanza VM utilizzando SSH o uno strumento simile e assicurati di disporre dell'accesso
sudo
.Passa a una directory a cui hai accesso in scrittura, ad esempio la tua home page .
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 dello script. Per informazioni sulle versioni, vedi Elenco di tutte le versioni degli agenti.--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 l'agente di 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.
Aggiungi il repository dei pacchetti dell'agente e installa l'agente:
Per elencare le versioni dell'agente disponibili, consulta Elenco di tutte le versioni dell'agente.
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 la versione 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 averlo 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 "Metrics Agent" in esecuzione.
Se hai 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 amministrativi facendo clic con il tasto destro del mouse sul 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 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 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 la versione precedente Agente Logging (StackdriverLogging
).-UninstallStandaloneMonitoringAgent
: disinstalla la versione precedente Agente di monitoraggio (StackdriverMonitoring
).
Per ulteriori informazioni ed esempi di utilizzo, consulta i commenti dello script.
Aggiungi il repository dei pacchetti dell'agente e installa l'agente:
Per elencare le versioni dell'agente disponibili, consulta Elenca tutte le versioni dell'agente.
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.*.*"
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.
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 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 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 Agent 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, vedi 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à.
Ops Agent: l'agente operativo è 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, 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 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 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 la sezione Eseguire la migrazione dagli agenti legacy all'agente operativo per informazioni sulla transizione all'agente operativo.
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, consulta Gestire le VM coperte dal criterio del sistema operativo di Ops Agent. I criteri del sistema operativo di Ops Agent non sono supportati in tutte le versioni dei sistemi operativi sistemi operativi. 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 configurando l'agente operativo.
Compute Engine
-
Nella console Google Cloud, vai alla pagina Istanze VM:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Compute Engine.
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, 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 operativi. 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'utilizzo di gcpdiag prevede alcuni 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 Dashboard delle istanze VM:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
Poi controlla che la colonna Agent per questa VM indichi Ops Agent.
Utilizzare gcpdiag
Per informazioni sull'utilizzo di gcpdiag, consulta 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 alle API di logging e monitoraggio, segui questi passaggi:
Linux
Modifica il file di configurazione seguente (crea il file, se non è già presente esistenti):
/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 il seguente comando da un prompt dei comandi amministrativo. 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
Determinare 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:
Individua la voce per la VM nella tabella Istanze nella sezione Monitoraggio delle 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 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
Per rilevare le modifiche apportate alle modifiche, devi riavviare Ops Agent di configurazione dei deployment. Per riavviare l'agente, segui le istruzioni riportate di seguito.
LINUX
Esegui il seguente 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 amministrativi facendo clic con il tasto destro del mouse sul Icona di PowerShell e selezionando Esegui come amministratore.
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 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 release più recente dell'agente:
Connettiti all'istanza utilizzando RDP o uno strumento simile e accedi a Windows.
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"
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
Elenca tutte le versioni dell'agente
Per elencare le versioni dell'agente disponibili, esegui il comando seguente:
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 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, segui le istruzioni riportate di seguito.
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
Facoltativamente, per rimuovere il repository e disinstallare l'agente,
aggiungi --remove-repo
al comando precedente.
Windows
Per disinstallare Ops Agent:
Connettiti all'istanza utilizzando RDP o uno strumento simile e accedi a Windows.
Apri un terminale PowerShell con privilegi amministrativi facendo clic con il tasto destro del mouse sul Icona di PowerShell e selezionando Esegui come amministratore.
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 ai repository dei pacchetti remoti, sia per il pacchetto dell'agente sia (su Linux) per le relative dipendenze.
Se utilizzi VPC-SC o una rete privata, la configurazione di rete potrebbe influire anche sulla tua capacità di installare le dipendenze dell'agente dai repository a monte. I pacchetti di agenti stessi accessibile tramite Private Google Accesso. Questa opzione può essere configurata seguendo la procedura descritta in Abilitare l'accesso privato Google.
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.