Connecter à Log Analytics ou application Recommandations à partir de flux de travail dans Azure Logic Apps

S’applique à : Azure Logic Apps (Consommation)

Remarque

Le connecteur Azure Monitor Logs remplace le connecteur Azure Log Analytics et le connecteur Azure Application Insights. Ce connecteur fournit les mêmes fonctionnalités que les autres connecteurs et est la méthode recommandée pour exécuter une requête sur un espace de travail Log Analytics ou une ressource d’application Recommandations. Par exemple, lorsque vous vous connectez à votre ressource Application Recommandations, vous n’avez pas besoin de créer ou de fournir un ID d’application et une clé API. L’authentification est intégrée à l’ID Microsoft Entra.

Pour créer des flux de travail dans Azure Logic Apps qui récupèrent des données à partir d’un espace de travail Log Analytics ou d’une ressource application Recommandations dans Azure Monitor, vous pouvez utiliser le connecteur Journaux Azure Monitor.

Par exemple, vous pouvez créer un flux de travail d’application logique qui envoie des données de journal Azure Monitor dans un e-mail de votre compte Bureau 365 Outlook, créer un bogue dans Azure DevOps ou publier un message Slack. Ce connecteur fournit uniquement des actions, afin de démarrer un flux de travail, vous pouvez utiliser un déclencheur Périodicité pour spécifier une planification simple ou tout déclencheur d’un autre service.

Ce guide pratique explique comment créer un flux de travail d’application logique Consommation qui envoie les résultats d’une requête de journal Azure Monitor par e-mail.

Référence technique du connecteur

Pour plus d’informations techniques sur les opérations de ce connecteur, consultez la documentation de référence du connecteur.

Remarque

Les deux actions suivantes peuvent exécuter une requête de journal sur un espace de travail Log Analytics ou une ressource d’application Recommandations. La différence existe dans la façon dont les données sont retournées.

Action	Description
Exécuter des résultats de requête et de liste	Retourne chaque ligne comme son propre objet. Utilisez cette action quand vous voulez utiliser chaque ligne séparément dans le reste du workflow. L’action est généralement suivie d’une action Pour chaque action.
Exécuter une requête et visualiser les résultats	Retourne un fichier JPG qui représente le jeu de résultats de la requête. Cette action vous permet d’utiliser le jeu de résultats dans le reste du flux de travail en envoyant les résultats dans un e-mail, par exemple. L’action retourne uniquement un fichier JPG si la requête retourne des résultats.

Limites

• Le connecteur a les limites suivantes, que votre flux de travail peut atteindre, en fonction de la requête que vous utilisez et de la taille des résultats :

  Limite	Valeur	Notes
  Taille maximale de la réponse de requête	~16,7 Mo ou 16 Mio	L’infrastructure du connecteur détermine que la limite de taille est inférieure à la limite de l’API de requête.
  Nombre maximal d’enregistrements	500 000 enregistrements
  Délai d’expiration maximal du connecteur	110 secondes
  Délai d’expiration maximal des requêtes	100 secondes

  Pour éviter d’atteindre ces limites, essayez d’agréger des données pour réduire la taille des résultats ou d’ajuster la périodicité du flux de travail pour s’exécuter plus fréquemment sur une plage de temps plus petite. Toutefois, en raison de la mise en cache, les requêtes fréquentes avec des intervalles inférieurs à 120 secondes ne sont pas recommandées.

• Les visualisations sur la page Journaux et le connecteur utilisent différentes bibliothèques de graphiques. Par conséquent, le connecteur n’inclut actuellement pas de fonctionnalités.

Prérequis

• Un compte et un abonnement Azure. Si vous n’avez pas d’abonnement Azure, inscrivez-vous pour bénéficier d’un compte Azure gratuit.

• L’espace de travail Log Analytics ou l’application Recommandations ressource que vous souhaitez connecter.

• Flux de travail de l’application logique Consommation à partir duquel vous souhaitez accéder à votre espace de travail Log Analytics ou à votre ressource application Recommandations. Pour utiliser une action journaux Azure Monitor, démarrez votre flux de travail avec n’importe quel déclencheur. Ce guide utilise le déclencheur Périodicité.

  Remarque

  Bien que vous puissiez activer le paramètre Log Analytics dans une ressource d’application logique pour collecter des informations sur les données et les événements d’exécution, comme décrit dans le guide pratique Configurer les journaux Azure Monitor et collecter des données de diagnostic pour Azure Logic Apps, ce paramètre n’est pas nécessaire pour vous permettre d’utiliser le connecteur Journaux Azure Monitor.

• Un compte Outlook Bureau 365 pour suivre l’exemple dans ce guide. Sinon, vous pouvez utiliser n’importe quel fournisseur de messagerie disposant d’un connecteur disponible dans Azure Logic Apps.

Ajouter une action Azure Monitor Logs

1. Sur le Portail Azure, ouvrez votre flux de travail d’application logique dans le Concepteur.

2. Dans votre flux de travail où vous souhaitez ajouter l’action Journaux Azure Monitor, effectuez l’une des étapes suivantes :

   • Pour ajouter une action sous la dernière étape, sélectionnez Nouvelle étape.

   • Pour ajouter une action entre les étapes, déplacez votre pointeur sur la flèche de connexion. Cliquez sur le signe ( + ) qui s’affiche, puis sélectionnez +.

   Pour plus d’informations sur l’ajout d’une action, consultez Générer un flux de travail en ajoutant un déclencheur ou une action.

3. Sous la zone de recherche Choisir une opération, sélectionnez Standard. Dans la zone de recherche, entrez les journaux Azure Monitor.

4. Dans la liste des actions, sélectionnez l’action qui vous intéresse.

   Cet exemple continue avec l’action nommée Exécuter la requête et visualiser les résultats.

