Questa pagina è stata tradotta dall'API Cloud Translation.

Installazione dell'agente Cloud Monitoring su singole VM

L'agente Cloud Monitoring raccoglie le metriche di sistema e delle applicazioni dalle istanze VM e le invia a Monitoring. Puoi anche configurare l'agente Monitoring per monitorare applicazioni di terze parti.

Questa guida spiega come installare l'agente Cloud Monitoring per Monitoring su Compute Engine e Amazon Elastic Compute Cloud (EC2). L'utilizzo dell'agente è facoltativo ma consigliato per le istanze VM di Compute Engine. Per queste VM, Monitoring può accedere ad alcune metriche dell'hypervisor della VM senza l'agente, tra cui l'utilizzo della CPU, alcune metriche sul traffico del disco, traffico di rete e uptime. L'utilizzo dell'agente è obbligatorio per le VM Amazon Elastic Compute Cloud (EC2).

Nelle istanze che eseguono Microsoft Windows, l'agente registra l'utilizzo della CPU e la memoria, il file di paging e l'utilizzo del volume. Se esegui IIS o SQL Server, per impostazione predefinita l'agente raccoglie le metriche da questi servizi.

Prima di iniziare

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

Un'istanza VM supportata in un progetto Google Cloud o in un account Amazon Web Services (AWS).
- Per eseguire l'agente Monitoring, si consiglia un minimo di 250 MiB di memoria residente (RSS).
Inoltre, assicurati che sulla tua VM sia in esecuzione un sistema operativo supportato.
Credenziali sull'istanza VM che autorizzano la comunicazione con Cloud Logging o Cloud Monitoring. In genere, le istanze VM di Compute Engine hanno per impostazione predefinita le credenziali corrette. Se si verifica uno dei seguenti scenari, potresti non disporre delle credenziali corrette e completare le procedure per autorizzare l'agente Monitoring:
- Per eseguire le istanze VM di AWS EC2, devi installare le credenziali di autorizzazione sulle tue VM prima di installare l'agente.
- Esecuzione di istanze di Compute Engine molto vecchie o di istanze di Compute Engine create senza le credenziali predefinite.
Per controllare se hai le credenziali corrette, esegui le procedure di verifica delle credenziali di Compute Engine.
Per gli utenti di AWS:
1. Collega il tuo account AWS a Google Cloud. Per informazioni su questo processo, consulta Visualizzazione delle metriche per gli account AWS.
  
  Nota: quando connetti il tuo account AWS a Google Cloud, crei un progetto connettore AWS. Per semplificare l'identificazione di questi progetti, ti consigliamo di seguire la convenzione di denominazione per i tuoi progetti per il connettore AWS.
2. Per ulteriori informazioni, consulta la sezione Progetti Google Cloud per istanze VM AWS EC2.
Per informazioni sui prezzi, vedi Prezzi per la suite operativa di Google Cloud.
Se utilizzi VM che non hanno accesso ai repository di pacchetti remoti, consulta la sezione VM senza accesso remoto ai pacchetti per ulteriori informazioni.

Installazione dell'agente dalla riga di comando

Per installare l'agente utilizzando la riga di comando, segui queste istruzioni.

Installazione della 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 l'accesso sudo.
Passa a una directory a cui hai accesso in scrittura, ad esempio la home directory.

Esegui:

curl -sSO https://dl.google.com/cloudagents/add-monitoring-agent-repo.sh
sudo bash add-monitoring-agent-repo.sh --also-install

Windows

Connettiti alla tua istanza utilizzando RDP o uno strumento simile e accedi a Windows.
Per aprire un terminale PowerShell con privilegi di amministratore, fai clic con il tasto destro del mouse sull'icona di PowerShell e seleziona Esegui come amministratore.

Esegui questi comandi di 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 l'accesso sudo.
Passa a una directory a cui hai accesso in scrittura, ad esempio la 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 per l'installazione dello script.
- --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 degli script.
Aggiungi il repository dei pacchetti dell'agente e installalo:
1. Per elencare le versioni dell'agente disponibili per selezionare la versione da installare, consulta Elencare tutte le versioni dell'agente.
2. Per ambienti di produzione, consigliamo di limitare l'aggiornamento a una versione principale per evitare di installare versioni principali che potrebbero includere modifiche incompatibili con le versioni precedenti. Per bloccare su una versione principale, esegui:
```
sudo bash add-monitoring-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.*.*
```
  Ad esempio, per bloccare il codice 6.x.x dell'agente, esegui:
