Scrittura e visualizzazione dei log

Python 2.7/3 |Java 8/11/17 |PHP 5/7+ |Ruby |Go 1.11 / 1.1.1.1

In questa pagina vengono descritti i log disponibili per le app di App Engine e come scrivere e visualizzare le voci di log.

App Engine raccoglie due tipi di log:

• Log di richiesta: un log delle richieste inviate alla tua app. App Engine crea automaticamente voci nel log di richiesta.

• Log dell'app: voci di log scritte in un framework o in un file supportati, come descritto in questa pagina.

App Engine invia automaticamente questi log all'agente Cloud Logging e puoi visualizzarli nel visualizzatore log, dalla riga di comando o in modo programmatico.

Scrittura dei log dell'app in corso...

Per scrivere voci di log, ti consigliamo di utilizzare la libreria client di Cloud Logging per PHP. Per istruzioni ed esempi di codice, consulta Configurazione di Cloud Logging per PHP.

Importante: una voce di log dell'app non deve superare i 16.000 byte. Non verrà mostrato nulla di superiore a questo limite in Esplora log.

Metodo alternativo: scrittura di log strutturati in stdout e stderr

Invece dell'approccio consigliato, puoi inviare semplici stringhe di testo a stdout e stderr. Le stringhe verranno visualizzate come messaggi in Esplora log, nella riga di comando e nell'API Cloud Logging e verranno associate al servizio e alla versione di App Engine che le ha emesse.

Se vuoi filtrare queste stringhe in Esplora log in base al livello di gravità, devi formattarle come dati strutturati. Per ulteriori informazioni, consulta Logging strutturato.

Se vuoi mettere in correlazione le voci nel log dell'app con il log della richiesta, le voci del log dell'app strutturata devono contenere l'identificatore di traccia della richiesta. Puoi estrarre l'identificatore di traccia dall'intestazione della richiesta X-Cloud-Trace-Context. Nella voce del log strutturato, scrivi l'ID in un campo denominato logging.googleapis.com/trace. Per ulteriori informazioni sull'intestazione X-Cloud-Trace-Context, consulta Forzare il tracciamento di una richiesta.

Visualizza un esempio di scrittura di voci di log strutturate con un ID traccia nella documentazione di Cloud Run. Puoi utilizzare la stessa tecnica nelle tue app App Engine.

Importante: nell'ambiente standard di App Engine, la scrittura di log strutturati in stdout e stderr non viene conteggiata nel calcolo della quota di richieste di importazione log al minuto nell'API Cloud Logging.

Visualizzazione dei log

Puoi visualizzare l'applicazione e richiedere i log utilizzando Esplora log:

1. Vai a Esplora log in Google Cloud Console:

   Vai a Esplora log

2. Seleziona un progetto Google Cloud esistente nella parte superiore della pagina.

3. Dai menu a discesa, seleziona Applicazione GAE come tipo di risorsa.

4. Per vedere quali voci di log dell'app sono correlate alle richieste di log delle richieste:

   1. Seleziona il log httpRequest.requestUrl dai menu dei filtri.

   2. Espandi una voce del log delle richieste. I log delle app correlati alla richiesta vengono visualizzati come nidificati nella voce del log della richiesta.

   Se invii semplici voci di testo all'output standard, non puoi utilizzare il visualizzatore log per filtrare le voci dell'app in base alla gravità, né puoi vedere quali log dell'app corrispondono a richieste specifiche. Puoi comunque utilizzare altri tipi di filtri in Esplora log, ad esempio testo e timestamp.

Puoi filtrare Esplora log per servizio di App Engine, versione e altri criteri. Puoi anche cercare voci specifiche nei log. Per maggiori dettagli, consulta Utilizzo di Esplora log.

Nota: nei runtime di App Engine meno recenti, una voce di log della richiesta erediterebbe il livello di gravità più elevato dalle relative voci figlio. Ad esempio, se una voce di richiesta è stata correlata a un avviso nel log dell'app, viene visualizzata come avviso in Esplora log. Questa funzionalità di ereditarietà non è disponibile nei runtime più recenti come PHP 7+. Invece, tutte le voci mantengono il livello di gravità assegnato al momento della generazione della voce.

Visualizzazione dei log mediante la riga di comando

Per visualizzare i log di App Engine dalla riga di comando, utilizza il comando seguente:

gcloud app logs tail

Per ulteriori informazioni, consulta la sezione relativa alla coda di log delle app gcloud.

Lettura dei log in modo programmatico

Se vuoi leggere i log in modo programmatico, puoi utilizzare uno dei seguenti metodi:

• Utilizza un sink di log in Pub/Sub e uno script da estrarre da Pub/Sub.
• Chiama l'API Cloud Logging tramite la libreria client per il linguaggio di programmazione.
• Chiama direttamente gli endpoint REST dell'API Cloud Logging.

Criteri di conservazione di prezzi, quote e log

Per informazioni sui prezzi che si applicano ai log delle richieste e delle app, consulta la pagina relativa ai prezzi di Cloud Logging.

Per il criterio di conservazione dei log e le dimensioni massime delle voci di log, vedi Quote e limiti. Se vuoi archiviare i log per un periodo di tempo più lungo, puoi esportarli in Cloud Storage. Puoi anche esportare i log in BigQuery e Pub/Sub per un'ulteriore elaborazione.

Gestione dell'utilizzo delle risorse di log

Puoi controllare la quantità di attività di logging dai log dell'app scrivendo più o meno voci dal codice dell'app. I log delle richieste vengono creati automaticamente. Per gestire il numero di voci di log delle richieste associate alla tua app, utilizza la funzionalità di esclusione dei log di Cloud Logging.

Problemi noti

A volte le voci del log dell'app non sono correlate al log della richiesta. Questo si verifica la prima volta che la tua app riceve una richiesta e ogni volta che App Engine scrive i messaggi di stato nel log dell'app. Per ulteriori informazioni, consulta https://issuetracker.google.com/issues/138365527.