Impostazioni amministratore - Log

Pannello 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. A questo scopo, inserisci il testo nel campo Filtro per fare in modo che il riquadro Log mostri solo i messaggi che includono quel testo.

Per aggiornare il log e mostrare 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.

Livelli di log

La sezione 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 dei 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. Ciò 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 archiviati i metadati degli oggetti Looker creati dagli utenti) sia in un database esterno (dove vengono archiviati 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 del log di debug sono messaggi informativi dettagliati che mostrano i processi interni dell'applicazione 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.

  • Avviso: questi messaggi indicano situazioni potenzialmente dannose.

  • Errore: questi messaggi indicano eventi di errore probabilmente non 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 predefinito 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 di tabella derivata permanente.

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

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

  • http: messaggi generati da richieste HTTP che il web server frontend riceve o elabora.

  • http_core: messaggi generati dalle 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 Avviso, 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 che Looker utilizza per comunicare le attività tra i sottosistemi. Viene utilizzato dallo scheduler, dalla rigenerazione del PDT e da altre attività a esecuzione prolungata.

  • raven: messaggi generati dal servizio di segnalazione errori.

  • 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 sulle istanze ospitate dal cliente

Per impostazione predefinita, i messaggi di sistema vengono visualizzati in formato di 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 eccezioni e 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 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"}