```
sudo bash add-monitoring-agent-repo.sh --also-install \
  --version=6.*.*
```
3. 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 completata correttamente, puoi eliminare lo script di installazione.

Per verificare che l'agente funzioni come previsto, esegui questo comando:
```
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 la pagina Risoluzione dei problemi.

Windows

Connettiti alla tua istanza utilizzando RDP o uno strumento simile e accedi a Windows.
Per aprire un terminale PowerShell con privilegi di amministratore, fai clic con il tasto destro del mouse sull'icona di PowerShell e seleziona Esegui come amministratore.

Nota: solo le versioni più recenti dell'agente sono supportate sulle istanze VM che utilizzano Windows. Non è consigliabile installare versioni precedenti.
1. Esegui questi comandi di 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 il programma di installazione dell'agente:

https://repo.stackdriver.com/windows/StackdriverMonitoring-GCM-46.exe

Attenzione: devi scaricare il programma di installazione in una directory non di sistema, ad esempio C:\Users\[USERNAME]. Per motivi di sicurezza, il programma di installazione non viene eseguito dalle directory di sistema, inclusa la directory C:\.
Se scarichi il programma di installazione in una directory di sistema, spostalo in un'altra directory prima di eseguirlo.
Nota: il programma di installazione dell'agente supporta anche l'opzione "Silenziosa", /S, che può essere utilizzata per creare uno script dell'installazione.

Per installare l'agente in silenzio, aggiungi l'opzione /S alla chiamata del programma di installazione:
```
& "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe" /S
```
Attenzione: l'installazione silenziosa è un'operazione asincrona. Quando il comando di installazione viene chiuso, l'agente non è ancora installato. Puoi controllare l'installazione riuscita cercando il servizio StackdriverMonitoring.
Nota: il programma di installazione inserisce l'agente nella directory "C:\Programmi (x86)\Stackdriver\MonitoringAgent" per impostazione predefinita. Puoi modificare la directory durante l'installazione.

In modalità silenziosa, utilizza l'opzione /D per specificare la directory di installazione, ad esempio:
```
& "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe" /S /D="C:\Stackdriver\Monitoring\"
```
Una volta completata, puoi eliminare il programma di installazione.

In caso di problemi con l'installazione, consulta la pagina Risoluzione dei problemi.

Installare l'agente utilizzando la console Google Cloud

Puoi installare l'agente su una o più VM di Compute Engine dalla dashboard Istanze VM di Monitoring preconfigurata.

Per accedere a questa dashboard:

Nella console Google Cloud, seleziona il tuo progetto Google Cloud.

Vai alla console Google Cloud
Nel riquadro di navigazione, seleziona Monitoring.
Nel pannello di navigazione di Monitoring, seleziona Dashboard.
Nella tabella delle dashboard, individua la voce Istanze VM, quindi fai clic sul nome.

La visualizzazione Elenco nella scheda Inventario della dashboard elenca tutte le VM e include una colonna di stato per l'agente, come mostrato nel seguente screenshot:

La dashboard Istanze VM in Monitoring mostra lo stato degli agenti.

La colonna Agente indica i seguenti valori:

Non rilevato: nessun agente installato. Se Cloud Monitoring non rileva agenti installati nell'istanza di Compute Engine, puoi installare un agente nel seguente modo:
- Seleziona le istanze VM su cui vuoi installare gli agenti.
- Fai clic sull'opzione Installa/aggiorna agenti nella tabella Istanze, che mostra un flusso di lavoro di installazione nella dashboard, e segui le istruzioni.
  
  Puoi anche installare o aggiornare gli agenti dalla pagina Dettagli VM per una VM specifica.
  
  L'agente Ops raccoglie sia le metriche che i log per impostazione predefinita. Puoi modificare questo comportamento predefinito configurando l'agente Ops.
Agente operativo: stai eseguendo l'agente operativo. Se non vedi un segno di spunta verde accanto alla voce, è disponibile un upgrade dell'agente in base al sistema operativo rilevato della VM.

Quando passi il mouse sopra l'indicatore dell'agente Ops nella tabella, vengono visualizzate le informazioni sulla versione dell'agente Ops. Se stai utilizzando una versione precedente, viene visualizzato anche un consiglio per l'upgrade dell'agente.
Pending (In attesa): l'agente Ops è in fase di installazione o upgrade.
Agente legacy: stai eseguendo l'agente Monitoring o Logging legacy. Per informazioni sulla transizione all'agente operativo, consulta la sezione Migrazione dagli agenti legacy all'agente operativo.
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.

Attività facoltative

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

Configurazione dell'agente Monitoring

Per regolare la configurazione dell'agente, consulta Configura l'agente Monitoring.

Configurazione di un proxy HTTP

Se utilizzi un proxy HTTP per 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à):
- Per le versioni 6.0.0 e successive dell'agente, 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
```
  Nota: se questo file non esiste, crealo.

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 il comando seguente sulla tua istanza VM:
```
 sudo service stackdriver-agent restart
```

