Installazione dell'agente Cloud Monitoring su singole VM

L'agente Cloud Monitoring raccoglie metriche di sistema e delle applicazioni dalle tue 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 Monitoring sulle VM 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 del traffico del disco, il traffico di rete e l'uptime. L'utilizzo dell'agente è obbligatorio per le VM Amazon Elastic Compute Cloud (EC2).

Sulle 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, l'agente raccoglie le metriche da questi servizi per impostazione predefinita.

Prima di iniziare

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

Installazione dell'agente dalla riga di comando

Per installare l'agente utilizzando la riga di comando, segui le istruzioni riportate di seguito.

Installazione della versione più recente dell'agente in corso...

Per installare la versione più recente dell'agente, completa la procedura seguente.

Linux

  1. Apri una connessione di 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
    

    Dopo l'installazione, 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 di amministratore 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 passaggi riportati di seguito.

Linux

  1. Apri una connessione di 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 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 agente.
    • --version: imposta la versione dell'agente da installare 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.

    Consulta i commenti dello script per ulteriori informazioni e per esempi di utilizzo.

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

    1. Per elencare le versioni disponibili dell'agente in modo da selezionare la versione da installare, consulta Elenco di tutte le versioni dell'agente.

    2. Per gli ambienti di produzione, è consigliabile bloccare una versione principale per evitare l'installazione di 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 l'errore 6.x.x, 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
    

Puoi eliminare lo script di installazione dopo che è stato eseguito correttamente.

  • Per verificare se l'agente funziona come previsto, esegui:

    sudo service stackdriver-agent status
    

    Lo stato dell'agente deve essere OK.

  • Puoi anche esaminare i log e assicurarti che non siano presenti errori:

    sudo grep collectd /var/log/{syslog,messages} | tail
    

In caso di problemi con l'installazione, consulta la pagina 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 di amministratore facendo clic con il tasto destro del mouse sull'icona di PowerShell e selezionando Esegui come amministratore.

    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 passare al 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 automaticamente, aggiungi l'opzione /S alla chiamata del programma di installazione:

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

    In modalità "silenzioso", usa l'opzione /D per specificare la directory di installazione, ad esempio:

    & "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe" /S /D="C:\Stackdriver\Monitoring\"
    

    Una volta completato correttamente, puoi eliminare il programma di installazione.

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

Visualizzazione delle informazioni sull'agente utilizzando la console Google Cloud

Puoi trovare informazioni sullo stato dell'agente nella dashboard preconfigurata delle istanze VM di Monitoring. Per accedere a questa dashboard, procedi nel seguente modo:

Nel pannello di navigazione della console Google Cloud, seleziona Monitoring, seleziona  Dashboard e quindi Istanze VM:

Vai alla dashboard delle istanze VM

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

La dashboard delle istanze VM in Monitoring mostra lo stato degli agenti.

La colonna Agente riporta i seguenti valori:

  • Non rilevato: non hai installato un agente o non è in esecuzione. Se non sai se hai installato un agente, puoi eseguire una query per la versione installata. Se hai installato l'agente, puoi riavviarlo.

  • Ops Agent: stai eseguendo 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 Ops Agent nella tabella, vengono visualizzate informazioni sulla versione di Ops Agent. Se esegui 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. Per informazioni sulla transizione a Ops Agent, consulta Migrazione dagli agenti legacy 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 è sconosciuto.

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 Ops Agent dalla pagina Dettagli VM per una VM specifica.

Quando possibile, l'agente viene installato utilizzando un criterio del sistema operativo di Ops Agent. Per maggiori informazioni, consulta Gestire le VM coperte dal criterio del sistema operativo 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.

Ops Agent raccoglie sia metriche che log per impostazione predefinita. Puoi modificare questo comportamento predefinito configurando Ops Agent.

Attività facoltative

In questa sezione viene descritto come eseguire le attività di manutenzione più comuni.

Configurazione dell'agente Monitoring

Per modificare la configurazione dell'agente, consulta Configurare l'agente Monitoring.

Configurazione di un proxy HTTP

Se utilizzi un proxy HTTP per le richieste di proxy alle API Logging e Monitoring, segui questi passaggi:

Linux

  1. 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
      
  2. Aggiungi il seguente codice 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. Riavvia l'agente eseguendo questo comando sull'istanza VM:

     sudo service stackdriver-agent restart
    

Windows

  1. Se utilizzi un proxy HTTP, esegui questo comando dal 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
    

Determinazione della versione dell'agente

Per determinare la versione dell'agente Monitoring sul tuo sistema, esegui questi comandi sull'istanza VM:

AMAZON LINUX AMI / CENTOS / RHEL

Esegui questo comando 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

FINESTRA

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

Riavvio dell'agente

Per rilevare le modifiche nei file di configurazione, devi riavviare l'agente Monitoring. 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 di amministratore facendo clic con il tasto destro del mouse sull'icona di PowerShell e selezionando Esegui come amministratore.

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

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

Per eseguire l'upgrade dell'agente alla release più recente di una versione principale specifica, 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 di disinstallare la versione precedente dell'agente.

Elenco di tutte le versioni dell'agente

Per elencare le 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

FINESTRA

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

Facoltativamente, per rimuovere il repository oltre a disinstallare l'agente, aggiungi --remove-repo al comando precedente.

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 AWS EC2

Quando la documentazione fa riferimento al progetto Google Cloud associato all'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 del connettore AWS. Per informazioni su questo processo, consulta Raccolta di metriche dagli account AWS.

Per accedere al progetto del connettore AWS per un account AWS, esegui una di queste 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, quindi seleziona il progetto specifico per il tuo account AWS.

  • Identifica il progetto Google Cloud il cui ambito delle metriche include le metriche del tuo account AWS e seleziona quel progetto 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 usare il selettore di 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 ai repository di pacchetti remoti, sia per il pacchetto agente sia (su Linux) le sue dipendenze.

Se utilizzi VPC-SC o una rete privata, la configurazione di rete potrebbe influire anche sulla capacità di installare le dipendenze degli agenti dai repository upstream. I pacchetti degli agenti sono accessibili mediante l'accesso privato Google. Questa opzione può essere configurata in base ad Abilita l'accesso privato Google.

Se il criterio di sicurezza dell'host della VM nega 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.