Créer des rapports d'utilisation Looker avec les explorations d'activité du système

Les administrateurs et les utilisateurs Looker disposant de l'autorisation see_system_activity ont accès aux explorations de l'activité du système de Looker dans le menu Explorer.

Les explorations d'activité du système se connectent à la base de données d'application sous-jacente de Looker. Ils affichent des informations sur votre instance Looker, y compris les Looks et les tableaux de bord enregistrés sur votre instance, des informations utilisateur, des informations sur l'historique des requêtes et des statistiques sur les performances de l'instance. La précision et la conservation des données d'activité du système sont soumises à des contraintes du système. L'activité du système est conçue pour collecter de grands volumes de données. Son agrégation peut être utilisée pour compléter vos journaux d'entreprise.

Par défaut, les données Activité du système sont stockées dans la base de données interne de Looker. La plupart des tables sont tronquées régulièrement afin de respecter les limites de stockage. Par exemple, le tableau de l'historique est tronqué aux 90 derniers jours de données. Certaines tables appliquent des règles de conservation des données plus strictes. Pour améliorer la conservation des données, envisagez d'utiliser le paramètre Activité du système Élite.

Il n'est pas possible d'interroger les données d'activité du système à l'aide de SQL Runner, car les autorisations pour la base de données interne de Looker sont limitées.

Explorations de l'activité du système

Voici les explorations de l'activité du système:

Nom de l'exploration Description Durée du cache
Utilisation du contenu Données sur l'utilisation des Looks et du tableau de bord, y compris la fréquence des vues, les favoris, la planification, l'intégration et l'accès via l'API. Inclut également des détails sur les Looks et les tableaux de bord individuels. 12 heures
Connexion à la base de données Détails sur les connexions de base de données. Inclut des informations sur les utilisateurs ayant accès aux connexions aux bases de données. 1 heure
Tableau de bord Détails sur tous les tableaux de bord et éléments du tableau de bord. Inclut des informations sur les Looks, les requêtes, les rôles, les utilisateurs et les dossiers associés aux tableaux de bord. 12 heures
Performances du tableau de bord Données de performances et historiques des tableaux de bord. 1 heure
Événement Des informations sur l'historique des événements dans Looker, y compris le nom, le type et la fréquence de chaque événement. Inclut des informations sur les groupes et les utilisateurs associés aux événements. 1 heure
Attribut d'événement Informations sur les attributs qui composent les événements. Inclut les données de l'exploration des événements et ajoute des informations sur les attributs. 12 heures
Utilisation du champ Champs LookML et le nombre d'utilisations. 1 heure
Dossiers Informations sur tous les dossiers, le contenu de chaque dossier et le créateur de chaque dossier. 1 heure
Groupe Liste des groupes et informations sur ces groupes, y compris les groupes parents et enfants, ainsi que les utilisateurs et les rôles qui appartiennent à chaque groupe. 1 heure
Historique Détails sur toutes les requêtes exécutées au cours des 90 derniers jours 12 heures
Look Détails sur tous les Looks. Inclut des informations sur les tableaux de bord, les requêtes, les utilisateurs et les dossiers associés aux Looks. 12 heures
Fusionner la requête Informations sur les requêtes fusionnées, y compris les champs et les autres éléments des requêtes source et fusionnées. 1 heure
Builds de PDT Détails sur les générations de PDT, y compris le temps nécessaire pour terminer les générations, ainsi que la connexion et le modèle dont font partie les PDT. 1 heure
Journal des événements PDT Informations sur les événements historiques liés aux PDT, y compris les reconstructions et les erreurs de PDT.

Consultez la page de documentation Comprendre les actions du journal des PDT pour découvrir comment afficher et comprendre les actions du journal des PDT et les données d'action correspondantes.
12 heures
Métriques de performances des requêtes Répartition détaillée des requêtes exécutées à partir de votre instance Looker. 1 heure
Rôle Les rôles Looker, ainsi que les ensembles de modèles et d'autorisations qui les composent. 1 heure
Requête SQL Requêtes SQL exécutées, y compris la date et la fréquence d'exécution, ainsi que les informations sur les utilisateurs qui les ont exécutées. 1 heure
Plan planifié Informations sur tous les envois de données planifiés, y compris les jobs déjà planifiés et ceux actuellement planifiés. Inclut des données sur les tableaux de bord, les Looks, les requêtes, les dossiers et les utilisateurs associés aux envois de données planifiés. 12 heures
Utilisateur les informations sur chaque utilisateur, y compris l'historique des requêtes exécutées, ainsi que le contenu et les dossiers auxquels ils ont accès ; 12 heures

Consultez la section Utiliser les explorations d'activité système de cette page pour obtenir des exemples d'utilisations courantes de l'utilisation du contenu, du tableau de bord, de l'événement, de l'attribut d'événement, de l'historique, de la requête, de la requête de fusion, des builds de PDT, de requête SQL2, de la requête SQL2.

Utiliser les explorations d'activité du système

Voici quelques exemples d'utilisation de certaines explorations dans l'activité du système, ainsi que les réponses à quelques questions courantes. Vous pouvez accéder aux exemples d'explorations de cette section en remplaçant <instance_name.looker.com> dans les exemples d'URL par l'adresse de votre instance Looker.

Utilisation de l'API

L'exploration Utilisation des API fournit un résumé du volume d'appels d'API effectués vers votre instance Looker.

Vous pouvez utiliser la fonctionnalité Explorer de l'utilisation des API pour répondre à des questions telles que les suivantes:

Comment obtenir un audit quotidien des appels d'API ?

