Lettura e scrittura dei log delle applicazioni

Panoramica

Quando viene inviata una richiesta alla tua app, App Engine scrive automaticamente un log delle richieste. Durante la gestione della richiesta, l'app può anche scrivere i log delle applicazioni. In questa pagina imparerai a scrivere i log delle applicazioni dalla tua applicazione, come visualizzare il logging nella console Google Cloud e come comprendere i dati del log delle richieste che App Engine scrive durante la richiesta.

Per informazioni sul download dei dati dei log, consulta Panoramica delle esportazioni dei log.

Importante: tieni presente che i log per impostazione predefinita non vengono mantenuti quando utilizzi il server delle app di sviluppo. Per informazioni su come rendere persistenti i log, consulta Il server di sviluppo e l'API Logs.

Log delle richieste e log delle applicazioni

Esistono due categorie di dati di log: log delle richieste e log delle applicazioni. Un log delle richieste viene scritto automaticamente da App Engine per ogni richiesta gestita dalla tua app e contiene informazioni come l'ID progetto, la versione HTTP e così via. Per un elenco completo delle proprietà disponibili per i log delle richieste, consulta RequestLog. Per le descrizioni dei campi del log delle richieste, consulta anche la tabella dei log delle richieste.

Ogni log delle richieste contiene un elenco di log delle applicazioni (AppLog) associati alla richiesta, restituiti nella proprietà RequestLog.app_logs. Ogni log dell'app contiene l'ora in cui è stato scritto, il messaggio di log e il livello di log.

Nota: un log delle richieste può contenere solo 1000 log delle app. Se ne aggiungi più di 1000, i log meno recenti non verranno conservati.

Scrittura dei log delle applicazioni

Importante: le singole voci di log di un'applicazione hanno un limite di 16 kB. Nessun elemento oltre questo limite verrà scritto nel log dell'app.

Potrebbe essere utile leggere la documentazione per il modulo di logging di Python standard su Python.org.

Il modulo di logging in Python consente a uno sviluppatore di registrare 5 livelli di gravità. :

• esegui il debug
• Informazioni
• Avviso
• Errore
• Critico

Nell'esempio seguente viene illustrato come utilizzare i diversi livelli di logging:

import logging

import webapp2


class MainPage(webapp2.RequestHandler):
    def get(self):
        logging.debug('This is a debug message')
        logging.info('This is an info message')
        logging.warning('This is a warning message')
        logging.error('This is an error message')
        logging.critical('This is a critical message')

        try:
            raise ValueError('This is a sample value error.')
        except ValueError:
            logging.exception('A example exception log.')

        self.response.out.write('Logging example.')


app = webapp2.WSGIApplication([
    ('/', MainPage)
], debug=True)

Formato dell'URL del log nella console Google Cloud

Consulta il seguente URL di esempio per un esempio del formato dell'URL del log nella console Google Cloud:

https://console.cloud.google.com/logs?filters=request_id:000000db00ff00ff827e493472570001737e73686966746361727331000168656164000100

Nota: l'URL non include più filter_type.

Lettura dei log nella console

Nota: i log descritti qui vengono mostrati come visibili nel visualizzatore log.

Per visualizzare i log scritti dalle app in esecuzione nell'ambiente standard, utilizza Esplora log.

Un tipico log di App Engine contiene dati nel formato di log combinato Apache, insieme ad alcuni campi speciali di App Engine, come illustrato nel seguente log di esempio:

192.0.2.0 - test [27/Jun/2014:09:11:47 -0700] "GET / HTTP/1.1" 200 414
"http://www.example.com/index.html"
Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/35.0.1916.153 Safari/537.36"
"1-dot-calm-sylph-602.appspot.com" ms=195 cpu_ms=42 cpm_usd=0.000046
loading_request=1 instance=00c61b117cfeb66f973d7df1b7f4ae1f064d app_engine_release=

Informazioni sui campi del log delle richieste

Nella tabella seguente sono elencati i campi in ordine di occorrenza insieme a una descrizione:

