Surveiller et suivre les messages business-to-business dans les flux de travail de consommation pour Azure Logic Apps avec Azure Monitor

S’applique à : Azure Logic Apps (Consommation)

Note

Cet article s’applique uniquement aux flux de travail d’applications logiques Consommation. Pour les flux de travail d’application logique standard, consultez :

• Activer ou ouvrir Application Insights après le déploiement pour les flux de travail Standard
• Surveiller et suivre les transactions B2B dans les flux de travail Standard

Après avoir configuré la communication B2B entre les partenaires commerciaux dans un compte d’intégration, ces partenaires peuvent échanger des messages à l’aide de protocoles tels que AS2, X12 et EDIFACT. Si vous souhaitez confirmer que cette communication fonctionne comme prévu, configurez les journaux Azure Monitor pour votre compte d’intégration.

Azure Monitor vous aide à surveiller vos environnements cloud et locaux afin que vous puissiez gérer plus facilement leur disponibilité et leurs performances. En utilisant les journaux Azure Monitor, vous pouvez enregistrer et stocker des données sur les données et événements d’exécution, tels que les événements déclencheurs, les événements d’exécution et les événements d’action dans un espace de travail Log Analytics.

Pour les messages, la journalisation collecte également les informations suivantes :

• Nombre de messages et état
• État des accusés de réception
• Corrélations entre les messages et les accusés de réception
• Descriptions détaillées des erreurs en cas de défaillances

Azure Monitor vous permet de créer des requêtes de journal qui vous aident à trouver et à passer en revue ces informations. Vous pouvez également utiliser ces données de diagnostic avec d’autres services Azure, tels que Stockage Azure et Azure Event Hubs.

Ce guide montre comment configurer la journalisation Azure Monitor pour votre compte d’intégration. Vous installez d’abord la solution Logic Apps B2B dans le portail Azure. Cette solution fournit des informations agrégées pour les événements de message B2B. Ensuite, pour activer la journalisation et la création de requêtes, vous apprenez à configurer les journaux Azure Monitor.

Pour plus d’informations, consultez :

• Vue d’ensemble d’Azure Monitor
• Vue d’ensemble de Journaux d’activité Azure Monitor
• Destinations des journaux des ressources
• Requêtes de journalisation dans Azure Monitor
• Envoyer des données de diagnostic à Stockage Azure et Azure Event Hubs

Note

Cet article a récemment été mis à jour pour utiliser le terme journaux d’activité Azure Monitor au lieu de Log Analytics. Les données de journal sont toujours stockées dans un espace de travail Log Analytics, et elles sont toujours collectées et analysées par le même service Log Analytics. Nous mettons la terminologie à jour pour mieux refléter le rôle des journaux d’activité dans Azure Monitor. Pour plus d'informations, consultez Modifications de la terminologie d'Azure Monitor.

Prerequisites

• Un compte Azure avec un abonnement actif. Si vous n’avez pas d’abonnement, créez un compte gratuit.

• Un espace de travail Log Analytics. Si vous n’avez pas d’espace de travail Log Analytics, consultez Créer un espace de travail Log Analytics.

• Une ressource d’application logique Consommation qui est configurée pour la journalisation d’Azure Monitor et dispose d’un workflow avec les messages B2B que vous souhaitez monitorer.

  Votre flux de travail envoie des informations de journalisation à un espace de travail Log Analytics ou à une autre destination souhaitée.

• Un compte d’intégration lié à votre ressource d’application logique.

Installer la solution Logic Apps B2B

Pour suivre les messages B2B liés à votre application logique avec les journaux Azure Monitor, vous devez ajouter la solution Logic Apps B2B à votre espace de travail Log Analytics.

1. Dans la zone de recherche du portail Azure, entrez Espaces de travail Log Analytics, puis sélectionnez Espaces de travail Log Analytics.

   

2. Sous Espaces de travail Log Analytics, sélectionnez votre espace de travail.

   

3. Dans la page Vue d’ensemble , sous Prise en main des solutions de supervision de Log Analytics>, sélectionnez Afficher les solutions.

   

4. Dans la page Vue d’ensemble , sélectionnez Ajouter.

5. Une fois la Place de marché ouverte, dans la zone de recherche, entrez logic apps b2b, puis sélectionnez Logic Apps B2B.

   

