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 Logging invia il flusso di log da applicazioni e software di sistema comuni di terze parti a Logging; esamina l'elenco dei log predefiniti. Puoi configurare l'agente per il flusso di log aggiuntivi; vai a Configura il Agente Logging per 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.
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 (eccetto Amazon Linux 2.0 AMI)
Se esegui VM Container-Optimized OS poi segui le istruzioni per Container-Optimized OS per la raccolta dei 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 Logging di inviare i log.
Amazon Elastic Compute Cloud (Amazon EC2) di Compute Engine. L'agente Logging invia i log all'account Progetto connettore AWS che collega il tuo account AWS a servizi Google Cloud.
Affinché l'agente Logging funzioni correttamente, Amazon EC2 su cui viene eseguito devono poter comunicare con le API Google Cloud, in particolare l'API Logging. Ciò richiede un indirizzo IP esterno o un gateway internet VPC.
Per queste istanze VM, viene addebitato un minimo di 250 MiB di memoria residente (RSS) richiesto per eseguire l'agente Logging, ma è consigliato 1 GiB. Per Ad esempio, a una velocità di 100 voci di log di dimensioni pari a 1 kB al secondo, L'agente Logging con configurazioni predefinite utilizza il 5% di CPU su uno e 150 MiB di memoria.
Le seguenti istanze VM supportano il logging utilizzando la propria software, quindi l'installazione manuale dell'agente Logging non è supportati:
dell'ambiente standard di App Engine. App Engine include il supporto integrato per Logging. Per ulteriori informazioni, vai a Scrittura dei log delle applicazioni.
dell'ambiente flessibile di App Engine. App in esecuzione nell'ambiente flessibile di App Engine, possono scrivere log oltre a quanto incluso nello standard di App Engine, completamente gestito di Google Cloud. Per ulteriori informazioni, vai a Scrittura dei log delle applicazioni.
delle istanze dei nodi Google Kubernetes Engine. La raccolta di log con Logging è abilitata per impostazione predefinita per le nuove o puoi abilitarlo per i tuoi cluster esistenti. Per le informazioni, vedi Configurazione del logging e del monitoraggio per GKE.
Per le istanze in esecuzione su Google Distributed Cloud, raccoglie i log di sistema, ma non quelli dell'applicazione.
Istanze di container Cloud Run. Cloud Run include il supporto integrato per Logging. Per saperne di più, vedi Logging e visualizzazione dei log.
Cloud Functions per HTTP e funzioni in background. Cloud Functions include il supporto integrato per Logging. Per ulteriori informazioni, consulta Scrittura, visualizzazione e risposta a Log.
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 dati dalla tua infrastruttura è incluso nel tuo progetto senza costi aggiuntivi.
Per ulteriori informazioni su observIQ e BindPlane, vedi 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 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 di questa sezione a meno che tu non voglia capire il codice sorgente o se hai altre esigenze speciali. Il logging viene installato mediante lo script descritto istruzioni di installazione.
L'agente Logging, google-fluentd
, è una versione modificata del
raccoglitore dati di log fluentd.
google-fluentd
è distribuito in due pacchetti separati. Il codice sorgente è
disponibili dai repository GitHub associati:
- Il repository GitHub denominato
google-fluentd
che include il programmafluentd
principale, gli script per pacchetti personalizzati e il plug-in di output per l'API Cloud Logging.- Il plug-in di output è pacchettizzato come gem Ruby ed è incluso nella
google-fluentd
pacco. È anche disponibile separatamente nella gemma Ruby all'indirizzo fluent-plugin-google-cloud. - I contenuti relativi al programma di installazione di Windows sono disponibili nella sezione programma di installazione Windows .
- Il plug-in di output è pacchettizzato come gem Ruby ed è incluso nella
- 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'indirizzogoogle-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 località:
google-fluentd/releases
. Tuttavia, i tag di release hanno invece il prefissoWindows
.Le note di rilascio per il gem autonomo
fluent-plugin-google-cloud
sono disponibili all'indirizzofluent-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
Dopo l'installazione dell'agente, visualizza i log nel Esplora log.