Panoramica dell'agente Logging

Attenzione: a partire dal 28 settembre 2026, l'agente Logging legacy ha raggiunto il termine del supporto. La manutenzione standard e le correzioni di bug non vengono più fornite. Ti consigliamo vivamente di eseguire la migrazione a una delle alternative supportate. Per saperne di più su questo ritiro, consulta Fine del supporto degli agenti di monitoraggio e logging legacy.

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

Nella configurazione predefinita, l'agente Logging trasmette i log di applicazioni di terze parti e software di sistema 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 Configura l'agente Logging.

Si consiglia di eseguire l'agente Logging su tutte le istanze VM. L'agente viene eseguito sia su Linux che su Windows.

Per installare l'agente Logging, consulta Installazione dell'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
• 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 di Container-Optimized OS per raccogliere i log dalle 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.

Nota: l'agente Logging standard non è supportato sulle macchine on-premise. Tuttavia, Google Distributed Cloud include una versione dell'agente già installata e pronta per l'uso.

Per queste istanze VM, è richiesto un minimo di 250 MiB di memoria residente (RSS) per eseguire l'agente Logging, ma è consigliato 1 GiB. Ad esempio, con una frequenza 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.

Supporto per cloud on-premise e ibridi

Google Cloud collabora con Bindplane per fornire servizi di logging per piattaforme on-premise e cloud ibrido in modo coerente e prevedibile. Utilizzando 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 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 alla versione più recente.

• 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

Ambienti gestiti non supportati

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

• Istanze dell'ambiente standard di App Engine. App Engine include il supporto integrato per Logging. Per saperne di più, consulta Scrittura dei log delle applicazioni.

• Istanze dell'ambiente flessibile di App Engine. Le app in esecuzione nell'ambiente flessibile App Engine possono scrivere log aggiuntivi rispetto a quelli inclusi nell'ambiente standard App Engine. Per saperne di più, consulta Scrittura dei log delle applicazioni.

• Istanze di nodi Google Kubernetes Engine. La raccolta dei log con Logging è abilitata per impostazione predefinita per i nuovi cluster di container, oppure puoi abilitarla per i cluster esistenti. Per informazioni, consulta Configura il logging e il monitoraggio per GKE.

• Per le istanze in esecuzione su Google Distributed Cloud, l'agente raccoglie i log di sistema, ma non i log delle applicazioni.

• Istanze di container Cloud Run. Cloud Run include il supporto integrato per Logging. Per saperne di più, vai a Logging e visualizzazione dei log.

• Funzioni HTTP e in background di Cloud Run Functions. Cloud Run Functions include il supporto integrato per Logging.

Codice sorgente dell'agente Logging

Le informazioni contenute in questa sezione non sono necessarie, a meno che tu non voglia comprendere il codice sorgente o abbia altre esigenze particolari. L'agente Logging viene installato dallo script descritto nelle istruzioni di installazione.

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

• Il repository GitHub denominato google-fluentd, che include il programma fluentd principale, gli script di pacchettizzazione 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 sul servizio di hosting di gemme Ruby all'indirizzo fluent-plugin-google-cloud.
  • I contenuti relativi al programma di installazione di Windows 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 della versione semantico [Major].[Minor].[Patch].

• 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 il prefisso Windows.

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

Norme sul ritiro

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

Passaggi successivi

• Installazione dell'agente Logging

• Configura l'agente Logging

• Autorizza l'agente Logging

• Upgrade dell'agente Logging

• Dopo aver installato l'agente, visualizza i log in Esplora log.