Partager via


Personnaliser des notifications d’alerte en tirant parti de Logic Apps

Cet article vous présente comment créer une application logique et l’intégrer à une alerte Azure Monitor. Vous pouvez utiliser Azure Logic Apps pour générer et personnaliser des workflows pour une intégration. Utilisez Logic Apps pour personnaliser vos notifications d’alerte. Vous pouvez :

  • Personnalisez l’e-mail des alertes en utilisant votre propre format d’objet et de corps d’e-mail.

  • Personnalisez les métadonnées d’alerte en recherchant des balises pour les ressources concernées ou en extrayant un résultat de recherche de requête de journal. Pour plus d’informations sur l’accès aux lignes de résultats de recherche qui contiennent des données d’alertes, consultez :

  • Intégrez des services externes en tirant parti de connecteurs existants comme Outlook, Microsoft Teams, Slack et PagerDuty. Vous pouvez également configurer l’application logique pour vos propres services.

Cet exemple crée une application logique qui utilise le schéma d’alerte commun pour envoyer les détails de l’alerte.

Créer une application logique

  1. Dans le Portail Azure, créez une application logique. Dans la barre de recherche en haut de la page, entrez applications logiques et sélectionnez-la dans le menu déroulant.

  2. Dans la page Applications logiques, sélectionnez Ajouter.

  3. Sous Consommation, sélectionnez Multilocataire.

  4. Dans la page suivante, sélectionnez l’abonnement et le groupe de ressources pour votre application logique.

  5. Définissez un nom d’application logique et choisissez une région.

  6. Sélectionnez Vérifier + créer>Créer.

    Capture d’écran de la page « Créer une application logique ».

  7. Sélectionnez Accéder à la ressource après la fin du déploiement.

Configurer un déclencheur

  1. Dans la page de l’application logique , sélectionnez Modifier dans la barre d’action supérieure.

  2. Sélectionnez Ajouter un déclencheur, recherchez Quand une requête HTTP est reçue, puis sélectionnez-la dans les résultats de la recherche.

    Capture d’écran du menu « Ajouter un déclencheur » avec « Quand une requête HTTP est reçue » mise en surbrillance.

  3. Collez le schéma d’alerte commun dans le champ Schéma JSON du corps de la demande à partir du code JSON suivant :

     {
        "type": "object",
        "properties": {
            "schemaId": {
                "type": "string"
            },
            "data": {
                "type": "object",
                "properties": {
                    "essentials": {
                        "type": "object",
                        "properties": {
                            "alertId": {
                                "type": "string"
                            },
                            "alertRule": {
                                "type": "string"
                            },
                            "severity": {
                                "type": "string"
                            },
                            "signalType": {
                                "type": "string"
                            },
                            "monitorCondition": {
                                "type": "string"
                            },
                            "monitoringService": {
                                "type": "string"
                            },
                            "alertTargetIDs": {
                                "type": "array",
                                "items": {
                                    "type": "string"
                                }
                            },
                            "originAlertId": {
                                "type": "string"
                            },
                            "firedDateTime": {
                                "type": "string"
                            },
                            "resolvedDateTime": {
                                "type": "string"
                            },
                            "description": {
                                "type": "string"
                            },
                            "essentialsVersion": {
                                "type": "string"
                            },
                            "alertContextVersion": {
                                "type": "string"
                            }
                        }
                    },
                    "alertContext": {
                        "type": "object",
                        "properties": {}
                    }
                }
            }
        }
    }
    

    Capture d’écran du menu « Quand une requête HTTP est reçue » avec le champ « Schéma JSON du corps de la requête » mis en surbrillance.

  4. (Facultatif). Vous pouvez personnaliser la notification d’alerte en extrayant des informations sur la ressource affectée qui a déclenché l’alerte, par exemple, les balises de la ressource. Vous pouvez ensuite inclure ces balises de ressources dans la charge utile de l’alerte et utiliser les informations de vos expressions logiques pour envoyer les notifications. Pour effectuer cette étape, nous allons effectuer ce qui suit :

    • Créez une variable pour les ID de ressource affectés.
    • Fractionner l’ID de ressource dans un tableau de manière à pouvoir utiliser ses différents éléments (par exemple, un abonnement ou un groupe de ressources).
    • Utiliser le connecteur Azure Resource Manager pour lire les métadonnées de la ressource.
    • Récupérer les balises de la ressource qui peuvent ensuite être utilisées lors des étapes suivantes de l’application logique.
    1. Sélectionnez +>Ajouter une action pour insérer une nouvelle étape.

    2. Dans le champ Rechercher, recherchez et sélectionnez Initialiser la variable.

    3. Dans le champ Nom, entrez le nom de la variable, par exemple AffectedResource.

    4. Dans le champ Type, sélectionnez Groupe.

    5. Dans le champ Valeur , sélectionnez fx pour ouvrir la fenêtre contextuelle de fonction. Entrez la chaîne split(triggerBody()?['data']?['essentials']?['alertTargetIDs'][0], '/') dans le champ vide en haut et sélectionnez Ajouter.

      Capture d’écran de l’onglet Paramètres du volet « Initialiser la variable ».

    6. Sélectionnez +>Ajouter une action pour insérer une autre étape.

    7. Dans le champ De recherche, recherchez et sélectionnez Azure Resource Manager>Pour plus d’informations>,consultez la rubrique Lire une ressource.

    8. Sélectionnez une méthode d’authentification et connectez-vous.

    9. Renseignez les champs de l’action Lire une ressource avec les valeurs de tableau de la AffectedResource variable. Dans chacun des champs, sélectionnez le champ, puis faites défiler vers le bas jusqu’à Entrer une valeur personnalisée. Sélectionnez fx pour ouvrir la fenêtre contextuelle de fonction. Entrez la chaîne correspondante de ce tableau dans le champ vide en haut, puis sélectionnez Ajouter.

      Champ Valeur de chaîne
      Abonnement variables('AffectedResource')[2]
      Groupe de ressources variables('AffectedResource')[4]
      Fournisseur de ressources variables('AffectedResource')[6]
      ID court de ressource concat(variables('AffectedResource')[7], '/', variables('AffectedResource')[8])
      Version d’API client Version de l’API du type de ressource

      Pour trouver la version de l’API de votre type de ressource, sélectionnez le lien d’affichage JSON en haut à droite de la page vue d’ensemble de la ressource.

      La page Ressource JSON s’affiche avec ResourceID et la Version d’API en haut de la page.

    Le contenu dynamique inclut désormais des balises de la ressource affectée. Vous pouvez utiliser ces balises lorsque vous configurez vos notifications comme décrit dans les étapes suivantes.

