Créer des rapports d'utilisation et de métadonnées Looker avec i__looker

Les administrateurs et les utilisateurs de Looker disposant de l'autorisation see_system_activity ont accès au panneau Utilisation de l'instance, qui se connecte directement à la base de données d'applications sous-jacente de Looker, appelée i__looker. La base de données i__looker stocke des informations sur votre instance Looker, y compris tous les looks et les tableaux de bord enregistrés sur votre instance, les informations utilisateur et les 90 derniers jours de requêtes historiques:

Cette page décrit les explorations les plus couramment utilisées dans i__looker et donne des exemples d'utilisations courantes. Cette fonctionnalité peut être utile à des fins d'audit et de surveillance.

Le texte SQL et le texte des filtres exécutés par les utilisateurs sont accessibles dans i__looker et peuvent être consultés par tout utilisateur autorisé à afficher le modèle i__looker.

Action : Modifiez qui dispose d'un accès en lecture au modèle i__looker. Les administrateurs Looker ont accès à i__looker par défaut. Les utilisateurs non administrateurs peuvent obtenir l'accès à i__looker s'ils disposent de l'autorisation see_system_activity.

Conseil de l'équipe Chat: Les données temporelles de i__looker sont stockées dans le fuseau horaire du système Looker. Pour en savoir plus, consultez la page Utiliser les paramètres de fuseau horaire.

Exploration de l'historique

L'explorateur d'historique inclut des informations sur chaque requête exécutée sur votre instance Looker au cours des 90 derniers jours.

Vous pouvez accéder à la fonctionnalité d'exploration de l'historique à l'URL suivante, en remplaçant <instance_name.looker.com> par l'adresse de votre instance Looker:

https://<instance_name.looker.com>/explore/i__looker/history

Vous pouvez utiliser la fonctionnalité d'exploration de l'historique pour obtenir une version plus détaillée du panneau Requêtes de la page Administration. Toutes les informations sont affichées dans le panneau Requêtes, mais le rapport contient des données plus précises sur les 50 dernières requêtes et les utilisateurs, les rôles, les groupes, etc.

Ce que l'historique n'est pas

La fonctionnalité d'exploration de l'historique inclut les vues Look (Aperçu), Dashboard (Tableau de bord) et User (Utilisateur). Ces vues ne présentent pas tous les looks, les tableaux de bord et les utilisateurs de votre instance. Ces vues répertorient plutôt les looks, les tableaux de bord et les utilisateurs qui ont été consultés ou actifs au cours des 90 derniers jours. Pour afficher la liste complète des looks, des tableaux de bord ou des utilisateurs, utilisez la section "Explorations" décrite plus loin sur cette page.

Troncation de la table History (Historique)

Étant donné que la taille de la table "Historique" peut augmenter rapidement, Looker supprime automatiquement les enregistrements correspondant à l'un des critères suivants:

  • La métrique history.created_time date de plus de 90 jours.
  • La métrique history.created_time date de plus de sept jours et la valeur history.source est scheduled_task.

Champs utiles de la section "Historique"

La fonctionnalité Explorer de l'historique comprend de nombreux champs. Voici quelques-uns des champs les plus couramment utilisés:

  • history.source : source d'une requête, telle qu'un affichage enregistré, un tableau de bord, une exploration, une tâche planifiée, une API, etc.

  • history.created_time: date et heure de création d'un événement dans l'outil d'exploration de l'historique. Chaque événement est associé à une requête dans Looker. Les requêtes proviennent de la page Explorer, des tableaux de bord, des looks, des appels d'API et des événements planifiés.

  • history.result_source : indique si les résultats d'une requête ont été renvoyés par le cache ou la base de données sous la forme d'une nouvelle requête.

  • history.runtime_in_seconds: temps nécessaire à l'exécution d'une requête. Cela inclut la construction de la requête, chaque fois que la requête est passée dans la file d'attente, le transit vers et depuis la base de données et l'exécution de la base de données.

  • query.model: modèle LookML associé à une requête.

  • query.explore : exploration LookML associée à une requête.

  • query.sql_text: code SQL réel exécuté pour une requête.

Examples

Vous trouverez ci-dessous quelques utilisations courantes de la fonctionnalité Historique. Notez que vous devez remplacer <instance_name.looker.com> au début de l'URL par l'adresse de votre instance Looker pour que ces liens fonctionnent.

