Créer des alertes

Si vous disposez des autorisations utilisateur appropriées, vous pouvez créer des alertes pour les tuiles basées sur les requêtes ou basées sur le style des tableaux de bord définis par l'utilisateur ou des tableaux de bord LookML qui utilisent des tableaux de bord nouveaux ou anciens.

Créer une alerte

Les alertes ne peuvent être définies que sur des tuiles ayant au moins une mesure numérique ou un calcul de table dans la visualisation de la tuile. Le type de visualisation et les champs présents dans la visualisation en mosaïque du tableau de bord déterminent si vous pouvez définir une condition d'alerte basée sur une seule valeur de calcul de champ ou de table, ou sur n'importe quelle valeur de calcul de champ ou de table.

Selon le type de visualisation du tableau de bord et les types de champs présents dans la visualisation, Looker vérifie vos données de différentes manières. Voici les types d'alertes que vous pouvez créer:

  • Alertes à valeur unique (utilisées uniquement avec les visualisations à valeur unique) : Looker vérifie les données en fonction de la valeur utilisée dans la visualisation, qui correspond à la première ligne du tableau de résultats.
  • Alertes de séries temporelles (utilisées lorsqu'une dimension de date ou d'heure est affichée dans les résultats de la requête) : Looker vérifie toutes les nouvelles lignes qui n'ont pas encore été vues (en fonction de la dimension de date ou d'heure dans la requête).
  • Alertes catégorielles (ni valeur unique, ni série temporelle) : Looker vérifie toutes les lignes et les valeurs de tableaux croisés dynamiques, sauf si une ligne ou une valeur de tableau croisé dynamique spécifique a été sélectionnée lors de la création de l'alerte.

Les alertes basées sur un calcul de table comprenant un total de lignes ne sont pas acceptées.

Pour créer des alertes, vous devez désactiver le mode Édition du tableau de bord, ainsi que le mode Développement.

Pour créer une alerte sur la vignette d'un tableau de bord, cliquez sur l'icône en forme de cloche, puis sur le bouton Nouvelle, au bas de la liste des alertes autorisées à afficher (vous devrez peut-être faire défiler la page pour voir toute la liste). Si aucune alerte n'est actuellement configurée pour cette tuile, ou si vous n'êtes pas autorisé à voir des alertes existantes sur cette tuile, pointez sur la tuile de tableau de bord pour afficher l'icône en forme de cloche. Cliquez sur l'icône en forme de cloche pour ouvrir la fenêtre de création d'alerte:

Dans la fenêtre de création d'alerte, vous pouvez spécifier plusieurs composants de votre alerte:

Chaque requête d'alerte capture les paramètres du tableau de bord et des tuiles au moment de la création de l'alerte. Une requête d'alerte ne prend pas en compte les modifications apportées au tableau de bord ou à la tuile après la création de l'alerte, y compris les modifications apportées aux filtres du tableau de bord ou à l'apparence de la tuile de votre tableau de bord (par exemple, les modifications apportées au type de visualisation). Vous devez créer une nouvelle alerte une fois les modifications appliquées pour qu'elles s'appliquent à votre alerte et aux notifications.

Une alerte se synchronise avec de nombreux types de modifications courantes que vous ou d'autres utilisateurs apportez à son tableau de bord ou à sa tuile sous-jacente, sans qu'il soit nécessaire de recréer l'alerte. Pour en savoir plus, consultez la page Modifier les alertes du tableau de bord avec des alertes.

Nommer une alerte

Le titre de l'alerte par défaut indique les conditions à remplir pour déclencher l'alerte. Si vous souhaitez renommer votre alerte:

  1. Cliquez sur le menu à trois points, puis sur Modifier l'alerte.
  2. Cliquez une fois sur le titre de l'alerte.
  3. Saisissez un titre personnalisé, puis cliquez en dehors du champ ou appuyez sur la touche Entrée pour afficher votre mise à jour.
  4. Cliquez sur Enregistrer l'alerte pour enregistrer le nouveau titre.

