Panoramica dell'agente Logging

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

Nella configurazione predefinita, l'agente di logging trasmette i log da applicazioni di terze parti e software di sistema comuni a Logging. Esamina l'elenco dei log predefiniti. Puoi configurare l'agente in modo che trasmetta in streaming log aggiuntivi. Vai a Configurare l'agente Logging per informazioni dettagliate sulla configurazione e sul funzionamento dell'agente.

Una best practice consiste nell'eseguire l'agente Logging su tutte le VM di Compute Engine. L'agente viene eseguito sia in Linux che in Windows.

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

Come funziona l'agente Logging

Sistemi operativi supportati

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

  • CentOS 7 e 8
  • Rocky Linux 8
  • Red Hat Enterprise Linux 7 e 8
  • Debian 9 "Stretch", 10 "Buster" e 11 "Bullseye"
  • Ubuntu LTS 20.04 (Focal Fossa)
  • Ubuntu Minimal LTS 20.04 (Focal Fossa)
  • SUSE Linux Enterprise Server 12 e 12 SP5 per SAP
  • SUSE Linux Enterprise Server 15, 15 SP2 per SAP, 15 S3 per SAP, 15 SP4 per SAP e 15 SP5 per SAP
  • OpenSUSE Leap 15, 15.2, 15.3 e 15.4
  • Windows Server 2016 e 2019
  • Windows Server Core 2016 e 2019
  • Amazon Linux AMI (tranne Amazon Linux 2.0 AMI)

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

Ambienti supportati

L'agente Logging è compatibile con i seguenti ambienti:

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

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

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

    Affinché l'agente di 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. È necessario un indirizzo IP esterno o un gateway internet VPC.

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

Le seguenti istanze VM supportano il 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 observIQ fornire servizi di logging per cloud on-premise e cloud ibrido di terze parti in un ambiente e prevedibile. Utilizzando BindPlane, puoi raccogliere i tuoi dati e inviare in Logging per l'analisi. BindPlane si integra con Cloud Logging per acquisire i dati dall'infrastruttura ed è incluso nel progetto senza costi aggiuntivi.

Per ulteriori informazioni su observIQ e BindPlane, consulta Informazioni su observIQ e BindPlane.

Requisiti di accesso all'agente

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

  • Server 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 alla versione più recente completamente gestita.

  • API Logging: logging.googleapis.com

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

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

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

Codice sorgente dell'agente Logging

Le informazioni riportate in questa sezione non sono necessarie, a meno che tu non voglia comprendere il codice sorgente o 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 gatherer dei dati di log di fluentd. google-fluentd è distribuito in due pacchetti distinti. Il codice sorgente è disponibili dai repository GitHub associati:

  • Il repository GitHub denominato google-fluentd che include il programma fluentd principale, gli script di imballaggio personalizzati e il plug-in di output per l'API Cloud Logging.
    • Il plug-in di output è pacchettizzato come gem di Ruby ed è incluso nel pacchettogoogle-fluentd. È disponibile anche separatamente nel servizio di hosting delle gemme Ruby fluent-plugin-google-cloud.
    • I contenuti relativi al programma di installazione di Windows sono disponibili nella sezione windows-installer .
  • Il repository GitHub denominato google-fluentd-catch-all-config che include i file di configurazione per l'agente Logging per importare i 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, in cui i tag di rilascio seguono la semantica [Major].[Minor].[Patch] di controllo delle versioni.

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

  • Le note di rilascio per il gem autonomo fluent-plugin-google-cloud sono disponibili all'indirizzo fluent-plugin-google-cloud/releases, in cui i tag di rilascio seguono la semantica [Major].[Minor].[Patch] di controllo delle versioni.

Norme sul ritiro

L'agente Logging è soggetto agli agenti di Google Cloud Observability norme sul ritiro.

Passaggi successivi