Quel est l'environnement d'exécution moyen pour différents modèles sur mon instance ?

Cette exploration recense chaque modèle ayant fait l'objet d'une requête au cours des 90 derniers jours et affiche l'environnement d'exécution moyen des requêtes basées sur ces modèles au cours des 90 derniers jours:

https://<instance_name.looker.com>/explore/i__looker/history?fields=query.model,history.average_runtime&f[history.result_source]=query&sorts=history.average_runtime+desc&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22history.result_source%22%3A%5B%7B%22type%22%3A%22%3D%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22query%22%7D%2C%7B%7D%5D%2C%22id%22%3A0%2C%22error%22%3Afalse%7D%5D%7D&origin=share-expanded

Cette exploration liste les titres de chaque tableau de bord consulté au cours des 90 derniers jours, ainsi que le nombre d'accès à chacun de ces tableaux de bord:

https://<instance_name.looker.com>/explore/i__looker/history?fields=dashboard.title,history.query_run_count&f[dashboard.title]=-NULL&sorts=history.query_run_count+desc&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22dashboard.title%22%3A%5B%7B%22type%22%3A%22%21null%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22%22%7D%2C%7B%7D%5D%2C%22id%22%3A0%2C%22error%22%3Afalse%7D%5D%7D&origin=share-expanded

Cette exploration indique le nombre d'exécutions d'une exploration par chaque rôle sur votre instance au cours des 90 derniers jours:

https://<instance_name.looker.com>/explore/i__looker/history?fields=history.query_run_count,query.view,role.name&pivots=role.name&f[role.name]=-NULL&sorts=history.query_run_count+desc+0&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22role.name%22%3A%5B%7B%22type%22%3A%22%21null%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22%22%7D%2C%7B%7D%5D%2C%22id%22%3A1%2C%22error%22%3Afalse%7D%5D%7D&origin=share-expanded

Quelqu'un a-t-il interrogé une personne spécifique au cours des 90 derniers jours ?

Vous pouvez utiliser l'exploration de l'historique pour déterminer si une exploration spécifique a été utilisée au cours des 90 derniers jours:

  1. Sélectionnez les champs history.created_date, query.explore et query.link.
  2. Filtrez sur query.explore, en saisissant le nom de l'exploration.
  3. Cliquez sur Exécuter.

Quelqu'un a-t-il utilisé un champ d'une vue spécifique au cours des 90 derniers jours ?

L'explorateur de l'historique vous permet de déterminer si des champs d'une vue spécifique ont été utilisés au cours des 90 derniers jours:

  1. Sélectionnez les champs history.created_date, query.explore et query.link.
  2. Filtrez sur query.fields_used, en saisissant le nom de la vue suivi d'un point (par exemple, orders.), puis sélectionnez contient pour la condition de filtre. La période définie dans le filtre permet de vous assurer de ne renvoyer que les champs correspondant à cette vue, et non ceux issus de vues portant un nom similaire.
  3. Cliquez sur Exécuter.

Regardez "Explorer"

La fonctionnalité Explorer de Look comprend des informations sur tous les looks enregistrés de votre instance Looker, par exemple:

  • Qui a créé le style et quand
  • Les champs qui constituent un style
  • Dossiers de stockage des looks

Vous pouvez accéder à la fonctionnalité Explorer à l'adresse suivante, en remplaçant <instance_name.looker.com> par l'adresse de votre instance Looker:

https://<instance_name.looker.com>/explore/i__looker/look

Champs utiles dans l'onglet "Explorer"

Voici quelques-uns des champs les plus couramment utilisés dans Look Explorer:

  • look.created_date: date à laquelle un style a été créé.

  • look.deleted_date : date à laquelle un style a été supprimé. Si l'élément n'a pas été supprimé, ce champ est NULL.

  • look.public : indique si le style a été rendu public ou non.

  • look.public_slug: portion de hachage de l'URL de la page.

  • query.link : lien vers l'onglet "Explorer" sous-jacent.

  • space.name: le nom du dossier où est stocké un style

Examples

Voici quelques utilisations courantes de la fonctionnalité Explorer. Notez que vous devez remplacer <instance_name.looker.com> au début de l'URL par l'adresse de votre instance Looker pour que ces liens fonctionnent.

