Panneau de journalisation
La page Journal affiche les 500 derniers messages du journal système générés par votre instance Looker. Pour afficher la page Journal, sélectionnez Journal dans la section Serveur du menu Admin.
- Pour limiter les informations affichées dans la fenêtre de journal, vous pouvez saisir du texte dans le champ Filter (Filtre). La fenêtre de journalisation n'affiche que les messages comprenant le texte que vous avez saisi.
- Cliquez sur Actualiser le journal pour le mettre à jour et afficher les 500 derniers messages.
- Vous pouvez ajuster le niveau de gravité des messages de journal affichés pour divers services Looker. Vous trouverez des explications plus détaillées ci-dessous.
La fenêtre de journal ne constitue pas le meilleur moyen d'examiner l'utilisation ou l'historique utilisateur. En revanche, si vous avez activé la fonctionnalité expérimentale Activité du système, consultez la page de documentation Créer des rapports d'utilisation de Looker à l'aide d'explorations de l'activité système. Sinon, consultez la page de documentation Créer des rapports d'utilisation et de métadonnées Looker avec i__looker.
Niveaux de journalisation
La section Niveaux de journal 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 contenant ou filtrant des informations personnelles (par exemple, le nom d'un client) sont consignées par Looker. C'est le cas 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 consigne les instructions SQL dans notre base de données interne (où nous stockons les métadonnées des objets Looker créés par les utilisateurs) et dans nos bases de données externes (où nous stockons les métadonnées et les données client).
Descriptions de gravité
Les niveaux de gravité des messages de journal sont listés ci-dessous, du plus grave au plus grave:
debug: les entrées de journal de débogage sont des messages d'information détaillés qui montrent les processus d'application interne de Looker. Ce niveau de gravité est généralement utilisé uniquement pour le débogage du code interne.
détaillé : il s'agit de messages d'information détaillés qui permettent d'afficher de manière plus précise les événements qui se produisent dans Looker. Ce niveau de gravité n'est généralement utilisé que pour le dépannage.
info: messages d'information standards qui montrent des événements réguliers dans Looker.
avertissement: ces messages indiquent des situations potentiellement dangereuses.
error : ces messages indiquent des événements d'erreur qui ne sont probablement pas suffisamment graves pour empêcher Looker de s'exécuter.
fatales : ces messages indiquent des événements d'erreur très graves susceptibles d'entraîner l'arrêt de Looker.
Descriptions du service
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 utiliseront le niveau de gravité du menu déroulant Default (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 adressées à la base de données d'analyse ou à toute requête vers une base de données client.
db:looker: messages générés par des requêtes adressées à la base de données backend 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 vers le serveur Web principal qui diffuse les composants internes de l'application.
jsch : messages générés par des connexions SSH au service Git. Le paramètre par défaut est warn (avertissement), 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 qui permet à Looker de communiquer des tâches entre les sous-systèmes. Il est utilisé par le programmeur, la génération de PDT et d'autres tâches de longue durée.
raven : messages générés par le service Error Reporting
Rendu : messages générés par le moteur de rendu, qui affiche les fichiers PDF et PNG.
scheduler : messages générés par le programmeur.
Après avoir modifié le niveau de journalisation d'un service, cliquez sur Définir les niveaux pour enregistrer vos modifications.
Définir le format des journaux sur les instances hébergées par le client
Par défaut, les messages système s'affichent au format 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 sur plusieurs lignes. Cela peut poser des problèmes aux processeurs de journaux qui nécessitent des entrées sur une seule ligne pour la correspondance de 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 formater les entrées de journal en structures JSON à une seule ligne. L'exemple ci-dessous montre les mêmes événements que ci-dessus, 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"}