Scrittura e visualizzazione dei log

Python 2.7/3 |Java 8/11/17 |PHP 5/7 |Ruby |Go 1.11 / 1.12+ |Node.js

Questa pagina descrive i log disponibili per le app di App Engine e le istruzioni per scrivere e visualizzare le voci di log.

App Engine raccoglie due tipi di log:

• Log delle richieste. Un log delle richieste inviate alla tua app. App Engine crea automaticamente le voci nel log delle richieste.

• Log app: le voci di log che scrivi in un framework o file supportato, come descritto in questa pagina.

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

Scrittura nei log delle app

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

Importante: una voce del log dell'app non deve superare i 16.000 byte. Nessuna delle informazioni che supera questo limite verrà visualizzata in Esplora log.

Alternativa: scrittura di log strutturati in stdout e stderr

Anziché l'approccio consigliato, puoi inviare stringhe di testo semplici a stdout e stderr. Le stringhe appariranno come messaggi in Esplora log, la riga di comando e l'API Cloud Logging e saranno associate al servizio App Engine e alla versione che li ha emessi.

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

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

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

Importante: nell'ambiente standard di App Engine, la scrittura dei log strutturati in stdout e stderr non conteggia attualmente le richieste di importazione dei log al minuto nell'API Cloud Logging.

Visualizzazione dei log

Puoi visualizzare i log dell'applicazione e delle richieste utilizzando Esplora log:

1. Vai a Esplora log in Cloud Console:

   Vai a Esplora log

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

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

4. Per vedere quali voci di log dell'app sono correlate alle voci di log della richiesta:

   1. Seleziona il log httpRequest.requestUrl dal menu di selezione.

   2. Espandi una voce del log delle richieste. I log dell'app correlati a tale richiesta vengono visualizzati sotto la voce del log della richiesta.

   Se invii voci di testo semplici all'output standard, non puoi utilizzare il visualizzatore log per filtrare le voci delle app in base alla gravità, né visualizzare i log delle app corrispondenti a richieste specifiche. Puoi comunque utilizzare altri tipi di filtro in Esplora log, come testo e timestamp.

Puoi filtrare Esplora log per servizio e versione di App Engine e altri criteri. Puoi anche cercare voci specifiche nei log. Vedi i dettagli su visualizzazione dei log.

Nota: nei runtime di App Engine precedenti, una voce del log delle richieste ereditava il livello di gravità più elevato dalle voci secondarie. Ad esempio, se una voce della richiesta è correlata a un avviso del log dell'app, viene visualizzata come avviso in Esplora log. Questa funzionalità di ereditarietà non è disponibile nei runtime più recenti come Ruby. Tutte le voci mantengono invece il livello di gravità assegnato quando è stata generata la voce.

Visualizzazione dei log dalla 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 Coda dei log delle app gcloud.

Lettura programmatica dei log

Se vuoi leggere i log in modo programmatico, puoi utilizzare uno di questi metodi:

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

Prezzi, quote e criteri di conservazione dei log

Per informazioni sui prezzi che si applicano sia ai log delle richieste che alle app, consulta i prezzi per Cloud Logging.

Per i criteri di conservazione dei log e le dimensioni massime delle voci di log, vedi Quote e limiti. Se vuoi archiviare i log per un periodo 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, quindi per gestire il numero di voci dei log delle richieste associate alla tua app, utilizza la funzionalità di esclusione dei log di Cloud Logging.

Problemi noti

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