Combien de looks publics y a-t-il ?

Cette exploration répertorie tous les looks sur votre instance qui ont été rendus publics:

https://<instance_name.looker.com>/explore/i__looker/look?fields=look.id,look.title,look.link&f[look.public]=Yes&sorts=look.title&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22look.public%22%3A%5B%7B%22type%22%3A%22is%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22Yes%22%7D%2C%7B%7D%5D%2C%22id%22%3A0%7D%5D%7D&dynamic_fields=%5B%5D&origin=share-expanded

Quels styles ont été supprimés ?

Cette exploration répertorie tous les looks qui ont été supprimés:

https://<instance_name.looker.com>/explore/i__looker/look?fields=look.id,look.title,look.link,look.deleted_date&f[look.deleted_date]=NOT+NULL&sorts=look.title&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22look.deleted_date%22%3A%5B%7B%22type%22%3A%22%21null%22%2C%22values%22%3A%5B%7B%22constant%22%3A%227%22%2C%22unit%22%3A%22day%22%7D%2C%7B%7D%5D%2C%22id%22%3A1%2C%22error%22%3Afalse%7D%5D%7D&dynamic_fields=%5B%5D&origin=share-expanded

Dans quels dossiers mes styles sont-ils enregistrés ?

L'onglet "Explorer" répertorie tous vos styles, triés en fonction du dossier dans lequel ils sont stockés:

https://<instance_name.looker.com>/explore/i__looker/look?fields=space.name,look.id,look.title,look.link&f[look.deleted_date]=NOT+NULL&sorts=space.name+desc&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22look.deleted_date%22%3A%5B%7B%22type%22%3A%22%21null%22%2C%22values%22%3A%5B%7B%22constant%22%3A%227%22%2C%22unit%22%3A%22day%22%7D%2C%7B%7D%5D%2C%22id%22%3A1%2C%22error%22%3Afalse%7D%5D%7D&dynamic_fields=%5B%5D&origin=share-expanded

Exploration du tableau de bord

L'exploration du tableau de bord comprend des informations sur chaque tableau de bord enregistré sur votre instance Looker. Comme avec la fonctionnalité Explorer, vous trouverez des informations sur vos tableaux de bord, comme leur auteur, la date de leur création et le dossier dans lequel elles se trouvent. Vous y trouverez également des informations sur les paramètres et les éléments du tableau de bord.

Vous pouvez accéder au tableau de bord"Explorer"à l'URL suivante, en remplaçant <instance_name.looker.com> par l'adresse de votre instance Looker:

https://<instance_name.looker.com>/explore/i__looker/dashboard

Champs utiles du tableau de bord "Explorer"

L'onglet "Explorer" du tableau de bord comporte des champs semblables à l'onglet "Explorer". En plus de ces champs, vous trouverez ci-dessous des champs propres au tableau de bord "Explorer" couramment utilisés:

  • dashboard.refresh_interval: si l'actualisation automatique est activée sur le tableau de bord, la fréquence d'actualisation est atteinte.

  • dashboard.run_on_load : indique si l'option Run on Load (Exécuter lors du chargement) est activée sur le tableau de bord.

Examples

Voici quelques utilisations courantes de la fonctionnalité Explorer du tableau de bord. Vous devez remplacer <instance_name.looker.com> au début de l'URL par l'adresse de votre instance Looker pour que ces liens fonctionnent.

Combien de tableaux de bord s'exécutent au chargement ?

Cette exploration indique le nombre de tableaux de bord de votre instance configurés pour Run on Load (Exécuter au chargement) :

https://<instance_name.looker.com>/explore/i__looker/dashboard?fields=dashboard.count&f[dashboard.run_on_load]=Yes&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22dashboard.run_on_load%22%3A%5B%7B%22type%22%3A%22is%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22Yes%22%7D%2C%7B%7D%5D%2C%22id%22%3A1%7D%5D%7D&origin=share-expanded

Combien existe-t-il de tableaux de bord fréquemment actualisés ?

