L'agente Cloud Monitoring raccoglie le metriche di sistema e di applicazione dai tuoi le istanze VM e le invia a Monitoring. Puoi anche configurare l'agente Monitoring per monitorare le applicazioni di terze parti.
Questa guida spiega come installare l'agente Cloud Monitoring per Monitoraggio su Compute Engine e Amazon Elastic Compute Cloud (EC2). L'utilizzo dell'agente è facoltativo, ma consigliato per Compute Engine di istanze VM di Compute Engine. Per queste VM, Il monitoraggio può accedere ad alcune metriche dall'hypervisor della VM senza l'agente, inclusi l'utilizzo della CPU, alcune metriche relative al traffico del disco, traffico e tempo di attività. Per Amazon Elastic Compute è necessario utilizzare l'agente VM Cloud (EC2).
Nelle istanze che eseguono Microsoft Windows, l'agente registra l'utilizzo della CPU e utilizzo di memoria, file di paging e volume. Se esegui IIS o SQL Server, dell'agente raccoglie le metriche da questi servizi per impostazione predefinita.
Prima di iniziare
Per installare l'agente, assicurati di disporre di quanto segue:
Un'istanza VM supportata in un ambiente Progetto Google Cloud o account Amazon Web Services (AWS).
- Si consiglia un minimo di 250 MiB di memoria residente (RSS) per eseguire Agente di monitoraggio.
Assicurati inoltre che sulla VM sia in esecuzione un sistema operativo supportato .
Credenziali sull'istanza VM che autorizzano la comunicazione con Cloud Logging o Cloud Monitoring. Istanze VM di Compute Engine in genere dispongono delle credenziali corrette per impostazione predefinita. Se uno dei seguenti documenti scenari che si applicano al tuo caso, potresti non disporre delle credenziali appropriate devi completare Autorizza l'agente Monitoring:
Quando esegui istanze VM AWS EC2, devi installare le autorizzazioni le credenziali sulle VM installare l'agente.
Esecuzione di istanze di Compute Engine molto vecchie o di Compute Engine di istanze gestite senza le credenziali predefinite.
Per controllare se disponi delle credenziali corrette, esegui il corso di verifica Credenziali di Compute Engine le procedure del caso.
Per informazioni sui prezzi, vai a Prezzi per Google Cloud Observability.
Se utilizzi VM che non hanno accesso ai repository di pacchetti remoti, Fai riferimento alle VM senza accesso remoto ai pacchetti per ulteriori informazioni.
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 del terminale all'istanza VM utilizzando 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 page .
Scarica ed esegui lo script di installazione dell'agente utilizzando il seguente codice :
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 sul 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 del terminale all'istanza VM utilizzando 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 page .
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 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.
Vedere i commenti sullo 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, 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:
sudo bash add-monitoring-agent-repo.sh --also-install \ --version=MAJOR_VERSION.*.*
Ad esempio, per bloccare il file 6.x.x del 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
Una volta eseguita correttamente l'esecuzione, puoi eliminare lo script di installazione.
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
In caso di problemi con l'installazione, consulta 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.
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 andare al seguente URL per scaricare ed eseguire del programma di installazione dell'agente:
https://repo.stackdriver.com/windows/StackdriverMonitoring-GCM-46.exe
Per installare l'agente automaticamente, aggiungi l'opzione
/S
alla chiamata di chi ha eseguito l'installazione:& "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe" /S
In modalità "silenziosa", utilizza l'opzione
/D
per specificare directory di installazione, ad esempio:& "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe" /S /D="C:\Stackdriver\Monitoring\"
Una volta completata, potrai eliminare il programma di installazione.
In caso di problemi con l'installazione, consulta Risoluzione dei problemi.
Visualizzazione delle informazioni sull'agente mediante la console Google Cloud
Puoi trovare le informazioni sullo stato dell'agente nella la dashboard preconfigurata per le istanze VM di Monitoring. Per accedere a questa dashboard, procedi nel seguente modo:
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 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 disponi di un agente installato oppure 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.
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.
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.
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.
configura un proxy HTTP
Se utilizzi un proxy HTTP per il proxy delle richieste ai server di accesso Monitoring, segui questi passaggi:
Linux
Modifica il file di configurazione seguente (crea il file, se non è già presente esistenti):
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.
Riavvia l'agente eseguendo questo comando sull'istanza VM:
sudo service stackdriver-agent restart
Windows
Se utilizzi un proxy HTTP, esegui questo comando da un al prompt dei comandi dell'amministratore. Questa operazione imposta
HTTP_PROXY
eHTTPS_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 169.254.169.254 /m
Determina la versione dell'agente
Per determinare la versione dell'agente Monitoring nel tuo sistema, esegui i comandi seguenti sulla tua istanza VM:
AMAZON LINUX AMI / CENTOS / RHEL
Esegui il comando seguente su Amazon Linux, Red Hat o CentOS Linux:
rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' stackdriver-agent
DEBIAN / UBUNTU
Esegui questo comando su Debian o Ubuntu:
dpkg-query --show --showformat '${Package} ${Version} ${Architecture} ${Status}\n' stackdriver-agent
SLES / SUSE
Esegui il comando seguente su SUSE:
rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' stackdriver-agent
FINESTRE
Al momento non c'è modo di determinare la versione Agente di monitoraggio in esecuzione su Windows.
Riavvia l'agente
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 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 sul 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 alla release più recente, utilizza seguendo le istruzioni riportate di seguito:
Linux
Per eseguire l'upgrade dell'agente alla versione più recente, esegui questo comando:
sudo bash add-monitoring-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-monitoring-agent-repo.sh --also-install \
--version=MAJOR_VERSION.*.*
Windows
Per eseguire l'upgrade alla release più recente dell'agente, installa l'agente più recente come descritto in Installazione su Windows in questa pagina. Il programma di installazione ti chiede per disinstallare la versione precedente dell'agente.
Elenco di tutte le versioni dell'agente
Per visualizzare l'elenco delle versioni disponibili dell'agente, esegui questo comando:
AMAZON LINUX AMI / CENTOS / RHEL
Elenca le versioni disponibili dell'agente:
sudo yum list --showduplicates stackdriver-agent
DEBIAN / UBUNTU
Elenca le versioni disponibili dell'agente:
sudo apt-cache madison stackdriver-agent
SLES / SUSE
Elenca le versioni disponibili dell'agente:
sudo zypper search -s stackdriver-agent
FINESTRE
L'installazione di versioni precedenti dell'agente su Windows non è supportata.
Disinstalla l'agente
Per rimuovere l'agente Monitoring 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-monitoring-agent-repo.sh --uninstall
Facoltativamente, per rimuovere il repository e disinstallare l'agente,
aggiungi --remove-repo
al comando precedente.
Windows
Nel Pannello di controllo di Windows, scegli Disinstalla un programma. Dovresti vedere l'etichetta
Agente Monitoring nell'elenco dei programmi che puoi disinstallare. Puoi anche
esegui uninstall.exe
dalla directory in cui hai installato
Agente di monitoraggio.
VM senza accesso remoto ai pacchetti
L'installazione dell'agente Monitoring 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.