Questo documento descrive come visualizzare le voci di log in tempo reale tramite
e tailing in tempo reale.
La funzionalità di streaming dei log ti consente di visualizzare le voci di log in tempo reale ed è disponibile in
Esplora log.
Il tailing in tempo reale consente di visualizzare le voci di log in tempo reale ed è disponibile come
gcloud CLI
Comando 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
, stai visualizzando le voci di log che
Cloud Logging ha archiviato. Quando esegui lo streaming o visualizzi le voci di log in tempo reale, le visualizzi mentre le applicazioni le scrivono nell'API Cloud Logging.
Visualizzare i log in streaming in Esplora log
In Esplora log puoi visualizzare i dati dei log in tempo reale utilizzando Avvia il flusso dei log. Quando utilizzi Stream log, puoi aggiungere una query per eseguire lo streaming solo dei log corrispondenti alla query. Per trasmettere i log, segui questi passaggi:
-
Nella console Google Cloud, vai alla pagina Esplora log:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.
Nella casella di testo Query, inserisci una query e poi fai clic su Stream log.
Poiché Logging scrive i dati dei log, vengono utilizzati solo i log che corrispondono vengono visualizzate nel riquadro Risultati delle query. Se non viene fornita una query, Logging mostra la query le voci di log archiviate. Lo streaming dei log continua 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 nel Esplora log.
Utilizzo del tailing in tempo reale in Google Cloud CLI
Il monitoraggio in tempo reale ti consente di visualizzare le voci di log in tempo reale man mano che vengono scritte da Cloud Logging, 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, indipendentemente può eseguire il flusso di log per i 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 disporre di Python 3 e
il pacchetto Python grpcio
installato.
Per istruzioni su come installare Python, consulta la pagina di Python.
Per istruzioni su come installare il gestore dei 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 per installare Google Cloud CLI, consulta Installazione di Google Cloud CLI.
Verifica di utilizzare la versione 302.0.0 o successiva delle con gcloud CLI.
gcloud version
Per istruzioni su come aggiornare gcloud CLI, consulta
gcloud components update
.Installa i componenti alpha della 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 qualsiasi valore:export CLOUDSDK_PYTHON_SITEPACKAGES=1
Usa i comandi seguenti per impostare l'ID progetto Google Cloud e su autentica:
gcloud config set project PROJECT_ID gcloud auth login
Per ottenere l'ID progetto, consulta la sezione Creazione e gestione Google Cloud.
Verifica che
gcloud alpha logging tail
sia installato eseguendo questo comando :gcloud alpha logging tail
Il comando visualizza il seguente messaggio:
Initializing tail session.
Ora visualizzi le voci di log per il tuo progetto Google Cloud man mano che vengono scritte da Logging.
Per ulteriori informazioni sull'utilizzo di Live tailing, consulta
Guida di riferimento di gcloud alpha logging tail
.
Buffering e ordinamento
Poiché Logging può ricevere voci di log in ordine cronologico, il monitoraggio in tempo reale fornisce un'impostazione della finestra di buffer per consentirti di bilanciare il compromesso tra la visualizzazione delle voci di log durante la loro scrittura e la 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 ritardi nella scrittura delle voci di log nei bucket di log per durata della finestra di 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 visualizzare i log così come sono scritti e le voci in ordine non corretto.
Finestra di buffer | Compromesso |
---|---|
0 secondi |
Sono state restituite le voci di log più recenti, ma è più probabile che vengano escluse in ordine di importanza. |
60 secondi |
Un ritardo di 60 secondi prima di visualizzare le voci restituite, ma la maggior parte dei log viene restituita in ordine crescente. |
Limiti e quote
La tabella seguente elenca i limiti e le quote per il monitoraggio in tempo reale:
Limiti e quote | Valore |
---|---|
Voci restituite al minuto | 60.000 Se più di 60.000 voci corrispondono a un filtro, Il logging restituisce il conteggio delle voci nella risposta. |
Sessioni aperte di logging in tempo reale per progetto Google Cloud | 10 |
Limitazioni del client
Per un progetto Google Cloud che scrive molte voci rapidamente, il client potrebbero non essere in grado di usufruirne con la velocità con cui vengono scritti. Nel in questo caso, Logging limita il numero totale di voci inviate, dando la priorità alle voci più recenti. Al termine della sessione di coda, Logging restituisce il numero di voci che non sono 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 come Cloud Logging e li scrive. Per informazioni sul metodo API per il tailing in tempo reale, consulta il metodo entries.tail.
Il monitoraggio in tempo reale non è supportato per i bucket di log con controlli dell'accesso a livello di campo, ma puoi riprodurre in streaming i 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 su Logging, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 su Logging, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 su Logging, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.