Créer des alertes

Si vous disposez des autorisations utilisateur appropriées, vous pouvez créer des alertes sur des vignettes basées sur des requêtes ou associées à une présentation dans les tableaux de bord définis par l'utilisateur ou dans les tableaux de bord LookML.

Créer une alerte

Les alertes ne peuvent être définies que sur les vignettes qui ont au moins une mesure numérique ou un calcul de table dans la visualisation de la vignette. Le type de visualisation et les champs présents dans la visualisation des vignettes 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 "any" valeur de calcul de champ ou de table.

Selon le type de visualisation de la vignette 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. Lorsque vous créez une alerte, elle peut être de l'un des types suivants :

  • 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 est la première ligne de la table de résultats.
  • Alertes de série temporelle (utilisées lorsqu'une dimension de date ou d'heure est présente dans les résultats de la requête) : Looker vérifie toutes les nouvelles lignes qui n'ont jamais été vues auparavant (en fonction de la dimension de date ou d'heure de la requête).
  • Alertes catégorielles (ni valeur unique ni série temporelle) : Looker vérifie toutes les lignes et toutes les valeurs pivot, sauf si une ligne ou une valeur pivot spécifique a été sélectionnée lors de la création de l'alerte.

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

Pour créer des alertes, vous devez quitter le mode Édition et le mode Développement de votre tableau de bord.

Pour créer une alerte sur une vignette de tableau de bord, cliquez sur l'icône en forme de cloche de la vignette, puis sur le bouton Nouveau au bas de la liste des alertes que vous êtes autorisé à voir (vous devrez peut-être faire défiler la page pour voir la liste complète). Si aucune alerte n'est encore configurée pour cette vignette, ou si vous n'êtes pas autorisé à voir les alertes existantes sur cette vignette, maintenez le pointeur de la souris sur la vignette du tableau de bord pour afficher l'icône Alertes en forme de cloche. Cliquez sur l'icône Alertes en forme de cloche dans la vignette du tableau de bord pour ouvrir la boîte de dialogue de création d'alertes.

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 de la carte au moment de la création de l'alerte. Toutefois, une alerte se synchronise avec de nombreux types de modifications courants que vous ou d'autres utilisateurs apportez à son tableau de bord ou à sa vignette sous-jacents, sans avoir à recréer l'alerte. Pour en savoir plus, consultez la page de documentation Effet des modifications du tableau de bord sur les alertes.

Nommer une alerte

Le titre par défaut de l'alerte indique les conditions qui doivent être remplies pour que l'alerte soit déclenchée. Pour renommer votre alerte, procédez comme suit :

  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 voir votre modification.
  4. Cliquez sur Enregistrer l'alerte pour enregistrer votre nouveau titre.

Le titre de votre alerte personnalisée s'affichera dans toutes les alertes visibles publiquement qui sont répertoriées dans la fenêtre de vue des alertes de cette vignette. Le titre personnalisé apparaîtra également dans les notifications de l'alerte.

Dans la fenêtre de la vue d'alerte, pointez sur le titre personnalisé d'une alerte pour voir les conditions qui la déclenchent.

Définir des conditions d'alerte

Dans les menus déroulants 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 des vignettes et les types de modifications qui déclenchent une notification d'alerte.

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

  • Liste des champs ou calculs de table qui apparaissent dans la visualisation de la vignette du tableau de bord
  • Modification que le ou les champs, calculs de table ou calculs de table sélectionnés doivent subir pour déclencher la notification d'alerte
  • L'ampleur de la modification susceptible de déclencher la notification d'alerte

Ces conditions incluent les suivantes:

  • Est supérieur à
  • Est inférieur à
  • Est égal(e) à
  • Est supérieur ou égal à
  • Est inférieur ou égal à

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

  • Augmente de
  • Diminue de
  • Variations de (une combinaison des options Augmente de et Baisse de)

L'utilisation de ces conditions de comparaison avec des données de séries temporelles nécessite certaines considérations supplémentaires. Pour en savoir plus, consultez la page des bonnes pratiques sur la configuration d'alertes basées sur des données de séries temporelles.

