La page utilisateur Gérer les alertes affiche la liste de toutes les alertes dont vous êtes propriétaire ou que vous suivez, ou pour lesquelles vous êtes répertorié comme destinataire, en fonction de vos autorisations d'alerte :
| 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 répertoriés comme destinataires. |
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 comme destinataires. |
Accéder à la page utilisateur "Gérer les alertes"
Pour accéder à la page utilisateur Gérer les alertes , sélectionnez le menu Profil , puis Alertes.
La page utilisateur Gérer les alertes fournit des informations sur toutes les alertes de l'instance Looker. Pour les alertes dont vous êtes propriétaire, que vous suivez ou pour lesquelles vous êtes répertorié comme destinataire, vous pouvez afficher ces paramètres dans le tableau de la page utilisateur 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 d'alerte par défaut indique les conditions qui doivent être remplies ou dépassées pour que l'alerte soit déclenchée. Sélectionnez 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 vignette avec l'alerte. Cliquez sur le lien pour accéder au tableau de bord. Aucun indique que l'alerte n'est plus synchronisée avec 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 | Oui ou Non indiquant 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 elle a été exécutée, mais qu'il n'a pas été possible de déterminer si les conditions d'alerte ont été remplies. Cette colonne affiche des icônes d'avertissement ou d'erreur liées aux avertissements ou erreurs qui s'affichent lors de l'exécution de la requête d'alerte ou de la diffusion de la notification d'alerte. 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 d'alerte 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 active ou désactivée.
|
| Suivi | Bouton indiquant votre état de suivi pour l'alerte. Pour en savoir plus, consultez la section Suivre les alertes 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 à 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 du tableau de bord sur laquelle l'alerte est activée, cette alerte sera désactivée : les abonnés ou destinataires ne recevront plus de notifications lorsque les conditions d'alerte seront remplies. Sur cette page, le nom du tableau de bord sera immédiatement supprimé pour l'alerte. Après la prochaine exécution de la requête d'alerte, l'état sera Désactivé avec un message d'info-bulle indiquant que le tableau de bord ou l'élément de 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, sélectionnez l'icône de 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 pour déterminer si les conditions ont été remplies ou dépassées
- Minutes : renvoie toutes les alertes avec une fréquence de 15 minutes ou 30 minutes
- Par heure : renvoie toutes les alertes avec une fréquence de 1 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 l'heure
- Chaque semaine : renvoie toutes les alertes avec une fréquence Chaque semaine , quel que soit le jour ou l'heure
- Tous les mois : renvoie toutes les alertes avec une fréquence Tous les mois , quel que soit le jour ou l'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 vérifiée par rapport à ses conditions
- Actif : l'alerte est toujours vérifiée par rapport à ses conditions
- Désactivé : l'alerte n'est plus vérifiée par rapport à ses conditions
Vous pouvez appliquer plusieurs filtres à vos résultats. Pour supprimer un filtre, sélectionnez le x à côté du nom du filtre. L'actualisation du navigateur supprime également tous les filtres sélectionnés.
Regrouper les alertes
Cliquez sur l'icône Regrouper les alertes pour ouvrir le menu Regrouper 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 du nom du tableau de bord sur lequel l'alerte est définie
- Propriétaire : par ordre alphabétique du propriétaire de l'alerte
Messages d'erreur et d'avertissement d'alerte
La page utilisateur Gérer les alertes affiche toutes les erreurs ou tous les avertissements qui s'affichent lors de l'exécution de la requête d'alerte ou de la diffusion de la notification d'alerte. Pointez sur l'icône d'avertissement ou d'erreur dans la colonne Condition remplie pour afficher le message d'erreur associé.
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 vers lequel l'alerte était envoyée a été déconnecté de l'instance Looker, si le canal Slack vers lequel l'alerte était envoyée a été supprimé ou si Looker ne peut pas se connecter aux intégrations.
Avertissement : interroger des données actualisées
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.
Il existe plusieurs explications possibles à la raison pour laquelle les données n'ont 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 vignette du tableau de bord sont alignées sur le paramètre de fréquence des alertes.
Suivre les alertes
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é de l'alerte. Si vous sélectionnez Ne plus suivre, vous ne recevrez plus de notifications lorsque cette alerte sera déclenchée. Une fois que vous avez sélectionné Ne plus suivre, vous verrez différents résultats, en fonction de votre relation avec l'alerte (propriétaire, destinataire ou aucun des deux) :
- Si vous êtes propriétaire de l'alerte, un bouton Suivre s'affiche dans cette colonne.
- Si vous n'êtes pas propriétaire de l'alerte, elle sera supprimée de cette page une fois que vous aurez actualisé votre navigateur.
- Si vous étiez répertorié comme destinataire des notifications d'une alerte, mais que vous n'avez pas suivi l'alerte depuis la fenêtre d'affichage des alertes, 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 vous ne pouvez pas la suivre.
- Vous étiez répertorié comme destinataire des notifications d'alerte par e-mail, mais vous n'avez pas suivi l'alerte depuis la fenêtre d'affichage 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 se trouve un menu à trois points avec les options suivantes :
- Afficher l'alerte
- Modifier l'alerte
- Désactiver l'alerte (si l'alerte est activée)
- Activer l'alerte (si l'alerte est désactivée)
Sélectionnez Afficher l'alerte pour ouvrir la page Détails de l'alerte.
Sélectionnez Modifier l'alerte pour ouvrir la fenêtre d'alerte dans laquelle vous pouvez modifier les paramètres de l'alerte. Sélectionnez Enregistrer l'alerte pour enregistrer les modifications ou 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 sur laquelle l'alerte est activée, cette alerte sera désactivée : les abonnés ou destinataires ne recevront plus de notifications lorsque les conditions d'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. Après la prochaine exécution de la requête d'alerte, l'état de l'alerte sera Désactivé.
Page d'informations sur l'alerte
La page Détails de l'alerte est une boîte de dialogue qui affiche un résumé des informations sur l'alerte, configurées par le propriétaire de l'alerte. Les propriétaires et les abonnés de l'alerte voient une vue différente de cette 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'informations de l'alerte
Une fois que vous avez créé une alerte, une entrée pour cette alerte s'affiche sur la page utilisateur Gérer les alertes. Ouvrez la page Détails de l'alerte pour configurer les informations sur l'alerte que ses abonnés et destinataires peuvent consulter :
- Sélectionnez le champ pour ajouter du contexte sur les conditions qui déclenchent votre alerte ou sur ce que signifie le déclenchement d'une alerte. Sélectionnez Enregistrer pour enregistrer votre description.
- Sélectionnez le bouton + Lier 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 Lier le tableau de bord à l'alerte, sélectionnez le dossier contenant le tableau de bord, puis sélectionnez le nom du tableau de bord. Le nom du tableau de bord lié s'affiche à la place du bouton + Lier le tableau de bord d'investigation. Sélectionnez le bouton pour accéder au tableau de bord lié. Vous pouvez supprimer le tableau de bord lié en cliquant sur le x dans le nom du tableau de bord. Looker vous demandera de confirmer que vous souhaitez supprimer le lien vers le tableau de bord.
Certains détails de l'alerte 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 synchronisation du tableau de bord et nom du tableau de bord auquel l'alerte est associée
Voici d'autres façons d'interagir avec une alerte dont vous êtes propriétaire :
- Sélectionnez le menu à trois points sur la visualisation de l'alerte, puis sélectionnez Explorer à partir d'ici pour ouvrir une exploration prédéfinie avec la requête de la vignette du tableau de bord sur laquelle l'alerte est définie.
- Sélectionnez le bouton Tester maintenant pour exécuter une requête d'alerte instantanée. Si l'alerte est déclenchée, une notification est envoyée à son propriétaire, à ses destinataires et à ses abonnés.
Sélectionnez OK pour fermer la page Détails de l'alerte.
Afficher la page d'informations de l'alerte
Vous pouvez afficher les Détails de l'alerte pour une alerte dont vous n'êtes pas propriétaire si vous êtes répertorié comme destinataire de cette alerte ou si vous avez choisi de suivre l'alerte. Ouvrez l'onglet Détails de la page Détails de l'alerte pour afficher les informations sur une alerte que son propriétaire a configurée :
- Affichez le contexte sur les conditions qui déclenchent votre alerte ou sur ce que signifie le déclenchement d'une alerte.
- Sélectionnez le tableau de bord lié pour accéder à un autre tableau de bord qui peut ajouter du contexte à la requête d'alerte.
- Affichez la visualisation de l'alerte.
- Affichez l'état de synchronisation de l'alerte .
- Sélectionnez le menu à trois points sur la visualisation de l'alerte, puis sélectionnez Explorer à partir d'ici pour ouvrir une exploration prédéfinie avec la requête de la vignette du tableau de bord sur laquelle l'alerte est définie.
- Sélectionnez le bouton Tester maintenant pour exécuter une requête d'alerte instantanée. Si l'alerte est déclenchée, une notification est envoyée à son propriétaire, à ses destinataires et à ses abonnés.
- Pour fermer la page Détails de l'alerte, sélectionnez OK.
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 atteint ou dépassé les conditions d'alerte. Les résultats de ces vérifications deviennent l'historique de l'alerte. Vous pouvez sélectionner 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.
- Affichez les métadonnées de l'alerte.
- Affichez l'état de synchronisation de l'alerte .
- Sélectionnez le bouton Tester maintenant pour exécuter une requête d'alerte instantanée. Si l'alerte est déclenchée, une notification est envoyée à son propriétaire, à ses destinataires et à ses abonnés.
- Sélectionnez OK pour fermer la page Détails de l'alerte.
Afficher les métadonnées de l'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 |
|---|---|---|
| Exécuté à | Horodatage du lancement de la requête d'alerte | N'importe quel horodatage au format 6/25/2021, 10:45:21 AM |
| Durée d'exécution | Durée d'exécution de la requête d'alerte | N'importe quelle durée au format 0.81s |
| Actualisé | Valeur booléenne indiquant si la requête d'alerte a vérifié les données qui avaient 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 source | Horodatage de la ligne de base de données à partir de laquelle la requête d'alerte a vérifié la valeur conditionnelle | N'importe quel horodatage au format 6/25/2021, 9:25:40 AM |
| 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 atteinte ou dépassée | N'importe quelle valeur numérique |
| Observé | Valeur observée qui a atteint ou dépassé les conditions d'alerte et déclenché l'alerte | N'importe quelle valeur numérique |
| État | État de la requête d'alerte |
|
Afficher l'état de synchronisation de l'alerte
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 encerclé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 horodatage indiquant le moment où 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.