Vous pouvez utiliser l'exploration Utilisation de l'API pour récupérer la liste de tous les appels d'API effectués sur votre instance pour une période donnée. Pour voir quels appels ont été passés un jour donné:

  1. Sélectionnez Point de terminaison dans Utilisation de l'API.
  2. Sélectionnez Total Usage (Utilisation totale) dans API Usage (Utilisation de l'API).
  3. Filtrez sur Date de création dans Utilisation de l'API pour la date souhaitée.
https://<instance_name.looker.com>/explore/system__activity/api_usage?fields=api_usage.endpoint,api_usage.total_usage&f[api_usage.created_date]=yesterday&sorts=api_usage.total_usage+desc&limit=500&column_limit=50&vis=%7B%7D&filter_config=%7B%22api_usage.created_date%22%3A%5B%7B%22type%22%3A%22advanced%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22yesterday%22%2C%22unit%22%3A%22day%22%7D%2C%7B%7D%5D%2C%22id%22%3A5%2C%22error%22%3Afalse%7D%5D%7D&origin=share-expanded

Consultez la documentation de référence de l'API Looker ou l'explorateur d'API Looker pour en savoir plus sur le fonctionnement de chaque appel d'API.

Combien d'appels d'API ont été effectués sur mon instance cette année ?

Vous pouvez utiliser la fonctionnalité Explorer de l'utilisation de l'API pour cumuler le volume d'appels d'API sur une période donnée. Par exemple, vous pouvez créer un rapport annuel indiquant le nombre d'appels d'API effectués chaque mois:

  1. Sélectionnez Mois de création dans Utilisation de l'API.
  2. Sélectionnez Total Usage (Utilisation totale) dans API Usage (Utilisation de l'API).
  3. Filtrez sur Created Year (Année de création) dans API Usage (Utilisation de l'API) pour indiquer l'année souhaitée.
https://<instance_name.looker.com>/explore/system__activity/api_usage?fields=api_usage.total_usage,api_usage.created_month&fill_fields=api_usage.created_month&f[api_usage.created_year]=last+year&sorts=api_usage.created_month+desc&limit=500&column_limit=50&vis=%7B%7D&filter_config=%7B%22api_usage.created_year%22%3A%5B%7B%22type%22%3A%22advanced%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22last+year%22%2C%22unit%22%3A%22yr%22%7D%2C%7B%7D%5D%2C%22id%22%3A6%2C%22error%22%3Afalse%7D%5D%7D&origin=share-expanded

Utilisation du contenu

La section Utilisation du contenu de la page "Activité du système" fournit des informations sur l'utilisation des Looks et du tableau de bord, y compris la fréquence des vues, les favoris, la planification et l'accès via l'API. Il inclut également des détails sur les Looks et les tableaux de bord individuels.

Analyses rapides

L'exploration Utilisation du contenu inclut des analyses de démarrage rapide que vous pouvez utiliser pour répondre rapidement à des questions ou comme points de départ pour d'autres requêtes.

Sélectionnez une tuile d'analyse de démarrage rapide dans une exploration vide ou dans le menu Démarrage rapide en forme d'éclair d'une exploration exécutée. Looker affichera une requête avec des champs présélectionnés et triés pour répondre à l'une des questions suivantes:

  • Quel contenu a été le plus souvent ajouté à vos favoris ?
  • Quel contenu avez-vous consulté au cours des trois derniers jours ?
  • Quel contenu n'a pas été consulté au cours des 60 derniers jours ?
  • Quel contenu a été le plus consulté à l'aide de l'API Looker ?
  • Quels tableaux de bord créés au cours des sept derniers jours sont les plus utilisés ?
  • Quels Looks créés au cours des sept derniers jours sont les plus utilisés ?
  • Quels sont les tableaux qui ont été le plus souvent ajoutés aux favoris ?
  • Quel contenu a été le plus regardé ?

Vous pouvez utiliser l'exploration Content Usage pour trouver les Looks ou les tableaux de bord les plus populaires sur votre instance. Vous pouvez ensuite utiliser l'exploration de l'historique pour identifier les filtres utilisés par les Looks ou les tableaux de bord courants. Pour trouver les Looks ou les tableaux de bord les plus populaires:

  1. Dans la section Utilisation du contenu de la page Utilisation du contenu, sélectionnez Content ID, Titre du contenu et Type de contenu dans la vue Utilisation du contenu.
  2. Ajoutez un filtre sur Content Type (Type de contenu) dans la vue Content Usage (Utilisation du contenu), puis définissez la valeur du filtre sur dashboard OR look.
  3. Sélectionnez Afficher le total dans Utilisation du contenu. Vous pouvez également sélectionner des champs tels que Favorites Total (Total des favoris), Schedule Total (Total du calendrier), API Total (Total API) et Embed Total (Total intégré) dans la vue Content Usage (Utilisation du contenu).
  4. Triez les résultats par ordre décroissant sur View Total (Total de la vue) pour afficher les contenus les plus populaires en premier.
  5. Vous pouvez également ajouter un filtre dans le champ Jours depuis le dernier accès à partir de la vue Utilisation du contenu afin de limiter les données à une durée spécifique. Par exemple, vous pouvez limiter les données affichées aux 30 derniers jours en définissant la valeur du filtre sur is less than 30.

Ensuite, vous pouvez utiliser l'exploration de l'historique pour trouver les filtres utilisés dans une présentation ou un tableau de bord spécifique:

  1. Dans l'exploration de l'historique, filtrez le champ ID depuis la vue Tableau de bord ou Look, puis saisissez les ID des tableaux de bord ou des Looks que vous avez identifiés à l'aide de l'exploration Utilisation du contenu.
  2. Sélectionnez Filters (Filtres) dans la vue Query (Requête) pour obtenir la liste des filtres utilisés par les tableaux de bord ou les Looks utilisés par votre filtre.

Tableau de bord

L'exploration du tableau de bord contient des détails sur les tableaux de bord et les éléments du tableau de bord, y compris les Looks, les requêtes, les rôles, les utilisateurs et les dossiers associés aux tableaux de bord.

Analyses rapides

L'exploration du tableau de bord comprend des analyses de démarrage rapide que vous pouvez utiliser pour répondre rapidement à des questions ou comme points de départ pour d'autres requêtes.

Sélectionnez une tuile d'analyse de démarrage rapide dans une exploration vide ou dans le menu Démarrage rapide en forme d'éclair d'une exploration exécutée. Looker affichera une requête avec des champs présélectionnés et triés pour répondre à l'une des questions suivantes:

  • Quels tableaux de bord utilisent plusieurs explorations ?
  • Quels tableaux de bord présentent des intervalles d'actualisation automatique courts ?
  • Combien de tableaux de bord sont configurés pour être exécutés au chargement ?
  • Quels tableaux de bord comportent plus de 25 vignettes ?
  • Quels tableaux de bord utilisent le plus de requêtes de fusion ?
  • Quels tableaux de bord utilisent une vue ou un champ particulier ?
  • Quels dossiers contiennent quels tableaux de bord ?
  • Quelles vignettes constituent un tableau de bord individuel ?

Événement

L'exploration des événements inclut des informations sur les événements historiques dans Looker, y compris le nom, le type et la fréquence de chaque événement. Cette exploration inclut également des informations sur les groupes et les utilisateurs associés aux événements.

Voici quelques cas d'utilisation courants de l'exploration des événements:

Consultez la page de documentation Événements Looker pour en savoir plus sur l'affichage des événements et des attributs d'événements courants, ainsi que pour obtenir la liste des types d'événements.

Comment rechercher et classer les requêtes API ?

Vous pouvez rechercher toutes les requêtes API effectuées et les classer à l'aide de l'exploration des événements:

  1. Sélectionnez les champs Nom et Catégorie dans la vue Événement.
  2. Ajoutez le filtre Est un appel d'API (Oui / Non) et définissez la valeur du filtre sur Yes.
  3. Vous pouvez également sélectionner des champs tels que Created Date (Date de création) dans Event (Événement) et Name (Nom) dans User (Utilisateur), pour obtenir des informations sur des requêtes API spécifiques.
https://<instance_name.looker.com>/explore/system__activity/event?fields=event.created_date,event.name,event.category,user.name&f[event.is_api_call]=Yes&sorts=event.name&limit=500

Existe-t-il un moyen d'examiner les mises à jour de contenu ?

Vous pouvez utiliser l'exploration des événements pour examiner les mises à jour de contenu en filtrant les événements qui incluent le mot update:

  1. Dans la vue Event (Événement), sélectionnez le Name (Nom).
  2. Ajoutez un filtre sur le champ Nom dans la vue Événement et définissez la valeur du filtre sur contains update.
  3. Vous pouvez également sélectionner d'autres champs pour fournir plus d'informations sur chaque mise à jour du contenu, comme Date de création depuis Événement et ID depuis Utilisateur.
https://<instance_name.looker.com>/explore/system__activity/event?fields=event.name,user.id,event.created_time&f[event.name]=%25update%25&sorts=event.created_time+desc&limit=500

Comment afficher les événements de connexion ?

Vous pouvez utiliser l'exploration des événements pour déterminer qui s'est connecté au système avec des événements de connexion. Exemple :

  1. Ajoutez un filtre sur le champ Nom dans la vue Événement et définissez la valeur du filtre sur login.
  2. Sélectionnez l'ID et le nom dans la vue User (Utilisateur).
  3. Sélectionnez Created Time (Date de création) dans la vue Event (Événement).

Attribut d'événement

L'exploration d'attributs d'événement contient les données de l'exploration des événements et fournit des informations supplémentaires sur les attributs qui composent les événements.

Voici quelques exemples d'utilisations courantes de l'exploration d'attribut d'événement:

Pour en savoir plus sur l'affichage des événements, les attributs d'événement courants et la liste des types d'événements, consultez la page de documentation Événements Looker.

Comment afficher les modifications d'autorisations ?

Vous pouvez utiliser l'exploration Attribut d'événement pour afficher les modifications d'autorisations. Par exemple, vous pouvez savoir quand une autorisation a été modifiée et qui l'a fait:

  1. Dans la vue Event (Événement), sélectionnez Created Time (Heure de création) et Name (Nom) pour connaître l'heure à laquelle la modification a été effectuée et le type d'événement.
  2. Sélectionnez Nom et Valeur dans Attribut d'événement pour obtenir des informations sur le type de modification effectuée et sur les utilisateurs dont les autorisations ont été modifiées ou les autorisations spécifiques qui ont été modifiées.
  3. Sélectionnez ID et tous les autres champs souhaités dans Utilisateur pour obtenir des informations sur l'utilisateur qui a effectué la modification.
  4. Filtrez sur Name (Nom) dans la vue Event (Événement) en définissant la valeur sur user_permission_elevation.
https://<instance_name.looker.com>/explore/system__activity/event_attribute?fields=event.created_time,user.id,user.name,event_attribute.name,event_attribute.value&f[event.name]=%22user_permission_elevation%22&sorts=event.created_time+desc&limit=500

Comment savoir quand les fonctionnalités Labs sont activées ?

Vous pouvez utiliser l'exploration Attribut d'événement pour savoir quand les fonctionnalités expérimentales sont activées. Par exemple, sélectionnez les champs suivants:

  1. Sélectionnez Date de création dans le champ Événement.
  2. Sélectionnez Nom et Valeur dans le champ Attribut d'événement.
  3. Ajoutez un filtre sur Nom dans Événement et définissez la valeur du filtre sur update_labs_feature.
  4. Vous pouvez également ajouter des champs tels que ID ou Nom dans Utilisateur pour afficher des informations sur l'utilisateur qui a activé une fonctionnalité Labs.

Dans cet exemple, le nom de la fonctionnalité Labs que vous avez activée ou désactivée s'affiche dans le champ Valeur de l'attribut d'événement lorsque le nom de Attribut d'événement a la valeur labs_feature_id. Lorsque le nom de l'attribut d'événement a la valeur labs_feature_value, les valeurs true et false indiquent si la fonctionnalité Labs a été activée ou désactivée.

https://<instance_name.looker.com>/explore/system__activity/event_attribute?fields=event.created_time,event_attribute.name,event_attribute.value,user.id&f[event.name]=%22update_labs_feature%22&sorts=event.created_time+desc&limit=500

Quand le nom d'un projet a-t-il été modifié ?

L'exploration d'attributs d'événement vous permet de voir à quel moment le nom d'un projet a été modifié:

  1. Dans la vue Event (Événement), sélectionnez Created Time (Heure de création) et Name (Nom).
  2. Dans Attribut d'événement, sélectionnez Nom et Valeur.
  3. Ajoutez un filtre sur Nom dans la vue Événement et définissez la valeur du filtre sur rename_project_file.
https://<instance_name.looker.com>/explore/system__activity/event_attribute?fields=event.created_time,event.name,event_attribute.name,event_attribute.value&f[event.name]=%22rename_project_file%22&sorts=event.created_time+desc&limit=500&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22event.name%22%3A%5B%7B%22type%22%3A%22%3D%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22rename_project_file%22%7D%2C%7B%7D%5D%2C%22id%22%3A0%2C%22error%22%3Afalse%7D%5D%7D&origin=share-expanded

Historique

L'exploration de l'historique fournit un enregistrement de chaque requête. Il peut être utile pour le dépannage, car il fournit des détails sur toutes les requêtes exécutées sur votre instance au cours des 90 derniers jours.

Voici quelques questions fréquentes sur l'utilisation de la fonctionnalité Explorer de l'historique:

Troncation de la table d'historique

Comme la taille de la table Historique peut augmenter rapidement, Looker supprime automatiquement les enregistrements qui répondent à l'un des critères suivants:

  • history.created_time remonte à plus de 90 jours.
  • history.created_time se situe plus de sept jours dans le passé, et history.source est scheduled_task.

Clarification concernant les champs sélectionnés

Chaque champ de l'exploration Historique est associé à une description pour vous aider à comprendre son objectif. Le tableau suivant contient une description plus détaillée de certains champs fréquemment posés par les clients:

Nom du champ Description Valeurs possibles
Source Source d'une requête, telle qu'une présentation, une exploration, une tâche planifiée, une alerte, un tableau de bord, etc.
  • alerts: la requête a été lancée à partir d'une alerte.
  • api: la requête a été lancée à l'aide de l'API Looker.
  • api3: la requête a été lancée à l'aide de l'API Looker.
  • authenticated_download: la requête a été lancée à l'aide de Looker Action Hub avec une [action de streaming](/looker/docs/downloading#streaming_query_results) planifiée.
  • dashboard: la requête a été lancée à partir d'un tableau de bord. La requête peut avoir été lancée depuis l'interface utilisateur, l'API ou une tâche planifiée.
  • dashboard_prefetch: la requête a été lancée à partir d'un préchargement de tableau de bord.
  • data-download-api: cette requête a été lancée à partir d'un tableau de bord téléchargé au format CSV.
  • drill_modal: la requête a été lancée lorsqu'un utilisateur a analysé les données.
  • explore: la requête a été lancée à partir d'une exploration. (La requête peut avoir été lancée à partir de l'interface utilisateur ou de l'API.)
  • guided_analysis: la requête a été créée à l'aide de la fonctionnalité Labs Analyses guidées dans l'activité du système.
  • internal: la requête a été exécutée par Looker pour récupérer des métadonnées à des fins internes.
  • look: la requête a été lancée à partir d'un Look. La requête peut avoir été lancée depuis l'interface utilisateur, l'API ou une tâche planifiée.
  • merge_query: la requête a été lancée à partir d'une requête de fusion.
  • private_embed: la requête a été lancée à partir d'une intégration privée.
  • public_url: la requête a été lancée à partir d'un Look pour lequel l'accès public est activé.
  • regenerator: la requête a été lancée par le régénérateur PDT.
  • render_manager_cache: la requête a été lancée par un téléchargement au format PDF ou PNG. Il peut s'agir d'une présentation ou d'un tableau de bord.
  • scheduled_task: la requête a été exécutée selon une planification qui a généré un PDF. (Cette source n'inclut pas les envois planifiés de formats autres que PDF, tels que CSV.)
  • sql_interface: la requête a été lancée par une application tierce à l'aide de l'interface Open SQL.
  • sqlrunner: la requête a été lancée à partir de l'exécuteur SQL.
  • suggest: la requête a été créée en tant que requête de suggestions de filtre.
Source de l'émetteur Source d'une requête, répartie dans des bins.
  • Action Hub: la requête a été lancée à l'aide de Looker Action Hub. Cela inclut la valeur Source authenticated_download.
  • API: la requête a été lancée à l'aide de l'API Looker. Cela inclut la valeur Source api3.
  • System (Système) : la requête a été lancée par Looker sans intervention directe de l'utilisateur. Cela inclut les valeurs Source alerts, data-download-api et scheduled_task.
  • Utilisateur: la requête a été lancée par un utilisateur Looker. Cela inclut les valeurs Source dashboard, drill_modal, explore, look, merge_query, private_embed, render_manager, sqlrunner et suggest.
  • Autre: la requête ne correspond à aucun des autres buckets. Cela inclut la valeur Source internal.
État État actuel de l'événement d'historique.
  • cache_only_miss: la requête a été exécutée avec l'option cache_only=TRUE, et l'entrée de cache n'était pas présente.
  • complete: la requête a bien été exécutée.
  • error: la requête a échoué avec une erreur. Incluez le champ Message pour afficher les détails de l'erreur.
  • killed: la requête a été annulée par un utilisateur, par la base de données ou par Looker.
Nombre d'exécutions de requêtes Ce champ compte le nombre d'exécutions de requête en filtrant les entrées d'historique dont la valeur du champ État est cache_only_miss. En d'autres termes, ce champ n'inclut que les entrées d'historique dont la valeur du champ Status est complete, error ou killed. Un entier positif.

Analyses rapides

L'exploration de l'historique inclut des analyses de démarrage rapide que vous pouvez utiliser pour répondre rapidement à des questions ou comme points de départ pour d'autres requêtes.

Sélectionnez une tuile d'analyse de démarrage rapide dans une exploration vide ou dans le menu Démarrage rapide en forme d'éclair d'une exploration exécutée. Looker affichera une requête avec des champs présélectionnés et triés pour répondre à l'une des questions suivantes:

  • Quelles sources de requêtes ont été les plus actives au cours des dernières 24 heures ?
  • Quels utilisateurs ont été les plus actifs au cours de la semaine dernière ?
  • Quels sont les tableaux de bord les plus populaires pour les utilisateurs ?
  • Combien de fois un tableau de bord particulier a-t-il été utilisé au cours des 30 derniers jours ?
  • Quelles sont les dernières requêtes exécutées ?
  • Combien de fois un Look donné a-t-il été utilisé au cours des 30 derniers jours ?
  • Quelles sont les durées d'exécution moyennes des requêtes pour chaque modèle ?
  • Quelle est l'activité de requêtes récente d'un utilisateur particulier ?

Quels sont tous les modèles utilisés par un tableau de bord ?

Vous pouvez utiliser l'exploration Historique pour rechercher tous les modèles utilisés par un tableau de bord. Par exemple, cela peut aider à identifier les modèles pour lesquels un utilisateur a besoin d'autorisations lorsqu'il ne peut pas voir les données d'un tableau de bord.

  1. Sélectionnez ID (Inclusive) (ID (inclusif)) dans la vue Tableau de bord.
  2. Sélectionnez Model (Modèle) et Count (Nombre) dans la vue Query (Requête).
  3. Filtrez les données sur ID (Inclusive) (ID (inclusif)) en saisissant l'ID du tableau de bord concerné.

Dans l'exemple d'URL suivant, vous pouvez remplacer l'ID de tableau de bord 123 dans l'élément de filtre f[history.real_dash_id]=123 par l'ID du tableau de bord souhaité:

https://<instance_name.looker.com>/explore/system__activity/history?fields=history.real_dash_id,query.model,query.count&f[history.real_dash_id]=123&sorts=history.real_dash_id+desc&limit=500

Comment identifier les requêtes de longue durée ?

Supposons que vous souhaitiez créer des alertes pour les requêtes de longue durée. L'exploration de l'historique vous permet, par exemple, d'identifier les requêtes dont l'exécution prend le plus de temps:

  1. Sélectionnez ID et Lien dans Requête.
  2. Sélectionnez Durée moyenne d'exécution en secondes et Nombre d'exécutions de requêtes dans Historique pour afficher la durée moyenne d'exécution de chaque requête et le nombre de fois où elle a été exécutée.
  3. Vous pouvez ajouter un filtre sur la date de fin dans l'historique et définir la valeur du filtre sur une période comme is in the past 7 days afin de limiter les résultats affichés.
  4. Ajoutez un filtre pour Is Single Query (Yes / No) (Requête unique (oui/non)) et définissez sa valeur sur is Yes pour exclure les requêtes de fusion des résultats.
  5. Vous ne pouvez afficher que les requêtes dont la durée d'exécution dépasse un certain seuil, par exemple cinq minutes. Pour ce faire, utilisez le filtre Durée moyenne d'exécution en secondes et définissez la valeur du filtre sur is greater than 300.
  6. Triez les requêtes par ordre décroissant en fonction de la durée d'exécution moyenne en secondes dans Historique afin de lister les requêtes avec les durées d'exécution moyennes les plus longues en premier.

Vous pouvez ensuite enregistrer la requête en tant que Look et créer une alerte pour être averti si des requêtes avec des environnements d'exécution dépassent le seuil que vous avez spécifié.

Dans l'exemple d'URL suivant, vous modifiez la période pour laquelle les résultats sont affichés en remplaçant 7+days dans l'élément de filtre f[history.created_date]=7+days par la valeur de filtre souhaitée. Vous pouvez également modifier la valeur du filtre Durée moyenne d'exécution en secondes en remplaçant is greater than 300 par le nombre de secondes souhaité dans l'élément de filtre f[history.average_runtime]=%3E300.

https://<instance_name.looker.com>/explore/system__activity/history?fields=query.id,history.average_runtime,history.query_run_count,query.link&f[history.is_single_query]=Yes&f[history.created_date]=7+days&f[history.average_runtime]=%3E300&sorts=history.average_runtime+desc&limit=500

Quand quelqu'un a-t-il utilisé SQL Runner pour la dernière fois ?

Pour déterminer la dernière fois qu'un utilisateur spécifique a exécuté une requête d'exécuteur SQL à l'aide de l'exploration History (Historique) :

  1. Sélectionnez Dernière exécution et ID utilisateur dans la vue Requête de l'exécuteur SQL.
  2. Ajoutez un filtre sur l'ID utilisateur dans la vue Requête de l'exécuteur SQL et définissez la valeur du filtre sur l'ID de l'utilisateur.
https://<instance_name.looker.com>/explore/system__activity/history?fields=sql_query.last_run_time,sql_query.user_id&sorts=sql_query.last_run_time+desc&limit=500&column_limit=50

Comment retrouver les requêtes supprimées par la base de données ?

Pour rechercher les requêtes supprimées par votre base de données à l'aide de l'exploration Historique:

  1. Ajoutez un filtre sur Message dans Historique et définissez la valeur du filtre sur contains query killed.
  2. Sélectionnez Date de création, ID et Message dans Historique.
  3. Sélectionnez ID dans Requête.
https://<instance_name.looker.com>/explore/system__activity/history?fields=history.id,history.created_date,query.id,history.message&f[history.message]=%25query+killed%25&sorts=history.message&limit=500

L'exploration du tableau de bord liste les titres de tous les tableaux de bord consultés au cours des 90 derniers jours et indique le nombre de fois où chacun d'eux a été consulté:

  1. Sélectionnez Title (Titre) dans Dashboard (Tableau de bord).
  2. Sélectionnez Query Run Count (Nombre d'exécutions de requêtes) dans Historique.
  3. Ajoutez un filtre sur Title (Titre) dans Dashboard (Tableau de bord), puis définissez la valeur du filtre sur is not null.
https://<instance_name.looker.com>/explore/system__activity/history?fields=dashboard.title,history.query_run_count&f[dashboard.title]=-NULL&sorts=history.query_run_count+desc&limit=500&column_limit=50

Cette exploration indique le nombre de fois qu'une exploration a été exécutée par chaque rôle sur votre instance au cours des 90 derniers jours:

  1. Sélectionnez Explorer dans Requête.
  2. Sélectionnez le nom dans Rôle utilisateur et faites-le pivoter.
  3. Sélectionnez Query Run Count (Nombre d'exécutions de requêtes) dans Historique.
  4. Ajoutez le filtre Nom dans Rôle utilisateur et définissez la valeur du filtre sur is not null.
https://<instance_name.looker.com>/explore/system__activity/history?fields=history.query_run_count,query.view,role.name&pivots=role.name&f[role.name]=-NULL&sorts=history.query_run_count+desc+0,role.name&limit=500&column_limit=50

Quelqu'un a-t-il interrogé une exploration 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 Date de création dans Historique.
  2. Sélectionnez Explorer et Associer dans Requête.
  3. Ajoutez un filtre sur Explorer depuis Requête, puis saisissez le nom de l'exploration.

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

Vous pouvez utiliser l'exploration Historique pour déterminer si des champs d'une vue spécifique ont été utilisés au cours des 90 derniers jours:

  1. Sélectionnez Date de création dans Historique.
  2. Sélectionnez Explorer et Associer dans Requête.
  3. Filtrez sur Champs utilisés dans Requête, saisissez le nom de la vue suivi d'un point (par exemple, orders.), puis sélectionnez contient comme condition de filtre. Le point défini dans votre filtre permet de s'assurer que les résultats renvoient uniquement les champs de cette vue et non ceux de vues portant un nom similaire.

Dans l'exemple d'URL suivant, vous pouvez remplacer order%5E_items. dans l'élément de filtre f[query.formatted_fields]=%25order%5E_items. par le nom de la vue que vous souhaitez filtrer, suivi d'un point:

https://<instance_name.looker.com>/explore/system__activity/history?fields=history.created_date,query.view,query.link&f[query.formatted_fields]=%25order%5E_items.%25&sorts=history.created_date+desc&limit=500&column_limit=50

Quelles requêtes ont été lancées à partir de Google Sheets ?

La fonctionnalité Explorer de l'historique vous permet d'afficher une liste de requêtes générées dans Google Sheets à l'aide de la fonctionnalité Feuilles connectées pour Looker:

  1. Sélectionnez Date et Heure de la journée dans le groupe Date de création de la section Historique.
  2. Sélectionnez Nom du client API, ID de la feuille de calcul des feuilles connectées et Déclencheur des feuilles connectées dans le groupe Propriétés du client API Query dans Historique.
  3. Sélectionnez Name (Nom) dans User (Utilisateur).
  4. Filtrez sur ID de feuille de calcul des feuilles connectées dans le groupe Propriétés clientes de l'API Query dans Historique, puis définissez la valeur sur is not null.
https://<instance_name.looker.com>/explore/system__activity/history?fields=query_api_client_context.name,query_api_client_context.cs_spreadsheet_id,query_api_client_context.cs_trigger,user.name,history.created_date,history.created_time_of_day&f[query_api_client_context.cs_spreadsheet_id]=-NULL&sorts=history.created_time_of_day+desc&limit=5000

Look

L'exploration de Looks inclut des détails sur tous les Looks, y compris des informations sur les tableaux de bord, les requêtes, les utilisateurs et les dossiers qui sont associés aux Looks.

Vous trouverez ci-dessous des questions fréquentes sur l'utilisation de Look:

Quels Looks sont partagés en mode public ?

L'exploration de Looks vous permet d'identifier les Looks partagés publiquement ou ceux pour lesquels une URL publique est activée.

  • Appliquez le filtre Public (Yes / No) (Public (Oui/Non)) dans Look (Apparence), puis définissez la valeur du filtre sur Yes.
  • Sélectionnez ID, Nom et Lien dans Look.
https://<instance_name.looker.com>/explore/system__activity/look?fields=look.id,look.title,look.link&f[look.public]=Yes&limit=500

Qui est l'auteur d'un Look spécifique ?

Pour trouver l'auteur d'un Look spécifique:

  1. Filtrez les données en fonction de l'ID du Look en définissant la valeur sur l'ID du Look.
  2. Sélectionnez ID et Nom dans Utilisateur.
  3. Vous pouvez également sélectionner des champs comme Date de création et Titre dans Apparence.

Quels Looks ont été supprimés ?

Pour afficher la liste de tous les Looks supprimés:

  1. Sélectionnez ID, Titre, Lien et Date de suppression dans Look.
  2. Ajoutez un filtre sur la date supprimée dans Look et définissez la valeur du filtre sur is not null.
https://<instance_name.looker.com>/explore/system__activity/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

Fusionner la requête

L'exploration Merge Query (Fusionner la requête) contient des informations sur les requêtes fusionnées, y compris les champs et d'autres éléments des requêtes source et fusionnées.

Vous pouvez utiliser l'exploration Merge Query (Fusionner la requête) pour répondre à des questions comme celles-ci:

Quelles explorations sont les plus fusionnées ?

Vous pouvez utiliser l'exploration Merge Query (Fusionner la requête) pour identifier les explorations qui sont fusionnées le plus souvent et envisager de joindre les tables pour obtenir de meilleures performances et davantage de fonctionnalités.

  1. Sélectionnez Explorer dans Requête.
  2. Sélectionnez Nombre dans Fusionner la requête source de la requête.
https://<instance_name.looker.com>/explore/system__activity/merge_query?fields=query.view,merge_query_source_query.count&sorts=merge_query_source_query.count+desc&limit=500&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%7D&origin=share-expanded

Builds de PDT

L'exploration PDT Builds contient des informations sur les builds de PDT, y compris le temps nécessaire pour terminer les compilations, ainsi que la connexion et le modèle dont font partie les PDT.

Voici quelques utilisations courantes de l'exploration PDT Builds:

Ces requêtes peuvent prendre plus de temps à s'exécuter sur des instances avec de nombreuses PDT exécutées simultanément.

Comment consulter les durées de compilation des PDT ?

Vous pouvez utiliser l'exploration PDT Builds pour afficher les durées de compilation des PDT. Par exemple, pour afficher les durées de compilation des PDT au cours des deux derniers jours:

  1. Ajoutez un filtre sur l'heure de début dans la vue PDT Builds et définissez sa valeur sur is in the past 2 days.
  2. Sélectionnez l'heure de début, le nom de la vue, la connexion, le nom du modèle, les minutes écoulées et les secondes écoulées dans la vue Builds PDT.
https://<instance_name.looker.com>/explore/system__activity/pdt_builds?fields=pdt_builds.start_time,pdt_builds.view_name,pdt_builds.connection,pdt_builds.model_name,pdt_builds.elapsed_minutes,pdt_builds.elapsed_seconds&f[pdt_builds.start_time]=2+days&sorts=pdt_builds.start_time+desc&limit=500

Comment identifier les tables PDT de longue durée sur lesquelles générer une alerte ?

Vous pouvez utiliser l'exploration PDT Builds pour identifier les PDT de longue durée. Vous pouvez ensuite enregistrer la requête en tant que Look et créer une alerte pour être informé de l'existence de tables PDT dont les durées de compilation dépassent le seuil que vous avez spécifié.

Par exemple, pour voir les PDT dont la durée moyenne de compilation est supérieure à 30 minutes:

  1. Ajoutez un filtre sur Average Build Time Minutes (Durée moyenne de compilation) dans la vue PDT Builds et définissez sa valeur sur is greater than 30.
  2. Sélectionnez View Name (Nom de la vue), Connection (Connexion) et Average Build Time Minutes (Durée moyenne de compilation) dans la vue PDT Builds.

Pour modifier la valeur du filtre Average Build Time Minutes (Durée moyenne de compilation en minutes) à partir de PDT Builds, remplacez 30 dans l'élément de filtre f[pdt_builds.average_build_time_minutes]=%3E20 par le nombre de minutes souhaité:

https://<instance_name.looker.com>/explore/system__activity/pdt_builds?fields=pdt_builds.view_name,pdt_builds.connection,pdt_builds.average_build_time_minutes&f[pdt_builds.average_build_time_minutes]=%3E30&sorts=pdt_builds.average_build_time_minutes+desc&limit=500

Métriques de performances des requêtes

L'exploration des métriques de performances des requêtes fournit une répartition détaillée de chaque requête exécutée à partir de votre instance Looker.

Par exemple, vous pouvez utiliser cette exploration pour identifier les composants d'une requête qui ont mis le plus de temps à se charger. Vous pouvez également utiliser cette exploration pour identifier les tendances et les anomalies des performances des requêtes. Pour une répartition plus détaillée du cycle de vie des requêtes et des champs suivis dans cette exploration, consultez la page de documentation Comprendre les métriques de performances des requêtes.

Analyses rapides

L'exploration des performances des requêtes inclut des analyses de démarrage rapide que vous pouvez utiliser pour répondre rapidement aux questions ou comme points de départ pour d'autres requêtes.

Sélectionnez une tuile d'analyse de démarrage rapide dans une exploration vide ou dans le menu Démarrage rapide en forme d'éclair d'une exploration exécutée. Looker affichera une requête avec des champs présélectionnés et triés pour répondre à l'une des questions suivantes:

  • Combien de temps chaque étape de la requête a-t-elle duré ?
  • Quelles explorations présentent la durée moyenne d'exécution de la requête principale la plus élevée ?
  • Quels utilisateurs ont le temps moyen d'exécution de la requête principale le plus élevé ?
  • À quels moments de la journée les nœuds de calcul asynchrones sont-ils les plus longs ?
  • À quelles heures de la journée les requêtes sont-elles initialisées le plus longtemps ?
  • À quelles heures de la journée les temps de traitement des connexions sont-ils les plus longs ?
  • À quelles heures de la journée les requêtes principales sont-elles les plus longues ?
  • À quels moments de la journée les temps post-requête sont-ils les plus longs ?

Requête SQL

L'exploration de requête SQL comprend des informations sur les requêtes SQL exécutées, y compris la date et la fréquence d'exécution, ainsi que des détails sur les utilisateurs qui les ont exécutées.

Vous pouvez utiliser l'exploration de requête SQL pour répondre à des questions comme celles-ci:

Quels utilisateurs exécutent le plus de requêtes SQL ?

Vous pouvez utiliser l'exploration SQL Query (Requête SQL) pour identifier les utilisateurs qui exécutent le plus de requêtes SQL Runner:

  1. Sélectionnez ID et Nom dans Utilisateur.
  2. Sélectionnez Count (Nombre) dans SQL Runner Query (Requête d'exécuteur SQL).
  3. Tri par ordre décroissant sur Count (Nombre) de SQL Runner Query (Requête de l'exécuteur SQL) pour lister les utilisateurs qui exécutent le plus de requêtes en premier.
https://<instance_name.looker.com>/explore/system__activity/sql_query?fields=sql_query.count,user.id,user.name&sorts=sql_query.count+desc&limit=500

Plan planifié

L'exploration de plan planifié inclut des informations sur toutes les livraisons de données planifiées, y compris les jobs déjà planifiés et ceux actuellement planifiés.

Voici quelques questions fréquentes sur l'utilisation de l'outil Explorer Plan planifié:

Comment afficher les plans planifiés dans un fuseau horaire cohérent ?

Vous pouvez utiliser le plan planifié pour afficher tous les plans planifiés dans un fuseau horaire cohérent, puisque l'activité du système stocke les données temporelles dans le fuseau horaire du système:

  1. Sélectionnez ID, Nom et Prochain environnement d'exécution dans Plan planifié pour afficher l'exécution suivante pour chaque plan planifié dans le fuseau horaire du système.
  2. Pour afficher l'utilisateur qui a créé la planification, sélectionnez ID et Nom dans le champ Utilisateur.
  3. Appliquez le filtre Exécuter une fois (Oui/Non) et définissez la valeur du filtre sur No pour exclure les diffusions envoyées une fois (par exemple, pour l'envoi d'un Look) ou un test ponctuel (par exemple, pour l'envoi d'un Look test).
  4. Vous pouvez également ajouter des champs tels que Cron Schedule (Planification Cron) et Timezone à partir de la vue Scheduled Plan (Plan planifié).
https://<instance_name.looker.com>/explore/system__activity/scheduled_plan?fields=scheduled_plan.id,scheduled_plan.name,user.id,scheduled_plan.next_run_time,scheduled_plan.cron_schedule,scheduled_plan.timezone,user.name&f[scheduled_plan.run_once]=No&sorts=scheduled_plan.timezone+desc&limit=500&column_limit=50

À quel stade les plannings sont-ils bloqués ?

L'exploration Plan planifié vous permet d'identifier l'étape à laquelle les plannings sont bloqués. Exemple :

  1. Pour afficher l'étape à laquelle un job planifié spécifique a été bloqué, filtrez sur ID dans Job planifié et définissez la valeur du filtre sur l'ID du job planifié. Sélectionnez Étape, ID du job planifié et Environnement d'exécution en secondes dans Étape de tâche planifiée.
  2. Vous pouvez également sélectionner Heure de début et Heure de fin dans Étape de mission planifiée.

Vous pouvez ensuite utiliser les champs ID et Environnement d'exécution en secondes pour résoudre les problèmes liés à la tâche ayant échoué, selon qu'elle était bloquée (par exemple, à l'étape execute ou enqueued for delivery).

Dans l'exemple d'URL suivant, vous pouvez remplacer l'ID de job planifié 12913 dans l'élément de filtre &f[scheduled_job.id]=12913 par l'ID du job planifié sur lequel vous souhaitez filtrer:

https://<instance_name.looker.com>/explore/system__activity/scheduled_plan?fields=scheduled_job_stage.stage,scheduled_job_stage.scheduled_job_id,scheduled_job_stage.runtime,scheduled_job_stage.started_time,scheduled_job_stage.completed_time&f[scheduled_job.id]=12913&sorts=scheduled_job_stage.scheduled_job_id+desc&limit=500

Comment trouver les propriétaires d'un planning ?

Vous pouvez utiliser l'exploration Plan planifié pour trouver les propriétaires de la planification:

  1. Sélectionnez ID et Nom dans Plan planifié.
  2. Sélectionnez ID et Nom dans Utilisateur.
  3. Appliquez le filtre Exécuter une fois (Oui/Non) et définissez la valeur du filtre sur No pour exclure les diffusions envoyées une fois (par exemple, pour l'envoi d'un Look) ou un test ponctuel (par exemple, pour l'envoi d'un Look test).
  4. Pour trouver le propriétaire d'une planification spécifique, filtrez sur ID dans Plan planifié et définissez la valeur du filtre sur l'ID de cette planification.
https://<instance_name.looker.com>/explore/system__activity/scheduled_plan?fields=scheduled_plan.id,scheduled_plan.name,user.id,user.name&f[scheduled_plan.run_once]=No&sorts=scheduled_plan.id&limit=500

Quels plans programmés sont exécutés à la même heure ?

L'exploration Plan planifié vous permet d'identifier les plans dont l'exécution est planifiée en même temps:

  1. Sélectionnez ID, Nom, Programmation Cron et Prochaine exécution dans Plan planifié.
  2. Appliquez le filtre Exécuter une fois (Oui/Non) et définissez la valeur du filtre sur No pour exclure les diffusions envoyées une fois (par exemple, pour l'envoi d'un Look) ou un test ponctuel (par exemple, pour l'envoi d'un Look test).
  3. Vous pouvez également ajouter un filtre sur Next Run Time (Prochaine exécution) et définir la valeur de filtre sur is not null pour n'inclure que les envois planifiés existants dans les résultats.

Vous pouvez ensuite modifier l'heure des planifications (par exemple, pour l'envoi d'un Look) afin que plusieurs planifications ne s'exécutent pas en même temps.

https://<instance_name.looker.com>/explore/system__activity/scheduled_plan?fields=scheduled_plan.id,scheduled_plan.name,scheduled_plan.cron_schedule,scheduled_plan.next_run_time&f[scheduled_job.run_once]=No&f[scheduled_plan.next_run_time]=NOT+NULL&sorts=scheduled_plan.id&limit=500

Quels plannings sont illimités ?

L'exploration Plan planifié vous permet de rechercher des plannings illimités ou des plannings avec un nombre maximal de lignes de -1:

  1. Appliquez le filtre Send All Results (Envoyer tous les résultats) et définissez la valeur sur Yes (Oui).
  2. Sélectionnez l'ID, l'heure de création, l'heure finale et le nombre dans Job planifié.
https://<instance_name.looker.com>/explore/system__activity/scheduled_plan?fields=scheduled_job.id,scheduled_job.created_time,scheduled_job.finalized_time,scheduled_job.count&f[scheduled_plan.send_all_results]=Yes&sorts=scheduled_job.created_time+desc&limit=500

Est-il possible de consulter l'historique de plus de 50 planifications ?

L'exploration Plan planifié vous permet d'afficher l'historique de bien plus que les 50 planifications disponibles sur la page d'administration Historique des planifications. Exemple :

  1. Sélectionnez ID dans Plan planifié.
  2. Dans Utilisateur, sélectionnez Nom pour voir qui a créé chaque planification.
  3. Sélectionnez Cron Schedule (Planification Cron) dans Schedule Job (Tâche planifiée) pour afficher l'heure d'envoi planifiée pour chaque job planifié sous la forme d'une chaîne Cron.
  4. Dans Destination du plan planifié, sélectionnez Type pour afficher le type de destination (par exemple, pour l'envoi d'un Look).
  5. Sélectionnez ID, Status (État) et Status Details (Détails de l'état) dans Schedule Job (Tâche planifiée) pour afficher l'état et les messages d'erreur associés à chaque job planifié.
  6. Sélectionnez Heure de création et Heure finale dans Job planifié.
  7. Sélectionnez Environnement d'exécution en secondes dans Étape de tâche planifiée.
  8. Vous pouvez également sélectionner Associer dans la vue Look ou dans la vue Tableau de bord pour obtenir un lien vers la présentation ou le tableau de bord pour une planification.
  9. Pour limiter les résultats à une période spécifique, ajoutez un filtre sur la date de création dans Job planifié et définissez la valeur du filtre sur la durée souhaitée, par exemple is in the past 7 days.
  10. Appliquez le filtre Exécuter une fois (Oui/Non) et définissez la valeur du filtre sur No pour exclure les diffusions envoyées une fois (par exemple, pour l'envoi d'un Look) ou un test ponctuel (par exemple, pour l'envoi d'un Look test).
https://<instance_name.looker.com>/explore/system__activity/scheduled_plan?fields=scheduled_plan.id,user.name,scheduled_job.cron_schedule,scheduled_plan_destination.type,scheduled_job.id,scheduled_job.status,scheduled_job.status_detail,scheduled_job.created_time,scheduled_job.finalized_time,scheduled_job_stage.runtime,look.link,dashboard.link&f[scheduled_plan.run_once]=No&f[scheduled_job.created_date]=7+days&sorts=scheduled_job.created_time+desc&limit=500

Comment filtrer les résultats en fonction d'un calendrier spécifique ?

Vous pouvez utiliser l'exploration Plan planifié pour n'afficher qu'un ensemble spécifique de planifications en filtrant, par exemple, sur des tableaux de bord, des propriétaires ou des modèles spécifiques. Par exemple, pour afficher une liste de planifications basées sur un modèle spécifique, tel que thelook:

  1. Ajoutez un filtre sur Model (Modèle) dans la vue Query (Requête), puis définissez la valeur du filtre sur le nom du modèle.
  2. Sélectionnez ID et Nom dans Plan planifié.
  3. Dans Utilisateur, sélectionnez Nom pour voir qui a créé chaque planification.
  4. Sélectionnez Cron Schedule (Planification Cron) dans Schedule Plan (Plan planifié) pour afficher l'heure d'envoi planifiée pour chaque planification sous la forme d'une chaîne Cron.
  5. Vous pouvez également sélectionner Associer dans la vue Look ou dans la vue Tableau de bord pour obtenir un lien vers la présentation ou le tableau de bord pour une planification.
  6. Appliquez le filtre Exécuter une fois (Oui/Non) et définissez la valeur du filtre sur No pour exclure les diffusions envoyées une fois (par exemple, pour l'envoi d'un Look) ou un test ponctuel (par exemple, pour l'envoi d'un Look test).

Dans l'exemple d'URL suivant, vous pouvez remplacer le nom de modèle thelook dans l'élément de filtre f[query.model]=thelook par le nom du modèle souhaité:

https://<instance_name.looker.com>/explore/system__activity/scheduled_plan?fields=scheduled_plan.id,scheduled_plan.name,user.name,scheduled_plan.cron_schedule,look.link,dashboard.link&f[scheduled_plan.run_once]=No&f[query.model]=thelook&sorts=scheduled_plan.id&limit=500

L'exploration Plan planifié peut également servir à identifier les tendances d'erreurs sur les différentes planifications. Par exemple, vous pouvez identifier les échecs de planifications SFTP par un message d'erreur spécifique:

  1. Sélectionnez Heure de création, Heure finale, ID, État et Détails de l'état dans Job planifié pour afficher la liste des jobs planifiés, leur état et leurs messages d'erreur.
  2. Sélectionnez Étape dans Étape de mission planifiée.
  3. Sélectionnez Type et Format dans Destination du plan planifié pour afficher le type de destination (par exemple, pour l'envoi d'un Look) et le format de données (par exemple, pour l'envoi d'un Look).
  4. Définissez le filtre Status (État) sur Schedule Job (Tâche planifiée), puis définissez la valeur du filtre sur failure pour n'inclure que les jobs planifiés ayant échoué.
  5. Pour n'inclure les résultats que pour une destination spécifique, filtrez le champ Type dans Destination du plan planifié et définissez la valeur du filtre sur la destination souhaitée, par exemple sftp ou email.
https://<instance_name.looker.com>/explore/system__activity/scheduled_plan?fields=scheduled_job.created_time,scheduled_job.finalized_time,scheduled_job.id,scheduled_job.status,scheduled_job.status_detail,scheduled_job_stage.stage,scheduled_plan_destination.type,scheduled_plan_destination.format&f[scheduled_job.status]=failure&sorts=scheduled_job.status&limit=500&column_limit=50

Comment afficher les métriques d'exécution des planifications ?

L'exploration Plan planifié vous permet d'examiner les métriques d'exécution pour les planifications. Par exemple, pour afficher les durées d'exécution moyennes des planifications:

  1. Sélectionnez ID et Nom dans Plan planifié.
  2. Sélectionnez Name (Nom) dans User (Utilisateur).
  3. Sélectionnez Cron Schedule (Programmation Cron) dans Plan programmé.
  4. Sélectionnez Durée moyenne d'exécution en secondes dans Étape de tâche planifiée.
  5. Appliquez le filtre Exécuter une fois (Oui/Non) et définissez la valeur du filtre sur No pour exclure les diffusions envoyées une fois (par exemple, pour l'envoi d'un Look) ou un test ponctuel (par exemple, pour l'envoi d'un Look test).
https://<instance_name.looker.com>/explore/system__activity/scheduled_plan?fields=scheduled_plan.id,scheduled_plan.name,user.name,scheduled_plan.cron_schedule,scheduled_job_stage.avg_runtime&f[scheduled_plan.run_once]=No&sorts=scheduled_plan.id&limit=500

Pour afficher les environnements d'exécution des jobs planifiés:

  1. Pour afficher les environnements d'exécution de tous les jobs d'un plan spécifique, ajoutez un filtre sur ID dans Plan planifié et définissez la valeur du filtre sur l'ID du plan planifié souhaité.
  2. Sélectionnez ID dans Plan planifié.
  3. Sélectionnez Name (Nom) dans User (Utilisateur).
  4. Sélectionnez Cron Schedule (Programmation Cron) dans Plan programmé.
  5. Sélectionnez l'ID, le état, l'heure de création et l'heure finale dans Job planifié.
  6. Sélectionnez Environnement d'exécution en secondes dans Étape de tâche planifiée.
  7. Appliquez le filtre Exécuter une fois (Oui/Non) et définissez la valeur du filtre sur No pour exclure les diffusions envoyées une fois (par exemple, pour l'envoi d'un Look) ou un test ponctuel (par exemple, pour l'envoi d'un Look test).

Pour modifier le filtre ID au lieu de Plan planifié dans l'exemple d'URL suivant, remplacez 145 dans l'élément de filtre f[scheduled_plan.id]=145 par l'ID du plan planifié que vous souhaitez utiliser:

https://<instance_name.looker.com>/explore/system__activity/scheduled_plan?fields=scheduled_plan.id,user.name,scheduled_job.cron_schedule,scheduled_job.id,scheduled_job.status,scheduled_job.created_time,scheduled_job.finalized_time,scheduled_job_stage.runtime&f[scheduled_plan.run_once]=No&f[scheduled_plan.id]=145&sorts=scheduled_job.created_time+desc&limit=500

Utilisateur

L'exploration Utilisateur inclut des détails sur chaque utilisateur, y compris l'historique des requêtes exécutées, ainsi que le contenu et les dossiers auxquels il a accès.

Analyses rapides

L'exploration des utilisateurs inclut des analyses de démarrage rapide que vous pouvez utiliser pour répondre rapidement à des questions ou comme points de départ pour d'autres requêtes.

Sélectionnez une tuile d'analyse de démarrage rapide dans une exploration vide ou dans le menu Démarrage rapide en forme d'éclair d'une exploration exécutée. Looker affichera une requête avec des champs présélectionnés et triés pour répondre à l'une des questions suivantes:

  • Combien d'utilisateurs activés disposent de l'autorisation Lecteur (access_data) ?
  • Quels utilisateurs ont échoué au cours des sept derniers jours avec plus de trois jobs planifiés ?
  • Quand un utilisateur s'est-il connecté pour la dernière fois ?
  • Quels sont les utilisateurs les plus actifs ?
  • Quels utilisateurs ne se sont pas connectés depuis plus de 90 jours ?
  • Pour quels utilisateurs l'accès a-t-il été désactivé ?
  • Quels utilisateurs disposent de l'autorisation de développeur (develop) ?
  • Combien d'utilisateurs y a-t-il dans chaque rôle ?

Comment savoir quels employés de Google ont accédé à mon instance ?

Outre le panneau Accès récent de la page Accès à l'assistance, vous pouvez afficher des informations sur les membres du personnel de Google qui ont accédé à votre instance. Par exemple, pour voir quels employés de Google ont accédé à votre instance, combien de minutes ils ont accédé à votre instance et combien de requêtes elles ont exécutées:

  1. Sélectionnez Name (Nom) dans User (Utilisateur).
  2. Sélectionnez Utilisation approximative du Web en minutes et Nombre de requêtes > Nombre d'exécutions de requêtes dans Historique.
  3. Dans Historique, sélectionnez Date de création > Date, puis définissez la valeur sur la période pour laquelle vous souhaitez que les membres du personnel de Google puissent accéder à votre compte.
  4. Filtrez sur Source > Source dans Historique et définissez la valeur sur is not equal to scheduled_task pour éliminer toutes les tâches planifiées.
  5. Appliquez le filtre Autorisations de l'utilisateur > Est un employé de Looker (Oui / Non) dans Informations sur l'utilisateur et définissez la valeur sur is Yes pour n'afficher que le personnel de Google.
https://<instance_name>/explore/system__activity/user?fields=user.name,history.approximate_usage_in_minutes,history.query_run_count_drill&f[user.is_disabled]=No&f[history.created_date]=70+days&f[history.source]=-%22scheduled_task%22&f[user_facts.is_looker_employee]=Yes

Analyses guidées dans la fonctionnalité de laboratoire Activité du système

Les analyses guidées permettent aux administrateurs et utilisateurs Looker disposant de l'autorisation see_system_activity de répondre rapidement aux questions clés sur l'utilisation des instances dans l'exploration Historique avec un format de question-réponse. Pour que les utilisateurs puissent accéder aux analyses guidées, un administrateur doit activer la fonctionnalité expérimentale Analyses guidées dans l'activité du système.

Une analyse guidée comprend des champs préremplis, des valeurs et des options à sélectionner, ainsi qu'une visualisation affichant les métriques sélectionnées.

Looker choisit le type de visualisation pour un affichage optimal des données sélectionnées, et il ne peut pas être modifié.

Les utilisateurs ont actuellement accès à plusieurs options d'analyse guidée à partir de l'exploration Historique:

  • Quels sont les utilisateurs les plus actifs dans votre instance ? — Déterminer qui exploite au mieux votre instance
  • Quel contenu met votre instance à rude épreuve ? – Identifier les contenus très utilisés
  • Audit des utilisateurs : analysez l'activité des utilisateurs par type et rôle.
  • Utilisation des instances au fil du temps : comparez différentes métriques d'activité au fil du temps.

Choisir une analyse guidée à partir d'une exploration vide

Pour exécuter une analyse guidée, sélectionnez l'option d'analyse que vous souhaitez utiliser. Les options d'analyse s'affichent dans la section Analyse guidée au-dessus des options d'analyse Démarrage rapide.

Une fois l'analyse guidée terminée, vous pouvez personnaliser les valeurs des données pour répondre à des questions clés, approfondir l'analyse ou enregistrer l'analyse pour la partager avec d'autres utilisateurs qui y ont accès. Pour fermer l'analyse, il vous suffit de fermer son onglet de navigateur.

Choisir une analyse guidée après l'exécution d'une exploration

Si vous avez déjà exécuté une exploration de l'historique des activités des systèmes, vous pouvez sélectionner une analyse guidée en sélectionnant le bouton Démarrage rapide à côté du nom de l'exploration.

Cette action lance le menu Démarrage rapide.

Sélectionnez une analyse guidée dans le menu Démarrage rapide pour l'ouvrir et l'exécuter dans un nouvel onglet du navigateur.

Une fois l'analyse guidée terminée, vous pouvez personnaliser les valeurs des données pour répondre à des questions clés, approfondir l'analyse ou enregistrer l'analyse pour la partager avec d'autres utilisateurs qui y ont accès. Pour fermer l'analyse, il vous suffit de fermer son onglet de navigateur.

Personnaliser une analyse guidée

Une fois que vous avez sélectionné une analyse guidée dans une exploration vide ou dans le menu Démarrage rapide d'une exploration, l'analyse s'ouvre et s'exécute automatiquement dans un nouvel onglet du navigateur.

Une fois l'analyse guidée terminée, vous pouvez modifier et créer des combinaisons de valeurs préremplies en sélectionnant des valeurs et des conditions dans les menus déroulants, les menus de date ou les cases d'option, selon l'analyse.

Par exemple, vous pouvez sélectionner l'analyse Quel contenu impose votre instance ? pour identifier le contenu très utilisé sur votre instance Looker. Une fois l'analyse guidée chargée, vous pouvez remplacer la valeur par défaut de la période Sur quelle période par 30 derniers jours.

L'analyse guidée sera automatiquement mise à jour avec la valeur de période sélectionnée.

À ce stade, vous pouvez choisir d'approfondir ou non l'analyse en explorant les données plus en détail. Vous pouvez enregistrer l'analyse sous la forme d'une présentation ou d'un tableau de bord pour la partager avec d'autres utilisateurs qui y ont accès. Vous pouvez également fermer l'analyse en fermant la fenêtre de son navigateur.

Menu d'options à trois points de l'analyse guidée

Dans une analyse guidée, le menu Options à trois points permet aux utilisateurs:

Approfondir l'analyse guidée

Une fois que vous disposez des données initiales d'une analyse guidée, vous pouvez choisir de les explorer plus en détail. Pour ce faire, vous pouvez sélectionner le menu Options à trois points, puis Explorer à partir d'ici.

Un nouvel onglet de navigateur s'ouvre. Il contient une exploration préchargée avec les champs et la visualisation de l'analyse guidée.

Vous pouvez obtenir des insights supplémentaires sur les données en ajoutant ou en supprimant des champs, des tableaux croisés dynamiques ou des filtres, entre autres personnalisations. Consultez la page de documentation Créer et modifier des explorations pour en savoir plus sur les bonnes pratiques et les conseils.

Enregistrer une analyse guidée

Après avoir personnalisé une analyse guidée, vous pouvez l'enregistrer pour la partager avec d'autres utilisateurs qui y ont accès. Vous pouvez enregistrer une analyse guidée de deux manières:

Ajouter une visualisation d'analyse guidée à un tableau de bord

Pour ajouter une visualisation d'analyse guidée à un tableau de bord, ouvrez le menu Save Guided Analysis to a Dashboard (Enregistrer l'analyse guidée dans un tableau de bord) en sélectionnant + Ajouter au tableau de bord dans le menu à trois points Options.

Une fois que le menu Enregistrer l'analyse guidée dans un tableau de bord s'affiche, procédez comme suit:

  1. Saisissez un titre pour la vignette du tableau de bord de l'analyse guidée.
  2. Sélectionnez le dossier dans lequel est enregistré le tableau de bord auquel vous souhaitez ajouter l'analyse guidée.
  3. Sélectionnez le tableau de bord souhaité.
  4. Sélectionnez Enregistrer.

    Une boîte de dialogue s'affiche pour vous avertir que l'analyse guidée a été ajoutée au tableau de bord sélectionné.

  5. Sélectionnez le lien pour accéder au tableau de bord et y apporter des modifications.

  6. Vous pouvez également sélectionner OK pour quitter le pop-up.

Enregistrer une analyse guidée en tant que Look

Pour enregistrer une analyse guidée en tant que présentation, sélectionnez l'option Explorer à partir d'ici dans le menu à trois points Options:

Un nouvel onglet de navigateur s'ouvre. Il contient une exploration préchargée avec les champs et la visualisation de l'analyse guidée:

Pour enregistrer l'exploration en tant que Look:

  1. Sélectionnez le menu Outils, en haut à droite de l'exploration.
  2. Sélectionnez Enregistrer.
  3. Sélectionnez As a Look (En tant que Look) pour ouvrir le menu Save Look (Enregistrer le Look).

  4. Dans le champ Titre, saisissez un nouveau titre. Si vous enregistrez une présentation existante, laissez ce champ vide.

  5. Dans le champ Description, vous pouvez saisir une description du Look. Si vous enregistrez une présentation existante, laissez ce champ vide.

  6. Dans le champ Dossier, vérifiez si le dossier actuel correspond à la destination souhaitée. Le champ Folder (Dossier) affiche le nom et l'emplacement du dossier sélectionné, tandis que le côté droit affiche le contenu de ce dossier. Si vous choisissez un dossier dans lequel vous n'êtes pas autorisé à enregistrer le Look, un avertissement s'affiche en bas du menu et le bouton Enregistrer et afficher le Look est désactivé.

  7. Si vous souhaitez enregistrer la présentation dans un autre dossier, accédez au dossier dans lequel vous souhaitez enregistrer votre présentation. Vous pouvez accéder au dossier de n'importe laquelle des manières suivantes :

    • Dans le champ Dossier, sélectionnez les dossiers parents pour y accéder.
    • Sur la gauche, sélectionnez le nom d'un dossier de niveau supérieur pour y accéder.
    • Sur la droite, sélectionnez le nom du sous-dossier souhaité ou recherchez l'un de ses sous-dossiers.
    • S'il y a de nombreux sous-dossiers, vous pouvez saisir le nom du sous-dossier dans le champ Filtrer par titre pour filtrer la liste en fonction de ce sous-dossier.

  8. Si vous souhaitez enregistrer une présentation existante, faites défiler la page vers le bas ou utilisez le champ Filtrer par titre pour rechercher et sélectionner le Look souhaité. Le titre et la description du Look (le cas échéant) apparaissent dans les champs Titre et Description.

  9. Enregistrez votre présentation.

    • Pour enregistrer votre présentation et revenir à la page d'exploration, sélectionnez Enregistrer.
    • Pour enregistrer et afficher votre Look, sélectionnez Enregistrer et afficher le Look.

Vous pouvez également sélectionner d'autres options de l'exploration pour enregistrer ou partager l'exploration Analyse guidée, par exemple:

  • Télécharger : pour télécharger l'exploration Analyse guidée
  • Envoyer : pour envoyer l'exploration d'analyse guidée en une seule fois.
  • Enregistrer et planifier : pour enregistrer l'exploration d'analyse guidée en tant que Look ou tableau de bord et définir une diffusion récurrente
  • Fusionner les résultats : permet de fusionner les résultats d'analyse guidée avec d'autres résultats.

Actualiser une analyse guidée

Pour actualiser les données d'une analyse guidée, sélectionnez l'option Actualiser dans le menu à trois points Options.

L'analyse guidée s'actualise et affiche les données les plus récentes.