Partager via

Suivi des dépendances dans Application Insights

Une dépendance est un composant externe appelé par votre application. Il s’agit habituellement d’un service appelé à l’aide de HTTP, d’une base de données ou d’un système de fichiers. Application Insights mesure la durée des appels de dépendances et indique s’il échoue ou non, et collecte des informations telles que le nom de la dépendance. Vous pouvez examiner des appels de dépendances spécifiques et les mettre en corrélation avec les requêtes et les exceptions.

Dépendances suivies automatiquement

Cette section établit un lien vers des listes d’appels de dépendances détectés automatiquement en tant que dépendances sans nécessiter de modification supplémentaire du code de votre application. Ces dépendances sont visualisées dans les vues Cartographie d’application et Diagnostics des transactions d’Application Insights.

Si votre dépendance n’est pas dans la liste, vous pouvez toujours la suivre manuellement, voir Suivre manuellement les dépendances.

Pour obtenir la liste de toutes les dépendances autocollectées, consultez les onglets spécifiques au langage dans Ajouter et modifier Azure Monitor OpenTelemetry pour .NET, Java, Node.jset les applications Python.

Comment fonctionne le suivi automatique des dépendances ?

Les dépendances sont collectées automatiquement à l’aide de l’une des techniques suivantes, en fonction de la méthode de collecte de données de télémétrie.

  • Les bibliothèques d’instrumentation OpenTelemetry sont utilisées pour collecter automatiquement des dépendances telles que les appels HTTP, SQL et azure SDK. Ces bibliothèques se connectent à des infrastructures et des bibliothèques clientes prises en charge à l’aide ou à DiagnosticSource des mécanismes équivalents.

  • Dans les environnements pris en charge comme Azure App Services, la saisie automatique est disponible et activée par défaut, en injectant des collecteurs de données de télémétrie au moment de l’exécution sans modification du code.

  • Dans d’autres environnements, les développeurs peuvent configurer manuellement l’instrumentation à l’aide des packages Azure.Monitor.OpenTelemetry.* et des API OpenTelemetry pour contrôler les dépendances suivies et la façon dont elles sont enrichies ou filtrées.

Suivre manuellement les dépendances

Vous pouvez suivre manuellement les dépendances lorsque la collecte automatique ne répond pas à vos besoins.

Conseil / Astuce

Pour les nouveaux projets, nous vous recommandons d’utiliser OpenTelemetry pour une meilleure flexibilité et une meilleure compatibilité future.

Pour savoir comment suivre manuellement les dépendances, consultez Ajouter et modifier Azure Monitor OpenTelemetry pour .NET, Java, Node.jset les applications Python.

Où trouver des données sur les dépendances

Les outils et vues suivants dans Application Insights facilitent l’exploration et l’analyse des données de télémétrie des dépendances :

Points de vue Descriptif
Plan de l’application Offre une représentation visuelle des dépendances de votre application et de leurs relations avec les services externes.
Transaction Diagnostics Affiche les détails des transactions de bout en bout, en utilisant des opérations côté serveur avec des appels de dépendance.
Onglet Navigateur dans les affichages d’échecs et de performances Met en surbrillance les appels AJAX à partir des navigateurs clients.
Onglet Serveur dans les vues d’échecs et de performances Vous permet d’explorer les demandes de serveur lentes ou ayant échoué et d’inspecter les appels de dépendance associés.

Consultez des exemples de suivi des demandes vers les dépendances et des demandes ayant échoué associées aux appels ayant échoué aux dépendances.
Journaux Azure Monitor Active l’interrogation et l’analytique avancées sur la télémétrie des dépendances.

Consultez des exemples pour suivre les dépendances à l’aide de KQL.

Diagnostiquer les requêtes lentes

Chaque événement de requête est associé aux appels de dépendance, aux exceptions et aux autres événements suivis lors du traitement de la requête. Ainsi, si certaines demandes échouent, vous pouvez savoir si cela est dû à la lenteur des réponses d’une dépendance.

Effectuer une trace des requêtes vers les dépendances

Sélectionnez l’onglet Performances à gauche, puis l’onglet Dépendances en haut.

Sélectionnez un Nom de dépendance sous Général. Après avoir sélectionné une dépendance, vous voyez un graphique de la distribution des durées de cette dépendance.

Capture d’écran montrant l’onglet Dépendances ouvert pour sélectionner un nom de dépendance dans le graphique.

Sélectionnez le bouton Exemples en bas à droite. Sélectionnez ensuite un exemple pour afficher les détails de la transaction de bout en bout.

Capture d’écran montrant la sélection d’un exemple pour afficher les détails de la transaction de bout en bout.

Profiler votre site en ligne

Le profileur .NET trace les appels HTTP vers votre site en direct et vous montre les fonctions de votre code qui ont pris le plus de temps.

Requêtes échouées

Les requêtes ayant échoué peuvent également être associées à des appels échoués aux dépendances.

Sélectionnez l’onglet Défaillances à gauche, puis l’onglet Dépendances en haut.

Capture d’écran montrant la sélection du graphique des requêtes ayant échoué.

Vous voyez ici le nombre de dépendances ayant échoué. Pour plus d’informations sur une occurrence ayant échoué, sélectionnez un nom de dépendance dans le tableau du bas. Sélectionnez le bouton Dépendances en bas à droite pour afficher les détails de la transaction de bout en bout.

Journaux (Analytics)

Vous pouvez suivre les dépendances dans le langage de requête Kusto. Voici quelques exemples.

  • Rechercher les appels de dépendances ayant échoué :

    dependencies | where success != "True" | take 10

  • Rechercher les appels AJAX :

    dependencies | where client_Type == "Browser" | take 10

  • Rechercher les appels de dépendance associés aux requêtes :

    dependencies
| where timestamp > ago(1d) and  client_Type != "Browser"
| join (requests | where timestamp > ago(1d))
    on operation_Id

  • Rechercher les appels AJAX associés à des pages consultées :

    dependencies
| where timestamp > ago(1d) and  client_Type == "Browser"
| join (browserTimings | where timestamp > ago(1d))
    on operation_Id

Kit de développement logiciel (SDK) open source

Comme chaque SDK Application Insights, le module de collecte des dépendances est également open source. Lisez et contribuez au code, ou signalez les problèmes rencontrés dans le dépôt GitHub officiel.

Étapes suivantes

  • Last updated on