Les administrateurs Looker peuvent gérer les alertes créées par tous les utilisateurs sur la page d'administration de gestion Alertes, accessible depuis la section Alertes et programmations du panneau Administration. La page d'administration de la gestion Alertes affiche les informations sur toutes les alertes actives et inactives.
Les administrateurs peuvent également voir 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 concernant les alertes peuvent gérer les alertes qu'ils ont créées et suivies depuis 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 disposant de l'autorisation see_alerts peuvent afficher les paramètres suivants 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 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 qu'elle se déclenche. Cliquez sur le nom de l'alerte pour ouvrir la page Détails de l'alerte. |
| Tableau de bord | Nom du tableau de bord qui contient la vignette avec l'alerte. Cliquez sur le lien pour accéder au tableau de bord. Aucune indique que l'alerte n'est plus synchronisée à partir de 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 ayant 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 étaient 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 pu être déterminé si les conditions d'alerte ont été 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 | Fréquence à laquelle l'alerte est vérifiée pour déterminer si les conditions sont remplies ou dépassées. |
| État | Cette colonne indique si l'alerte est actuellement active ou désactivée.
|
| Suivi | Un bouton indiquant l'état de suivi de l'alerte. Pour en savoir plus, consultez la section Alertes de suivi de cette page. |
| Activity | Un 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 de cette page. |
Si un utilisateur supprime le tableau de bord ou la vignette de tableau de bord où l'alerte est activée, cette alerte sera désactivée: les followers ou 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 sera exécutée, l'état indiquera Désactivé, et une info-bulle indiquera que le tableau de bord ou l'élément (tuile) du tableau de bord a été supprimé. Un administrateur peut ensuite supprimer définitivement l'alerte dans le menu à trois points situé à droite de l'alerte.
Filtrer les alertes
Pour filtrer la liste des alertes, utilisez la barre de recherche Liste des filtres 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 : renvoie toutes les alertes avec une fréquence de 15 minutes ou 30 minutes.
- Toutes les heures : renvoie toutes les alertes avec une fréquence de Heure, 2 heures, 3 heures, 4 heures, 6 heures, 8 heures ou 12 heures.
- Daily (Quotidien) : renvoie toutes les alertes avec une fréquence Daily (Quotidienne) définie sur Time (Heure).
- Hebdomadaire : renvoie toutes les alertes avec une fréquence hebdomadaire définie sur Day (Jour) ou Time (Heure).
- Mensuelle : renvoie toutes les alertes avec une fréquence mensuelle 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 : la vérification de l'alerte est toujours en cours 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 la croix x à côté de son nom. Actualiser le navigateur supprimera également tous les filtres sélectionnés.
Alertes de regroupement
Cliquez sur l'icône Alertes de groupe pour ouvrir le menu Grouper par.
Vous pouvez regrouper les alertes comme suit:
- Par défaut: aucun regroupement
- Noms des tableaux de bord: nom du tableau de bord sur lequel l'alerte est définie, classés par ordre alphabétique.
- Propriétaire: par propriétaire de l'alerte (par ordre alphabétique)
Messages d'erreur et d'avertissement
La page d'administration Gérer les alertes affiche les erreurs ou les avertissements affichés lors de l'exécution de la requête d'alerte ou de la notification de la notification d'alerte. Les messages d'erreur, le cas échéant, s'affichent lorsque vous passez la souris 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 pièce jointe Slack (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 sont remplies, mais que la notification n'a pas pu être envoyée. Cet échec peut se produire si des modifications ont été apportées à la configuration Slack depuis la création de l'alerte, par exemple si l'espace de travail Slack auquel l'alerte était envoyée a été déconnecté de l'instance Looker, si le canal Slack dans lequel l'alerte était envoyée a été supprimé, ou si Looker ne peut pas se connecter aux intégrations.
Avertissement: Interrogation de 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. Passez la souris sur cette icône pour afficher le message Stale Alert Warning (Avertissement d'alerte non actualisé) 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 conformes au 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 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 apparaît dans cette colonne.
- Si vous n'êtes pas le 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 dans la fenêtre d'affichage des alertes, vous verrez un bouton Suivre non cliquable. Pour ne plus suivre l'alerte, vous devez vous désabonner directement depuis la notification d'alerte.
Un bouton Follow (Suivre) non cliquable s'affiche à côté de l'alerte si l'une des conditions suivantes est remplie:
- Vous êtes le propriétaire de l'alerte, mais elle est indésirable.
- Vous avez été listé comme destinataire des e-mails ayant reçu les notifications d'alerte, 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 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 proposant 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 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 de tableau de bord où l'alerte est activée, cette alerte sera désactivée: les followers ou 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. Après la prochaine exécution de la requête d'alerte, l'état de l'alerte affichera 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 configurées par son propriétaire. Les propriétaires et les abonnés à l'alerte voient la page différemment.
Vous pouvez ouvrir la page Détails de l'alerte de l'une des manières suivantes:
- en cliquant sur le menu à trois points à droite de l'alerte et en sélectionnant 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 pour celle-ci s'affiche sur la page d'administration Gérer les alertes. Ouvrez la page Détails de l'alerte pour configurer les informations de l'alerte que ses abonnés et 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 qui déclenchent votre alerte ou sur son déclenchement. Cliquez sur Enregistrer pour enregistrer votre description.
- Cliquez sur le bouton + Associer un tableau de bord d'investigation.
Dans la fenêtre Link Dashboard to Alert (Associer le tableau de bord à l'alerte), sélectionnez le dossier contenant 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 le x dans le nom du tableau de bord. Looker vous demandera de confirmer la suppression du lien.
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é dans l'onglet Activité de la page)
- La visualisation des alertes
- État de synchronisation du tableau de bord et nom du tableau de bord auquel l'alerte est associée
Voici d'autres moyens d'interagir avec une de vos alertes:
- Cliquez sur le menu à trois points dans la visualisation de l'alerte, puis sur 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.
- 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 est envoyée à son propriétaire, à ses destinataires et à ses followers.
Cliquez sur OK pour fermer la page Détails de l'alerte.
Afficher la page "Détails de l'alerte"
Vous pouvez consulter les Détails de l'alerte d'une alerte dont vous n'êtes pas le propriétaire si vous êtes répertorié comme destinataire de cette alerte ou si vous avez choisi de suivre celle-ci. Ouvrez l'onglet Détails de la page Détails des alertes pour afficher les informations concernant une alerte configurée par son propriétaire.
Dans l'onglet Détails de la page Détails des alertes, vous pouvez effectuer les tâches suivantes:
- Affichez le contexte sur les conditions qui déclenchent votre alerte et sur ce qu'elle implique pour qu'une alerte soit déclenchée.
- Cliquez sur le tableau de bord associé pour accéder à un autre tableau de bord pouvant ajouter du contexte à la requête d'alerte.
- afficher la visualisation de l'alerte ;
- Consultez l'état de synchronisation des alertes.
- Cliquez sur le menu à trois points dans la visualisation de l'alerte, puis sur 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.
- 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 est envoyée à son propriétaire, à ses destinataires et à ses followers.
- Cliquez sur OK pour fermer la page Détails de l'alerte.
Afficher l'activité liée aux alertes
Looker exécute une requête d'alerte à la fréquence spécifiée pour vérifier si les conditions d'alerte des données sont remplies ou dépassées. Le résultat de ces vérifications constitue 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 des informations supplémentaires.
Dans l'onglet Activité de la page Détails de l'alerte, vous pouvez effectuer les tâches suivantes:
- Affichez la fréquence à laquelle l'alerte est vérifiée par rapport à ses conditions.
- Affichez 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 est envoyée à son propriétaire, à ses destinataires et à ses followers.
- Cliquez sur OK pour fermer la page Détails de l'alerte.
Afficher les métadonnées d'alerte
Le tableau de l'onglet Activité de la page Détails de l'alerte inclut des métadonnées sur chaque alerte exécutée.
| Titre | Définition | Valeurs possibles |
|---|---|---|
| Exécuté le | L'horodatage du lancement 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
|
| Actualisée | Valeur booléenne indiquant si la requête d'alerte a vérifié les données qui ont changé entre les deux requêtes d'alerte les plus récentes. 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 recherché la valeur conditionnelle |
|
| Heure source | Horodatage de la ligne de la base de données à partir de laquelle la requête d'alerte a recherché 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 de l'alerte ont été remplies |
|
| Déclencheur | Valeur conditionnelle qui déclenchera l'alerte si elle est atteinte ou dépassée | N'importe quelle valeur numérique |
| Observée | Valeur observée qui a atteint ou dépassé les conditions de l'alerte et qui a 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 l'alerte est associée:
- Une coche entourée de couleur verte 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 comprend l'horodatage de l'interruption de la synchronisation. Une alerte non synchronisée affiche la valeur Aucune dans la colonne Tableau de bord. Pour en savoir plus sur la résolution d'une alerte non synchronisée, consultez la page de documentation Effet des modifications du tableau de bord sur les alertes.