Impostazioni amministratore - Log

Riquadro dei log

Il riquadro Log mostra i 500 messaggi di log di sistema più recenti generati dalla tua istanza di Looker. Per visualizzare la pagina Log, seleziona Log nella sezione Server del menu Amministratore.

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

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

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

Per creare report sull'utilizzo nell'istanza di Looker, consulta la pagina della documentazione Creazione di report sull'utilizzo di Looker con esplorazioni delle attività di sistema.

Livelli di log

La sezione Log Levels (Livelli di log) consente di impostare il livello minimo di gravità richiesto 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. Ciò 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, dettagliata o debug. Per disattivare il logging delle istruzioni SQL, imposta il livello di gravità dei servizi db:* e db:looker su warn, error o irreversibile.

Looker registra le istruzioni SQL sia su un database interno (in cui sono archiviati i metadati per gli oggetti Looker creati dagli utenti) sia a un database esterno (in cui sono archiviati 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: le voci del log di debug sono messaggi con informazioni dettagliate che mostrano i processi interni dell'applicazione di Looker. Questo livello di gravità viene utilizzato solo per il debug del codice interno.

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

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

  • Attenzione: questi messaggi indicano situazioni potenzialmente dannose.

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

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

Descrizioni del servizio

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

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

  • pdt: messaggi associati alla procedura di tabella derivata permanente.

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

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

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

  • http_core: messaggi generati dalle richieste HTTP al server web principale che gestisce gli elementi interni dell'applicazione.

  • jsch: messaggi generati da connessioni SSH al servizio Git. L'impostazione predefinita è avviso, 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 della PDT e da altre attività di lunga durata.

  • raven: messaggi generati dal servizio di segnalazione degli errori.

  • render: messaggi generati dal renderer, in cui vengono visualizzati PDF e PNG.

  • scheduler: messaggi generati dal processo dello scheduler.

Dopo aver modificato il livello di log per un servizio, seleziona 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 sotto forma di 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 a una riga per la corrispondenza del pattern.

Se la tua istanza di Looker è ospitata dal cliente e utilizzi un output di una riga, puoi usare l'opzione di avvio --log-format=json per formattare le voci di log in strutture JSON di una riga. 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"}