5. Dans la zone de connexion, dans la liste des locataires, sélectionnez votre locataire Microsoft Entra, puis sélectionnez Créer.

   Remarque

   Le compte associé à la connexion actuelle est utilisé ultérieurement pour envoyer l’e-mail. Pour utiliser un autre compte, sélectionnez Modifier la connexion.

6. Dans la zone d’action Exécuter la requête et visualiser les résultats , fournissez les informations suivantes :

   Propriété	Obligatoire	Value	Description
   Abonnement	Oui	<abonnement-Azure>	Abonnement Azure pour votre espace de travail Log Analytics ou application Recommandations application.
   Groupe de ressources	Oui	<Azure-resource-group>	Groupe de ressources Azure pour votre espace de travail Log Analytics ou application Recommandations.
   Type de ressource	Oui	Espace de travail Log Analytics ou application Recommandations	Type de ressource à connecter à partir de votre flux de travail. Cet exemple se poursuit en sélectionnant l’espace de travail Log Analytics.
   Nom de la ressource	Oui	<Nom-ressource Azure>	Nom de votre espace de travail Log Analytics ou de votre ressource d’application Recommandations.

7. Dans la zone Requête , entrez la requête Kusto suivante pour récupérer les données de journal spécifiées à partir des sources suivantes :

   • Espace de travail Log Analytics

     L’exemple de requête suivant sélectionne les erreurs qui se sont produites au cours du dernier jour, signale leur nombre total et les trie dans l’ordre croissant.

     Event
     | where EventLevelName == "Error" 
     | where TimeGenerated > ago(1day)
     | summarize TotalErrors=count() by Computer
     | sort by Computer asc
     

   • Ressource Application Insights

     L’exemple de requête suivant sélectionne les requêtes ayant échoué au cours du dernier jour et les met en corrélation avec des exceptions qui se sont produites dans le cadre de l’opération, en fonction de l’identificateur operation_Id . La requête segmente ensuite les résultats à l’aide de l’algorithme autocluster() .

     requests
     | where timestamp > ago(1d)
     | where success == "False"
     | project name, operation_Id
     | join ( exceptions
         | project problemId, outerMessage, operation_Id
     ) on operation_Id
     | evaluate autocluster()
     

   Remarque

   Lorsque vous créez vos propres requêtes, assurez-vous qu’elles fonctionnent correctement dans Log Analytics avant de les ajouter à votre action journaux Azure Monitor.

8. Pour l’intervalle de temps, sélectionnez Définir dans la requête.

9. Pour le type de graphique, sélectionnez Tableau Html.

10. Enregistrez votre flux de travail. Dans la barre d’outils du Concepteur, sélectionnez Enregistrer.

Ajouter une action de messagerie

1. Dans votre flux de travail où vous souhaitez ajouter l’action Bureau 365 Outlook, effectuez l’une des étapes suivantes :

   • Pour ajouter une action sous la dernière étape, sélectionnez Nouvelle étape.

   • Pour ajouter une action entre les étapes, déplacez votre pointeur sur la flèche de connexion. Cliquez sur le signe ( + ) qui s’affiche, puis sélectionnez +.

2. Sous la zone de recherche Choisir une opération, sélectionnez Standard. Dans la zone de recherche, entrez Bureau 365 envoyer un e-mail.

3. Dans la liste des actions, sélectionnez l’action nommée Envoyer un e-mail (V2).

4. Dans la zone À, entrez l’adresse e-mail du destinataire. Pour cet exemple, utilisez votre propre adresse e-mail.

5. Dans la zone Objet , entrez un objet pour l’e-mail, par exemple, les erreurs quotidiennes principales ou les échecs.

6. Dans la zone Corps, cliquez n’importe où à l’intérieur pour ouvrir la liste de contenu dynamique, qui affiche les sorties des étapes précédentes du flux de travail.

   1. Dans la liste de contenu dynamique, en regard de la requête Exécuter et visualiser le nom de la section Résultats , sélectionnez Afficher plus.

   2. Dans la liste des sorties, sélectionnez Corps, qui représente les résultats de la requête que vous avez entrée précédemment dans l’action Log Analytics.

7. Dans la liste Ajouter un nouveau paramètre , sélectionnez Pièces jointes.

   L’action Envoyer un e-mail inclut désormais les propriétés Nom et Contenu des pièces jointes.

8. Pour les propriétés ajoutées, procédez comme suit :

   1. Dans la zone Nom de pièce jointe, dans la liste de contenu dynamique qui s’affiche, sous Exécuter la requête et visualiser les résultats, sélectionnez la sortie Nom de la pièce jointe.

   2. Dans la zone Contenu de pièce jointe, dans la liste de contenu dynamique qui s’affiche, sous Exécuter la requête et visualiser les résultats, sélectionnez la sortie Contenu de la pièce jointe.

9. Enregistrez votre flux de travail. Dans la barre d’outils du Concepteur, sélectionnez Enregistrer.

Tester votre workflow

1. Dans la barre d’outils du concepteur, sélectionnez Exécuter le déclencheur>Exécuter.

2. Une fois le flux de travail terminé, case activée votre e-mail.

   Remarque

   Le flux de travail génère un e-mail avec un fichier JPG qui affiche le jeu de résultats de la requête. Si votre requête ne retourne aucun résultat, le flux de travail ne crée pas de fichier JPG.

   Pour l’exemple d’espace de travail Log Analytics, l’e-mail que vous recevez a un corps semblable à l’exemple suivant :

   

   Pour une ressource application Recommandations, l’e-mail que vous recevez a un corps semblable à l’exemple suivant :

   

Étapes suivantes

• En savoir plus sur les requêtes de journal dans Azure Monitor
• En savoir plus sur les requêtes pour Log Analytics