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 Amministratore.

Puoi limitare le informazioni mostrate nel riquadro del 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 gli ultimi 500 messaggi, seleziona Aggiorna log.

Per regolare il livello di gravità dei messaggi di log che verranno 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 le esplorazioni delle attività di sistema.

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 del 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 in base alle informazioni personali (ad esempio i nomi dei clienti) vengono registrate da Looker. Questo vale per le impostazioni di gravità di informazioni, dettagliate 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 in un database interno (in cui sono archiviati i metadati per gli oggetti Looker creati dagli utenti) e in un database esterno (in cui sono 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 di log di debug sono messaggi informativi dettagliati che mostrano i processi interni dell'applicazione di Looker. Questo livello di gravità viene generalmente utilizzato solo per il debug del codice interno.

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

  • info: messaggi informativi standard che mostrano 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 potrebbero causare l'interruzione dell'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 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 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 da query a qualsiasi database del cliente.

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

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

  • 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 è il livello di warn, che non mostra alcuna informazione. Passa al livello informazioni per risolvere i problemi di connessione SSH.

  • logger: messaggi generati quando apporti modifiche a livello di log.

  • org.apache.active: messaggi generati da ActiveMQ. ActiveMQ è un servizio di messaggistica che Looker utilizza per comunicare attività tra sottosistemi. Viene 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 dello scheduler.

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

Impostazione del formato del log per le 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. Ciò può causare problemi ai processori di log che richiedono voci a riga singola per la corrispondenza dei pattern.

Se l'istanza di Looker è ospitata dal cliente e hai bisogno di un output su 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"}