Impostazioni amministratore - Log

La pagina Log nel menu Admin di Looker consente di visualizzare e filtrare i 500 messaggi di log di sistema più recenti generati dall'istanza. Puoi anche configurare i livelli di gravità minimi per i singoli servizi Looker per risolvere i problemi relativi agli eventi delle applicazioni e controllare quali messaggi vengono visualizzati nel 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 Admin.

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 includono quel testo.

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, modifica i livelli di log.

Livelli di log

La sezione Livelli di log consente di impostare il livello di gravità minimo 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, il che significa che le istruzioni SQL che contengono o filtrano 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 la registrazione 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 (dove vengono memorizzati i metadati per gli oggetti Looker creati dagli utenti) sia in database esterni (dove vengono memorizzati i dati e i metadati dei clienti).

Descrizioni della gravità

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

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

  • verbose: 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 in genere utilizzato solo per la risoluzione dei problemi.

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

  • warn: 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.

  • fatal: 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 default utilizzano 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 persistente.

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

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

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

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

  • jsch: messaggi generati dalle connessioni SSH al servizio Git. L'impostazione predefinita è il livello warn, che non visualizza alcuna informazione. Passa al livello info per risolvere i problemi di connessione SSH.

  • logger: messaggi generati quando modifichi il 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. Viene utilizzato dallo scheduler, dalla rigenerazione PDT e da altre attività a lunga esecuzione.

  • 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 dello scheduler.

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

Impostare il formato dei log sulle istanze ospitate dal cliente

Per impostazione predefinita, i messaggi di sistema vengono visualizzati in formato testo utilizzando 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. Ciò può causare problemi per i processori di log che richiedono voci su una sola riga per la corrispondenza dei pattern.

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