6. Dans le volet description de la solution, sélectionnez Créer.

   

7. Passez en revue et confirmez l’espace de travail Log Analytics dans lequel vous souhaitez installer la solution, puis sélectionnez Créer à nouveau.

   

   Azure déploie la solution dans le groupe de ressources Azure qui contient votre espace de travail Log Analytics.

8. Accédez à votre espace de travail Log Analytics, dans la page Vue d’ensemble , sous l’onglet Prise en main , sélectionnez à nouveau Afficher les solutions pour afficher la solution installée. Sélectionnez la vignette de solution pour afficher plus de détails sur les messages.

   Lorsque le flux de travail traite les messages B2B, les graphiques sont mis à jour avec le nombre de messages.

   

Configurer les journaux Azure Monitor

Vous pouvez activer la journalisation Azure Monitor directement à partir de votre compte d’intégration.

1. Dans le portail Azure, recherchez et sélectionnez votre compte d’intégration.

   

2. Dans la barre latérale du compte d’intégration, sous Surveillance, sélectionnez Paramètres de diagnostic. Sous la table Des paramètres de diagnostic , sélectionnez Ajouter un paramètre de diagnostic.

   

3. Pour créer le paramètre, procédez comme suit :

   1. Pour le nom du paramètre de diagnostic, indiquez un nom.

   2. Sous Détails de la destination, sélectionnez Envoyer à l’espace de travail Log Analytics.

   3. Pour l’abonnement, sélectionnez l’abonnement Azure pour votre espace de travail Log Analytics.

   4. Pour l’espace de travail Log Analytics, sélectionnez l’espace de travail que vous souhaitez utiliser.

   5. Sous Journaux, sélectionnez Événements de suivi de compte d’intégration, qui spécifie la catégorie d’événement que vous souhaitez enregistrer.

   6. Lorsque vous avez terminé, dans la barre d’outils, sélectionnez Enregistrer.

   Par exemple:

   

Afficher l’état du message

Une fois votre flux de travail exécuté, vous pouvez afficher l’état et les données des messages B2B échangés par des partenaires.

1. Dans la zone de recherche du portail Azure , recherchez et ouvrez le groupe de ressources de votre espace de travail Log Analytics.

2. Dans le groupe de ressources, sélectionnez la solution Logic Apps B2B que vous avez installée précédemment.

3. Dans la barre latérale de la solution, sélectionnez Résumé.

   

   Note

   Si la vignette Logic Apps B2B n’affiche pas immédiatement les résultats après une exécution, essayez d’actualiser le navigateur ou d’attendre un court instant avant de réessayer.

   Par défaut, la vignette Logic Apps B2B affiche les données basées sur un seul jour. Pour modifier l’étendue des données à un intervalle différent, sélectionnez le contrôle d’étendue en haut de la page :

   

4. Une fois le tableau de bord d’état du message affiché, vous pouvez afficher plus de détails pour un type de message spécifique, qui affiche les données basées sur une seule journée. Sélectionnez la vignette as2, X12 ou EDIFACT.

   

   Une liste de messages s’affiche pour votre vignette choisie. Par exemple, voici à quoi ressemble une liste de messages AS2 :

   

   Pour en savoir plus sur les propriétés de chaque type de message, consultez les descriptions des propriétés de message suivantes :

   • Propriétés du message AS2
   • Propriétés du message X12
   • Propriétés du message EDIFACT

Descriptions des propriétés et formats de nom pour les messages AS2, X12 et EDIFACT

Pour chaque type de message, voici les descriptions de propriétés et les formats de nom pour les fichiers de message téléchargés.

Descriptions des propriétés de message AS2

Voici les descriptions des propriétés pour chaque message AS2.