Le titre de votre alerte personnalisée apparaît dans toutes les alertes visibles dans la fenêtre d'affichage de l'alerte de cette tuile. Le titre personnalisé apparaîtra également dans les notifications d'alerte.

Pointez sur le titre personnalisé d'une alerte dans la fenêtre d'affichage de l'alerte pour afficher les conditions qui la déclenchent.

Définir des conditions d'alerte

Dans la liste déroulante Condition de la fenêtre de création d'alerte, vous pouvez définir les composants qui indiquent à Looker comment vérifier les modifications apportées aux données de tuile, ainsi que les types de modifications qui déclenchent une notification d'alerte.

La condition d'alerte est représentée par les composants suivants:

  • Liste des champs ou des calculs de tableau qui apparaissent dans la tuile de tableau de bord
  • Modification que le champ, les champs, le calcul de la table ou les calculs de la table sélectionnés doivent déclencher pour déclencher la notification d'alerte
  • L'ampleur de la modification qui déclencherait la notification d'alerte

Ces conditions sont les suivantes:

  • Est supérieur à
  • est inférieur à
  • Est égal à
  • Est supérieur ou égal à
  • Est inférieur ou égal à

Si la requête contient un champ de date ou d'heure, des conditions supplémentaires sont disponibles:

  • Augmente de
  • Diminue de
  • Modifications de (une combinaison des colonnes Augmente de et Diminue de)

L'utilisation de ces conditions de comparaison avec des données de séries temporelles comporte des considérations supplémentaires. Pour en savoir plus, consultez l'article du centre d'aide Définir des alertes basées sur les données des séries temporelles.

Looker crée uniquement des alertes basées sur des comparaisons de valeurs entières et décimales de données. Cependant, avec une solution de contournement simple, vous pouvez définir des alertes basées sur les pourcentages de modification des valeurs des données.

Définir des notifications d'alerte

Dans la section Où l'envoyer, vous pouvez spécifier la destination de la notification d'alerte.

Envoyer des alertes par e-mail

Pour envoyer vos notifications d'alerte par e-mail, sélectionnez E-mail dans la liste déroulante À qui envoyer. Vous pouvez désigner les destinataires de la notification d'alerte par e-mail. Votre adresse e-mail est répertoriée par défaut, mais vous pouvez modifier la liste des destinataires si nécessaire. Vos autorisations déterminent les domaines de messagerie auxquels vous pouvez envoyer des notifications d'alerte.

Chaque destinataire reçoit un e-mail contenant des informations sur l'alerte et une option permettant de ne plus la suivre. S'il décide de ne plus suivre l'alerte, son adresse e-mail sera supprimée de la liste des destinataires.

Envoyer des alertes à l'intégration du rattachement de Slack (jeton d'API)

L'action de pièce jointe Slack (jeton d'API) est disponible dans Looker Action Hub. Lorsque cette action est activée sur la page Actions du panneau Admin, l'option Pièce jointe Slack (jeton d'API) apparaît dans le menu déroulant Où l'envoyer de la fenêtre de création d'alerte.

Les administrateurs d'instances hébergées par le client qui utilisent un serveur d'actions auto-hébergées doivent redémarrer leur serveur Action Hub lorsqu'ils mettent à jour leur instance Looker.