Vous pouvez créer des alertes basées uniquement sur des comparaisons de nombres entiers et de valeurs décimales. Pour définir des alertes basées sur les variations de pourcentage des valeurs de données, consultez la page des bonnes pratiques Définir des conditions d'alerte basées sur les variations de pourcentage des valeurs de données.

Configurer les notifications d'alerte

Dans la section Où l'envoyer de la fenêtre de création d'alerte, 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 Où l'envoyer. Vous pouvez désigner les destinataires des notifications d'alerte par e-mail. Votre adresse e-mail s'affichera 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 recevra un e-mail contenant des informations sur l'alerte et la possibilité de ne plus la suivre. S'ils décident de ne plus suivre l'alerte, leur adresse e-mail sera supprimée de la liste des destinataires.

Pour les tableaux de bord intégrés, vous pouvez personnaliser l'URL que vous fournissez aux destinataires pour les rediriger vers Looker. Pour utiliser cette option, un administrateur Looker ou un utilisateur disposant de l'autorisation schedule_look_emails ou create_alerts doit d'abord spécifier les domaines autorisés pour le lien personnalisé, puis sélectionner le format de l'URL du lien personnalisé sur la page Intégrer du menu Admin.

  • Dans le champ Domaine, sélectionnez l'un des domaines disponibles.
  • Dans le champ Chemin d'accès, saisissez un chemin d'accès au tableau de bord, par exemple /dashboards/12 ou /reports/salesoverview. L'option Chemin ne s'affiche que si l'option URL définie par l'utilisateur est sélectionnée dans le champ Sélectionner le chemin d'accès au contenu sur la page Intégrer du menu Administration.
  • Dans le champ Libellé de l'URL, vous pouvez saisir un nouveau texte pour le lien qui pointe vers le contenu. Par défaut, ce champ affiche tout texte saisi dans le champ Libellé de l'URL de la page Intégration du menu Administration. Vous pouvez le modifier dans ce champ.

Envoi d'alertes sur l'intégration de pièces jointes Slack (jeton d'API)

L'action Pièce jointe dans Slack (Jeton API) est disponible dans Action Hub de Looker. 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 la liste déroulante Où l'envoyer de la fenêtre de création d'alerte.

Les administrateurs des instances hébergées par le client qui utilisent un serveur Action Hub autogéré 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 suivre ces étapes pour envoyer des notifications d'alerte à Slack à l'aide de l'intégration des pièces jointes Slack (jeton d'API) :

  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 sont autorisés à envoyer des notifications d'alerte à l'intégration de la pièce jointe dans Slack, ils ne verront pas l'option Pièce jointe dans Slack (Jeton API) dans le menu déroulant 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 : envoyez l'alerte à un canal Slack.
    • Utilisateurs : envoyez l'alerte en message privé à un utilisateur Slack.

    Une fois que vous avez sélectionné le type de chaîne, le champ Partager dans est renseigné avec les options de chaîne 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 le canal sélectionné recevra une notification contenant des informations sur la carte sur laquelle l'alerte est définie :

    • Image PNG de la visualisation des cartes du tableau de bord
    • Un message indiquant le nom du tableau de bord ou le titre de l'alerte personnalisée, ainsi que les conditions ayant déclenché l'alerte
    • Lien permettant d'accéder au tableau de bord de la carte
    • Un lien pour se désabonner de la notification d'alerte

    Pour les visualisations à valeur unique, la notification Slack inclura la valeur unique sous forme de texte, plutôt qu'une image PNG de la visualisation.

Envoyer des alertes sur l'intégration Slack

