La page utilisateur Gérer les alertes affiche la liste de toutes les alertes que vous possédez ou suivez, ou dont vous êtes répertorié comme destinataire, en fonction des autorisations que vous avez définies pour les alertes:
| Autorisations | Alertes affichées sur la page utilisateur Gérer les alertes |
|---|---|
admin |
Les utilisateurs peuvent voir les alertes qu'ils ont créées ou suivies, ou pour lesquelles ils sont listés en tant que destinataire. |
create_alerts |
Les utilisateurs peuvent voir les alertes qu'ils ont créées. |
follow_alerts |
Les utilisateurs peuvent voir les alertes qu'ils ont suivies ou pour lesquelles ils sont répertoriés en tant que destinataire. |
Accéder à la page "Gérer les alertes" de l'utilisateur
Si votre administrateur Looker ne vous a pas accordé d'autorisations, vous ne pourrez pas accéder à cette page depuis le menu utilisateur.
Pour accéder à la page utilisateur Gérer les alertes, cliquez sur votre photo de profil ou votre icône de profil utilisateur, puis sélectionnez Alertes:
La page Gérer les alertes fournit des informations sur toutes les alertes de l'instance Looker. Pour les alertes dont vous êtes le propriétaire, que vous suivez ou pour lesquelles vous figurez en tant que destinataire, vous pouvez consulter les paramètres suivants dans le tableau de la page utilisateur Gérer les alertes:
| Colonne | Définition |
|---|---|
| Nom de l'alerte | Titre de l'alerte, qui est défini lors de la création ou de la modification de l'alerte. Le titre de l'alerte par défaut indique les conditions à remplir ou à dépasser pour que l'alerte se déclenche. 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 tuile avec l'alerte. Cliquez sur le lien pour accéder au tableau de bord. La mention Aucune indique que l'alerte n'est plus synchronisée dans son tableau de bord. Pour résoudre une alerte non synchronisée, consultez la page de documentation Effet des modifications du 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 | La valeur Yes ou No indique si les conditions d'alerte ont été remplies lors de la dernière exécution de la requête d'alerte. Le symbole -- s'affiche si la requête d'alerte n'a pas encore été exécutée ou si la requête d'alerte a été exécutée, mais n'a pas pu 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 aux erreurs qui apparaissent lors de l'exécution de la requête d'alerte ou de la notification d'alerte. Passez la souris 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 de cette page. |
| Fréquence | La fréquence à laquelle l'alerte est vérifiée pour savoir si les conditions sont remplies ou dépassées. |
| État | Cette colonne indique si l'alerte est actuellement active ou désactivée.
|
| Suivi | Bouton indiquant l'état à suivre pour l'alerte. Pour en savoir plus, consultez la section Alertes suivantes sur cette page. |
| Activité | Lien qui vous redirige vers l'onglet Activité de l'alerte sur la page Détails de l'alerte. |
| Menu à trois points | Menu dans lequel vous pouvez effectuer d'autres actions 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 du tableau de bord pour lesquels l'alerte est activée, cette alerte sera désactivée: les abonnés et 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. Lors de la prochaine exécution de la requête d'alerte, l'état sera Désactivé et une info-bulle indiquera que le tableau de bord ou l'élément de tableau de bord (tuile) a été supprimé. Un administrateur peut ensuite supprimer définitivement l'alerte depuis le menu à trois points situé à droite de celle-ci.
Alertes de filtrage
Pour filtrer la liste des alertes, cliquez sur l'icône Filtre en haut de la liste des alertes:
Vous pouvez filtrer les alertes par:
- Fréquence : fréquence à laquelle l'alerte est vérifiée (si les conditions sont remplies ou ont été dépassées)
- Minutes : renvoie toutes les alertes dont la fréquence est de 15 minutes ou 30 minutes
- Toutes les heures : renvoie toutes les alertes dont la fréquence est de 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 Tous les jours, quelle que soit la Durée.
- Toutes les semaines : renvoie toutes les alertes avec une fréquence hebdomadaire de Jour ou Heure.
- Tous les mois : renvoie toutes les alertes avec une fréquence mensuelle ou journée.
- 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 de l'alerte ont été remplies ou ont été dépassées
- Non : les conditions de l'alerte n'ont pas été remplies ou ont été dépassées
- État : indique si l'alerte est toujours en cours d'examen par rapport à ses conditions.
- Active : l'alerte est toujours en cours d'examen par rapport à ses conditions
- Désactivé : l'alerte n'est plus vérifiée par rapport à ses conditions
Vous pouvez imposer plusieurs filtres à vos résultats. Pour supprimer un filtre, cliquez sur la croix (x) à côté de son nom. Actualiser le navigateur supprime aussi tous les filtres sélectionnés.
Alertes de regroupement
Cliquez sur l'icône Regrouper les alertes pour ouvrir le menu Grouper par.
Vous pouvez regrouper des 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 sur 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
La page utilisateur Gérer les alertes affiche les erreurs ou les avertissements qui s'affichent lorsque la requête d'alerte est exécutée ou que la notification d'alerte est envoyée. Le cas échéant, des messages d'erreur s'affichent lorsque vous pointez sur l'icône d'avertissement ou l'icône d'erreur dans la colonne Condition remplie:
Pour les alertes configurées pour fournir des notifications aux intégrations Slack ou Slack Attachment (API Token), 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. Cela peut se produire si un élément de la configuration Slack a changé depuis la création de l'alerte (par exemple, si l'espace de travail Slack auquel l'alerte était distribuée a été déconnecté de l'instance Looker, si le canal Slack auquel l'alerte était envoyée a été supprimé, ou si Looker ne peut pas se connecter aux intégrations).
Avertissement: Interroger de nouvelles données
Une icône d'avertissement dans la colonne Condition remplie indique que les données de la vignette du tableau de bord sur lesquelles repose l'alerte n'ont pas changé entre les deux dernières requêtes d'alerte. Pointez sur cette icône pour afficher le message Avertissement d'alerte obsolète et le texte suivant:
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 pourquoi les données n'ont pas changé entre les requêtes. Si cet avertissement persiste, contactez votre administrateur ou votre développeur Looker pour vérifier que les règles de mise en cache définies pour cette vignette du tableau de bord sont alignées sur le paramètre de fréquence des alertes.
Alertes en cours
La colonne Suivi affiche les boutons Se désabonner et Suivre cliquables, ainsi que les boutons Suivre non cliquables.
Si vous suivez l'alerte, un bouton Se désabonner s'affiche à côté. Si vous cliquez sur Se désabonner, vous ne recevrez plus de notifications lorsque cette alerte sera déclenchée. Après avoir cliqué sur Se désabonner:
- Si l'alerte vous appartient, un bouton Suivre s'affichera dans cette colonne.
- Si vous n'êtes pas le propriétaire de l'alerte, cette dernière sera supprimée de cette page lorsque vous actualiserez votre navigateur.
- Si vous avez été répertorié en tant que destinataire des notifications d'alerte, mais que vous n'avez pas suivi l'alerte depuis la fenêtre de la vue d'alerte, un bouton Suivre non cliquable s'affiche. Pour ne plus suivre l'alerte, vous devez vous désabonner directement de votre notification d'alerte.
Un bouton Suivre non cliquable s'affiche à côté de l'alerte si l'une des conditions suivantes est remplie:
- Vous êtes propriétaire de l'alerte, mais elle ne peut pas être suivie.
- Vous avez été listé comme destinataire des notifications d'alerte, mais vous n'avez pas suivi l'alerte dans la fenêtre de la vue des alertes. Pour ne plus suivre l'alerte, vous devez vous désabonner directement de votre notification d'alerte.
- L'alerte est configurée pour envoyer des notifications à Slack.
Options de gestion des alertes
À droite de chaque alerte, vous trouverez 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 d'alerte, dans laquelle vous pouvez modifier les paramètres de l'alerte. Cliquez sur Enregistrer l'alerte pour enregistrer les modifications ou sur Annuler pour fermer la fenêtre d'alerte sans enregistrer.
Si un utilisateur supprime le tableau de bord ou la vignette du tableau de bord pour lesquels l'alerte est activée, cette alerte sera désactivée: les abonnés et 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é. La prochaine fois que la requête d'alerte s'exécutera, l'état de l'alerte sera désactivé.
Page "Détails de l'alerte"
La page Détails de l'alerte est un pop-up qui affiche un récapitulatif des informations sur l'alerte. Elle est configurée par le propriétaire de l'alerte. Alertez les propriétaires et les followers d'une autre page.
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.
- Cliquez sur le titre de l'alerte.
Configurer la page "Détails de l'alerte"
Une fois l'alerte créée, une entrée correspondante s'affiche sur la page utilisateur Gérer les alertes. Ouvrez la page Détails de l'alerte pour configurer les informations concernant l'alerte que les abonnés et les destinataires peuvent afficher:
- Cliquez dans la zone de texte pour ajouter des informations sur les conditions qui déclenchent votre alerte ou sa signification. Cliquez sur Enregistrer pour enregistrer la description.
- Cliquez sur le bouton + Associer le tableau de bord d'investigation pour ouvrir une nouvelle fenêtre dans laquelle vous pouvez connecter un autre tableau de bord à cette alerte:
Dans la fenêtre Link Dashboard to Alert (Associer le tableau de bord à l'alerte), sélectionnez le dossier qui contient le tableau de bord, puis cliquez sur son nom. Le nom du tableau de bord associé s'affichera à la place du bouton + Associer un tableau de bord d'investigation. Cliquez sur le bouton pour accéder au tableau de bord associé. Vous pouvez supprimer le tableau de bord associé en cliquant sur x dans son nom. Looker va vous demander de confirmer que vous souhaitez supprimer le lien vers le tableau de bord.
Certains détails de l'alerte sont affichés automatiquement sur la page Détails de l'alerte et ne peuvent pas être configurés:
- des informations sur l'historique de l'alerte (indiquées dans l'onglet Activité de la page) ;
- Visualisation des alertes
- État de synchronisation et nom du tableau de bord auxquels l'alerte est associée
Vous pouvez également interagir avec une alerte que vous possédez, par exemple:
- Cliquez sur le menu à trois points dans la visualisation des alertes, puis sur Explorer à partir d'ici pour ouvrir une exploration prédéfinie avec la requête pour la vignette 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 la page "Détails de l'alerte"
Vous pouvez afficher les détails de l'alerte pour une alerte dont vous n'êtes pas le propriétaire si vous êtes répertorié en tant que destinataire ou si vous avez choisi de suivre l'alerte. Sur la page Détails de l'alerte, ouvrez l'onglet Détails pour voir les informations sur une alerte configurée par son propriétaire:
- Affichez le contexte des conditions qui déclenchent votre alerte ou de ses conséquences.
- Cliquez sur le tableau de bord associé pour accéder à un autre tableau de bord qui peut ajouter du contexte à la requête d'alerte.
- Affichez la visualisation des alertes.
- Consultez l'état de la synchronisation des alertes.
- Cliquez sur le menu à trois points dans la visualisation des alertes, puis sur Explorer à partir d'ici pour ouvrir une exploration prédéfinie avec la requête pour la vignette 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.
Affichage de 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 ainsi que des informations supplémentaires:
- Affichez 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 la 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 inclut des métadonnées sur chaque exécution d'alerte.
| Titre | Définition | Valeurs possibles |
|---|---|---|
| Heure de la course | Code temporel du lancement de la requête d'alerte | Tout horodatage au format 6/25/2021, 10:45:21 AM
|
| Durée | Durée d'exécution de la requête d'alerte | Toutes les durées au format 0.81s
|
| Frais | Booléen 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 elles n'ont pas changé |
|
| Source | Origine des données à partir desquelles la requête d'alerte a recherché la valeur conditionnelle |
|
| Heure source | L'horodatage de la ligne de base de données à partir de laquelle la requête d'alerte a recherché la valeur conditionnelle | Tout horodatage au format 6/25/2021, 9:25:40 AM |
| Condition remplie | Booléen indiquant si les conditions de l'alerte ont été remplies |
|
| Déclencheur | Valeur conditionnelle qui déclencherait l'alerte si elle était atteinte ou dépassée. | Toute valeur numérique |
| Observé | Valeur observée qui a rempli ou dépassé les conditions de l'alerte et déclenché l'alerte | Toute 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 l'alerte est associée:
- Une coche verte entourée indique que l'alerte est toujours synchronisée avec le tableau de bord.
- Un symbole d'avertissement triangulaire jaune indique que l'alerte n'est plus synchronisée depuis son tableau de bord. L'état indique à quel moment la synchronisation a été interrompue. Une alerte non synchronisée affiche la valeur Aucun dans la colonne Tableau de bord. Pour savoir comment résoudre une alerte non synchronisée, consultez la page de documentation Effet des modifications du tableau de bord sur les alertes.