L'agente Monitoring 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 o in un account Amazon Web Services (AWS).
- Per eseguire l'agente di monitoraggio, è consigliato un minimo di 250 MiB di memoria residente (RSS).
Assicurati inoltre che la VM esegua un sistema operativo supportato.
Le credenziali nell'istanza VM che autorizzano la comunicazione con Cloud Logging o Cloud Monitoring. Le istanze VM di Compute Engine generalmente hanno le credenziali corrette per impostazione predefinita. Se uno dei seguenti scenari si applica al tuo caso, potresti non disporre delle credenziali appropriate e devi completare le procedure di autorizzazione dell'agente di monitoraggio:
Esegui istanze VM AWS EC2, devi installare le credenziali di autorizzazione sulle VM prima di installare l'agente.
Istanze Compute Engine molto vecchie o istanze Compute Engine create senza le credenziali predefinite.
Per verificare di disporre delle credenziali appropriate, esegui le procedure di verifica delle credenziali di Compute Engine.
Per informazioni sui prezzi, vai a Prezzi di Google Cloud Observability.
Se utilizzi VM che non hanno accesso ai repository dei pacchetti remoti, consulta la sezione VM senza accesso ai pacchetti remoti per ulteriori informazioni.
Installa l'agente dalla riga di comando
Per installare l'agente utilizzando la riga di comando, segui le istruzioni riportate di seguito.
Installa l'ultima versione 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 directory.
Scarica ed esegui lo script di installazione dell'agente utilizzando i seguenti comandi:
curl -sSO https://dl.google.com/cloudagents/add-monitoring-agent-repo.sh sudo bash add-monitoring-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 sull'icona di PowerShell e selezionando Esegui come amministratore.
Esegui i seguenti comandi PowerShell:
(New-Object Net.WebClient).DownloadFile("https://repo.stackdriver.com/windows/StackdriverMonitoring-GCM-46.exe", "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe") & "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe"
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 directory.
Scarica lo script di installazione dell'agente:
curl -sSO https://dl.google.com/cloudagents/add-monitoring-agent-repo.sh
Quando esegui lo script
add-monitoring-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 per lo script. Per informazioni sulle versioni, vedi Elenco di tutte le versioni degli agenti.--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.
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, ti consigliamo di bloccare una versione principale per evitare di installare versioni principali che potrebbero includere modifiche non compatibili con le versioni precedenti. Per bloccare una versione principale, esegui:
sudo bash add-monitoring-agent-repo.sh --also-install \ --version=MAJOR_VERSION.*.*
Ad esempio, per bloccare la versione 6.x.x dell'agente, esegui:
sudo bash add-monitoring-agent-repo.sh --also-install \ --version=6.*.*
Per installare una versione specifica dell'agente, esegui:
sudo bash add-monitoring-agent-repo.sh --also-install \ --version=MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION
Avvia il servizio dell'agente
sudo service stackdriver-agent start
Puoi eliminare lo script di installazione dopo averlo eseguito correttamente.
Per verificare che l'agente funzioni come previsto, esegui:
sudo service stackdriver-agent status
Lo stato dell'agente deve essere OK.
Puoi anche esaminare i log e assicurarti che non ci siano errori:
sudo grep collectd /var/log/{syslog,messages} | tail
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 sull'icona di PowerShell e selezionando Esegui come amministratore.
Esegui i seguenti comandi PowerShell:
(New-Object Net.WebClient).DownloadFile("https://repo.stackdriver.com/windows/StackdriverMonitoring-GCM-46.exe", "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe") & "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe"
In alternativa, puoi visitare il seguente URL per scaricare ed eseguire il programma di installazione dell'agente:
https://repo.stackdriver.com/windows/StackdriverMonitoring-GCM-46.exe
Per installare l'agente in modalità silenziosa, aggiungi l'opzione
/S
all'invocazione del programma di installazione:& "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe" /S
In modalità "silenzioso", utilizza l'opzione
/D
per specificare la directory di installazione, ad esempio:& "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe" /S /D="C:\Stackdriver\Google Cloud Observability\"
Puoi eliminare il programma di installazione al termine dell'operazione.
Se hai problemi con l'installazione, consulta la pagina Risoluzione dei problemi.
Visualizzazione delle informazioni sugli agenti utilizzando la console Google Cloud
Puoi trovare le informazioni sullo stato dell'agente nella dashboard preconfigurata Istanze VM di Monitoring. Per accedere a questa dashboard:
Nella console Google Cloud, vai alla pagina Dashboard 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 Agente 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.
Agente operativo: l'Ops Agent è 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, viene visualizzato anche un consiglio per eseguire l'upgrade dell'agente.
In attesa: è in corso l'installazione o l'upgrade di Ops Agent.
Agente legacy: stai eseguendo l'agente Monitoring o Logging legacy. Consulta la sezione Eseguire la migrazione dagli agenti legacy all'agente operativo per informazioni sulla transizione all'Ops Agent.
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.
Per installare Ops Agent, segui 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 l'Ops Agent dalla pagina Dettagli VM di 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 viene visualizzata una serie di comandi da eseguire in Cloud Shell.
Per impostazione predefinita, Ops Agent raccoglie sia le metriche sia i log. Puoi modificare questo comportamento predefinito configurando l'agente operativo.
Attività facoltative
Questa sezione descrive come eseguire le attività di manutenzione più comuni.
Configurazione dell'agente Monitoring
Per modificare la configurazione dell'agente, consulta Configurare l'agente Monitoring.
Configurare 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 seguente file di configurazione (crea il file se non esiste già):
Per le versioni dell'agente 6.0.0 e successive, modifica:
/etc/default/stackdriver-agent
Per le versioni dell'agente precedenti alla 6.0.0, modifica il file appropriato per il tuo sistema operativo:
Per Debian e Ubuntu, modifica:
/etc/default/stackdriver-agent
Per CentOS e SLES, modifica:
/etc/default/stackdriver-collectd
Aggiungi quanto segue al file:
export http_proxy="http://proxy-ip:proxy-port" export https_proxy="http://proxy-ip:proxy-port" export no_proxy=169.254.169.254 # Skip proxy for the local Metadata Server.
Riavviare l'agente eseguendo il seguente comando nell'istanza VM:
sudo service stackdriver-agent restart
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 169.254.169.254 /m
Determinare la versione dell'agente
Per determinare la versione dell'agente Monitoring sul tuo sistema, esegui i seguenti comandi nell'istanza VM:
AMAZON LINUX AMI / CENTOS / RHEL
Esegui il seguente comando su Amazon Linux, Red Hat o CentOS Linux:
rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' stackdriver-agent
DEBIAN / UBUNTU
Esegui il seguente comando su Debian o Ubuntu:
dpkg-query --show --showformat '${Package} ${Version} ${Architecture} ${Status}\n' stackdriver-agent
SLES / SUSE
Esegui il seguente comando su SUSE:
rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' stackdriver-agent
WINDOWS
Al momento non è possibile determinare la versione dell'agente Monitoring in esecuzione su Windows.
Riavvia l'agente
Devi riavviare l'agente di monitoraggio per rilevare le modifiche nei file di configurazione. Per riavviare l'agente, segui le istruzioni riportate di seguito.
LINUX
Esegui il seguente comando sull'istanza:
sudo service stackdriver-agent restart
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 sull'icona di PowerShell e selezionando Esegui come amministratore.
Esegui il seguente comando PowerShell:
Restart-Service -Name StackdriverMonitoring
Esegui l'upgrade dell'agente
Per eseguire l'upgrade dell'agente Monitoring all'ultima release, segui le seguenti istruzioni:
Linux
Per eseguire l'upgrade dell'agente alla versione più recente, esegui il seguente comando:
sudo bash add-monitoring-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-monitoring-agent-repo.sh --also-install \
--version=MAJOR_VERSION.*.*
Windows
Per eseguire l'upgrade alla versione più recente dell'agente, installa l'agente più recente come descritto in Installazione su Windows in questa pagina. Il programma di installazione ti chiede di disinstallare la versione precedente dell'agente.
Elenca tutte le versioni dell'agente
Per elencare le versioni dell'agente disponibili, esegui il comando seguente:
AMAZON LINUX AMI / CENTOS / RHEL
Elenca le versioni dell'agente disponibili:
sudo yum list --showduplicates stackdriver-agent
DEBIAN / UBUNTU
Elenca le versioni dell'agente disponibili:
sudo apt-cache madison stackdriver-agent
SLES / SUSE
Elenca le versioni dell'agente disponibili:
sudo zypper search -s stackdriver-agent
WINDOWS
L'installazione di versioni precedenti dell'agente su Windows non è supportata.
Disinstalla l'agente
Per rimuovere l'agente di monitoraggio 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-monitoring-agent-repo.sh --uninstall
Se vuoi, puoi rimuovere il repository oltre a disinstallare l'agente aggiungendo --remove-repo
al comando precedente.
Windows
Nel Pannello di controllo di Windows, scegli Disinstalla un programma. Dovresti vedere Agente di monitoraggio nell'elenco dei programmi che puoi disinstallare. Puoi anche eseguire uninstall.exe
dalla directory in cui hai installato l'agente Monitoring.
VM senza accesso ai pacchetti da remoto
L'installazione dell'agente Monitoring richiede l'accesso ai repository dei pacchetti remoti, sia per il pacchetto dell'agente sia (su Linux) per le sue 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 dell'agente sono accessibili tramite l'accesso privato Google. Questa opzione può essere configurata in base a Abilitare l'accesso privato Google.
Se il criterio di sicurezza della VM host nega l'accesso ai repository dei pacchetti remoti, ti consigliamo di creare un'immagine VM personalizzata con l'agente preinstallato e di disattivare la gestione dei pacchetti in quell'immagine.