Questo documento descrive come visualizzare le voci di log in tempo reale tramite streaming e tailing in tempo reale.
I flussi di log consentono di visualizzare le voci di log in tempo reale e sono disponibili in Esplora log.
Il tailing in tempo reale consente di visualizzare le voci di log in tempo reale ed è disponibile come
comando gcloud CLI gcloud alpha logging tail
e come metodo API Cloud Logging
entries.tail
.
Quando visualizzi e analizzi i log utilizzando Esplora log, gcloud logging read
o il metodo API entries.list
, visualizzi le voci di log archiviate da Cloud Logging. Quando esegui il flusso di voci
o le voci di log in live tail, visualizzi le voci di log mentre le
applicazioni le scrivono nell'API Cloud Logging.
Trasmetti i log in Esplora log
In Esplora log puoi visualizzare i dati dei log in tempo reale utilizzando lo strumento Avvia flusso di log. Quando utilizzi flussi di log, puoi aggiungere una query per trasmettere in flusso solo i log che corrispondono alla query. Per trasmettere i log, segui questi passaggi:
-
Nella console Google Cloud, vai alla pagina Esplora log:
Se usi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.
Nella casella di testo Query, inserisci una query e fai clic su Avvia flusso di log.
Man mano che Logging scrive i dati dei log, nel riquadro Risultati delle query vengono visualizzati solo i log che corrispondono alla query. Se non viene fornita una query, Logging mostra le voci di log archiviate di recente. I log continuano a trasmettere in flusso finché non selezioni la barra di scorrimento nel riquadro dei log. Quando lo streaming viene interrotto, viene visualizzato il pulsante Riavvia streaming.
Per informazioni sulle query, consulta Creare query in Esplora log.
Utilizzo del tailing in tempo reale in Google Cloud CLI
Il tailing in tempo reale consente di visualizzare le voci di log in tempo reale mentre Cloud Logging le scrive, utilizzando Google Cloud CLI o l'API Cloud Logging.
Il tailing in tempo reale non è supportato per i bucket di log con controlli di accesso a livello di campo, ma puoi trasmettere i flussi di log per questi bucket in Esplora log.
Per informazioni sul metodo API per il tailing in tempo reale, consulta il metodo entries.tail.
Installazione di gcloud alpha logging tail
in corso...
Per utilizzare gcloud alpha logging tail
, devi aver installato Python 3 e
il pacchetto Python grpcio
.
Per istruzioni su come installare Python, consulta la pagina Python.
Per istruzioni sull'installazione del gestore di pacchetti Python, pip
, necessario per installare il pacchetto grpcio
, consulta la pagina del programma di installazione dei pacchetti Python.
Completa i seguenti passaggi per installare gcloud alpha logging tail
:
Verifica di aver installato Google Cloud CLI. Per istruzioni su come installare Google Cloud CLI, consulta Installazione di Google Cloud CLI.
Verifica di utilizzare la versione 302.0.0 o successiva di gcloud CLI.
gcloud version
Per istruzioni sull'aggiornamento di gcloud CLI, consulta
gcloud components update
.Installa i componenti alpha gcloud CLI:
gcloud components install alpha
Per gli utenti di MacOS, Linux e Cloud Shell:
Installa le librerie client gRPC:
sudo pip3 install grpcio
Imposta la variabile di ambiente
CLOUDSDK_PYTHON_SITEPACKAGES
su un valore qualsiasi:export CLOUDSDK_PYTHON_SITEPACKAGES=1
Usa i comandi seguenti per impostare l'ID progetto Google Cloud ed eseguire l'autenticazione:
gcloud config set project PROJECT_ID gcloud auth login
Per ottenere l'ID progetto, consulta la sezione Creazione e gestione dei progetti.
Verifica che
gcloud alpha logging tail
sia installato eseguendo questo comando:gcloud alpha logging tail
Il comando visualizza il seguente messaggio:
Initializing tail session.
Stai visualizzando le voci di log per il tuo progetto Google Cloud così come le scrive Logging.
Per ulteriori informazioni sull'utilizzo del tailing in tempo reale, consulta la
guida di riferimento di gcloud alpha logging tail
.
Buffering e ordinazione
Poiché Logging può ricevere voci di log in ordine cronologico, il tailing live fornisce un'impostazione di buffer-window in modo da poter bilanciare il compromesso tra la visualizzazione delle voci di log man mano che vengono scritte e la loro visualizzazione in ordine crescente. Puoi impostare la finestra del buffer
tra 0
e 60
secondi.
Osserva le seguenti caratteristiche della finestra del buffer:
La finestra di buffer predefinita è di due secondi.
Logging ritarda la scrittura delle voci di log nei bucket di log per la durata della finestra del buffer.
Se una voce di log viene scritta al di fuori della finestra del buffer, Logging restituisce le voci di log man mano che vengono ricevute.
Quando configuri la finestra del buffer, devi trovare un compromesso tra la visualizzazione dei log perché sono scritti e la visualizzazione delle voci in ordine non corretto.
Finestra del buffer | Compromesso |
---|---|
0 secondi |
Sono state restituite le voci di log più recenti, ma è più probabile che non siano in ordine. |
60 secondi |
Ritardo di 60 secondi prima di visualizzare le voci restituite, ma la maggior parte dei log viene restituita in ordine crescente. |
Limiti e quote
Nella tabella seguente sono elencati i limiti e le quote per il tailing in tempo reale:
Limiti e quote | Valore |
---|---|
Voci restituite al minuto | 60.000 Se più di 60.000 voci corrispondono a un filtro, Logging restituisce il conteggio delle voci nella risposta. |
Sessioni aperte di live-tailing per progetto Google Cloud | 10 |
Limitazioni client
Per un progetto Google Cloud che scrive molte voci rapidamente, il tuo client potrebbe non essere in grado di utilizzarle con la stessa velocità con cui vengono scritte. In questo caso, Logging limita il numero totale di voci inviate, dando la priorità a quelle più recenti. Al termine della sessione tail, Logging restituisce il numero di voci che non erano state visualizzate a causa dei limiti del client.
Utilizzare il tailing in tempo reale con le librerie client
Il tailing in tempo reale consente di visualizzare le voci di log in tempo reale mentre Cloud Logging le scrive. Per informazioni sul metodo API per il tailing in tempo reale, consulta il metodo entries.tail.
Il tailing in tempo reale non è supportato per i bucket di log con controlli di accesso a livello di campo, ma puoi trasmettere i flussi di log per questi bucket in Esplora log.
Questo esempio mostra le voci di log di tailing in tempo reale di un determinato logger.
Go
Per scoprire come installare e utilizzare la libreria client per Logging, consulta Librerie client di Logging.
Per autenticarti a Logging, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per scoprire come installare e utilizzare la libreria client per Logging, consulta Librerie client di Logging.
Per autenticarti a Logging, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per scoprire come installare e utilizzare la libreria client per Logging, consulta Librerie client di Logging.
Per autenticarti a Logging, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.