Panneau des journaux
Le panneau Journal affiche les 500 messages de journal système les plus récents générés par votre instance Looker. Pour afficher la page Journal, sélectionnez Journal dans la section Serveur du menu Administrateur.
Vous pouvez limiter les informations affichées dans le panneau "Journal". Pour ce faire, saisissez du texte dans le champ Filtrer afin que le panneau "Journal" n'affiche que les messages qui incluent ce texte.
Pour actualiser le journal et afficher les 500 messages les plus récents, sélectionnez Actualiser le journal.
Pour ajuster le niveau de gravité des messages de journal affichés pour les services Looker, ajustez les niveaux de journalisation.
Niveaux de journalisation
La section Niveaux de journalisation vous permet de définir le niveau de gravité minimal requis pour qu'un message s'affiche dans le journal pour plusieurs services Looker différents. Cela vous permet de masquer les informations de journal qui ne vous intéressent pas.
Le niveau de gravité par défaut pour les services db:* et db:looker est défini sur info, ce qui signifie que les instructions SQL qui contiennent ou filtrent des informations personnelles (par exemple, les noms des clients) sont enregistrées par Looker. Cela vaut pour les paramètres de gravité info, verbose ou debug. Pour désactiver la journalisation des instructions SQL, définissez le niveau de gravité des services db:* et db:looker sur warn, error ou fatal.
Looker enregistre les instructions SQL dans une base de données interne (où sont stockées les métadonnées des objets Looker créés par les utilisateurs) et dans des bases de données externes (où sont stockées les données et les métadonnées des clients).
Descriptions des niveaux de gravité
Les niveaux de gravité des messages de journal sont listés ci-dessous, du moins grave au plus grave :
debug : les entrées du journal de débogage sont des messages d'information détaillés qui affichent les processus internes de l'application Looker. Ce niveau de gravité n'est généralement utilisé que pour le débogage du code interne.
verbose : il s'agit de messages d'information détaillés qui affichent les événements se produisant dans Looker à un niveau plus précis. Ce niveau de gravité n'est généralement utilisé que pour la résolution des problèmes.
info : il s'agit de messages d'information standards qui affichent les événements réguliers se produisant dans Looker.
warn : ces messages indiquent des situations potentiellement dangereuses.
error : ces messages indiquent des événements d'erreur qui ne sont probablement pas assez graves pour entraîner l'arrêt de Looker.
fatal : ces messages indiquent des événements d'erreur très graves qui entraîneront probablement l'arrêt de Looker.
Descriptions des services
La liste déroulante Par défaut définit le niveau de gravité par défaut pour tous les services Looker. Tous les services définis sur default utilisent le niveau de gravité de la liste déroulante Par défaut. Le niveau de gravité par défaut de la liste déroulante Par défaut est info.
Vous pouvez également définir des niveaux de gravité individuellement pour les services suivants :
pdt : messages associés au processus de table dérivée persistante.
db* : messages générés par des requêtes envoyées à la base de données d'analyse ou à une base de données client.
db:looker : messages générés par les requêtes envoyées à la base de données backend de Looker.
http : messages générés à partir de requêtes HTTP que le serveur Web frontend reçoit ou traite.
http_core : messages générés à partir de requêtes HTTP adressées au serveur Web principal qui gère les composants internes de l'application.
jsch : messages générés par les connexions SSH au service Git. Le paramètre par défaut est le niveau warn, qui n'affiche aucune information. Passez au niveau info pour résoudre les problèmes de connexion SSH.
logger : messages générés lorsque vous modifiez le niveau de journalisation.
org.apache.active : messages générés par ActiveMQ. ActiveMQ est un service de messagerie que Looker utilise pour communiquer des tâches entre les sous-systèmes. Il est utilisé par le planificateur, la régénération des tables PDT et d'autres tâches de longue durée.
raven : messages générés par le service de création de rapports d'erreurs.
render : messages générés par le moteur de rendu, qui génère des PDF et des PNG.
scheduler : messages générés par le processus du planificateur.
Une fois que vous avez modifié le niveau de journalisation d'un service, sélectionnez Définir les niveaux pour enregistrer vos modifications.
Définir le format de journalisation sur les instances hébergées par le client
Par défaut, les messages système s'affichent au format texte suivant :
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
Certains messages système, tels que les exceptions et les requêtes SQL, sont générés en sortie multiligne. Cela peut poser problème aux processeurs de journaux qui nécessitent des entrées sur une seule ligne pour la mise en correspondance des modèles.
Si votre instance Looker est hébergée par le client et que vous avez besoin d'une sortie sur une seule ligne, vous pouvez utiliser l'option de démarrage --log-format=json pour mettre en forme les entrées de journal dans des structures JSON sur une seule ligne. L'exemple suivant montre les mêmes événements que l'exemple précédent, mais au format 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"}