Questa pagina è stata tradotta dall'API Cloud Translation.

Installazione dell'agente Cloud Logging su singole VM

L'agente Logging invia i flussi di log dalle istanze VM e di pacchetti software di terze parti selezionati in Cloud Logging. È una di eseguire l'agente Logging su tutte le tue istanze VM.

Le immagini VM per Compute Engine e Amazon Elastic Compute Cloud (EC2) includi l'agente Logging, quindi devi completare questi passaggi per installarlo su quelle 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, è già incluso nell'immagine VM, quindi puoi saltare questa pagina.

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).
- Durante l'installazione dell'agente di logging, è richiesta una memoria minima di 250 MiB, ma è consigliato 1 GiB.
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. Le istanze VM di Compute Engine generalmente hanno le 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 Procedure per autorizzare l'agente Logging:
- 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 di disporre delle credenziali appropriate, esegui le procedure di verifica delle credenziali Compute Engine.
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 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

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://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

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-logging-agent-repo.sh
```
Quando esegui lo script add-logging-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:
1. Per elencare le versioni dell'agente disponibili, consulta Elenca 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-logging-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.*.*
```
  Ad esempio, per bloccare il componente 1.x.x del 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
```
Riavvia il servizio dell'agente

È necessario un riavvio per le configurazioni installate i pacchetti catch-all precedenti.
```
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 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.

Nota: sulle istanze VM è supportata solo la versione più recente dell'agente con Windows. Non è consigliabile installare le versioni precedenti.
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 del programma di installazione dell'agente:

https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-21.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 viene eseguito dalle directory di sistema, inclusa la directory C:\.
Se scarichi il programma di installazione in una directory di sistema, spostalo in prima di eseguirlo.
Nota: il programma di installazione dell'agente supporta anche un'opzione "silent", /S, che può essere utilizzato nello scripting dell'installazione.

Per installare l'agente automaticamente, aggiungi l'opzione /S alla chiamata di chi ha eseguito l'installazione:
```
& "${env:UserProfile}\StackdriverLogging-v1-21.exe" /S
```
Attenzione :l'installazione silenziosa è un'operazione asincrona. Quando il comando di installazione esce, l'agente non è ancora installato. Puoi per verificare che l'installazione sia riuscita, cercando il StackdriverLogging.
Nota: il programma di installazione inserisce l'agente nel Directory "C:\Programmi (x86)\Stackdriver\LoggingAgent" per impostazione predefinita. Puoi modificare la directory durante l'installazione.

In modalità "silenziosa", utilizza l'opzione /D per specificare directory di installazione, ad esempio:
```
& "${env:UserProfile}\StackdriverLogging-v1-21.exe" /S /D="C:\Stackdriver\Logging\"
```
Una volta completata, potrai eliminare il programma di installazione.

Se hai problemi con l'installazione, consulta la pagina Risoluzione dei problemi.

Visualizzazione delle informazioni sugli agenti utilizzando 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 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
di
e gli agenti interessati.

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, puoi eseguire una query per la versione installata. Se hai installato L'agente, dopodiché potrai riavviarlo.
Ops Agent: l'agente operativo è in esecuzione. 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: è in corso l'installazione o l'upgrade di Ops Agent.
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, 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, 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, facendo clic su Installa/aggiorna Ops Agent viene visualizzata 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.

Abilita il logging strutturato

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

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

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 Logging strutturato.

Configurazione dell'agente Logging

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

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

configura un proxy HTTP

Se utilizzi un proxy HTTP per il proxy delle richieste alle API di logging e monitoraggio, segui questi passaggi:

Linux

Modifica il file di configurazione seguente (crea il file, se non è già presente esistenti):
```
 /etc/default/google-fluentd
```

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 google-fluentd restart
```

Windows

Se utilizzi un proxy HTTP, esegui questo comando da un al prompt dei comandi dell'amministratore. Questa operazione imposta http_proxy e https_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
```

Determinare la versione dell'agente

Per determinare la versione dell'agente Logging 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' google-fluentd google-fluentd-catch-all-config google-fluentd-catch-all-config-structured

DEBIAN / UBUNTU

Esegui il seguente 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 seguente comando su SUSE:

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

FINESTRE

Connettiti all'istanza utilizzando RDP o uno strumento simile e accedi a Windows.
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.

Esegui il seguente comando PowerShell:

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

Riavvia l'agente

Devi riavviare l'agente Logging 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 google-fluentd restart

Dopo aver riavviato l'agente Logging, potresti voler invia un messaggio di prova.

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 StackdriverLogging

Esegui l'upgrade dell'agente

Per eseguire l'upgrade dell'agente Logging 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-logging-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-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 elencare le versioni dell'agente disponibili, esegui il comando seguente:

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 la classe 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-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'etichetta Agente Logging nell'elenco dei programmi che puoi disinstallare. Puoi anche esegui uninstall.exe dalla directory in cui hai installato Agente Logging.

VM senza accesso remoto ai pacchetti

L'installazione dell'agente Logging 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 della VM host nega l'accesso ai repository dei pacchetti remoti, consigliamo di creare un'immagine VM personalizzata con l'agente preinstallato e di disattivare la gestione dei pacchetti in quell'immagine.

Passaggi successivi

Scopri i log che l'agente invia a Cloud Logging utilizzando il suo configurazione predefinita.
Per informazioni sulla visualizzazione dei log, consulta Utilizzo del Esplora log.