Partager via

Créer des alertes Activator à partir d’un ensemble de requêtes KQL

Cet article explique comment créer des alertes Fabric Activateor à partir d’un ensemble de requêtes KQL. L’activateur fabric dans Microsoft Fabric vous permet d’effectuer des actions lorsque des modèles ou des conditions sont détectés dans les flux de données. Pour plus d’informations, consultez Présentation d’Activator.

Vous pouvez configurer Activateor pour déclencher des notifications en fonction de l’ensemble de requêtes KQL dans deux scénarios :

  • Lorsque les requêtes KQL planifiées retournent des résultats.
  • Lorsque des requêtes KQL planifiées retournent des résultats avec des visualisations qui répondent à des conditions spécifiques.

Envoyez-vous des notifications d’alerte ou envoyez-les à d’autres personnes de votre organisation. Vous pouvez configurer les notifications à envoyer par e-mail ou par courrier Microsoft Teams.

Exemples de scénarios

Voici quelques exemples d’utilisation des alertes Activateor avec des requêtes KQL :

  • Surveillez les journaux des applications pour les erreurs : supposons que vous disposez d’une base de données KQL stockant les journaux d’application. Vous pouvez configurer une alerte pour vous avertir si des enregistrements des cinq dernières minutes contiennent la chaîne authorization error dans la colonne de message .

  • Suivez les vélos disponibles dans les quartiers : imaginez que vous disposez de données en flux continu pour les vélos disponibles dans différents quartiers. Vous créez une requête KQL pour générer un diagramme circulaire montrant le nombre de vélos disponibles par quartier. Vous pouvez configurer une alerte pour vous avertir lorsque le nombre de vélos disponibles dans n’importe quel quartier tombe en dessous d’un seuil spécifié.

Prérequis

Important

  • Seules les requêtes sur les bases de données KQL au sein d’un Eventhouse sont prises en charge. Si votre jeu de requêtes KQL est connecté à un cluster Azure Data Explorer externe, la création d’une alerte n’est pas prise en charge.
  • L’impact d’une règle d’alerte sur Eventhouse dépend de la complexité de la requête. Les requêtes et les agrégations simples sont légères, tandis que les jointures, les transformations et les tris sont plus gourmands en ressources. Si une requête s’exécute toutes les 1 ou 5 minutes, elle conserve efficacement Eventhouse dans un état toujours actif . Sans requêtes ni ingestion pendant plus de 5 minutes, Eventhouse peut être inactif, ce qui réduit les coûts. Pour plus d’informations, consultez Eventhouse Uptime.

Les étapes suivantes vous montrent comment créer une alerte sur une requête qui crée une visualisation ou sur une requête qui ne crée pas de visualisation.

Choisissez l’onglet correspondant au workflow qui vous convient.

Définir une alerte sur un ensemble de requêtes KQL

Important

Les visualisations de graphique chronologique ne sont pas prises en charge dans ce scénario. Ils sont pris en charge dans Créer des alertes d'activation à partir d'un tableau de bord en temps réel.

  1. Ouvrez l’espace de travail qui contient votre jeu de requêtes KQL.

  2. Accédez à votre ensemble de requêtes KQL et sélectionnez-le pour l’ouvrir.

  3. Exécutez une requête qui renvoie une visualisation.

  4. Une fois que la requête a renvoyé les résultats, sélectionnez Définir une alerte dans le ruban supérieur.

    Capture d’écran du bouton Définir l’alerte dans le ruban supérieur.

Définir les conditions d’alerte

