Panoramica dell'agente Logging

Questa guida fornisce informazioni di base sull'agente Logging, un'applicazione basata su fluentd che viene eseguita sulle istanze di macchine virtuali (VM).

Nella sua configurazione predefinita, l'agente Logging trasmette i log da software di sistema e applicazioni di terze parti comuni a Logging; consulta l'elenco dei log predefiniti. Puoi configurare l'agente per lo streaming di log aggiuntivi. Per informazioni dettagliate sulla configurazione e sul funzionamento dell'agente, consulta Configurare l'agente Logging.

È una best practice eseguire l'agente Logging su tutte le istanze VM. L'agente viene eseguito sia su Linux che su Windows.

Per installare l'agente Logging, vedi Installazione dell'agente Logging.

Come funziona l'agente Logging

Sistemi operativi supportati

Puoi eseguire l'agente Logging sui seguenti sistemi operativi su istanze di macchine virtuali (VM) compatibili:

  • Rocky Linux 8
  • RHEL 8: rhel-8-6-sap-ha, rhel-8-8-sap-ha
  • Debian 11 (Bullseye)
  • SLES 12: sles-12-sp5-sap
  • SLES 15: sles-15-sp6, sles-15-sp3-sap, sles-15-sp4-sap, sles-15-sp5-sap
  • Windows Server 2016 e 2019
  • Windows Server Core 2016 e 2019

Se esegui VM Container-Optimized OS, segui le istruzioni per Container-Optimized OS per raccogliere i log dalle tue VM.

Ambienti supportati

L'agente Logging è compatibile con i seguenti ambienti:

  • Istanze Compute Engine. L'agente Logging invia i log al progetto associato a ogni istanza VM.

    Per le istanze senza indirizzi IP esterni, devi abilitare l'accesso privato Google per consentire all'agente Logging di inviare i log.

  • Istanze Amazon Elastic Compute Cloud (Amazon EC2). L'agente Logging invia i log da AWS a un progetto Google Cloud .

    Affinché l'agente Logging funzioni correttamente, l'istanza Amazon EC2 su cui viene eseguito deve essere in grado di comunicare con le API Google Cloud, in particolare con l'API Logging. Ciò richiede un indirizzo IP esterno o un gateway internet VPC.

Per queste istanze VM, è necessario un minimo di 250 MiB di memoria residente (RSS) per eseguire l'agente Logging, ma è consigliato 1 GiB. Ad esempio, a una velocità di 100 voci di log di 1 KB al secondo, l'agente Logging con configurazioni predefinite consuma il 5% della CPU su un core e 150 MiB di memoria.

Le seguenti istanze VM supportano Logging utilizzando il proprio software, pertanto l'installazione manuale dell'agente Logging non è supportata:

Supporto per cloud on-premise e ibridi

Google Cloud collabora con Bindplane per fornire servizi di logging per piattaforme cloud ibrido on-premise e ibride in modo coerente e prevedibile. Con Bindplane, puoi raccogliere i tuoi dati e inviarli a Logging per l'analisi. Bindplane si integra con Cloud Logging per acquisire i dati dalla tua infrastruttura ed è incluso nel tuo progetto senza costi aggiuntivi.

Per saperne di più su Bindplane e Bindplane, consulta Informazioni su Bindplane e Bindplane.

Requisiti di accesso dell'agente

L'esecuzione dell'agente richiede l'accesso ai seguenti nomi DNS:

  • Server dei token OAuth2: oauth2.googleapis.com

    Le versioni precedenti dell'agente potrebbero richiedere l'accesso a www.googleapis.com (URL completo: https://www.googleapis.com/oauth2/v3/token).

    Se utilizzi una versione precedente dell'agente, ti consigliamo di eseguire l'upgrade dell'agente all'ultima versione.

  • API Logging: logging.googleapis.com

L'installazione dell'agente richiede l'accesso ai seguenti nomi DNS:

  • (Linux) Repository di pacchetti Google Cloud: packages.cloud.google.com

  • Server di download di Google: dl.google.com

Codice sorgente dell'agente Logging

Non hai bisogno delle informazioni in questa sezione, a meno che tu non voglia comprendere il codice sorgente o tu non abbia altre esigenze speciali. L'agente Logging viene installato dallo script descritto nelle istruzioni di installazione.

L'agente Logging, google-fluentd, è una versione modificata del fluentd, il raccoglitore di dati di log. google-fluentd è distribuito in due pacchetti separati. Il codice sorgente è disponibile dai repository GitHub associati:

  • Il repository GitHub denominato google-fluentd che include il programma fluentd principale, gli script di packaging personalizzati e il plug-in di output per l'API Cloud Logging.
    • Il plug-in di output è pacchettizzato come gemma Ruby ed è incluso nel pacchetto google-fluentd. È disponibile anche separatamente nel servizio di hosting di gem Ruby all'indirizzo fluent-plugin-google-cloud.
    • I contenuti relativi a Windows Installer si trovano nella cartella windows-installer.
  • Il repository GitHub denominato google-fluentd-catch-all-config che include i file di configurazione dell'agente Logging per l'importazione dei log da vari pacchetti software di terze parti.

Note di rilascio dell'agente Logging

  • Le note di rilascio per il pacchetto Linux google-fluentd sono disponibili all'indirizzo google-fluentd/releases, dove i tag di rilascio seguono il formato di controllo delle versioni semantico [Major].[Minor].[Patch].

  • Le note di rilascio dei programmi di installazione di Windows sono disponibili nella stessa posizione: google-fluentd/releases. Tuttavia, i tag di rilascio hanno il prefisso Windows.

  • Le note di rilascio della gemma autonoma fluent-plugin-google-cloud sono disponibili all'indirizzo fluent-plugin-google-cloud/releases, dove i tag di rilascio seguono il formato di controllo delle versioni semantico [Major].[Minor].[Patch].

Norme sul ritiro

L'agente Logging è soggetto alle norme sul ritiro degli agenti Google Cloud Observability.

Passaggi successivi