Créer des alertes

Si vous disposez des autorisations utilisateur appropriées, vous pouvez créer des alertes sur des vignettes basées sur une requête ou sur des vignettes liées à une présentation dans des tableaux de bord définis par l'utilisateur ou sur des 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 tables dans la visualisation de la tuile. 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 valeur de calcul de champ ou de table unique, ou sur une valeur de calcul de champ ou de table unique.

En fonction du type de visualisation de la vignette du tableau de bord et des 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, celle-ci est 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, c'est-à-dire la première ligne de la table de résultats.
  • Alertes de séries temporelles (utilisées lorsque les résultats de la requête comportent une dimension de date ou d'heure) : Looker vérifie toutes les nouvelles lignes qui n'ont pas é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 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 incluant un total de ligne ne sont pas acceptées.

Pour que vous puissiez créer des alertes, votre tableau de bord doit être hors mode Édition et en mode Développement.

Pour créer une alerte dans une vignette du tableau de bord, cliquez sur l'icône en forme de cloche correspondante, puis sur le bouton Nouvelle au bas de la liste des alertes existantes que vous êtes autorisé à voir (vous devrez peut-être faire défiler la page pour voir toute la liste). Si aucune alerte n'est encore configurée pour cette vignette ou si vous n'êtes pas autorisé à voir les alertes existantes dans cette vignette, pointez 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 éléments de l'alerte:

Chaque requête d'alerte capture les paramètres du tableau de bord et des vignettes au moment où l'alerte a été créée. Cependant, 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 qu'il soit nécessaire de 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 de l'alerte par défaut indique les conditions qui doivent être remplies pour qu'elle soit déclenchée. Si vous souhaitez 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 afficher la modification.
  4. Cliquez sur Enregistrer l'alerte pour enregistrer votre nouveau titre.

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

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

Définir les conditions d'alerte

Dans les menus déroulants Condition de la fenêtre de création d'alerte, vous pouvez définir les composants indiquant à Looker comment vérifier les modifications apportées aux données des cartes 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 champ, les champs, le calcul de tables ou les calculs de tables sélectionnés doivent subir pour déclencher la notification d'alerte
  • L'ampleur du changement 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, les conditions supplémentaires suivantes sont disponibles:

  • Augmente de
  • Diminue de
  • Modifications de (combinaison des options Augmente de et Diminue de)

L'utilisation de ces conditions de comparaison avec des données de séries temporelles nécessite quelques considérations supplémentaires. Pour en savoir plus, consultez la page des bonnes pratiques Définir des alertes en fonction de données de séries temporelles.

Vous pouvez créer des alertes basées uniquement sur des comparaisons de valeurs de données décimales et entières. Pour définir des alertes basées sur les variations en pourcentage des valeurs de données, consultez la page Définir des conditions d'alerte en fonction des pourcentages de variation des valeurs de données.

Définir des 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.

Envoi d'alertes par e-mail

Pour envoyer les notifications d'alerte par e-mail, sélectionnez E-mail dans le menu déroulant Où l'envoyer. Vous pouvez désigner les destinataires de la notification d'alerte par e-mail. Votre adresse e-mail est affichée par défaut, et vous pouvez modifier la liste des destinataires selon vos besoins. 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 pour 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.

Pour les tableaux de bord intégrés, vous pouvez personnaliser l'URL que vous fournissez aux destinataires pour qu'ils les renvoient à 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é et sélectionner le format de l'URL du lien personnalisé sur la page Intégrer du menu Administration.

  • 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, tel que /dashboards/12 ou /reports/salesoverview. L'option Chemin ne s'affiche que si URL définie par l'utilisateur est sélectionnée dans le champ Sélectionnez un chemin d'accès au contenu de la page Intégrer du menu Administration.
  • Dans le champ Libellé de l'URL, vous pouvez saisir un nouveau texte pour le lien qui redirige vers le contenu. Ce champ affiche par défaut tout texte saisi dans le champ Libellé de l'URL sur la page Intégrer du menu Administration. Vous pouvez le modifier.

Envoyer des alertes pour l'intégration des pièces jointes 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 Administration, Pièce jointe Slack (jeton d'API) s'affiche en tant qu'option 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 un client qui utilisent un serveur Action Hub auto-hébergé doivent redémarrer leur serveur Action Hub lorsqu'ils mettent à jour leur instance Looker.