Dans le volet Ajouter une règle qui s’affiche, procédez comme suit pour définir vos conditions d’alerte :

  1. Dans la section Détails , indiquez un nom pour votre règle d’alerte Activateur.

    Capture d’écran de la section Détails dans le volet Ajouter une règle.

  2. Dans la section Monitor , définissez une fréquence de temps pour la fréquence à laquelle la requête est exécutée. La valeur par défaut est 5 minutes.

    Capture d’écran de la section Surveillance dans le volet latéral Ajouter une règle.

  3. Dans la section Condition , spécifiez vos conditions d’alerte comme suit :

    Capture d’écran de la section Condition dans le volet Ajouter une règle.

    • Si votre visualisation n’a pas de dimension, vous pouvez sélectionner la condition À chaque événement lorsque pour monitorer les changements dans le flux de données en choisissant un champ spécifique à surveiller.
    • Dans la liste déroulante Lorsque, définissez la valeur à évaluer.
    • Dans la liste déroulante Condition, définissez la condition à évaluer. Pour plus d’informations, consultez l’article Conditions (Conditions MSBuild).
    • Dans le champ Occurrence , définissez le nombre de fois où la condition doit être remplie avant qu’une alerte soit déclenchée.

  4. Dans la section Action , sélectionnez l’une des actions suivantes :

    • Envoyer une notification par e-mail :

      1. Pour sélectionner une action, sélectionnez Envoyer un e-mail.
      2. Pour à, entrez l’adresse e-mail du destinataire ou utilisez la liste déroulante pour sélectionner une propriété dont la valeur est une adresse e-mail. Par défaut, votre adresse e-mail est renseignée ici.
      3. Pour Objet, entrez l’objet de la notification par e-mail.
      4. Pour Titre, entrez le titre de la notification par e-mail.
      5. Pour les notes, entrez des notes pour la notification par e-mail.

        Note

        Lorsque vous entrez un sujet, un titre ou des notes, vous pouvez faire référence aux propriétés des données en tapant @ ou en sélectionnant le bouton en regard des zones de texte. Par exemple : @BikepointID.

      6. Pour Contexte, sélectionnez les valeurs dans la liste déroulante que vous souhaitez inclure dans la notification par e-mail.

      Capture d’écran de la section Envoyer une notification par e-mail dans le volet Ajouter une règle.

    • Envoyer une notification Microsoft Teams : envoie un message Microsoft Teams à vous-même. Vous pouvez personnaliser le titre et le contenu du message.

      1. Pour Sélectionner une action, sélectionnez Teams -->Message pour individus ou Message de discussion de groupe ou Publication dans un canal.
      2. Suivez l’une de ces étapes en fonction de votre sélection :
        • Si vous avez sélectionné l’option Message à des personnes , entrez des adresses e-mail de récepteurs ou utilisez la liste déroulante pour sélectionner une propriété dont la valeur est une adresse e-mail. Lorsque la condition est remplie, un e-mail est envoyé à des personnes spécifiées.
        • Si vous avez sélectionné l’option de message de conversation de groupe, sélectionnez une conversation de groupe dans la liste déroulante. Lorsque la condition est remplie, un message est publié dans la conversation de groupe.
        • Si vous avez sélectionné l’option de publication de canal , sélectionnez une équipe et un canal dans les listes déroulantes. Lorsque la condition est remplie, un message est publié sur le canal sélectionné.
      3. Pour Titre, entrez le titre de la notification dans Teams.
      4. Pour Notes, entrez des notes pour la notification Teams.

        Note

        Lorsque vous entrez un sujet, un titre ou des notes, vous pouvez faire référence aux propriétés des données en tapant @ ou en sélectionnant le bouton en regard des zones de texte. Par exemple : @BikepointID.

      5. Pour Le contexte, sélectionnez les valeurs dans la liste déroulante que vous souhaitez inclure dans la notification Teams.

      Capture d’écran de la section Envoyer une notification Microsoft Teams dans le volet Ajouter une règle.

    • Exécuter des activités Fabric : pour configurer l’alerte pour lancer un pipeline Fabric, un travail Spark ou un notebook lorsque la condition est remplie, procédez comme suit :

      1. Pour sélectionner une action, sélectionnez Exécuter le pipeline, exécuter un travail Spark, exécuter un bloc-notes ou exécuter une fonction (préversion).
      2. Pour sélectionner l’élément Fabric à exécuter, sélectionnez l’élément Fabric (pipeline, carnet, travail Spark ou fonction) dans la liste.
      3. Sélectionnez Ajouter un paramètre et spécifiez le nom du paramètre pour l’élément Fabric et une valeur pour celui-ci. Vous pouvez ajouter plusieurs paramètres. Vous pouvez transmettre des paramètres à partir des données d’alerte en tapant @ ou en sélectionnant le bouton en regard de la zone de texte. Par exemple : @BikepointID. Capture d’écran de la section Exécuter les activités de Fabric dans le volet latéral Ajouter une règle.

    • Actions personnalisées : pour configurer l’alerte pour appeler une action personnalisée lorsque la condition est remplie, procédez comme suit :

      1. Pour Sélectionner une action, sélectionnez Créer une action personnalisée.

        Capture d’écran de la section Créer une action personnalisée dans le volet Ajouter une règle.

      2. Comme mentionné dans la section Action, créez d’abord la règle, puis effectuez la configuration de l’action personnalisée en suivant les étapes de Déclencheur d’actions personnalisées (flux Power Automate) .

      3. Après avoir créé l’action personnalisée, dans le volet Définition de la règle, sélectionnez l’action personnalisée que vous avez créée dans la liste déroulante Action .

  5. Dans Emplacement d’enregistrement, spécifiez où enregistrer votre alerte Activator. Choisissez un espace de travail existant et enregistrez votre alerte un dans un Activator existant ou dans un nouvel Activator.

    Capture d’écran de la section Enregistrer l’emplacement dans le volet Ajouter une règle.

  6. Sélectionnez Créer pour créer votre règle Activator.

Facultatif : modifier votre règle dans Activator

Lorsque votre activateur est enregistré, le volet latéral affiche un lien vers votre élément. Sélectionnez le lien pour faire des modifications dans Activator. Cette étape peut être utile si vous voulez faire une des actions suivantes :

  • ajoutez d’autres destinataires à votre alerte.
  • Changer le contenu de l’alerte pour refléter les données spécifiques qui ont déclenché l’alerte.
  • Définissez une condition d’alerte plus complexe que possible dans le volet Définir une alerte.

Pour plus d’informations sur la modification des règles dans Activator, consultez Créer des règles Activator.

Dans l’Activator lui-même, vous pouvez également voir l’historique des résultats de requête et l’historique des activations de la règle. Pour plus d’informations, consultez Créer des règles Activator.

Contenu connexe

  • Last updated on