Les administrateurs Looker peuvent gérer les alertes créées par tous les utilisateurs sur la page de gestion des Alertes, accessible depuis la section Alertes et planifications du panneau Admin. La page d'administration de gestion des alertes contient des informations sur toutes les alertes actives et inactives.
Les administrateurs peuvent également consulter les alertes qu'ils ont créées ou suivies, ou pour lesquelles ils sont listés comme destinataires, sur la page utilisateur Gérer les alertes. Les utilisateurs disposant d'autres autorisations pour les alertes peuvent gérer les alertes qu'ils ont créées et suivies sur la page utilisateur Gérer les alertes.
Informations sur l'alerte
La page d'administration Gérer les alertes fournit des informations sur toutes les alertes de l'instance Looker. Les administrateurs et les utilisateurs auxquels l'autorisation see_alerts a été accordée peuvent consulter ces paramètres dans le tableau de la page d'administration Gérer les alertes:
| Colonne | Définition |
|---|---|
| Nom de l'alerte | Titre de l'alerte, défini lors de sa création ou de sa modification. Le titre par défaut de l'alerte indique les conditions à remplir ou à dépasser pour que l'alerte soit déclenchée. Cliquez sur le nom de l'alerte pour ouvrir la page Détails de l'alerte correspondante. |
| Tableau de bord | Nom du tableau de bord contenant la carte avec l'alerte. Cliquez sur le lien pour accéder au tableau de bord. Aucun indique que l'alerte est devenue désynchronisée de son tableau de bord. Pour résoudre un problème d'alerte non synchronisée, consultez la page de documentation Effet des modifications apportées au tableau de bord sur les alertes. |
| Propriétaire | Nom de l'utilisateur qui a créé l'alerte. |
| Durée moy. d'exécution | Durée de la requête d'alerte en secondes. |
| Condition remplie | Oui ou Non, qui indique si les conditions d'alerte ont été remplies lors de la dernière exécution de la requête d'alerte. Un symbole -- s'affiche si la requête d'alerte n'a pas encore été exécutée ou si elle a été exécutée, mais qu'il n'a pas été possible de déterminer si les conditions d'alerte étaient remplies. Cette colonne affiche des icônes d'avertissement ou d'erreur liées aux avertissements ou erreurs qui s'affichent lorsque la requête d'alerte est exécutée ou que la notification d'alerte est envoyée. Pointez sur l'icône d'avertissement ou d'erreur pour afficher le message d'erreur associé, le cas échéant.Une icône d'avertissement avec un avertissement d'alerte obsolète indique que les données de la vignette du tableau de bord n'ont pas changé entre les deux dernières requêtes d'alerte. Pour en savoir plus sur ce message, consultez la section Messages d'erreur et d'avertissement des alertes sur cette page. |
| Fréquence | Fréquence à laquelle l'alerte est vérifiée pour déterminer si les conditions ont été remplies ou dépassées. |
| État | Cette colonne indique si l'alerte est actuellement active ou désactivée.
|
| Suivi | Bouton indiquant l'état de suivi de l'alerte. Pour en savoir plus, consultez la section Alertes suivantes de cette page. |
| Activité | Lien vous redirigeant vers l'onglet Activité de l'alerte sur la page Détails de l'alerte. |
| Menu à trois points | Menu à partir duquel vous pouvez effectuer des actions supplémentaires sur l'alerte. Pour en savoir plus, consultez la section Options de gestion des alertes sur cette page. |
Si un utilisateur supprime le tableau de bord ou la vignette de tableau de bord pour lesquels l'alerte est activée, celle-ci sera désactivée. Les abonnés ou les destinataires ne recevront plus de notifications lorsque les conditions de l'alerte seront remplies. Sur cette page, le nom du tableau de bord sera immédiatement supprimé pour l'alerte. La prochaine fois que la requête d'alerte s'exécutera, l'état affiché sera Désactivé, avec un message d'info-bulle indiquant que le tableau de bord ou l'élément du tableau de bord (vignette) a été supprimé. Un administrateur peut ensuite supprimer définitivement l'alerte à partir du menu à trois points situé à droite de l'alerte.
Filtrer les alertes
Pour filtrer la liste des alertes, utilisez la barre de recherche Filtrer la liste en haut de la page.
Vous pouvez filtrer les alertes en fonction des attributs suivants:
- Fréquence : fréquence à laquelle l'alerte est vérifiée pour déterminer si les conditions sont remplies ou dépassées.
- Minutes : affiche toutes les alertes avec une fréquence de 15 minutes ou de 30 minutes
- Heure par heure : affiche toutes les alertes avec une fréquence de heure par heure, 2 heures, 3 heures, 4 heures, 6 heures, 8 heures ou 12 heures.
- Tous les jours : renvoie toutes les alertes avec une fréquence quotidienne à n'importe quel moment.
- Hebdomadaire : affiche toutes les alertes avec une fréquence hebdomadaire pour n'importe quel jour ou heure
- Mensuelle : renvoie toutes les alertes avec une fréquence mensuelle pour n'importe quel jour ou heure
- Condition remplie : indique si les conditions d'alerte ont été remplies lors de la dernière exécution de la requête d'alerte.
- Oui : les conditions d'alerte ont été remplies ou dépassées
- Non : les conditions d'alerte n'ont pas été remplies ou dépassées
- État : indique si l'alerte est toujours en cours de vérification par rapport à ses conditions.
- Active : l'alerte est toujours en cours de vérification par rapport à ses conditions
- Désactivée : l'alerte n'est plus vérifiée par rapport à ses conditions
Vous pouvez appliquer plusieurs filtres à vos résultats. Pour supprimer un filtre, cliquez sur le symbole x à côté de son nom. Si vous actualisez le navigateur, tous les filtres sélectionnés seront également supprimés.
Regrouper les alertes
Cliquez sur l'icône Grouper les alertes pour ouvrir le menu Grouper par.
Vous pouvez regrouper les alertes de différentes manières:
- Par défaut: aucun regroupement
- Noms des tableaux de bord: par ordre alphabétique, en fonction du nom du tableau de bord pour lequel l'alerte est définie
- Propriétaire: par ordre alphabétique, en fonction du propriétaire de l'alerte
Messages d'erreur et d'avertissement des alertes
La page d'administration Gérer les alertes affiche toutes les erreurs ou avertissements qui s'affichent lorsque la requête d'alerte est exécutée ou que la notification d'alerte est envoyée. Les messages d'erreur, le cas échéant, s'affichent lorsque vous pointez sur l'icône d'avertissement ou d'erreur dans la colonne Condition remplie.
Pour les alertes configurées pour envoyer des notifications aux intégrations Slack ou Slack Attachment (jeton d'API), le message d'erreur Notification delivery failed with existing configuration s'affiche lorsque la requête d'alerte détermine que les conditions d'alerte ont été remplies, mais que la notification n'a pas pu être envoyée. Cet échec peut se produire si la configuration Slack a changé depuis la création de l'alerte. Par exemple, si l'espace de travail Slack auquel l'alerte était envoyée a été dissocié de l'instance Looker, si le canal Slack auquel l'alerte était envoyée a été supprimé ou si Looker ne parvient pas à se connecter aux intégrations.
Avertissement: Interroger des données récentes
Une icône d'avertissement dans la colonne Condition remplie indique que les données de la vignette du tableau de bord sur laquelle l'alerte est basée n'ont pas changé entre les deux dernières requêtes d'alerte. Lorsque vous pointez sur cette icône, le message Avertissement d'alerte obsolète et le texte suivant s'affichent:
The data for this tile did not change between the two most recent alert queries. Verify that the caching policies defined for this dashboard tile are aligned with the alert frequency.
Plusieurs raisons peuvent expliquer que les données n'aient pas changé entre les requêtes. Si cet avertissement persiste, contactez votre administrateur ou développeur Looker pour vérifier que les règles de mise en cache définies pour cette carte de tableau de bord sont correctement alignées sur le paramètre de fréquence des alertes.
Alertes suivantes
La colonne Suivi affiche des boutons Ne plus suivre et Suivre cliquables, ainsi que des boutons Suivre non cliquables.
Si vous suivez l'alerte, un bouton Ne plus suivre s'affiche à côté d'elle. Si vous cliquez sur Ne plus suivre, vous ne recevrez plus de notifications lorsque cette alerte sera déclenchée. Après avoir cliqué sur Se désabonner:
- Si vous êtes le propriétaire de l'alerte, un bouton Suivre s'affiche dans cette colonne.
- Si l'alerte ne vous appartient pas, elle sera supprimée de cette page une fois que vous aurez actualisé votre navigateur.
- Si vous êtes listé comme destinataire des notifications d'une alerte, mais que vous n'avez pas suivi l'alerte depuis la fenêtre de visionnage de l'alerte, le bouton Suivre ne peut pas être cliqué. Pour ne plus suivre l'alerte, vous devez vous désabonner directement depuis la notification d'alerte.
Un bouton Suivre non cliquable s'affiche à côté de l'alerte si l'une des conditions suivantes est remplie:
- L'alerte vous appartient, mais vous ne pouvez pas la suivre.
- Vous étiez destinataire des notifications d'alerte par e-mail, mais vous n'avez pas suivi l'alerte depuis la fenêtre de vue des alertes. Pour ne plus suivre l'alerte, vous devez vous désabonner directement depuis la notification d'alerte.
- L'alerte est configurée pour envoyer des notifications à Slack.
Options de gestion des alertes
À droite de chaque alerte se trouve un menu à trois points avec les options suivantes:
- Afficher l'alerte
- Modifier l'alerte
- Désactiver l'alerte (si l'alerte est actuellement activée)
- Activer l'alerte (si l'alerte est actuellement désactivée)
Cliquez sur Afficher l'alerte pour ouvrir la page Détails de l'alerte.
Cliquez sur Modifier l'alerte pour ouvrir la fenêtre de l'alerte dans laquelle vous pouvez modifier ses paramètres. Cliquez sur Enregistrer l'alerte pour enregistrer les modifications ou sur Annuler pour fermer la fenêtre d'alerte sans les enregistrer.
Si un utilisateur supprime le tableau de bord ou la vignette de tableau de bord pour lesquels l'alerte est activée, celle-ci sera désactivée. Les abonnés ou les destinataires ne recevront plus de notifications lorsque les conditions de l'alerte seront remplies. Sur cette page, le propriétaire de l'alerte verra immédiatement que le nom du tableau de bord a été supprimé pour l'alerte. La prochaine fois que la requête d'alerte sera exécutée, l'état de l'alerte indiquera Désactivé.
Page "Détails de l'alerte"
La page Détails de l'alerte est un pop-up qui affiche un résumé des informations de l'alerte, qui sont configurées par le propriétaire de l'alerte. Les propriétaires et les abonnés aux alertes voient cette page différemment.
Vous pouvez ouvrir la page Détails de l'alerte de l'une des manières suivantes:
- Cliquez sur le menu à trois points à droite de l'alerte, puis sélectionnez Afficher l'alerte.
- Cliquer sur le titre de l'alerte
Configurer la page "Détails de l'alerte"
Une fois l'alerte créée, une entrée s'affiche sur la page d'administration Gérer les alertes. Ouvrez la page Détails de l'alerte pour configurer les informations sur l'alerte que ses abonnés et ses destinataires peuvent consulter.
Pour associer un tableau de bord à une alerte, procédez comme suit:
- Cliquez dans la zone de texte pour ajouter du contexte sur les conditions de déclenchement de votre alerte ou sur ce que signifie son déclenchement. Cliquez sur Enregistrer pour enregistrer votre description.
- Cliquez sur le bouton + Associer un tableau de bord d'examen.
Dans la fenêtre Link Dashboard to Alert (Associer le tableau de bord à une alerte), sélectionnez le dossier contenant le tableau de bord, puis cliquez sur son nom.
Le nom du tableau de bord associé s'affiche à la place du bouton + Associer un tableau de bord d'investigation. Cliquez sur le bouton pour accéder au tableau de bord associé. Pour supprimer le tableau de bord associé, cliquez sur la croix X à côté de son nom. Looker vous demandera de confirmer que vous souhaitez supprimer l'association au tableau de bord.
Certains détails des alertes s'affichent automatiquement sur la page Détails de l'alerte et ne peuvent pas être configurés:
- Informations sur l'historique de l'alerte (indiquées dans l'onglet "Activité" de la page)
- Visualisation de l'alerte
- État de la synchronisation du tableau de bord et nom du tableau de bord auquel l'alerte est associée
Vous pouvez également interagir avec une alerte que vous avez créée de plusieurs façons:
- Cliquez sur le menu à trois points de la visualisation de l'alerte, puis sur Explorer à partir d'ici pour ouvrir une exploration prédéfinie avec la requête de la carte du tableau de bord sur laquelle l'alerte est définie.
- Cliquez sur le bouton Tester maintenant pour exécuter une requête d'alerte instantanée. Si l'alerte est déclenchée, une notification sera envoyée à son propriétaire, à ses destinataires et à ses abonnés.
Cliquez sur OK pour fermer la page Détails de l'alerte.
En consultant la page "Détails de l'alerte"
Vous pouvez afficher les détails de l'alerte d'une alerte qui ne vous appartient pas si vous êtes listé comme destinataire de cette alerte ou si vous avez choisi de la suivre. Ouvrez l'onglet Détails de la page Détails des alertes pour afficher les informations sur une alerte que son propriétaire a configurée.
Dans l'onglet Details (Détails) de la page Alerts Detail (Détails des alertes), vous pouvez effectuer les tâches suivantes:
- Obtenez des informations sur les conditions de déclenchement de votre alerte ou sur ce que signifie son déclenchement.
- Cliquez sur le tableau de bord associé pour accéder à un autre tableau de bord qui peut fournir du contexte à la requête d'alerte.
- Affichez la visualisation de l'alerte.
- Consultez l'état de synchronisation des alertes.
- Cliquez sur le menu à trois points de la visualisation de l'alerte, puis sur Explorer à partir d'ici pour ouvrir une exploration prédéfinie avec la requête de la carte du tableau de bord sur laquelle l'alerte est définie.
- Cliquez sur le bouton Tester maintenant pour exécuter une requête d'alerte instantanée. Si l'alerte est déclenchée, une notification sera envoyée à son propriétaire, à ses destinataires et à ses abonnés.
- Cliquez sur OK pour fermer la page Détails de l'alerte.
Afficher l'activité des alertes
Looker exécute une requête d'alerte à la fréquence spécifiée pour vérifier si les données ont rempli ou dépassé les conditions d'alerte. Les résultats de ces vérifications deviennent l'historique de l'alerte. Vous pouvez cliquer sur l'onglet Activité en haut de la page Détails de l'alerte pour afficher l'historique de l'alerte et d'autres informations.
Dans l'onglet Activité de la page Détails de l'alerte, vous pouvez effectuer les tâches suivantes:
- Afficher la fréquence à laquelle l'alerte est vérifiée par rapport à ses conditions
- Afficher les métadonnées des alertes
- Consultez l'état de synchronisation des alertes.
- Cliquez sur le bouton Tester maintenant pour exécuter une requête d'alerte instantanée. Si l'alerte est déclenchée, une notification sera envoyée à son propriétaire, à ses destinataires et à ses abonnés.
- Cliquez sur OK pour fermer la page Détails de l'alerte.
Afficher les métadonnées d'une alerte
Le tableau de l'onglet Activité de la page Détails de l'alerte contient des métadonnées sur chaque exécution d'alerte.
| Titre | Définition | Valeurs possibles |
|---|---|---|
| Exécuté le | Code temporel de début de la requête d'alerte | Tout code temporel au format DD/MM HH:MM05/30 18:25 |
| Durée d'exécution | Durée d'exécution de la requête d'alerte | Toute durée au format 0.81s
|
| Frais | Valeur booléenne indiquant si la requête d'alerte a vérifié des données qui ont changé entre les deux dernières requêtes d'alerte. Si les données ont changé ; si les données n'ont pas changé |
|
| Source | Origine des données à partir desquelles la requête d'alerte a vérifié la valeur conditionnelle |
|
| Heure de la source | Code temporel de la ligne de base de données à partir de laquelle la requête d'alerte a vérifié la valeur conditionnelle | Tout code temporel au format DD/MM HH:MMExemple : 05/25 16:01 |
| Condition remplie | Valeur booléenne indiquant si les conditions d'alerte ont été remplies ou non |
|
| Déclencheur | Valeur conditionnelle qui déclenche l'alerte si elle est remplie ou dépassée | N'importe quelle valeur numérique |
| Observé | Valeur observée qui a rempli ou dépassé les conditions d'alerte et déclenché l'alerte | N'importe quelle valeur numérique |
| Status | État de la requête d'alerte |
|
Afficher l'état de synchronisation des alertes
Les deux onglets de la page Détails de l'alerte affichent l'état de synchronisation de l'alerte et le nom du tableau de bord auquel elle est associée:
- Une coche verte entourée indique que l'alerte est toujours synchronisée avec son tableau de bord.
- Un symbole d'avertissement triangulaire jaune indique que l'alerte n'est plus synchronisée avec son tableau de bord. L'état inclut un code temporel indiquant le moment où la synchronisation a été interrompue. Une alerte non synchronisée affiche la valeur Aucune dans la colonne Panneau de contrôle. Pour savoir comment résoudre une alerte non synchronisée, consultez la page de documentation Effet des modifications apportées au tableau de bord sur les alertes.