Créer des rapports sur l'utilisation de Looker avec des explorations d'activité système

Les administrateurs et les utilisateurs Looker qui ont reçu l'autorisation see_system_activity ont accès aux explorations "Activité du système" de Looker dans le menu Explorer.

Les explorations de l'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 sur les utilisateurs, des informations sur l'historique des requêtes et des statistiques sur les performances de l'instance. La granularité et la conservation des données d'activité système sont soumises à des contraintes système. L'activité système est conçue pour collecter un grand volume de données. Vous pouvez l'agréger pour compléter vos journaux d'entreprise.

Par défaut, les données d'activité système sont stockées dans la base de données interne de Looker. La plupart des tables sont tronquées de manière régulière pour respecter les limites de stockage. Par exemple, la tableau de l'historique est tronquée aux données des 90 derniers jours. Certaines tables sont soumises à des règles de conservation des données plus strictes. Pour augmenter la conservation des données, envisagez d'utiliser l'activité du système élite.

Il n'est pas possible d'interroger les données d'activité système à l'aide de SQL Runner, car les autorisations de 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 de Look et des tableaux de bord, y compris la fréquence des vues, l'ajout aux favoris, la planification, l'intégration et l'accès via l'API. Il inclut également des informations sur les looks et les tableaux de bord individuels. 12 heures
Connexion à la base de données Informations sur les connexions de base de données. Inclut des informations sur les utilisateurs qui ont accès aux connexions aux bases de données. 1 heure
Tableau de bord Informations détaillées sur tous les tableaux de bord et leurs éléments. 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 sur les tableaux de bord. 1 heure
Événement 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 constituent les événements. Inclut les données de l'exploration Événement et ajoute des informations sur les attributs. 12 heures
Utilisation des champs Champs LookML et nombre de fois utilisés 1 heure
Dossiers Informations sur tous les dossiers, le contenu stocké dans chaque dossier et le créateur de chaque dossier. 1 heure
Groupe Liste des groupes et informations les concernant, y compris les groupes parents et enfants, ainsi que les utilisateurs et les rôles qui appartiennent à chaque groupe. 1 heure
Historique Détails de toutes les requêtes exécutées au cours des 90 derniers jours. 12 heures
Look Informations sur tous les looks. Inclut des informations sur les tableaux de bord, les requêtes, les utilisateurs et les dossiers associés aux présentations. 12 heures
Fusionner la requête Informations sur les requêtes fusionnées, y compris les champs et autres éléments de la source et des requêtes fusionnées. 1 heure
Builds PDT Informations sur les builds de PDT, y compris le temps nécessaire pour les terminer, ainsi que la connexion et le modèle auxquels les PDT appartiennent. 1 heure
Journal des événements PDT Informations sur l'historique des événements liés aux PDT, y compris les erreurs et les recompilations de PDT.

Pour en savoir plus sur l'affichage et la compréhension des actions de journalisation PDT et des données d'action correspondantes, consultez la page de documentation Comprendre les actions de journalisation PDT.		 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 le modèle et les ensembles d'autorisations qui les composent. 1 heure
Requête SQL Les requêtes SQL qui ont été exécutées, y compris la fréquence et la date de leur exécution, ainsi que des informations sur les utilisateurs qui les ont exécutées. 1 heure
Plan planifié Informations sur toutes les diffusions de données planifiées, y compris les tâches planifiées précédemment et celles actuellement planifiées. 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 Informations 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. 12 heures

Consultez la section Utiliser les explorations de l'activité système de cette page pour découvrir des exemples d'utilisations courantes des explorations Utilisation du contenu, Tableau de bord, Événement, Attribut d'événement, Historique, Affichage, Requête de fusion, Compilations PDT, Requête SQL, Plan planifié et Utilisateur.

Utiliser les explorations "Activité du système"

Vous trouverez ci-dessous des exemples d'utilisation de certaines explorations dans "Activité système", ainsi que des réponses à certaines questions fréquentes. Pour accéder aux exemples d'explorations de cette section, remplacez <instance_name.looker.com> dans les URL par l'adresse de votre instance Looker.

Utilisation de l'API

L'exploration Utilisation de l'API fournit un récapitulatif du volume d'appels d'API effectués sur votre instance Looker.

Vous pouvez utiliser l'exploration Utilisation de l'API pour répondre à des questions telles que:

Comment puis-je 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 les appels effectués un jour donné:

  1. Sélectionnez Point de terminaison dans Utilisation de l'API.
  2. Sélectionnez Consommation totale dans Consommation d'API.
  3. Filtrez sur la date de création de Utilisation de l'API avec 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

Pour en savoir plus sur la fonction de chaque appel d'API, consultez la documentation de référence de l'API Looker ou API Explorer.

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

Vous pouvez utiliser l'exploration Utilisation des API pour agréger 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 Consommation totale dans Consommation d'API.
  3. Filtrez sur Année de création dans Utilisation de l'API avec 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