L'action Slack est disponible dans l'Action Hub de Looker. Lorsque cette action est activée sur la page Actions du panneau Administration, Slack s'affiche dans le menu déroulant Où envoyer l'alerte 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 prise en charge pour les instances hébergées par le client.

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

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 en procédant comme suit:

  1. Sélectionnez Slack dans la liste déroulante Où l'envoyer.

    Si vous ne vous êtes pas encore authentifié dans Slack, un bouton Se connecter avec Slack s'affiche sous le menu déroulant 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, vous verrez une liste d'espaces de travail avec des options pour vous connecter à chacun d'eux individuellement.

    Une fois que vous vous êtes connecté à au moins un espace de travail Slack, les champs Type de canal et Partager dans s'affichent.

    Même si les utilisateurs de l'intégration ont l'autorisation d'envoyer des notifications d'alerte à l'intégration Slack, ils ne verront pas l'option Slack dans le menu déroulant Où l'envoyer, sauf si leur espace de travail Slack est connecté à l'instance Looker.

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

  4. Le champ Partager dans est renseigné avec les options de canal 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 une notification d'alerte. Tous les membres de ce canal verront une notification contenant des informations sur la carte sur laquelle l'alerte est définie :

    • Image PNG de la visualisation des vignettes du tableau de bord
    • Un message indiquant le nom du tableau de bord ou le titre de l'alerte personnalisée, ainsi que les conditions ayant déclenché l'alerte
    • Un lien pour accéder au tableau de bord de la vignette
    • Un lien pour vous désabonner de la notification d'alerte

    Pour les visualisations à valeur unique, la notification Slack inclura la valeur unique sous forme de texte plutôt qu'un fichier PNG de la visualisation.

Définir la fréquence des alertes

Dans la section Fréquence de la fenêtre de création d'alerte, vous pouvez définir la fréquence à laquelle Looker vérifie les modifications apportées à vos données (et envoie une notification d'alerte si les conditions de l'alerte sont remplies). La fréquence par défaut est Tous les jours à 05:00. Les options de fréquence disponibles sont les suivantes :

  • Tous les mois le jour du mois spécifié (la valeur par défaut est le 1er du mois) à une heure spécifiée (la valeur par défaut est 05:00)
  • Toutes les semaines, un jour spécifié de la semaine (la valeur par défaut est Dim pour le dimanche) à une heure spécifiée (la valeur par défaut est 05:00)
  • Tous les jours à une heure spécifiée (par défaut, 05h00)
  • Toutes les heures à un intervalle spécifié (par défaut, les données sont vérifiées toutes les heures) aux heures de début et de fin spécifiées (la valeur par défaut est 05:00 et 17:00). Avec les intervalles horaires, vous pouvez demander à Looker de 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, la vérification des données est effectuée toutes les 15 minutes) avec les heures de début et de fin spécifiées (la valeur par défaut est 05:00 et 17:00). Avec des intervalles basés sur une minute, Looker vérifie les données aux intervalles suivants:
    • 15 minutes
    • 30 minutes

Les heures de début et de fin sont inclusives. Par exemple, si vous définissez Fréquence du test sur 12 heures avec l'heure de début 05h00 et l'heure de fin sur 17h00, Looker vérifiera les données à 5het à 17h.

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

Définir des autorisations d'alerte

Pour des raisons de sécurité, certaines alertes ne peuvent pas être vues ni suivies par les autres utilisateurs. Vous ne pouvez pas non plus afficher ni définir leurs autorisations.

Vous pouvez définir les autorisations de votre alerte en sélectionnant l'option Publique ou Privée dans le menu déroulant Autorisations de la fenêtre de création de l'alerte. Si une alerte peut être suivie, elle est marquée comme Publique par défaut, ce qui signifie que tout utilisateur Looker disposant d'autorisations de suivi sur le contenu sous-jacent de la vignette du tableau de bord peut la voir et ses paramètres dans la fenêtre d'affichage des alertes. Ils peuvent également suivre votre alerte pour recevoir des notifications par e-mail lorsque les conditions de votre alerte sont déclenchées.

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

Les alertes concernant les intégrations Slack et Pièce jointe Slack (jeton d'API) ne peuvent pas être suivies. Toutefois, si vous créez une alerte pour l'une de ces destinations et que vous la marquez comme Publique, les autres utilisateurs pourront voir et dupliquer vos paramètres d'alerte.