Impostazioni amministratore - Log

Riquadro del log

Il riquadro 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 Amministrazione.

Puoi limitare le informazioni visualizzate nel riquadro Log. Per farlo, inserisci il testo nel campo Filtro in modo che il riquadro Log mostri solo i messaggi che lo includono.

Per aggiornare il log e visualizzare i 500 messaggi più recenti, seleziona Aggiorna log.

Per regolare il livello di gravità dei messaggi di log visualizzati per i servizi Looker, regola i livelli di log.

Livelli di log

La sezione Livelli di log consente di impostare il livello di gravità minimo necessario per visualizzare 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, il che significa che le istruzioni SQL che contengono o filtrano le informazioni personali (ad esempio i nomi dei clienti) vengono registrate da Looker. Questo vale per le impostazioni di gravità di info, dettagliato o debug. Per disattivare il logging delle istruzioni SQL, imposta il livello di gravità dei servizi db:* e db:looker su warn, error o fatal.

Looker registra le istruzioni SQL sia in un database interno (in cui sono archiviati i metadati per gli oggetti Looker creati dagli utenti) che in un database esterno (in cui sono archiviati i dati e i metadati dei clienti).

Descrizioni della gravità

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

  • debug: le voci di log di debug sono messaggi informativi dettagliati che mostrano i processi interni dell'applicazione di Looker. Questo livello di gravità in genere viene utilizzato solo per il debug del codice interno.

  • dettagliato: sono messaggi informativi dettagliati che mostrano gli eventi che si verificano in Looker a un livello più dettagliato. Questo livello di gravità in genere viene utilizzato solo per la risoluzione dei problemi.

  • info: sono messaggi informativi standard che mostrano gli eventi regolari che si verificano in Looker.

  • avvisa: questi messaggi indicano situazioni potenzialmente dannose.

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

  • irreversibile: questi messaggi indicano eventi di errore molto gravi che probabilmente causeranno l'interruzione dell'esecuzione di Looker.

Descrizioni dei servizi

Il menu a discesa Predefinito imposta il livello di gravità predefinito per tutti i servizi Looker. Tutti i servizi impostati su predefinito utilizzano il livello di gravità nel menu a discesa Predefinito. Il livello di gravità predefinito per il menu a discesa Predefinito è informazioni.

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

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

  • db:*: messaggi generati da query al database di analisi o a qualsiasi database di clienti.

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

  • http: messaggi generati da richieste HTTP ricevute o elaborate dal server web frontend.

  • http_core: messaggi generati da richieste HTTP al server web principale che gestisce i componenti interni dell'applicazione.

  • jsch: messaggi generati da connessioni SSH al servizio Git. L'impostazione predefinita è il livello avviso, che non mostra informazioni. Passa al livello informazioni 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 che Looker utilizza per comunicare le attività tra i sottosistemi. È utilizzato dallo scheduler, dalla rigenerazione delle PDT e da altre attività a lunga esecuzione.

  • raven: messaggi generati dal servizio Error Reporting.

  • render: messaggi generati dal renderer, che esegue il rendering dei file PDF e PNG.

  • scheduler: messaggi generati dal processo di pianificazione.

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

Impostazione del formato del log nelle istanze ospitate dal cliente

Per impostazione predefinita, i messaggi di sistema vengono visualizzati in testo nel 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, ad esempio eccezioni e query SQL, vengono generati come output su più righe. Questo può causare problemi per i processori di log che richiedono voci di una sola riga per la corrispondenza dei pattern.

Se l'istanza di Looker è ospitata dal cliente e hai bisogno di un output da una sola riga, puoi utilizzare l'opzione di avvio --log-format=json per formattare le voci di log in strutture JSON a riga singola. L'esempio seguente mostra gli stessi eventi dell'esempio precedente, ma in 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"}