L'exploration Utilisation des contenus dans l'activité du système fournit des informations sur l'utilisation des looks et des tableaux de bord, y compris la fréquence des vues, l'ajout aux favoris, la planification et l'accès via l'API. Il inclut également des informations sur les looks et les tableaux de bord individuels.

Analyses rapides

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

Sélectionnez une carte d'analyse de démarrage rapide dans une exploration vierge ou dans le menu éclair Démarrage rapide d'une exploration déjà exécutée. Looker affiche alors 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é ajouté aux favoris le plus souvent ?
  • Quels contenus ont été consultés au cours des trois derniers jours ?
  • Quels contenus n'ont pas été consultés au cours des 60 derniers jours ?
  • Quel contenu a été consulté le plus fréquemment à 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 ?
  • Quelles sont les tableaux les plus ajoutés aux favoris ?
  • Quel contenu a été le plus regardé ?

Vous pouvez utiliser l'exploration Utilisation du contenu pour trouver les looks ou les tableaux de bord les plus populaires dans votre instance. Vous pouvez ensuite utiliser l'exploration "Historique" pour identifier les filtres utilisés par les fiches ou les tableaux de bord populaires. Pour trouver les Looks ou les tableaux de bord les plus populaires:

  1. Dans l'exploration Utilisation du contenu, sélectionnez ID de contenu, Titre du contenu et Type de contenu dans la vue Utilisation du contenu.
  2. Ajoutez un filtre sur Type de contenu dans la vue Utilisation du contenu, puis définissez sa valeur sur dashboard OR look.
  3. Sélectionnez Afficher le total dans Utilisation du contenu. Vous pouvez également sélectionner des champs tels que Total des favoris, Total des programmations, Total des API et Total des intégrations dans la vue Utilisation des contenus.
  4. Triez les résultats par ordre décroissant du nombre total de vues pour afficher les contenus les plus populaires en premier.
  5. Vous pouvez également ajouter un filtre au champ Jours depuis le dernier accès de la vue Utilisation du contenu pour limiter les données à une période spécifique. Par exemple, vous pouvez limiter les données que vous consultez aux 30 derniers jours en définissant la valeur du filtre sur is less than 30.

Vous pouvez ensuite utiliser l'exploration "Historique pour trouver les filtres utilisés dans un look ou un tableau de bord spécifique:

  1. Dans l'exploration Historique, filtrez sur le champ ID dans 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 Filtres dans la vue Requête pour afficher la liste des filtres utilisés par les tableaux de bord ou les présentations sur lesquels vous effectuez un filtrage.

Tableau de bord

L'exploration Tableau de bord inclut des informations sur les tableaux de bord et leurs éléments, y compris les looks, les requêtes, les rôles, les utilisateurs et les dossiers associés.

Analyses rapides

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

Sélectionnez une carte d'analyse de démarrage rapide dans une exploration vierge ou dans le menu éclair Démarrage rapide d'une exploration exécutée. Looker affiche alors 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 ont des intervalles d'actualisation automatique courts ?
  • Combien de tableaux de bord sont exécutés à la charge ?
  • Quels tableaux de bord comportent plus de 25 tuiles ?
  • 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 ?
  • De quelles vignettes un tableau de bord individuel est-il composé ?

Événement

L'exploration Événement inclut des informations sur l'historique des événements 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 Événement:

Pour en savoir plus sur les événements de visionnage et les attributs d'événement courants, ainsi que pour obtenir une liste des types d'événements, consultez la page de documentation Événements Looker.

Comment puis-je trouver et classer les requêtes API ?

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

  1. Sélectionnez les champs Nom et Catégorie dans la vue Événement.
  2. Ajoutez un filtre sur Est un appel d'API (oui / non), puis 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 Événement pour examiner les mises à jour de contenu en filtrant les événements qui incluent le mot update:

  1. Sélectionnez Nom dans la vue Événement.
  2. Ajoutez un filtre au champ Nom de la vue Événement, puis définissez sa valeur sur contains update.
  3. Vous pouvez également sélectionner d'autres champs pour obtenir plus d'informations sur chaque mise à jour de contenu, comme Heure de création dans Événement et ID dans 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 Événement pour déterminer qui s'est connecté au système à l'aide d'événements de connexion. Exemple :

  1. Ajoutez un filtre au champ Nom de la vue Événement, puis définissez sa valeur sur login.
  2. Sélectionnez l'ID et le nom dans la vue Utilisateur.
  3. Sélectionnez Heure de création dans la vue Événement.

Attribut d'événement

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

