Impostazioni amministratore - Log

Riquadro dei 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 che verranno mostrati per i servizi Looker, regola i livelli di log.

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

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 in base a informazioni personali (ad esempio i nomi dei clienti) vengono registrate da Looker. Questo vale per le impostazioni di gravità info, verbose 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 del log di debug sono messaggi di informazioni dettagliate che mostrano i processi di applicazione interni 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à viene in genere utilizzato solo per la risoluzione dei problemi.

  • info: si tratta di messaggi informativi standard che mostrano 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 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 singolarmente i livelli di gravità per i seguenti servizi:

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

  • db:*: messaggi generati da query al database di analisi o da query a qualsiasi database dei 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 warn, che non mostra alcuna informazione. 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 dal programmatore, dalla rigenerazione del PDT e da altre attività che richiedono molto tempo.

  • raven: messaggi generati dal servizio Error Reporting.

  • render: messaggi generati dal renderer, che esegue il rendering di 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 dei 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, come eccezioni e query SQL, vengono generati come output di più righe. Ciò può causare problemi per i processori di log che richiedono voci singole per la corrispondenza dei pattern.

Se l'istanza di Looker è ospitata dal cliente e hai bisogno di un output di una sola riga, puoi utilizzare l'--log-format=jsonopzione di avvio per formattare le voci di log in strutture JSON di una sola 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"}