Une fois qu'un administrateur Looker a activé l'action de 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 de la pièce jointe Slack (jeton d'API) :

  1. Sélectionnez Pièce jointe Slack (jeton d'API) dans le menu déroulant Où l'envoyer.

    Les champs Type de canal et Partager dans apparaissent sous le menu déroulant Où l'envoyer.

    Même si les utilisateurs de l'intégration disposent des autorisations nécessaires pour envoyer des notifications d'alerte à l'intégration des pièces jointes Slack, la pièce jointe Slack (jeton d'API) ne s'affiche pas 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 Channel Type (Type de canal) pour spécifier le type de destinataire Slack pour l'alerte:

    • Chaînes: envoyez l'alerte à une chaîne Slack.
    • Utilisateurs: envoyez l'alerte dans un message privé à un utilisateur Slack.

    Une fois que vous avez sélectionné le type de canal, le champ Share In (Partager dans) est renseigné avec les options de canal ou de message privé qui s'appliquent aux identifiants de l'utilisateur de bot d'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 recevra une notification contenant des informations concernant la tuile sur laquelle l'alerte est activée:

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

    Pour les visualisations à valeur unique, la notification Slack inclut la valeur unique sous forme de texte plutôt que sous forme de 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 Administration, Slack s'affiche en tant qu'option dans la liste déroulante Où l'envoyer 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 compatible avec les instances hébergées par le client.

Pour permettre l'installation de l'application Looker, le propriétaire de votre espace de travail Slack devra peut-être modifier 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 dans la liste déroulante Où l'envoyer.

  2. Cliquez sur 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 d'espaces de travail s'affiche, avec des options pour vous connecter individuellement à chacun d'eux.

    Une fois que vous êtes connecté à au moins un espace de travail Slack, les champs Channel Type (Type de chaîne) et Share In (Partager dans) s'affichent sous le champ Workspace.

    Même si les utilisateurs de l'intégration disposent des autorisations nécessaires pour envoyer des notifications d'alerte à l'intégration Slack, l'option Slack ne s'affiche pas 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 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 consulter la liste des espaces de travail que votre administrateur Looker a connectés à votre instance Looker et vous y connecter individuellement depuis la page de votre compte personnel dans Looker.

  4. Le champ Share In (Partager dans) contient 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 la notification d'alerte. Tous les utilisateurs de cette chaîne recevront une notification contenant des informations concernant la tuile sur laquelle l'alerte est activée:

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

    Pour les visualisations à valeur unique, la notification Slack inclut la valeur unique sous forme de texte plutôt que sous forme de 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 que vos données ne sont pas modifié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, un jour spécifié du mois (la valeur par défaut est le 1er du mois) à une heure donnée (la valeur par défaut est 05:00)
  • Toutes les semaines, un Jour précis de la semaine (la valeur par défaut est Dim pour le dimanche) à une Heure donnée (la valeur par défaut est 05:00)
  • Tous les jours à une heure spécifiée (la valeur par défaut est 05:00)
  • Toutes les heures à un intervalle spécifié (la valeur par défaut consiste à vérifier les données toutes les heures) avec les heures de début et de fin (la valeur par défaut est 05:00 et 17:00) ; Avec des intervalles d'une heure, vous pouvez faire en sorte que Looker vérifie les données aux intervalles suivants :
    • Heure
    • 2 heures
    • 3 heures
    • 4 heures
    • 6 heures
    • 8 heures
    • Jusqu'à 12 heures
  • Minutes à un intervalle spécifié (par défaut, les données sont vérifiées toutes les 15 minutes) avec les heures de début et de fin (la valeur par défaut est 05:00 et 17:00). Avec les intervalles basés sur les 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 Fréquence du contrôle sur 12 heures avec une heure de début définie sur 05:00 et une heure de fin définie sur 17:00, Looker vérifiera les données à 05:00 et à 17:00.

Looker envoie des alertes en fonction du fuseau horaire indiqué dans le paramètre Fuseau horaire de l'application sur la page Paramètres de l'administrateur ou, s'il est activé, en fonction du Fuseau horaire spécifique à l'utilisateur du créateur de l'alerte.

Définir des autorisations pour les alertes

Pour des raisons de sécurité, certaines alertes ne peuvent pas être consultées ni suivies par d'autres utilisateurs, et vous ne pouvez pas afficher ni définir leurs autorisations.

Vous pouvez définir les autorisations de votre alerte en sélectionnant les options Publique ou Privée dans le menu déroulant Autorisations de la fenêtre de création d'alerte. Si une alerte peut être suivie, elle est marquée comme Publique par défaut, ce qui signifie que tout utilisateur de Looker disposant des autorisations de suivre sur le contenu sous-jacent de la vignette du tableau de bord peut voir votre alerte et ses paramètres dans la fenêtre d'affichage des alertes. Ils peuvent également suivre votre alerte afin de 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 seuls vous (et les administrateurs) puissiez voir ses paramètres. Pour ce faire, sélectionnez l'option Privée dans la liste déroulante Autorisations de la fenêtre de création d'alerte.

Il n'est pas possible de suivre les alertes envoyées aux intégrations Slack et de pièce jointe Slack (jeton d'API). Toutefois, si vous créez une alerte pour l'une de ces destinations et la marquez comme publique, d'autres utilisateurs pourront voir et dupliquer vos paramètres d'alerte.