Voici quelques utilisations courantes de l'exploration 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 consulter les modifications apportées aux autorisations ?

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

  1. Dans la vue Événement, sélectionnez Heure de création et Nom pour connaître l'heure à laquelle la modification a été apportée et le type d'événement.
  2. Sélectionnez Nom et Valeur dans Attribut d'événement pour afficher des informations sur le type de modification apportée et sur les utilisateurs dont les autorisations ont été modifiées ou sur les autorisations spécifiques qui ont été modifiées.
  3. Sélectionnez ID et les autres champs souhaités sous Utilisateur pour obtenir des informations sur l'utilisateur à l'origine de la modification.
  4. Filtrez sur Nom dans la vue É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 suivre l'activation des fonctionnalités Labs. Par exemple, sélectionnez les champs suivants:

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

Dans cet exemple, le nom de la fonctionnalité Labs activée ou désactivée s'affiche dans le champ Valeur de Attribut d'événement lorsque Nom de Attribut d'événement a la valeur labs_feature_id. Lorsque la valeur labs_feature_value est attribuée à Nom dans Attribut d'événement, 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é ?

Vous pouvez utiliser l'exploration Attribut d'événement pour voir quand le nom d'un projet a été modifié:

  1. Sélectionnez Heure de création et Nom dans la vue Événement.
  2. Sélectionnez Nom et Valeur dans Attribut d'événement.
  3. Ajoutez un filtre sur Nom dans la vue Événement, puis définissez sa valeur 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 Historique fournit un enregistrement des requêtes individuelles. Il peut s'avérer utile pour le dépannage, car il fournit des informations sur toutes les requêtes exécutées sur votre instance au cours des 90 derniers jours.

Vous trouverez ci-dessous les questions fréquentes sur l'exploration de l'historique:

Troncature du tableau "Historique"

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

  • La date de début (history.created_time) est antérieure de plus de 90 jours.
  • La date de début (history.created_time) est antérieure de plus de sept jours, et la date de fin (history.source) est scheduled_task.

Clarification de certains champs

Chaque champ de l'exploration Historique est accompagné d'une description pour vous aider à comprendre son objectif. Le tableau suivant contient des descriptions plus détaillées de certains champs sur lesquels les clients posent souvent des questions:

Nom du champ Description Valeurs possibles
Source Source d'une requête, comme 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 l'Action Hub de Looker avec une action de streaming planifiée.
  • dashboard: la requête a été lancée à partir d'un tableau de bord. (La requête peut avoir été lancée à partir de l'UI, de l'API ou d'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 téléchargement de tableau de bord au format CSV.
  • drill_modal: la requête a été lancée lorsqu'un utilisateur a approfondi 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'UI ou de l'API)
  • guided_analysis: la requête a été créée à l'aide de la fonctionnalité de laboratoire 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'une présentation. (La requête peut avoir été lancée à partir de l'UI, de l'API ou d'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'un intégration privée.
  • public_url: la requête a été lancée à partir d'une présentation avec l'accès public activé.
  • regenerator: la requête a été lancée par le régénérateur de table de diffusion de données.
  • 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'un look ou d'un tableau de bord.
  • scheduled_task: la requête a été exécutée sur une programmation qui a généré un fichier 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 SQL ouverte.
  • sqlrunner: la requête a été lancée à partir de SQL Runner.
  • 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, groupée
  • Action Hub: la requête a été lancée à l'aide de l'Action Hub de Looker. Cela inclut la valeur authenticated_download de la source.
  • API: la requête a été lancée à l'aide de l'API Looker. Cela inclut la valeur api3 de la source.
  • 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.
  • User (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 à aucune des autres catégories. Cela inclut la valeur internal pour Source.
É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é effectuée.
  • error: la requête a échoué en raison d'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 comptabilise le nombre d'exécutions de requêtes en filtrant les entrées de l'historique dont la valeur du champ État est cache_only_miss. En d'autres termes, ce champ n'inclut que les entrées de l'historique dont la valeur du champ État est complete, error ou killed. Entier positif.

Analyses rapides

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

Sélectionnez une carte d'analyse de démarrage rapide dans une exploration vierge ou dans le menu éclair Démarrage rapide d'une exploration exécutée. Looker affiche alors 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 de la dernière journée ?
  • Quels utilisateurs ont été les plus actifs au cours de la semaine écoulée ?
  • Quels sont les tableaux de bord les plus populaires ?
  • Combien de fois un tableau de bord particulier a-t-il été utilisé au cours des 30 derniers jours ?
  • Quelles sont les requêtes exécutées le plus récemment ?
  • Combien de fois un look particulier a-t-il été utilisé au cours des 30 derniers jours ?
  • Quels sont les temps d'exécution moyens des requêtes pour les différents modèles ?
  • Quelle est l'activité de requêtes récente d'un utilisateur donné ?

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

Vous pouvez utiliser l'exploration Historique pour trouver 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 (inclusif) dans la vue Tableau de bord.
  2. Sélectionnez Modèle et Nombre dans la vue Requête.
  3. Filtrez sur ID (inclusif) en saisissant l'ID du tableau de bord sur lequel vous souhaitez filtrer.

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

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 longues ?

Supposons que vous souhaitiez créer des alertes pour les requêtes longues. Vous pouvez utiliser l'exploration Historique pour trouver, par exemple, les requêtes les plus longues à exécuter:

  1. Sélectionnez ID et Association dans Requête.
  2. Sélectionnez Durée d'exécution moyenne en secondes et Nombre d'exécutions de la requête 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 Historique, puis définir la valeur du filtre sur une période comme is in the past 7 days pour limiter les résultats affichés.
  4. Ajoutez un filtre sur Est une 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 l'exécution dépasse un certain seuil, par exemple cinq minutes. Pour ce faire, vous pouvez filtrer sur Durée d'exécution moyenne en secondes et définir la valeur du filtre sur is greater than 300.
  6. Triez par ordre décroissant sur Durée d'exécution moyenne en secondes dans Historique pour afficher en premier les requêtes dont la durée d'exécution moyenne est la plus longue.

Vous pouvez ensuite enregistrer la requête en tant que Requête personnalisée et créer une alerte pour être averti si des requêtes dont l'exécution dépasse 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 sur Durée d'exécution moyenne 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 SQL Runner à l'aide de l'exploration Historique:

  1. Sélectionnez Heure de la dernière exécution et ID utilisateur dans la vue Requête SQL Runner.
  2. Ajoutez un filtre sur ID utilisateur dans la vue Requête du programme d'exécution SQL, puis 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 trouver les requêtes qui ont été arrêtées par la base de données ?

Pour rechercher les requêtes arrêtées par votre base de données avec l'exploration Historique:

  1. Ajoutez un filtre sur Message dans Historique, puis définissez sa valeur 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 auxquels vous avez accédé au cours des 90 derniers jours et indique le nombre de fois où chacun d'eux a été consulté:

  1. Sélectionnez Titre dans Tableau de bord.
  2. Sélectionnez Nombre d'exécutions de requêtes dans Historique.
  3. Ajoutez un filtre sur Titre dans 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 où 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 Nom dans Rôle utilisateur, puis effectuez une pivot.
  3. Sélectionnez Nombre d'exécutions de requêtes dans Historique.
  4. Ajoutez un filtre sur Nom dans Rôle utilisateur, puis 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 effectué une requête pour une exploration spécifique au cours des 90 derniers jours ?

Vous pouvez utiliser l'exploration 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 Exploration dans 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 pour la condition de filtrage. La période de votre filtre garantit que vos résultats ne renvoient que 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 sur laquelle 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 depuis Google Sheets ?

Vous pouvez utiliser l'exploration Historique pour afficher la liste des 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 dans le groupe Date de création de l'onglet Historique.
  2. Sélectionnez Nom du client de l'API, ID de la feuille de calcul Connected Sheets et Déclencheur Connected Sheets dans le groupe Propriétés client de l'API de requête dans Historique.
  3. Sélectionnez Nom dans Utilisateur.
  4. Filtrez sur ID de feuille de calcul Sheets connectée dans le groupe Propriétés client de l'API de requête 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 Look inclut des informations sur tous les looks, y compris sur les tableaux de bord, les requêtes, les utilisateurs et les dossiers qui y sont associés.

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

Quels looks sont partagés publiquement ?

Vous pouvez utiliser l'exploration Présentation pour voir quelles présentations sont partagées publiquement ou dont l'URL publique est activée.

  • Filtrez sur Public (Oui / Non) dans Look (Affichage), puis définissez la valeur du filtre sur Yes.
  • Sélectionnez ID, Nom et Lien dans Afficher.
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 sur l'ID de 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 tels que Date de création et Titre dans Affichage.

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 Afficher.
  2. Ajoutez un filtre sur Date de suppression dans Afficher, puis 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 Fusionner des requêtes inclut des informations sur les requêtes fusionnées, y compris les champs et d'autres éléments de la requête source et des requêtes fusionnées.

Vous pouvez utiliser l'exploration Joindre les requêtes pour répondre à des questions telles que:

Quelles explorations sont fusionnées le plus souvent ?

Vous pouvez utiliser l'exploration Requête de fusion pour identifier les explorations qui sont fusionnées le plus souvent et envisager de joindre les tables pour améliorer les performances et bénéficier de plus de fonctionnalités.

  1. Sélectionnez Explorer dans Requête.
  2. Sélectionnez Nombre dans Requête source de la requête de fusion.
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 PDT

L'exploration Compilations PDT inclut des informations sur les compilations PDT, y compris le temps nécessaire pour terminer les compilations, ainsi que la connexion et le modèle auxquels les compilations PDT appartiennent.

Voici quelques utilisations courantes de l'exploration Compilations PDT:

L'exécution de ces requêtes peut prendre plus de temps sur les instances où de nombreuses tables PDT s'exécutent simultanément.

Comment consulter les temps de compilation de la PDT ?

Vous pouvez utiliser l'exploration Compilations de tables PDT pour afficher les temps de compilation des tables PDT. Par exemple, pour afficher les temps de compilation de la PDT au cours des deux derniers jours:

  1. Ajoutez un filtre sur Heure de début dans la vue Compilations PDT et définissez sa valeur sur is in the past 2 days.
  2. Sélectionnez Heure de début, Nom de la vue, Connexion, Nom du modèle, Minutes écoulées et Secondes écoulées dans la vue Compilations 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 requêtes de durée prolongée à signaler ?

Vous pouvez utiliser l'exploration Compilations PDT pour identifier les tables PDT de grande taille. Vous pouvez ensuite enregistrer la requête en tant que look et créer une alerte pour être averti en cas de PDT dont le temps de compilation dépasse le seuil que vous spécifiez.

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

  1. Ajoutez un filtre sur Durée moyenne de compilation (en minutes) dans la vue Compilations PDT et définissez sa valeur sur is greater than 30.
  2. Sélectionnez Nom de la vue, Connexion et Durée de compilation moyenne (en minutes) dans la vue Compilations PDT.

Pour modifier la valeur du filtre sur Durée de compilation moyenne (en minutes) dans Compilations PDT, 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 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 déterminer 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 obtenir une analyse 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 Performances des requêtes inclut des analyses 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 carte d'analyse de démarrage rapide dans une exploration vierge ou dans le menu éclair Démarrage rapide d'une exploration exécutée. Looker affiche alors une requête avec des champs présélectionnés et triés pour répondre à l'une des questions suivantes:

  • Combien de temps a pris chaque étape de la requête ?
  • Quelles explorations ont la durée d'exécution moyenne de la requête principale la plus élevée ?
  • Quels utilisateurs ont le temps d'exécution moyen de la requête principale le plus élevé ?
  • À quel moment de la journée les délais des travailleurs asynchrones sont-ils les plus longs ?
  • À quels moments de la journée les temps d'initialisation des requêtes sont-ils les plus longs ?
  • À quels moments de la journée le traitement des connexions est-il le plus long ?
  • À quels moments de la journée les temps de requête principaux sont-ils les plus longs ?
  • À quels moments de la journée les temps de latence post-requête sont-ils les plus longs ?

Requête SQL

L'exploration Requête SQL inclut des informations sur les requêtes SQL exécutées, y compris leur fréquence et leur récence, ainsi que des informations sur les utilisateurs qui les ont exécutées.

Vous pouvez utiliser l'exploration Requête SQL pour répondre à des questions telles que:

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

Vous pouvez utiliser l'exploration 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 SQL Runner).
  3. Triez par ordre décroissant sur Nombre dans Requête de l'exécuteur SQL pour afficher en premier les utilisateurs qui exécutent le plus de requêtes.
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 Planification planifiée inclut des informations sur toutes les diffusions de données planifiées, y compris les tâches planifiées précédemment et celles actuellement planifiées.

Vous trouverez ci-dessous les questions fréquentes sur l'utilisation de l'exploration Planification planifiée:

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, car l'activité système stocke les données basées sur le temps dans le fuseau horaire système:

  1. Sélectionnez ID, Nom et Prochaine exécution dans Planification pour afficher la prochaine exécution de chaque planification dans le fuseau horaire système.
  2. Sélectionnez ID et Nom dans Utilisateur pour afficher l'utilisateur qui a créé la programmation.
  3. Filtrez sur Exécuter une fois (oui/non), puis définissez la valeur du filtre sur No pour exclure les envois qui ont été envoyés une seule fois (par exemple, pour un envoi d'une présentation) ou envoyés en tant que test ponctuel (par exemple, pour l'envoi d'une présentation de test).
  4. Vous pouvez également ajouter des champs tels que Planification Cron et Fuseau horaire dans la vue Planification planifiée.
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 planifications se bloquent-elles ?

Vous pouvez utiliser l'exploration Planification planifiée pour identifier l'étape à laquelle les planifications sont bloquées. Exemple :

  1. Pour afficher l'étape à laquelle une tâche planifiée spécifique s'est bloquée, filtrez sur ID dans Tâche planifiée, puis définissez la valeur du filtre sur l'ID de la tâche planifiée. Sélectionnez Étape, ID de tâche planifiée et Durée d'exécution en secondes dans Étape de la tâche planifiée.
  2. Vous pouvez également sélectionner Started Time (Heure de début) et Completed Time (Heure de fin) dans Scheduled Job Stage (Étape de la tâche planifiée).

Vous pouvez ensuite utiliser les champs ID et Durée d'exécution en secondes pour résoudre le problème de la tâche ayant échoué, selon que la tâche planifiée était bloquée à l'étape execute ou enqueued for delivery, par exemple.

Dans l'exemple d'URL suivant, vous pouvez remplacer l'ID de la tâche planifiée 12913 dans l'élément de filtre &f[scheduled_job.id]=12913 par l'ID de la tâche planifiée sur laquelle 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 Planification planifiée pour trouver les propriétaires des calendriers:

  1. Sélectionnez ID et Nom dans Plan programmé.
  2. Sélectionnez ID et Nom dans Utilisateur.
  3. Filtrez sur Exécuter une fois (oui/non), puis définissez la valeur du filtre sur No pour exclure les envois qui ont été envoyés une seule fois (par exemple, pour un envoi d'une présentation) ou envoyés en tant que test ponctuel (par exemple, pour l'envoi d'une présentation de test).
  4. Pour trouver le propriétaire d'une programmation spécifique, filtrez sur ID dans Programmation planifiée, puis définissez la valeur du filtre sur l'ID de cette programmation.
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 planifiés s'exécutent en même temps ?

Vous pouvez utiliser l'exploration Plan planifié pour identifier les plans dont l'exécution est planifiée au même moment:

  1. Sélectionnez ID, Nom, Planification Cron et Heure de l'exécution suivante dans Planification planifiée.
  2. Filtrez sur Exécuter une fois (oui/non), puis définissez la valeur du filtre sur No pour exclure les envois qui ont été envoyés une seule fois (par exemple, pour un envoi d'une présentation) ou envoyés en tant que test ponctuel (par exemple, pour l'envoi d'une présentation de test).
  3. Vous pouvez également ajouter un filtre sur Heure de diffusion suivante et définir sa valeur sur is not null pour n'inclure que les diffusions planifiées existantes dans les résultats.

Vous pouvez ensuite modifier la planification (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

Quelles planifications sont illimitées ?

Vous pouvez utiliser l'exploration Planification pour trouver des planifications illimitées ou des planifications limitées à -1 lignes:

  1. Filtrez sur Envoyer tous les résultats, puis définissez la valeur sur Oui.
  2. Sélectionnez ID, Heure de création, Heure de finalisation et Nombre dans Tâche planifiée.
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 d'afficher l'historique de plus de 50 plannings ?

L'exploration Planification planifiée vous permet d'afficher l'historique de plus de 50 plans que vous pouvez consulter sur la page d'administration Historique des plans. Exemple :

  1. Sélectionnez ID dans Planification planifiée.
  2. Sélectionnez Nom dans Utilisateur pour voir qui a créé chaque planification.
  3. Sélectionnez Planification Cron dans Tâche planifiée pour afficher l'heure de diffusion planifiée de chaque tâche planifiée sous forme de chaîne Cron.
  4. Sélectionnez Type dans Destination de la planification planifiée pour afficher le type de destination (par exemple, pour l'envoi d'un look).
  5. Sélectionnez ID, État et Détails de l'état dans Tâche planifiée pour afficher l'état et les éventuels messages d'erreur de chaque tâche planifiée.
  6. Sélectionnez Created Time (Heure de création) et Finalized Time (Heure de finalisation) dans Scheduled Job (Tâche planifiée).
  7. Sélectionnez Durée d'exécution en secondes dans Étape de la tâche planifiée.
  8. Vous pouvez également sélectionner Lien dans la vue Aperçu ou Tableau de bord pour obtenir un lien vers l'aperçu 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 de Tâche planifiée, puis définissez la valeur du filtre sur la durée souhaitée, par exemple is in the past 7 days.
  10. Filtrez sur Exécuter une fois (oui/non), puis définissez la valeur du filtre sur No pour exclure les envois qui ont été envoyés une seule fois (par exemple, pour un envoi d'une présentation) ou envoyés en tant que test ponctuel (par exemple, pour l'envoi d'une présentation de 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 ensemble spécifique de plannings ?

Vous pouvez utiliser l'exploration Planification planifiée pour afficher uniquement 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 la liste des planifications basées sur un modèle spécifique, tel que thelook:

  1. Ajoutez un filtre sur Modèle dans la vue Requête, puis définissez la valeur du filtre sur le nom du modèle.
  2. Sélectionnez ID et Nom dans Plan programmé.
  3. Sélectionnez Nom dans Utilisateur pour voir qui a créé chaque planification.
  4. Sélectionnez Programmation Cron dans Planification pour afficher l'heure d'envoi planifiée pour chaque programmation sous forme de chaîne cron.
  5. Vous pouvez également sélectionner Lien dans la vue Aperçu ou Tableau de bord pour obtenir un lien vers l'aperçu ou le tableau de bord pour une planification.
  6. Filtrez sur Exécuter une fois (oui/non), puis définissez la valeur du filtre sur No pour exclure les envois qui ont été envoyés une seule fois (par exemple, pour un envoi d'une présentation) ou envoyés en tant que test ponctuel (par exemple, pour l'envoi d'une présentation de test).

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

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 être utilisée pour identifier les tendances d'erreurs entre les planifications. Par exemple, vous pouvez constater que les planifications SFTP échouent avec un message d'erreur spécifique:

  1. Sélectionnez Heure de création, Heure de finalisation, ID, État et Détails de l'état dans Tâche planifiée pour afficher la liste des tâches planifiées, ainsi que leur état et leurs messages d'erreur.
  2. Sélectionnez Étape dans Étape de la tâche planifiée.
  3. Sélectionnez Type et Format dans Destination du plan planifié pour afficher le type de destination (par exemple, pour la diffusion d'un look) et le format de données (par exemple, pour la diffusion d'un look).
  4. Filtrez sur État dans Tâche planifiée, puis définissez la valeur du filtre sur failure pour n'inclure que les tâches planifiées ayant échoué.
  5. Pour n'inclure que les résultats d'une destination spécifique, filtrez sur le champ Type de Destination du plan planifié, puis 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 pour les planifications ?

Vous pouvez utiliser l'exploration Plan planifié pour examiner les métriques d'exécution des planifications. Par exemple, pour afficher les durées d'exécution moyennes des planifications:

  1. Sélectionnez ID et Nom dans Plan programmé.
  2. Sélectionnez Nom dans Utilisateur.
  3. Sélectionnez Programmation Cron dans Planification planifiée.
  4. Sélectionnez Durée d'exécution moyenne en secondes dans Étape de la tâche planifiée.
  5. Filtrez sur Exécuter une fois (oui/non), puis définissez la valeur du filtre sur No pour exclure les envois qui ont été envoyés une seule fois (par exemple, pour un envoi d'une présentation) ou envoyés en tant que test ponctuel (par exemple, pour l'envoi d'une présentation de 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 durées d'exécution des jobs planifiés:

  1. Pour afficher les durées d'exécution de tous les jobs d'un plan spécifique, ajoutez un filtre sur ID dans Plan planifié, puis définissez la valeur du filtre sur l'ID de plan planifié souhaité.
  2. Sélectionnez ID dans Planification planifiée.
  3. Sélectionnez Nom dans Utilisateur.
  4. Sélectionnez Programmation Cron dans Planification planifiée.
  5. Sélectionnez ID, État, Heure de création et Heure de finalisation dans Tâche planifiée.
  6. Sélectionnez Durée d'exécution en secondes dans Étape de la tâche planifiée.
  7. Filtrez sur Exécuter une fois (oui/non), puis définissez la valeur du filtre sur No pour exclure les envois qui ont été envoyés une seule fois (par exemple, pour un envoi d'une présentation) ou envoyés en tant que test unique (par exemple, pour l'envoi d'une présentation de test).

Pour remplacer le filtre ID par 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 filtrer:

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 informations sur chaque utilisateur, y compris l'historique des requêtes exécutées, ainsi que les contenus et les dossiers auxquels il a accès.

Analyses rapides

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

Sélectionnez une carte d'analyse de démarrage rapide dans une exploration vierge ou dans le menu éclair Démarrage rapide d'une exploration exécutée. Looker affiche alors 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 de lecteur (access_data) ?
  • Quels utilisateurs ont vu plus de trois tâches planifiées échouer au cours des sept derniers jours ?
  • Quand un utilisateur particulier s'est-il connecté pour la dernière fois ?
  • Quels utilisateurs sont les plus actifs ?
  • Quels utilisateurs ne se sont pas connectés depuis plus de 90 jours ?
  • Quels utilisateurs ont vu leur accès désactivé ?
  • Quels utilisateurs disposent de l'autorisation de développeur (develop) ?
  • Combien d'utilisateurs occupent chaque rôle ?

Comment savoir qui, parmi le personnel Google, a accédé à mon instance ?

En plus du panneau Accès récents de la page Accès à l'assistance, vous pouvez consulter les informations sur les membres du personnel Google qui ont accédé à votre instance. Par exemple, pour voir qui a accédé à votre instance, pendant combien de minutes et combien de requêtes ont été exécutées:

  1. Sélectionnez Nom dans Utilisateur.
  2. Dans Historique, sélectionnez Utilisation approximative du Web en minutes et Nombre de requêtes > Nombre d'exécutions de requêtes.
  3. Filtrez sur Date de création > Date dans Historique, puis définissez la valeur sur la période pour laquelle vous souhaitez afficher l'accès du personnel Google.
  4. Filtrez sur Source > Source dans Historique et définissez la valeur sur is not equal to scheduled_task pour supprimer toutes les tâches planifiées.
  5. Filtrez sur Autorisations utilisateur > Est-il un employé Looker (oui / non) dans Données utilisateur et définissez la valeur sur is Yes pour afficher uniquement le personnel 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 Looker et aux utilisateurs disposant de l'autorisation see_system_activity de répondre rapidement à des questions clés sur l'utilisation des instances dans l'exploration Historique, sous la forme de questions/réponses. Pour que les utilisateurs puissent accéder aux analyses guidées, un administrateur doit activer la fonctionnalité Labs Analyses guidées d'activité du système.

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

Le type de visualisation est choisi par Looker pour afficher au mieux les données sélectionnées. Il ne peut pas être modifié.

Les utilisateurs peuvent actuellement accéder à plusieurs options d'analyse guidée dans l'exploration Historique:

  • Quels sont les utilisateurs les plus actifs dans votre instance ? — Découvrez qui tire le meilleur parti de votre instance.
  • Quels contenus sollicitent votre instance ? — Identifier les contenus très utilisés
  • Audit des utilisateurs : comprendre l'activité des utilisateurs par type et par rôle
  • Utilisation des instances au fil du temps : comparez différentes métriques d'activité au fil du temps.

Sélectionner une analyse guidée depuis 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.

Une fois l'analyse guidée exécuté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 ayant accès à vos données. Pour fermer l'analyse, fermez simplement l'onglet du navigateur.

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

Si vous avez déjà exécuté une exploration de l'historique de l'activité système, vous pouvez sélectionner une analyse guidée en cliquant sur 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 exécutée, vous pouvez personnaliser les valeurs des données pour répondre à des questions clés, approfondir l'analyse ou l'enregistrer pour la partager avec d'autres utilisateurs ayant accès à vos données. Pour fermer l'analyse, fermez simplement l'onglet du navigateur.

Personnaliser une analyse guidée

Une fois que vous avez sélectionné une analyse guidée à partir d'une exploration vierge ou du menu de 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 des menus déroulants, des menus de dates ou des options de boutons d'option, en fonction de l'analyse.

Par exemple, vous pouvez sélectionner l'analyse Quel contenu sollicite votre instance ? pour identifier les contenus très utilisés dans votre instance Looker. Une fois l'analyse guidée chargée, vous pouvez modifier la valeur par défaut de la période dans Sur quelle période ? en sélectionnant 30 derniers jours.

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

À ce stade, vous pouvez choisir d'obtenir des insights supplémentaires sur l'analyse en explorant davantage les données. Vous pouvez enregistrer l'analyse en tant que Look ou dans un tableau de bord pour la partager avec d'autres utilisateurs ayant accès à ces éléments, ou fermer l'analyse en fermant sa fenêtre de navigateur.

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

Le menu Options à trois points d'une analyse guidée permet aux utilisateurs:

Explorer plus en détail une analyse guidée

Une fois que vous avez obtenu les 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 du navigateur s'ouvre avec une exploration préchargée avec les champs et la visualisation de l'analyse guidée.

Vous pouvez obtenir d'autres insights en ajoutant ou en supprimant des champs, des pivots ou des filtres, entre autres personnalisations. Pour en savoir plus sur les bonnes pratiques et les conseils concernant les explorations, consultez la page de documentation Créer et modifier des explorations.

Enregistrer une analyse guidée

Après avoir personnalisé une analyse guidée, vous pouvez l'enregistrer pour la partager avec d'autres utilisateurs ayant accès à vos données. 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 Enregistrer l'analyse guidée dans un tableau de bord en sélectionnant + Ajouter au tableau de bord dans le menu Options à trois points.

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

  1. Saisissez un titre pour la carte du tableau de bord d'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 informer 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 l'afficher ou le modifier.

  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 look, sélectionnez l'option Explorer à partir d'ici dans le menu Options à trois points:

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

Pour enregistrer l'exploration en tant que présentation, procédez comme suit:

  1. Sélectionnez le menu Outils, en haut à droite de l'exploration.
  2. Sélectionnez Enregistrer.

  3. Sélectionnez En tant que look pour ouvrir le menu Enregistrer un 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 que le dossier actuel est bien la destination souhaitée. Le champ Dossier indique le nom et l'emplacement du dossier sélectionné, tandis que la partie droite en affiche le contenu. Si vous choisissez un dossier dans lequel vous n'êtes pas autorisé à enregistrer la présentation, une alerte apparaît au bas du menu, et le bouton Enregistrer et afficher la présentation sera 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 l'une 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 beaucoup de sous-dossiers, vous pouvez saisir le nom du sous-dossier dans le champ Filtrer par titre pour afficher la liste filtrée de ce sous-dossier uniquement.

  8. Pour enregistrer une présentation existante, faites défiler la liste ou utilisez le champ Filtrer par titre pour rechercher et sélectionner la présentation souhaitée. Le titre et la description (le cas échéant) de la présentation apparaissent alors dans les champs Titre et Description.

  9. Enregistrez votre présentation.

    • Pour enregistrer votre présentation et revenir à la page "Explorer", sélectionnez Enregistrer.
    • Pour enregistrer et afficher votre look, sélectionnez Enregistrer et afficher le look.

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

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

Recharger une analyse guidée

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

L'analyse guidée est actualisée et affiche les dernières données.