Partager via

Voir les données du Débogueur d’instantané Application Insights

  • Article

Les instantanés apparaissent en tant qu’exceptions dans le volet Application Insights du Portail Azure. Affichez les instantanés de débogage dans le portail pour examiner la pile des appels et inspecter les variables à chaque frame de pile des appels.

Pour améliorer la puissance de débogage du code source, ouvrez les instantanés avec Visual Studio Enterprise. Vous pouvez également définir des snappoints pour prendre des captures instantanées de manière interactive sans attendre la levée d’une exception.

Prérequis

Les captures instantanées peuvent contenir des informations sensibles. Vous pouvez uniquement afficher les instantanés si le rôle Application Insights Snapshot Debugger vous a été attribué.

Accéder aux instantanés de débogage dans le portail

Après qu’une exception s’est produite dans votre application et qu’un instantané est créé, vous pouvez voir des instantanés dans le portail Azure au bout de 5 à 10 minutes.

  1. Dans votre ressource Application Insights, sélectionnez Examiner>Défaillances dans le menu de gauche.

  2. Dans le volet Défaillances, sélectionnez :

    • l’onglet Opérations ou
    • l’onglet Exceptions.

  3. Sélectionnez [x] exemples dans la colonne centrale de la page pour générer une liste d’exemples d’opérations ou d’exceptions à droite.

    Capure d’écran montrant la page des échecs dans le portail Azure.

  4. Dans la liste des exemples, sélectionnez une opération ou une exception pour ouvrir la page Détails de la transaction de bout en bout. À partir de là, sélectionnez l’événement d’exception à examiner.

    Capure d’écran montrant le bouton Ouvrir l’instantané de débogage au-dessus d’Exception.

  5. La page Instantané de débogage comprend une pile des appels avec un volet de variables locales. Sélectionnez un frame de pile des appels pour afficher les variables locales et les paramètres de cet appel de fonction dans le volet des variables.

    Capure d’écran montrant Instantané de débogage dans le portail Azure.

Télécharger des instantanés pour les afficher dans Visual Studio

Pour afficher des instantanés dans Visual Studio 2017 Enterprise ou version ultérieure :

  1. Cliquez sur le bouton Télécharger l’instantané dans la page Instantané de débogage pour télécharger un fichier .diagsession que vous pouvez ouvrir dans Visual Studio Enterprise.

  2. Dans Visual Studio, vérifiez que le composant Visual Studio Débogueur de capture instantanée est installé.

    • Pour Visual Studio 2017 Enterprise et versions ultérieures : vous pouvez sélectionner le composant Débogueur de capture instantanée requis dans la liste Composant individuel de Visual Studio Installer.
    • Pour une version antérieure à Visual Studio 2017 version 15.5 : installez l’extension à partir de Visual Studio Marketplace.

  3. Ouvrez le fichier .diagsession . La page de débogage de minidump s’affiche dans Visual Studio.

  4. Cliquez sur Debug Managed Code (Déboguer le code managé) pour démarrer le débogage de la capture instantanée. L’instantané s’ouvre sur la ligne de code où l’exception a été levée.

    Capture d’écran montrant Instantané de débogage dans Visual Studio.

L’instantané téléchargé inclut tous les fichiers de symboles trouvés sur votre serveur d’applications web. Ces fichiers de symboles sont nécessaires pour associer les données de capture instantanée au code source. Pour les applications App Service, veillez à activer le déploiement des symboles lorsque vous publiez vos applications web.

Étapes suivantes

Activez le Débogueur d’instantané dans votre :