Installazione dell'agente Cloud Logging su singole VM

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-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 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://dl.google.com/cloudagents/windows/StackdriverLogging-v1-21.exe", "${env:UserProfile}\StackdriverLogging-v1-21.exe")
   & "${env:UserProfile}\StackdriverLogging-v1-21.exe"
   

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 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 per lo script. Per informazioni sulle versioni, vedi Elenco di tutte le versioni degli agenti.
   • --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 dello script.

4. Aggiungi il repository dei 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, ti consigliamo di eseguire il pinning a 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 la versione 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

   È necessario un riavvio per l'applicazione delle configurazioni installate dai pacchetti generici sopra indicati.

   sudo service google-fluentd restart
   

Puoi eliminare lo script di installazione dopo averlo eseguito correttamente.

• 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
  

Se hai 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 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://dl.google.com/cloudagents/windows/StackdriverLogging-v1-21.exe", "${env:UserProfile}\StackdriverLogging-v1-21.exe")
      & "${env:UserProfile}\StackdriverLogging-v1-21.exe"
      

   In alternativa, puoi visitare il 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 in modalità silenziosa, aggiungi l'opzione /S all'invocazione del programma di installazione:

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

   In modalità "silenzioso", 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\"
   

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

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

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. Riavviare l'agente eseguendo il seguente comando nell'istanza VM:

    sudo service google-fluentd restart
   

Windows

1. Se utilizzi un proxy HTTP, esegui il seguente comando da un prompt dei comandi amministrativo. 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
   

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' 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

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

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

LINUX

Esegui il seguente comando sull'istanza:

     sudo service google-fluentd restart

Dopo aver riavviato l'agente Logging, ti consigliamo di inviare un messaggio di prova.

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

Restart-Service -Name StackdriverLogging

Linux

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

sudo bash add-logging-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-logging-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.*.*

Windows

Per eseguire l'upgrade alla versione 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.

AMAZON LINUX AMI / CENTOS / RHEL

Elenca le versioni dell'agente disponibili:

sudo yum list --showduplicates google-fluentd

DEBIAN / UBUNTU

Elenca le versioni dell'agente disponibili:

sudo apt-cache madison google-fluentd

SLES / SUSE

Elenca le versioni dell'agente disponibili:

sudo zypper search -s google-fluentd

WINDOWS

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

Linux

Esegui questo comando:

sudo bash add-logging-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 agente Logging nell'elenco dei programmi che puoi disinstallare. Puoi anche eseguire uninstall.exe dalla directory in cui hai installato l'agente Logging.