Configurer une action

Sélectionnez +>Ajouter une action pour insérer une nouvelle étape.

  1. Dans le champ de recherche, recherchez Envoyer un e-mail (V2).

  2. Sous Office 365 Outlook, sélectionnez Envoyer un e-mail (V2) dans la liste des actions.

    Capture d’écran du menu « Ajouter une action » avec « Envoyer un e-mail (V2) » mis en surbrillance.

  3. Connectez-vous à Office 365 lorsque vous êtes invité à créer une connexion.

  4. Entrez l’adresse e-mail à laquelle envoyer l’alerte dans le champ À.

  5. Dans le champ Objet, créez le texte d’objet en entrant du texte statique et en incluant le contenu extrait de la charge utile de l’alerte en choisissant des champs dans la liste Contenu dynamique.

    Par exemple :

    • Alerte : sélectionnez alertRule dans la liste Contenu dynamique.
    • avec la gravité : sélectionnez gravité dans la liste Contenu dynamique.
    • a la condition : sélectionnez monitorCondition dans la liste Contenu dynamique.
  6. Créez le corps de l’e-mail en entrant du texte statique et en incluant le contenu extrait de la charge utile de l’alerte en choisissant des champs dans la liste Contenu dynamique.

    Par exemple :

    • Condition de surveillance : Sélectionnez monitorCondition dans la liste de contenu dynamique .
    • Date de déclenchement : sélectionnez firedDateTime dans la liste Contenu dynamique.
    • Ressources affectées : sélectionnez alertTargetIDs dans la liste Contenu dynamique.
  7. Sélectionnez Enregistrer.

    Capture d’écran du menu « Envoyer un e-mail (V2) » avec les champs À, Objet et Corps mis en surbrillance.

Vous avez créé une application logique qui envoie un e-mail à l’adresse spécifiée, avec des détails de l’alerte qui l’a déclenchée.

L’étape suivante consiste à créer un groupe d’actions afin de déclencher votre application logique.

Créer un groupe d’actions

Pour déclencher votre application logique, créez un groupe d’actions. Créez ensuite une alerte qui utilise ce groupe d’actions.

  1. Accédez à la page Azure Monitor et sélectionnez Alertes dans le volet gauche.

  2. Sélectionnez Groupes d’actions>Créer.

  3. Sélectionnez les valeurs appropriées pour l’Abonnement, le Groupe de ressources et la Région.

  4. Entrez un nom pour Nom du groupe d’actions et Nom d’affichage.

  5. Sélectionnez l’onglet Actions.

    Capture d’écran de l’onglet Informations de base de la page « Créer un groupe d’actions ».

  6. Sous l’onglet Actions, sous Type d’action, sélectionnez Application logique.

  7. Dans la section Application logique, sélectionnez votre application logique dans la liste déroulante.

  8. Définissez Activer le schéma d’alerte commun sur Oui. Si vous sélectionnez Non, le type d’alerte détermine le schéma d’alerte utilisé. Pour plus d’informations sur les schémas d’alerte, voir Schémas d’alerte spécifiques au contexte.

  9. Sélectionnez OK.

  10. Entrez un nom dans le champ Nom.

  11. Sélectionnez Vérifier + créer>Créer.

    Capture d’écran de l’onglet Actions de la page « Créer un groupe d’actions ».

Tester votre groupe d’actions

  1. Accédez à la page Azure Monitor et sélectionnez Alertes dans le volet gauche.

  2. Accédez aux groupes d’actions et sélectionnez votre application logique.

  3. Sélectionnez Tester dans la barre d’action supérieure.

  4. Sélectionnez un exemple de type d’alerte dans la liste déroulante de Sélectionner un exemple de type .

  5. Sélectionnez Test.

    Capture d’écran de la page de test des détails d’un groupe d’actions.

    L’e-mail suivant est envoyé au compte spécifié :

    Capture d’écran d’un exemple d’e-mail envoyé par la page Test.

Créez une règle en utilisant votre groupe d’actions

  1. Créez une règle d’alerte pour l’une de vos ressources.

  2. Sous l’onglet Actions de votre règle, choisissez Utiliser des groupes d’actions.

  3. Sélectionnez votre groupe d’actions dans la liste.

  4. Choisissez Sélectionner.

  5. Terminez la création de votre règle.

    Capture d’écran montrant l’onglet Actions dans le volet Créer une règle d’alerte et le volet Sélectionner des groupes d’actions.

Étapes suivantes