Windows

Se utilizzi un proxy HTTP, esegui questo comando dal prompt dei comandi dell'amministratore. Questa operazione imposta le variabili di ambiente HTTP_PROXY e HTTPS_PROXY in modo che l'agente possa inviare dati tramite 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
```

Determinazione della versione dell'agente

Per determinare la versione dell'agente Monitoring nel sistema, esegui i comandi seguenti sull'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 questo comando su SUSE:

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' stackdriver-agent

FINESTRE

Al momento non è possibile determinare la versione dell'agente Monitoring in esecuzione su Windows.

Riavvio dell'agente in corso...

Riavvia l'agente Monitoring per rilevare le modifiche nei file di configurazione. Per riavviare l'agente, segui queste istruzioni.

LINUX

Esegui questo comando sulla tua istanza:

 sudo service stackdriver-agent restart

Windows

Connettiti alla tua istanza utilizzando RDP o uno strumento simile e accedi a Windows.
Per aprire un terminale PowerShell con privilegi di amministratore, fai clic con il tasto destro del mouse sull'icona di PowerShell e seleziona Esegui come amministratore.
Esegui il seguente comando PowerShell:

Restart-Service -Name StackdriverMonitoring

Upgrade dell'agente in corso...

Per eseguire l'upgrade dell'agente Monitoring alla release più recente, segui queste istruzioni:

Linux

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

sudo bash add-monitoring-agent-repo.sh --also-install

Per eseguire l'upgrade dell'agente all'ultima release di punto di una versione principale specifica, esegui il comando seguente:

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'ultimo agente come descritto in Installazione su Windows in questa pagina. Il programma di installazione ti chiede di disinstallare la versione precedente dell'agente.

Elenco di tutte le versioni dell'agente

Per elencare le versioni disponibili dell'agente, esegui il comando seguente:

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.

Disinstallazione dell'agente

Per rimuovere l'agente Monitoring 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

Windows

Nel Pannello di controllo di Windows, scegli Disinstalla un programma. Dovresti vedere l'agente Monitoring nell'elenco dei programmi che puoi disinstallare. Puoi anche eseguire uninstall.exe dalla directory in cui hai installato l'agente Monitoring.

Informazioni sui progetti Google Cloud per le istanze VM di AWS EC2

Quando la documentazione fa riferimento al progetto Google Cloud associato alla tua istanza VM, per le istanze VM EC2 questa frase si riferisce al progetto del connettore AWS collegato al tuo account AWS.

Quando connetti il tuo account AWS a Google Cloud, crei un progetto connettore AWS. Per informazioni su questo processo, consulta Visualizzazione delle metriche per gli account AWS.

Per accedere al progetto connettore AWS per un account AWS, esegui una delle seguenti operazioni:

Utilizza il selettore di progetti della console Google Cloud per identificare i progetti che corrispondono alle convenzioni di denominazione dei progetti del connettore AWS e seleziona quello specifico per il tuo account AWS.
Identifica il progetto Google Cloud il cui ambito delle metriche include le metriche del tuo account AWS e selezionalo nel selettore di progetti della console Google Cloud. Per questo progetto Google Cloud, vai alla pagina Monitoring e seleziona la pagina Impostazioni. Nella pagina Impostazioni sono elencati i progetti del connettore AWS. Puoi utilizzare il selettore dei progetti della console Google Cloud per accedere al progetto del connettore AWS.

VM senza accesso remoto ai pacchetti

L'installazione dell'agente Monitoring richiede l'accesso per remore i repository di pacchetti, sia per il pacchetto dell'agente sia (per Linux) dalle sue dipendenze.

Se utilizzi VPC-SC o una rete privata, la configurazione della rete potrebbe influire anche sulla possibilità di installare le dipendenze degli agenti dai repository a monte. I pacchetti degli agenti sono accessibili utilizzando l'accesso privato Google. Questa configurazione può essere configurata seguendo Abilita accesso privato Google.

Se il criterio di sicurezza dell'host della VM rifiuta l'accesso ai repository di pacchetti remoti, ti consigliamo di creare un'immagine VM personalizzata con l'agente preinstallato e di disabilitare la gestione dei pacchetti in quell'immagine.