Log

Riquadro del log

La pagina Log mostra i 500 messaggi di log di sistema più recenti generati dall'istanza di Looker. Per visualizzare la pagina Log, seleziona Log nella sezione Server del menu Admin.

  1. Per limitare le informazioni visualizzate nella finestra Log, puoi inserire del testo nel campo Filtro e la finestra Log mostrerà solo i messaggi che includono il testo che hai inserito.
  2. Fai clic su Refresh Log (Aggiorna log) per aggiornare il log e visualizzare gli ultimi 500 messaggi.
  3. Puoi modificare il livello di gravità dei messaggi di log che verranno visualizzati per i vari servizi di Looker. Questo aspetto è spiegato più dettagliatamente di seguito.

La finestra Log non è il metodo migliore per esaminare l'utilizzo o la cronologia utente. Se hai abilitato la funzionalità System Activity Labs, consulta la pagina della documentazione relativa alla creazione di report sull'utilizzo di Looker con le esplorazioni delle attività di sistema. In caso contrario, consulta la pagina della documentazione relativa alla creazione di report sull'utilizzo e sui metadati di Looker con i__looker.

Livelli di log

La sezione Log Levels (Livelli log) consente di impostare il livello minimo di gravità necessario per la visualizzazione di un messaggio nel log, per diversi servizi Looker. In questo modo puoi nascondere le informazioni di log che non ti interessano.

Il livello di gravità predefinito per i servizi db:* e db:looker è impostato su info. Questo significa che le istruzioni SQL contenenti o filtrando le informazioni personali (ad esempio, il nome di un cliente) vengono registrate da Looker. Questo vale per le impostazioni di gravità di info, dettagliata o debug. Per disattivare la registrazione delle istruzioni SQL, imposta il livello di gravità dei servizi db:* e db:looker su avviso, errore o irreversibile.

Looker registra le istruzioni SQL sia nel nostro database interno (in cui archiviamo i metadati per gli oggetti Looker creati dagli utenti) che nei nostri database esterni (in cui memorizziamo i dati dei clienti e i metadati).

Descrizioni di gravità

Di seguito sono elencati i livelli di gravità dei messaggi di log, dal meno grave al più grave:

  • debug: sono voci di informazioni dettagliate che mostrano i processi interni dell'applicazione di Looker. Questo livello di gravità viene generalmente utilizzato solo per eseguire il debug del codice interno.

  • dettagliata: si tratta di messaggi informativi dettagliati che mostrano gli eventi che si verificano in Looker a un livello più granulare. In genere questo livello di gravità viene utilizzato solo per la risoluzione dei problemi.

  • info: si tratta di messaggi informativi standard che mostrano eventi regolari che si verificano in Looker.

  • avviso: questi messaggi indicano situazioni potenzialmente dannose.

  • error: questi messaggi indicano eventi di errore probabilmente non abbastanza gravi da causare l'interruzione dell'esecuzione di Looker.

  • offerti irreversibili: questi messaggi indicano eventi molto gravi che potrebbero causare l'arresto di Looker.

Descrizioni dei servizi

Il menu a discesa Default (Predefinito) imposta il livello di gravità predefinito per tutti i servizi Looker. Tutti i servizi impostati su Predefinito utilizzeranno il livello di gravità nel menu a discesa Predefinito. Il livello di gravità predefinito per il menu a discesa Predefinito è info.

Puoi anche impostare i livelli di gravità singolarmente per i seguenti servizi:

  • pdt: messaggi associati al processo della tabella derivata permanente.

  • db:*: messaggi generati dalle query al database di analisi o dalle query ai database di clienti.

  • db:looker: messaggi generati dalle query al database di backend Looker.

  • http: messaggi generati dalle richieste http che il server web di frontend riceve o elabora.

  • http_core: messaggi generati dalle richieste http al server web principale che serve all'interno dell'applicazione.

  • jsch: messaggi generati dalle connessioni SSH al servizio Git. L'impostazione predefinita è Avvisa, che non mostra informazioni. Passa al livello info per risolvere i problemi di connessione SSH.

  • logger: messaggi generati quando apporti modifiche al livello di log.

  • org.apache.active: messaggi generati da ActiveMQ. ActiveMQ è un servizio di messaggistica utilizzato da Looker per comunicare le attività tra i sottosistemi. Viene utilizzato dallo scheduler, dalla rigenerazione delle PDT e da altre attività di lunga durata.

  • raven: messaggi generati dal servizio Error Reporting.

  • render: messaggi generati dal renderer, che consente di eseguire il rendering di PDF e PNG.

  • scheduler: messaggi generati dal processo dello scheduler.

Dopo aver modificato il livello di log per un servizio, fai clic su Imposta livelli per salvare le modifiche.

Impostazione del formato del log sulle istanze ospitate dal cliente

Per impostazione predefinita, i messaggi di sistema vengono visualizzati nel testo con il seguente formato:

2019-09-25 15:14:12.301 -0700 [INFO|007d0|main] :: Starting Looker : Version 6.21.0-localdev-ea88a4
...
2019-10-01 14:37:53.424 -0700 [INFO|0002a|http] :: Request from 0:0:0:0:0:0:0:1  GET /folders/1, {}
...
2019-10-01 14:37:53.425 -0700 [INFO|0002a|db:looker] :: (0.000180s) SELECT count(*) AS "COUNT" FROM "USER" LIMIT 1

Alcuni messaggi di sistema, come le eccezioni e le query SQL, vengono generati come output su più righe. Questo potrebbe causare problemi per i processori di log che richiedono voci a riga singola per la corrispondenza del pattern.

Se l'istanza di Looker è ospitata dal cliente e hai bisogno di un output a riga singola, puoi utilizzare l'opzione di avvio --log-format=json per formattare le voci di log in strutture JSON su una sola riga. L'esempio seguente mostra gli stessi eventi riportati sopra, ma nel formato JSON:

{"t":"2019-09-25 15:14:56.513 -0700","s":"INFO","rid":"007d0","c":"main","msg":"Starting Looker : Version 6.21.0-localdev-ea88a4"}
...
{"t":"2019-10-01T14:35:37.577 -07:00","s":"INFO","rid":"0002c","c":"http","ip":"0:0:0:0:0:0:0:1","verb":"GET","path":"/folders/1","params":{}}
...
{"t":"2019-10-01T14:35:37.581 -07:00","s":"INFO","rid":"0002c","c":"db:looker","duration":"0.000344","sql":"SELECT count(*) AS \"COUNT\" FROM \"USER\" LIMIT 1"}