Ordine sul campo	Nome campo	Sempre presente?	Descrizione
1	Indirizzo client	Sì	Indirizzo IP client. Esempio: 192.0.2.0
2	Identità RFC 1413	No	Identità RFC 1413 del client. Si tratta quasi sempre del carattere -
3	Utente	No	Presente solo se l'app utilizza l'API Users e l'utente ha eseguito l'accesso. Questo valore è la parte relativa al "nickname" dell'Account Google, ad esempio, se l'Account Google è [e-mail], il nickname registrato in questo campo è test.
4	Timestamp	Sì	Timestamp della richiesta. Esempio: [27/Jun/2014:09:11:47 -0700]
5	Stringa di query richiesta	Sì	Prima riga della richiesta, contenente metodo, percorso e versione HTTP. Esempio: GET / HTTP/1.1
6	Codice di stato HTTP	Sì	Codice di stato HTTP restituito. Esempio: 200
7	Dimensioni risposta	Sì	Dimensioni della risposta in byte. Esempio: 414
8	Percorso referrer	No	Se non è presente alcun referrer, il log non contiene alcun percorso, ma solo -. Esempio di percorso del referrer: "http://www.example.com/index.html".
9	User-agent	Sì	Identifica il browser e il sistema operativo con il server web. Esempio: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/35.0.1916.153 Safari/537.36
10	Nome host	Sì	Il nome host utilizzato dal client per connettersi all'applicazione App Engine. Esempio : (1-dot-calm-sylph-602.appspot.com)
11	Tempo reale	Sì	Tempo di clock totale in millisecondi impiegato da App Engine per soddisfare la richiesta. Questa durata non include il tempo trascorso tra il client e il server che esegue l'istanza della tua applicazione. Esempio: ms=195.
12	Millisecondi CPU	Sì	Millisecondi CPU necessari per soddisfare la richiesta. Si tratta del numero di millisecondi spesi dalla CPU che esegue effettivamente il codice dell'applicazione, espresso in termini di CPU Intel x86 di base da 1,2 GHz. Se la CPU effettivamente utilizzata è più veloce della base di riferimento, i millisecondi della CPU possono essere maggiori del tempo di clock effettivo definito sopra. Esempio: cpu_ms=42
13	Codice di uscita	No	Presente solo se l'istanza si arresta dopo aver ricevuto la richiesta. Nel formato exit_code=XXX, dove XXX è un numero di 3 cifre corrispondente al motivo per cui l'istanza è stata arrestata. I codici di uscita non sono documentati, poiché il loro scopo principale è aiutare Google a individuare e risolvere i problemi.
14	Costo stimato	Sì	OBSOLETO. Costo stimato di 1000 richieste come questa, in $. Esempio: cpm_usd=0.000046
15	Nome coda	No	Il nome della coda di attività utilizzata. Presente solo se la richiesta ha utilizzato una coda di attività. Esempio: queue_name=default
16	Nome attività	No	Il nome dell'attività eseguita nella coda di attività per questa richiesta. Presente solo se la richiesta ha comportato l'accodamento di un'attività. Esempio: task_name=7287390692361099748
17	Coda in attesa	No	Presente solo se una richiesta è rimasta in attesa per un po' di tempo in una coda in attesa. Se nei log sono presenti molte istanze di questo tipo e/o i valori sono alti, potrebbe significare che sono necessarie più istanze per gestire il traffico. Esempio: pending_ms=195
18	Caricamento della richiesta in corso...	No	Presente solo se la richiesta è una richiesta di caricamento. Ciò significa che è stato necessario avviare un'istanza. Idealmente, le tue istanze dovrebbero essere attive e in stato integro il più a lungo possibile, gestire un numero elevato di richieste prima di essere riciclate e dover essere riavviate. Ciò significa che non dovresti vederne troppi nei tuoi log. Esempio: loading_request=1.
19	Istanza	Sì	Identificatore univoco per l'istanza che gestisce la richiesta. Esempio: instance=00c61b117cfeb66f973d7df1b7f4ae1f064d
20	Versione	Sì	L'attuale versione di release di App Engine utilizzata nell'ambiente di produzione di App Engine:

Quote e limiti

L'applicazione è interessata dalle seguenti quote relative ai log:

• Dati di log recuperati tramite l'API Logs.
• Allocazione e conservazione per l'importazione dei log.

Quota per i dati recuperati

I primi 100 megabyte di dati di log recuperati al giorno tramite le chiamate API di log sono gratuiti. I dati che superano i 100 MB comportano addebiti di 0,12 $ per GB.

Allocazione per l'immissione dei log

Il logging per le app di App Engine è fornito da Google Cloud Observability. Consulta i prezzi di Google Cloud Observability per ulteriori informazioni sui costi e sui limiti di logging. Per l'archiviazione a lungo termine dei log, puoi esportare i log da Google Cloud Observability a Cloud Storage, BigQuery e Pub/Sub.

Server di sviluppo e API Logs

Importante:

• Prima di eseguire il server di sviluppo locale, segui le istruzioni per la configurazione. Indipendentemente dal runtime o dalla versione del linguaggio dell'app, devi eseguire dev_appserver.py con Python 3 e impostare la variabile di ambiente CLOUDSDK_DEVAPPSERVER_PYTHON nella shell sul percorso dell'interprete Python 2.
• Lo strumento dev_appserver non supporta lo sviluppo di app Python 3 su Windows.

Per impostazione predefinita, i log vengono archiviati in memoria solo nel server di sviluppo e sono accessibili se vuoi testare la funzionalità dell'API Logs. Se vuoi mantenere i log dal server di sviluppo al disco in una posizione di tua scelta, fornisci il percorso e il nome file desiderati all'opzione della riga di comando --logs_path come segue:

   python2 [DEVAPPSERVER_ROOT]/google_appengine/dev_appserver.py --logs_path=your-path/your-logfile-name your-app-directory