Une fois qu'un administrateur Looker a activé l'action "Pièce jointe Slack (jeton d'API)" et que l'utilisateur du bot de l'application Looker a été configuré dans Slack, vous pouvez envoyer des notifications d'alerte à Slack à l'aide de l'intégration du rattachement Slack (API Token) :

  1. Sélectionnez Pièce jointe Slack (jeton d'API) dans la liste déroulante Où l'envoyer.

    Les champs Type de chaîne et Partager dans s'affichent:

    Même si les utilisateurs intégrés disposent des autorisations d'envoyer des notifications d'alerte pour l'intégration du rattachement Slack, ils ne verront pas Pièce jointe Slack (jeton d'API) dans la liste déroulante Où l'envoyer, sauf si leur espace de travail Slack est configuré pour l'utilisateur du bot de l'application Looker.

  2. Utilisez le champ Type de canal pour spécifier le type de destinataire Slack pour l'alerte:

    • Canaux : envoyer l'alerte à un canal Slack
    • Utilisateurs : envoyer l'alerte dans un message privé à un utilisateur Slack

    Une fois que vous avez sélectionné le type de canal, le champ Partager dans contient les options de canal ou de message privé applicables aux identifiants de l'utilisateur du bot de l'application Looker dans l'espace de travail Slack.

  3. Dans le champ Partager dans, sélectionnez le message privé ou le canal auquel vous souhaitez envoyer la notification d'alerte. L'utilisateur ou la chaîne sélectionnés recevront une notification contenant des informations sur la tuile sur laquelle l'alerte est définie:

    • Image PNG de la visualisation en mosaïque du tableau de bord
    • Un message avec le nom du tableau de bord ou le titre de l'alerte personnalisée et les conditions qui ont déclenché l'alerte
    • Lien pour accéder au tableau de bord des vignettes
    • Lien pour se désabonner de la notification d'alerte

    Pour les visualisations à une seule valeur, la notification Slack inclut la valeur unique sous forme de texte, au lieu d'un fichier PNG de la visualisation.

Envoyer des alertes à l'intégration à Slack

L'action Slack est disponible dans Looker Action Hub. Lorsque cette action est activée sur la page Actions du panneau Admin, l'option Slack s'affiche dans la liste déroulante Emplacement de l'envoi de la fenêtre de création d'alerte. Un administrateur Looker doit également connecter au moins un espace de travail Slack à l'instance Looker.

L'intégration Slack est disponible pour les déploiements hébergés par Looker qui répondent aux conditions suivantes :

Cette intégration Slack n'est pas disponible pour les instances hébergées par le client.

Pour activer l'installation de l'application Looker, le propriétaire de l'espace de travail Slack devra peut-être modifier les paramètres d'installation associés.

Une fois qu'un administrateur Looker a activé l'action Slack et connecté les espaces de travail Slack appropriés, vous pouvez envoyer des notifications d'alerte à Slack:

  1. Sélectionnez Slack dans la liste déroulante À quel endroit l'envoyer.

    Si vous ne vous êtes pas encore authentifié dans Slack, un bouton Se connecter avec Slack s'affiche dans la liste déroulante Où l'envoyer:

  2. Cliquez sur Sign in with Slack (Se connecter avec Slack). Looker demandera accès à l'espace de travail Slack. Si votre administrateur Looker a connecté plusieurs espaces de travail Slack à votre instance Looker, un menu déroulant apparaît en haut à droite de la page OAuth. Sélectionnez l'espace de travail Slack approprié dans le menu déroulant. Cliquez sur Allow (Autoriser).

    Vous pouvez également vous authentifier dans Slack depuis la page de votre compte personnel dans Looker. Si votre administrateur Looker a connecté plusieurs espaces de travail Slack à votre instance Looker, une liste des espaces de travail s'affiche avec des options de connexion à chacun d'eux.

    Une fois que vous êtes connecté à au moins un espace de travail Slack, les autres champs Slack de la fenêtre de création d'alerte s'affichent:

    Même si les utilisateurs intégrés disposent des autorisations d'envoyer des notifications d'alerte à l'intégration Slack, à moins que leur espace de travail Slack ne soit connecté à l'instance Looker, ils ne verront pas l'option Slack dans la liste déroulante Où l'envoyer.

  3. La liste déroulante Espace de travail affiche la liste de tous les espaces de travail auxquels vous êtes connecté. Sélectionnez un espace de travail dans la liste. Si vous ne voyez pas l'espace de travail auquel vous souhaitez envoyer la notification d'alerte, vous pouvez afficher la liste des espaces de travail que votre administrateur Looker a connectés à votre instance Looker, puis vous y connecter individuellement depuis la page de votre compte personnel dans Looker.

  4. Le champ Partager dans contient les options de chaîne et de message privé basées sur l'espace de travail Slack sélectionné. Sélectionnez le message privé ou le canal auquel vous souhaitez envoyer la notification d'alerte. Tous les membres de la chaîne recevront une notification contenant des informations sur la tuile sur laquelle l'alerte est définie:

    • Image PNG de la visualisation en mosaïque du tableau de bord
    • Un message avec le nom du tableau de bord ou le titre de l'alerte personnalisée et les conditions qui ont déclenché l'alerte
    • Lien pour accéder au tableau de bord des vignettes
    • Lien pour vous désabonner de la notification d'alerte

    Pour les visualisations à une seule valeur, la notification Slack inclut la valeur unique sous forme de texte, au lieu d'un fichier PNG de la visualisation.