Semblable à Run on Load (Exécuter lors du chargement), le paramètre Auto-Refresh (Actualisation automatique) peut affecter les performances de Looker si vous disposez d'un grand nombre de tableaux de bord qui s'actualisent automatiquement fréquemment. Cette exploration affiche le nombre de tableaux de bord configurés pour s'actualiser automatiquement et le nombre d'actualisations à chaque intervalle:

https://<instance_name.looker.com>/explore/i__looker/dashboard?fields=dashboard.refresh_interval,dashboard.count&f[dashboard.refresh_interval]=-NULL&sorts=dashboard.count+desc&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22dashboard.refresh_interval%22%3A%5B%7B%22type%22%3A%22%21null%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22%22%7D%2C%7B%7D%5D%2C%22id%22%3A0%2C%22error%22%3Afalse%7D%5D%7D&origin=share-expanded

Exploration des utilisateurs

L'exploration des utilisateurs inclut des informations sur chaque utilisateur de votre instance Looker. Il inclut les informations suivantes:

  • Identifiants de l'API User

  • Groupes d'utilisateurs

  • Les rôles, les autorisations et les ensembles d'autorisations attribués aux utilisateurs

  • Détails utilisateur et paramètres tels que le nom et l'ID, et si l'utilisateur est activé sur l'instance

Vous pouvez accéder à l'exploration des utilisateurs à l'URL suivante, en remplaçant <instance_name.looker.com> par l'adresse de votre instance Looker:

https://<instance_name.looker.com>/explore/i__looker/user

Champs utiles dans l'explorateur d'utilisateurs

Voici quelques-uns des champs couramment utilisés:

  • group.name: nom d'un groupe auquel appartient un utilisateur

  • permission_set.permissions : liste des autorisations accordées à un utilisateur

  • role.name: rôle attribué à un utilisateur

  • user.dev_mode : indique si l'utilisateur est en mode Développement

  • user.is_disabled : indique si un utilisateur a été désactivé sur l'instance Looker.

  • user.edit_link : lien vers la page de Looker où vous pouvez modifier les informations utilisateur

  • role.edit_link: lien vers la page de Looker où vous pouvez modifier les informations de rôle attribuées à l'utilisateur

  • group.edit_link: lien vers la page de Looker, où vous pouvez modifier l'ensemble des groupes d'un utilisateur.

Examples

Vous trouverez ci-dessous quelques utilisations courantes de la fonctionnalité "Exploration des utilisateurs". Notez que vous devez remplacer <instance_name.looker.com> au début de l'URL par l'adresse de votre instance Looker pour que ces liens fonctionnent.

Quels utilisateurs ont désactivé l'accès ?

Cette exploration répertorie tous les utilisateurs dont l'accès a été désactivé:

https://<instance_name.looker.com>/explore/i__looker/user?fields=user.name&f[user.is_disabled]=Yes&sorts=user.name&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22user.is_disabled%22%3A%5B%7B%22type%22%3A%22is%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22Yes%22%7D%2C%7B%7D%5D%2C%22id%22%3A1%7D%5D%7D&origin=share-expanded

Quels utilisateurs disposent d'une autorisation spécifique ?

Cette exploration répertorie tous les utilisateurs de votre instance disposant de l'autorisation develop:

https://<instance_name.looker.com>/explore/i__looker/user?fields=user.name&f[permission_set.permissions]=%25develop%25&sorts=user.name&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22permission_set.permissions%22%3A%5B%7B%22type%22%3A%22contains%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22develop%22%7D%2C%7B%7D%5D%2C%22id%22%3A0%2C%22error%22%3Afalse%7D%5D%7D&origin=share-expanded

Combien y a-t-il d'utilisateurs dans chaque rôle sur mon instance ?

Cette exploration comptabilise le nombre d'utilisateurs actifs dans chaque rôle sur l'instance. Notez qu'un utilisateur peut se voir attribuer plusieurs rôles. Par exemple, si un utilisateur s'est vu attribuer le rôle "développeur" et le rôle "administrateur", il est comptabilisé deux fois:

https://<instance_name.looker.com>/explore/i__looker/user?fields=role.name,user.count&f[user.is_disabled]=No&sorts=user.count+desc&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22user.is_disabled%22%3A%5B%7B%22type%22%3A%22is%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22No%22%7D%2C%7B%7D%5D%2C%22id%22%3A2%2C%22error%22%3Afalse%7D%5D%7D&origin=share-expanded