Installazione dell'agente Cloud Logging su singole VM

L'agente Logging invia i log dalle istanze VM e da pacchetti software di terze parti selezionati a Cloud Logging. Una best practice consiste nell'eseguire l'agente Logging su tutte le istanze VM.

Le immagini VM per Compute Engine e Amazon Elastic Compute Cloud (EC2) non includono l'agente Logging, quindi devi completare questi passaggi per installarlo su queste istanze. L'agente viene eseguito sia in Linux che in Windows.

Se le tue VM sono in esecuzione in Google Kubernetes Engine o App Engine, l'agente è già incluso nell'immagine VM, quindi puoi saltare questa pagina.

Prima di iniziare

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

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

  1. Apri una connessione del terminale all'istanza VM utilizzando SSH o uno strumento simile e assicurati di avere 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-logging-agent-repo.sh
sudo bash add-logging-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 pulsante destro del mouse sull'icona di PowerShell e selezionando Esegui come amministratore.

  3. Esegui i seguenti comandi PowerShell:

    (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-21.exe", "${env:UserProfile}\StackdriverLogging-v1-21.exe")
& "${env:UserProfile}\StackdriverLogging-v1-21.exe"

Installazione di una versione specifica dell'agente

Per installare una versione specifica dell'agente, completa i seguenti passaggi.

Linux

  1. Apri una connessione del terminale all'istanza VM utilizzando SSH o uno strumento simile e assicurati di avere 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-logging-agent-repo.sh

    Quando esegui lo script add-logging-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 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 aver installato o disinstallato 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.

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

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

    2. Per gli ambienti di produzione, potrebbe essere opportuno fissare 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-logging-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.*.*

      Ad esempio, per bloccare il file 1.x.x dell'agente, esegui:

      sudo bash add-logging-agent-repo.sh --also-install \
  --version=1.*.*

    3. Per installare una versione specifica dell'agente, esegui:

      sudo bash add-logging-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION

  5. Riavvia il servizio dell'agente

    Affinché le configurazioni installate dai pacchetti catch-all precedenti abbiano effetto, è necessario un riavvio.

    sudo service google-fluentd restart

Una volta eseguita correttamente l'esecuzione, puoi eliminare lo script di installazione.

  • Per verificare che l'agente funzioni come previsto, esegui:

    sudo service google-fluentd status

    Lo stato dell'agente deve essere OK.

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

    tail /var/log/google-fluentd/google-fluentd.log

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 amministrativi facendo clic con il pulsante destro del mouse sull'icona di PowerShell e selezionando Esegui come amministratore.

    1. Esegui i seguenti comandi PowerShell:

      (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-21.exe", "${env:UserProfile}\StackdriverLogging-v1-21.exe")
& "${env:UserProfile}\StackdriverLogging-v1-21.exe"

    In alternativa, puoi andare al seguente URL per scaricare ed eseguire il programma di installazione dell'agente:

    https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-21.exe

    Per installare l'agente automaticamente, aggiungi l'opzione /S alla chiamata del programma di installazione:

    & "${env:UserProfile}\StackdriverLogging-v1-21.exe" /S

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

    & "${env:UserProfile}\StackdriverLogging-v1-21.exe" /S /D="C:\Stackdriver\Google Cloud Observability\"

    Una volta completata, potrai eliminare il programma di installazione.

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

Visualizzazione delle informazioni sull'agente mediante la console Google Cloud

Puoi trovare le informazioni sullo stato dell'agente nella dashboard preconfigurata delle 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 dashboard delle istanze VM in Monitoring mostra lo stato degli agenti.

La colonna Agent riporta i seguenti valori:

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

  • 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 Ops Agent nella tabella, vedi 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 l'agente Logging legacy. Consulta Migrazione dagli agenti legacy a Ops Agent 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 dalla pagina Dettagli VM per una VM specifica.

Se possibile, l'agente viene installato utilizzando un criterio di sistema operativo Ops Agent. Per maggiori 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 fornita 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 configurando Ops Agent.

Attività facoltative

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

Abilita il logging strutturato

Quando esegui lo script di installazione su una VM Linux, lo script installa per impostazione predefinita il pacchetto google-fluentd-catch-all quando è presente il flag --also-install. Per passare al logging strutturato, completa i seguenti passaggi.

  1. Esegui il backup di eventuali modifiche locali su /etc/google-fluentd/config.d/.

  2. Esegui uno dei seguenti comandi, a seconda della distribuzione Linux:

    • Slurp:

      sudo yum remove -y google-fluentd-catch-all-config
sudo yum install -y google-fluentd-catch-all-config-structured
sudo service google-fluentd restart

    • APT:

      sudo apt-get remove -y google-fluentd-catch-all-config
sudo apt-get install -y google-fluentd-catch-all-config-structured
sudo service google-fluentd restart

Per informazioni sul logging strutturato, consulta la guida sul logging strutturato.

Configurazione dell'agente Logging

L'agente è preconfigurato per monitorare determinate località di log note. Su Linux, queste posizioni sono descritte nel pacchetto google-fluentd-catch-all-config, che viene automaticamente inserito dallo script di installazione. Su Windows, l'agente monitora il log eventi di Windows per impostazione predefinita.

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

configura un proxy HTTP

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

Linux

  1. Modifica il seguente file di configurazione (crea il file se non esiste già):

     /etc/default/google-fluentd

  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. Riavvia l'agente eseguendo questo comando sull'istanza VM:

     sudo service google-fluentd restart

Windows

  1. Se utilizzi un proxy HTTP, esegui questo comando dal prompt dei comandi di un amministratore. Questa operazione imposta 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

Determina la versione dell'agente

Per determinare la versione dell'agente Logging nel tuo sistema, esegui questi comandi 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' google-fluentd google-fluentd-catch-all-config google-fluentd-catch-all-config-structured

DEBIAN / UBUNTU

Esegui questo comando su Debian o Ubuntu:

dpkg-query --show --showformat '${Package} ${Version} ${Architecture} ${Status}\n' google-fluentd google-fluentd-catch-all-config google-fluentd-catch-all-config-structured

SLES / SUSE

Esegui il comando seguente su SUSE:

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' google-fluentd google-fluentd-catch-all-config google-fluentd-catch-all-config-structured

FINESTRE

  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 il seguente comando PowerShell:

     reg query HKLM\Software\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall\GoogleStackdriverLoggingAgent\ /v Version

Riavvia l'agente

Per rilevare le modifiche nei file di configurazione, devi riavviare l'agente Logging. Per riavviare l'agente, segui le istruzioni riportate di seguito.

Linux

Esegui questo comando sull'istanza:


     sudo service google-fluentd restart

Dopo aver riavviato l'agente Logging, potrebbe essere opportuno inviare un messaggio di test.

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 pulsante destro del mouse sull'icona di PowerShell e selezionando Esegui come amministratore.

  3. Esegui il seguente comando PowerShell:

Restart-Service -Name StackdriverLogging

Esegui l'upgrade dell'agente

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

Linux

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

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

Per eseguire l'upgrade dell'agente alla release specifica più recente di una specifica versione principale, esegui questo comando:

sudo bash add-logging-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 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 google-fluentd

DEBIAN / UBUNTU

Elenca le versioni disponibili dell'agente:

sudo apt-cache madison google-fluentd

SLES / SUSE

Elenca le versioni disponibili dell'agente:

sudo zypper search -s google-fluentd

FINESTRE

L'installazione di versioni precedenti dell'agente su Windows non è supportata.

Disinstalla l'agente

Per rimuovere l'agente Logging e i relativi file di configurazione, utilizza le seguenti 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-logging-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'agente Logging nell'elenco dei programmi che puoi disinstallare. Puoi anche eseguire uninstall.exe dalla directory in cui hai installato l'agente Logging.

Informazioni sui progetti Google Cloud per le istanze VM AWS EC2

Quando la documentazione si riferisce 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 questa procedura, consulta Raccogliere metriche dagli account AWS.

Per accedere al progetto del 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, 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 il 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 per il connettore AWS. Puoi usare il selettore di progetti nella console Google Cloud per accedere al progetto.

VM senza accesso remoto ai pacchetti

L'installazione dell'agente Logging richiede l'accesso ai repository di pacchetti remoti, sia per il pacchetto dell'agente sia (su Linux) 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 degli agenti dai repository upstream. I pacchetti degli agenti sono accessibili tramite l'accesso privato Google. Questa opzione può essere configurata dopo 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 nell'immagine.

Passaggi successivi