Questa guida fornisce informazioni di base sull'agente Logging, un'applicazione basata su fluentd in esecuzione sulle tue istanze di macchine virtuali (VM).
Nella configurazione predefinita, l'agente Logging trasmette il flusso dei log dalle applicazioni di terze parti comuni e dal software di sistema a Logging; esamina l'elenco dei log predefiniti. Puoi configurare l'agente per trasmettere un flusso di log aggiuntivi. Vai a Configurare l'agente Logging per i dettagli sulla configurazione e sul funzionamento dell'agente.
Come best practice, conviene eseguire l'agente Logging su tutte le istanze VM. L'agente viene eseguito sia in Linux sia in Windows.
Per installare l'agente Logging, consulta Installazione dell'agente Logging.
Sistemi operativi supportati
Puoi eseguire l'agente Logging sui seguenti sistemi operativi sulle 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 (Fossa focale)
- Ubuntu Minimal LTS 20.04 (Fossa focale)
- 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
- AMI Amazon Linux (eccetto Amazon Linux 2.0 AMI)
Se esegui 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:
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 log.
Istanze Amazon Elastic Compute Cloud (Amazon EC2). L'agente Logging invia i log al progetto del connettore AWS che collega il tuo account AWS ai servizi 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. Questa operazione richiede un indirizzo IP esterno o un gateway internet VPC.
Per queste istanze VM, sono necessari almeno 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 dimensioni da 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, quindi l'installazione manuale dell'agente Logging su di esse non è supportata:
Istanze di ambiente standard di App Engine. App Engine include il supporto integrato per Logging. Per ulteriori informazioni, consulta Scrittura dei log delle applicazioni.
Istanze di ambiente flessibile di App Engine. Le app in esecuzione nell'ambiente flessibile di App Engine possono scrivere log in aggiunta a quanto incluso nell'ambiente standard di App Engine. Per ulteriori informazioni, consulta Scrittura dei log dell'applicazione.
Istanze di nodi Google Kubernetes Engine. La raccolta di log con Logging è abilitata per impostazione predefinita per i nuovi cluster di container oppure puoi abilitarla per i cluster esistenti. Per saperne di più, consulta Configurazione di logging e monitoraggio per GKE.
Per le istanze in esecuzione su GKE su VMware, l'agente raccoglie i log di sistema, ma non raccoglie i log delle applicazioni.
Istanze di container Cloud Run. Cloud Run include il supporto integrato per Logging. Per ulteriori informazioni, vai a Logging e visualizzazione dei log.
Funzioni HTTP e in background di Cloud Functions. Cloud Functions include il supporto integrato per Logging. Per ulteriori informazioni, consulta Scrittura, visualizzazione e risposta ai log.
Supporto per cloud on-premise e ibridi
Google Cloud collabora con observIQ 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 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 agli agenti
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.
API di 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
Non è necessario fornire le informazioni in questa sezione, a meno che tu non voglia capire il codice sorgente o 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 raccoglitore dati di log fluentd.
google-fluentd
viene distribuito in due pacchetti separati. Il codice sorgente è disponibile nei repository GitHub associati:
- Il repository GitHub denominato
google-fluentd
che include il programma principalefluentd
, gli script di pacchettizzazione personalizzati e il plug-in di output per l'API Cloud Logging.- Il plug-in di output è pacchettizzato come gem Ruby ed è incluso nel pacchetto
google-fluentd
. È inoltre disponibile separatamente nel servizio di hosting delle gem Ruby su fluent-plugin-google-cloud. - I contenuti relativi al programma di installazione di Windows si trovano nella cartella windows-installer.
- Il plug-in di output è pacchettizzato come gem Ruby ed è incluso nel pacchetto
- Il repository GitHub denominato
google-fluentd-catch-all-config
che include i file di configurazione per l'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'indirizzogoogle-fluentd/releases
, dove i tag di release seguono il formato di controllo delle versioni 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 release sono preceduti dal prefissoWindows
.Le note di rilascio della gemma autonoma
fluent-plugin-google-cloud
sono disponibili all'indirizzofluent-plugin-google-cloud/releases
, dove i tag di release seguono il formato di controllo delle versioni semantico[Major].[Minor].[Patch]
.
Norme sul ritiro
L'agente Logging è soggetto ai criteri di ritiro degli agenti di osservabilità di Google Cloud.
Passaggi successivi
Dopo aver installato l'agente, visualizza i log in Esplora log.