Installazione dell'agente Cloud Monitoring su singole VM

Questo è un agente legacy. Mentre questo agente è è ancora supportata su Linux, ti consigliamo di non utilizzarlo per nuovi carichi di lavoro Google Cloud.

Ti consigliamo invece di utilizzare Ops Agent per i nuovi carichi di lavoro Google Cloud ed eventualmente la transizione VM di Compute Engine per utilizzare Ops Agent. Ops Agent, che combina la raccolta di metriche e il logging in un unico agente, è la possibile sostituzione degli agenti legacy.

Ops Agent è in fase di sviluppo, ma potrebbero esserci alcune per i casi d'uso non supportati. Se l'agente Ops non supporta il tuo caso d'uso, puoi comunque utilizzare l'agente di monitoraggio su Linux.

Non ci saranno nuove funzionalità né assistenza per i nuovi sistemi operativi per l'agente Monitoring legacy.

Consigliamo vivamente di non utilizzare l'agente di monitoraggio precedente su Windows. L'agente di monitoraggio precedente su Windows non è supportato e tutte le sue funzionalità sono disponibili in Agente operativo. Consigliamo vivamente di utilizzare Ops Agent per il monitoraggio delle istanze Windows. Tuttavia, se devi eseguire l'agente Logging legacy su Windows e raccogliere metriche, devi usare l'agente Monitoring legacy. non puoi eseguire Ops Agent e un agente legacy sulla stessa macchina.

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 il monitoraggio sulle VM 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 utilizzano Microsoft Windows, l'agente registra l'utilizzo della CPU e della memoria, del file di pagina e del volume. Se esegui IIS o SQL Server, e l'agente raccoglie le metriche da questi servizi per impostazione predefinita.

Nota: l'agente Cloud Monitoring è progettato per importare le metriche di telemetria di sistema, di terze parti, predefinite dall'utente e dell'agente. Alcune di queste metriche sono addebitabili. Per informazioni sui prezzi, consulta Prezzi del monitoraggio.

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 sulla VM sia in esecuzione un sistema operativo supportato .

• Le credenziali nell'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 scenari si applica al tuo caso, potresti non disporre delle credenziali appropriate e devi completare le procedure di Autorizzazione dell'agente di monitoraggio:

  • Quando esegui istanze VM AWS EC2, devi installare le autorizzazioni le credenziali sulle VM installare l'agente.

  • Istanze Compute Engine molto vecchie o istanze Compute Engine create senza le credenziali predefinite.

  Per verificare 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 dei pacchetti remoti, consulta la sezione VM senza accesso ai pacchetti remoti per ulteriori informazioni.

Installa l'agente dalla riga di comando

Nota: verifica innanzitutto che tutte le condizioni siano soddisfatte nella sezione Prima di .

Per installare l'agente dalla 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

1. Apri una connessione da terminale all'istanza VM utilizzando SSH o uno strumento simile e assicurati di disporre dell'accesso sudo.

2. Passa a una directory a cui hai accesso in scrittura, ad esempio la tua home directory.

3. 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

1. Connettiti all'istanza utilizzando RDP o uno strumento simile e accedi a Windows.

2. Apri un terminale PowerShell con privilegi amministrativi facendo clic con il tasto destro del mouse sull'icona di PowerShell e selezionando Esegui come amministratore.

3. 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

1. Apri una connessione da terminale all'istanza VM utilizzando SSH o uno strumento simile e assicurati di disporre dell'accesso sudo.

2. Passa a una directory a cui hai accesso in scrittura, ad esempio la tua home page .

3. 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 repository del pacchetto dell'agente.
   • --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 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.

   Vedere i commenti sullo script per ulteriori informazioni ed esempi di utilizzo.

4. Aggiungi il repository di pacchetti dell'agente e installa l'agente:

   1. Per elencare le versioni dell'agente disponibili, consulta Elenco di tutte le versioni dell'agente.

   2. 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 componente 6.x.x del 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
      

5. 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

1. Connettiti all'istanza utilizzando RDP o uno strumento simile e accedi a Windows.

2. Apri un terminale PowerShell con privilegi amministrativi facendo clic con il tasto destro del mouse sul Icona di PowerShell e selezionando Esegui come amministratore.

   Nota: sulle istanze VM è supportata solo la versione più recente dell'agente con Windows. L'installazione di versioni precedenti non è consigliata.

   1. 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

   Attenzione: devi scaricare il programma di installazione in una directory non di sistema, come C:\Users\[USERNAME]. Per motivi di sicurezza, il programma di installazione non vengono eseguiti 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 un'opzione "silenziosa", /S, che può essere utilizzata per creare script di installazione.

   Per installare l'agente in modalità silenziosa, aggiungi l'opzione /S all'invocazione del programma di installazione:

   & "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe" /S
   

   Attenzione: l'installazione silenziosa è un'operazione asincrona. Quando viene chiuso, l'agente non è ancora installato. Puoi verificare se l'installazione è andata a buon fine cercando il servizio StackdriverMonitoring.
   Nota: per impostazione predefinita, l'installatore posiziona l'agente nella directory "C:\Program Files (x86)\Stackdriver\MonitoringAgent". Puoi modificare la directory durante l'installazione.

   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\Monitoring\"
   

   Puoi eliminare il programma di installazione al termine dell'operazione.

   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 dashboard preconfigurata Istanze VM di Monitoring. Per accedere a questa dashboard:

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 hai installato un agente oppure è in corso 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, puoi riavviare l'agente.

• Ops Agent: stai eseguendo l'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 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.

• Agente legacy: stai eseguendo l'agente Monitoring o Logging legacy. 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, pertanto 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 su tutte le versioni di tutti i sistemi operativi. In questo caso, se fai clic su Installa/Aggiorna Ops Agent, 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 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.

Configurare un proxy HTTP

Se utilizzi un proxy HTTP per il proxy delle richieste ai server di accesso Monitoring, segui questi passaggi:

Linux

1. 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
     

     Nota :se questo file non esiste, crealo.

2. 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.
   

3. Riavviare l'agente eseguendo il seguente comando nell'istanza VM:

    sudo service stackdriver-agent restart
   

Windows

1. Se utilizzi un proxy HTTP, esegui questo comando da un al prompt dei comandi dell'amministratore. In questo modo vengono impostate le variabili di ambiente HTTP_PROXY e HTTPS_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 c'è modo di determinare la versione Agente di monitoraggio 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 questo comando sull'istanza:

     sudo service stackdriver-agent restart

Windows

1. Connettiti all'istanza utilizzando RDP o uno strumento simile e accedi a Windows.

2. Apri un terminale PowerShell con privilegi amministrativi facendo clic con il tasto destro del mouse sul Icona di PowerShell e selezionando Esegui come amministratore.

3. 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:

Nota: se hai eseguito l'upgrade del sistema operativo Linux della tua istanza a una nuova versione principale devi prima rimuovere l'agente e poi riinstallalo utilizzando le procedure in questa pagina, anziché per completare queste procedure di upgrade.

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 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 di disinstallare la versione precedente dell'agente.

Elenca 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 dell'agente disponibili:

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 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 Monitoring e i relativi file di configurazione, utilizza seguendo le istruzioni.

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 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 ai pacchetti da remoto

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 anche sulla tua capacità di installare le dipendenze dell'agente dai repository a monte. I pacchetti dell'agente stessi sono accessibili utilizzando Accesso privato Google. 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.