Définir la fréquence des alertes

Vous pouvez définir la fréquence à laquelle Looker vérifie que vos données ne contiennent pas de modifications (et pour envoyer une notification d'alerte si les conditions sont remplies) dans la section Fréquence de la fenêtre de création d'une alerte. La fréquence par défaut est Tous les jours à 05:00. Voici les options de fréquence disponibles:

  • Un jour mensuel dans le mois (la valeur par défaut est le 1er du mois) à un moment précis (05:00)
  • Un jour de la semaine (par défaut, dimanche pour le dimanche) à un heure (la valeur par défaut est 05:00) ;
  • Tous les jours à l'heure spécifiée (par défaut, 05:00)
  • Toutes les heures à un intervalle spécifié (par défaut, les données sont vérifiées toutes les heures) avec les heures Start et End spécifiées (la valeur par défaut est 05:00 et 17:00). Avec des intervalles horaires, Looker peut vérifier les données à ces intervalles :
    • Heure
    • 2 heures
    • 3 heures
    • 4 heures
    • 6 heures
    • 8 heures
    • 12 heures
  • Minutes à un intervalle spécifié (par défaut, les données sont vérifiées toutes les 15 minutes) avec les valeurs Start et End spécifiées (la valeur par défaut est 05:00 et 17:00). Avec des intervalles basés sur des minutes, vous pouvez demander à Looker de vérifier les données à ces intervalles :
    • 15 minutes
    • 30 minutes

Les heures de début et de fin sont incluses. Par exemple, si vous définissez Check Every (Intervalle de temps entre deux vérifications) sur 12 heures avec une heure de début de 05:00 et une heure de fin de 17:00, Looker vérifie les données à 05:00 et 17:00.

Looker envoie les alertes en fonction du fuseau horaire indiqué dans le paramètre Application Time Zone (Fuseau horaire de l'application) de la page Paramètres de l'administrateur ou, si cette option est activée, du fuseau horaire spécifique à l'utilisateur du créateur des alertes.

Définir des autorisations pour les alertes

Vous pouvez définir les autorisations pour votre alerte en sélectionnant les options Public ou Privé dans la liste déroulante Autorisations de la fenêtre de création d'alerte. Si une alerte n'est pas non observable, elle est marquée Public par défaut, ce qui signifie que tout utilisateur Looker suivant les autorisations affichées sur la carte de votre tableau de bord peut afficher les alertes relatives au contenu sous forme de carte et de alerte. Ils peuvent également suivre votre alerte afin de recevoir des notifications par e-mail lorsque celle-ci est déclenchée.

Il n'est pas possible de suivre les alertes liées à l'intégration de Slack et de Pièce jointe Slack (jeton d'API). Toutefois, si vous créez une alerte pour l'une de ces destinations et que vous la rendez publique, les autres utilisateurs pourront voir et dupliquer vos paramètres d'alerte.

Vous pouvez définir votre alerte sur Privé afin que ses paramètres ne soient visibles que par vous et les administrateurs. Pour ce faire, sélectionnez l'option Privé dans le menu déroulant Autorisations de la fenêtre de création d'alerte.

Pour des raisons de sécurité, d'autres utilisateurs ne peuvent pas consulter ni suivre certaines alertes, et vous ne pouvez pas afficher ni définir les autorisations associées aux alertes.