Propriété	Descriptif
Expéditeur	Partenaire invité spécifié dans Paramètres de réception ou partenaire hôte spécifié dans Paramètres d’envoi pour un contrat AS2
Récepteur	Partenaire hôte spécifié dans Paramètres de réception ou partenaire invité spécifié dans Paramètres d’envoi pour un contrat AS2
Application logique	Application logique où les actions AS2 sont configurées
État	État du message AS2 Réussite = Reçu ou envoyé un message AS2 valide. Aucune notification de destruction de message (MDN) n’est configurée. Réussite = Reçu ou envoyé un message AS2 valide. MDN est configuré et reçu ou envoyé. Échec = Réception d’un message AS2 non valide. Aucun MDN n’est configuré. En attente = Reçu ou envoyé un message AS2 valide. Un MDN est configuré et attendu.
ACK	État du message MDN Accepté = Reçu ou envoyé un MDN positif. En attente = Attente de réception ou d’envoi d’un MDN. Rejeté = Reçu ou envoyé un MDN négatif. Non requis = MDN n'est pas mis en place dans l'accord.
Direction	Direction du message AS2
ID de suivi	ID qui met en corrélation tous les déclencheurs et actions dans une application logique
ID de message	Identifiant de message AS2 depuis les en-têtes de message AS2
Timestamp	Heure à laquelle l’action AS2 a traité le message

Descriptions des propriétés de message X12

Voici les descriptions des propriétés pour chaque message X12.

Propriété	Descriptif
Expéditeur	Partenaire invité spécifié dans Paramètres de réception ou partenaire hôte spécifié dans Paramètres d’envoi pour un contrat X12
Récepteur	Partenaire hôte spécifié dans Paramètres de réception ou partenaire invité spécifié dans Paramètres d’envoi pour un contrat X12
Application logique	Application logique où les actions X12 sont configurées
État	État du message X12 Réussite = Reçu ou envoyé un message X12 valide. Aucun accusé de réception fonctionnel configuré. Réussite = Reçu ou envoyé un message X12 valide. Accusé de réception fonctionnel configuré et reçu ou envoyé. Échec = Reçu ou envoyé un message X12 non valide. En attente = Reçu ou envoyé un message X12 valide. Accusé de réception fonctionnel configuré et attendu.
ACK	État de l’accusé de réception fonctionnel (997) Accepted = a reçu ou envoyé un accusé de réception positif. Rejected = a reçu ou envoyé un accusé de réception négatif. Pending = attendait un accusé de réception fonctionnel mais ne l’a pas reçu. Pending = a généré un accusé de réception fonctionnel mais ne peut pas l’envoyer au partenaire. Not Required = l’accusé de réception fonctionnel n’est pas configuré.
Direction	Direction du message X12
ID de suivi	ID qui met en corrélation tous les déclencheurs et actions dans une application logique
Type de message	Type de message EDI X12
ICN	Numéro de contrôle de l’échange pour le message X12
TSCN	Numéro de contrôle de l'ensemble des transactions pour le message X12
Timestamp	Heure à laquelle l’action X12 a traité le message

Descriptions des propriétés de message EDIFACT

Voici les descriptions des propriétés pour chaque message EDIFACT.

Propriété	Descriptif
Expéditeur	Partenaire invité spécifié dans Paramètres de réception ou partenaire hôte spécifié dans Paramètres d’envoi pour un contrat EDIFACT
Récepteur	Partenaire hôte spécifié dans Paramètres de réception ou partenaire invité spécifié dans Paramètres d’envoi pour un contrat EDIFACT
Application logique	Application logique où les actions EDIFACT sont configurées
État	État du message EDIFACT Réussite = Reçu ou envoyé un message EDIFACT valide. Aucun accusé de réception fonctionnel configuré. Réussite = Reçu ou envoyé un message EDIFACT valide. Accusé de réception fonctionnel configuré et reçu ou envoyé. Échec = Reçu ou envoyé un message EDIFACT non valide En attente = Reçu ou envoyé un message EDIFACT valide. Accusé de réception fonctionnel configuré et attendu.
ACK	État de l’accusé de réception fonctionnel (CONTRL) Accepted = a reçu ou envoyé un accusé de réception positif. Rejected = a reçu ou envoyé un accusé de réception négatif. Pending = attendait un accusé de réception fonctionnel mais ne l’a pas reçu. Pending = a généré un accusé de réception fonctionnel mais ne peut pas l’envoyer au partenaire. Not Required = l’accusé de réception fonctionnel n’est pas configuré.
Direction	Direction du message EDIFACT
ID de suivi	ID qui met en corrélation tous les déclencheurs et actions dans une application logique
Type de message	Type de message EDIFACT
ICN	Numéro de contrôle d'interchange pour le message EDIFACT
TSCN	Numéro de contrôle de document informatisé pour le message EDIFACT
Timestamp	Heure à laquelle l’action EDIFACT a traité le message

Contenu connexe

• Créer des requêtes de monitoring et de suivi