Paramètres d'administration - Journal

Panneau de journal

Le panneau Log (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 Log (Journal), sélectionnez Log (Journal) dans la section Server (Serveur) du menu Admin.

Vous pouvez limiter les informations affichées dans le panneau "Journal". Pour ce faire, saisissez du texte dans le champ Filtre afin que le panneau du journal n'affiche que les messages qui incluent ce texte.

Pour mettre à jour le journal et afficher les 500 derniers messages, sélectionnez Refresh Log (Actualiser le journal).

Pour ajuster le niveau de gravité des messages de journal qui seront affichés pour les services Looker, ajustez les niveaux de journalisation.

Pour créer des rapports sur l'utilisation de votre instance Looker, consultez la page de documentation Créer des rapports d'utilisation Looker avec les explorations d'activité du système.

Niveaux de journalisation

La section Log Levels (Niveaux de journalisation) vous permet de définir le niveau de gravité minimal requis pour qu'un message apparaisse dans le journal pour plusieurs services Looker. Cela vous permet de masquer les informations du journal qui ne vous intéressent pas.

Le niveau de gravité par défaut des services db:* et db:looker est défini sur info, ce qui signifie que les instructions SQL contenant des informations personnelles (par exemple, les noms de clients) ou filtrées en fonction de celles-ci sont enregistrées par Looker. Cela est vrai 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 à la fois 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 métadonnées des clients).

Descriptions des niveaux de gravité

Les niveaux de gravité des messages de journal sont classés du moins sévère au plus sévère:

  • debug: les entrées de journal de débogage sont des messages d'informations détaillées qui montrent les processus internes de l'application de Looker. Ce niveau de gravité n'est généralement utilisé que pour déboguer le code interne.

  • verbose: il s'agit de messages d'information détaillés qui affichent 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 affichent les événements réguliers qui se produisent dans Looker.

  • warn: ces messages indiquent des situations potentiellement dangereuses.

  • error (erreur) : ces messages indiquent des événements d'erreur qui ne sont probablement pas assez graves pour entraîner l'arrêt de l'exécution de Looker.

  • fatal: ces messages indiquent des événements d'erreur très graves susceptibles d'arrêter l'exécution 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 utiliseront le niveau de gravité du menu déroulant 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 par des requêtes adressées à 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 d'interface reçoit ou traite.

  • http_core: messages générés à partir de requêtes HTTP envoyées au 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 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 utilisé par Looker pour communiquer les 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 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 processus du programmeur.

Après avoir modifié le niveau de journalisation d'un service, sélectionnez Définir des niveaux pour enregistrer vos modifications.

Définir le format de journal sur les instances hébergées par le client

Par défaut, les messages système sont affichés sous forme de texte 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 sous forme de sortie sur plusieurs lignes. Cela peut causer des problèmes pour les 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 un 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 en structures JSON à 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"}