Problèmes connus et dépannage pour le débogage d’instantané dans Visual StudioTroubleshooting and known issues for snapshot debugging in Visual Studio

Si les étapes décrites dans cet article ne résolvent pas votre problème, contactez snaphelp@microsoft.com.If the steps described in this article do not resolve your issue, contact snaphelp@microsoft.com.

Problème : Point d’ancrage n’active pasIssue: Snappoint does not turn on

Si vous voyez une icône d’avertissement icône d’avertissement de point d’ancrage avec votre point d’ancrage au lieu de l’icône de point d’ancrage standard, puis le point d’ancrage n’est pas activé.If you see a warning icon Snappoint warning icon with your snappoint instead of the regular snappoint icon, then the snappoint is not turned on.

Point d’ancrage n’active pasSnappoint does not turn on

Procédez comme suit :Take these steps:

  1. Assurez-vous que vous disposez de la même version de code source qui a été utilisé pour générer et déployer votre app.isua1.Make sure you have the same version of source code that was used to build and deploy your app.isua1. Assurez-vous que vous chargez les symboles appropriés pour votre déploiement.Make sure you are loading the correct symbols for your deployment. Pour ce faire, vous devez afficher le Modules fenêtre lors du débogage d’instantané et vérifiez que la colonne du fichier de symboles affiche un fichier .pdb chargé pour le module que vous déboguez.To do this, view the Modules window while Snapshot Debugging and verify the Symbol File column shows a .pdb file loaded for the module you are debugging. Le débogueur d’instantané tente de télécharger et utiliser des symboles pour votre déploiement automatiquement.The Snapshot Debugger will try to automatically download and use symbols for your deployment.

Problème : Les symboles ne se chargent pas lorsque j’ouvre une capture instantanéeIssue: Symbols do not load when I open a Snapshot

Si vous voyez après la fenêtre, les symboles n’a pas chargé.If you see following window, symbols did not load.

Ne pas chargent de symbolesSymbols do not load

Procédez comme suit :Take these steps:

  • Cliquez sur le modifier les paramètres des symboles...Click the Change Symbol Settings… lien de cette page.link on this page. Dans le débogage > symboles paramètres, ajoutez un répertoire de cache de symboles.In the Debugging > Symbol settings, add a symbol cache directory. Redémarrez le débogage d’instantané une fois que le chemin des symboles a été défini.Restart snapshot debugging after the symbol path has been set.

    Les symboles, ou les fichiers .pdb disponibles dans votre projet doivent correspondre à votre déploiement d’App Service.The symbols, or .pdb files, available in your project must match your App Service deployment. La plupart des déploiements (déploiement via Visual Studio, CI/CD avec Azure Pipelines ou Kudu, etc.) publiera le long de vos fichiers de symboles à votre App Service.Most deployments (deployment through Visual Studio, CI/CD with Azure Pipelines or Kudu, etc.) will publish your symbol files along to your App Service. Définition du répertoire de cache de symboles permet à Visual Studio à utiliser ces symboles.Setting the symbol cache directory enables Visual Studio to use these symbols.

    Paramètres des symbolesSymbol settings

  • Également, si votre organisation utilise un serveur de symboles ou supprime les symboles dans un autre chemin d’accès, vous pouvez utiliser les paramètres des symboles pour charger les symboles appropriés pour votre déploiement.Alternatively, if your organization uses a symbol server or drops symbols in a different path, use the symbol settings to load the correct symbols for your deployment.

Problème : je ne vois pas l’option « Attacher le débogueur instantané » dans l’Explorateur de CloudIssue: I cannot see the "Attach Snapshot Debugger" option in the Cloud Explorer

Procédez comme suit :Take these steps:

  • Assurez-vous que le composant de débogueur de capture instantanée est installé.Make sure the Snapshot Debugger component is installed. Ouvrez Visual Studio Installer et vérifiez la débogueur de capture instantanée composant dans la charge de travail Azure.Open the Visual Studio Installer, and check the Snapshot Debugger component in the Azure workload.
  • Assurez-vous que votre application est prise en charge.Make sure your app is supported. Actuellement, seuls ASP.NET (4.6.1+) et les applications ASP.NET Core (2.0 +) déployées dans Azure App Services sont pris en charge.Currently, only ASP.NET (4.6.1+) and ASP.NET Core (2.0+) apps deployed to Azure App Services are supported.

Problème : je vois seulement limité des instantanés dans les outils de DiagnosticIssue: I only see Throttled Snapshots in the Diagnostic Tools

Point d’ancrage limitéesThrottled snappoint

Procédez comme suit :Take these steps:

  • Instantanés occupent peu de mémoire mais ont un coût de la validation.Snapshots take up little memory but do have a commit charge. Si le débogueur de capture instantanée détecte que votre serveur est sous une charge de mémoire importante, il ne prendre des captures instantanées.If the Snapshot Debugger detects your server is under heavy memory load, it will not take snapshots. Vous pouvez supprimer les instantanés déjà capturées par l’arrêt de la session du débogueur de capture instantanée, puis réessayez.You can delete already captured snapshots by stopping the Snapshot Debugger session and trying again.

Problèmes connusKnown Issues

  • Débogage d’instantané avec plusieurs clients de Visual Studio sur le même plan App Service n’est pas pris en charge actuellement.Snapshot debugging with multiple Visual Studio clients against the same App Service is not currently supported.
  • Optimisations de langage intermédiaire Roslyn ne sont pas pris en charge dans les projets ASP.NET Core.Roslyn IL optimizations are not fully supported in ASP.NET Core projects. Pour certains projets ASP.NET Core, vous ne serez peut-être pas en mesure de voir certaines variables ou utiliser des variables dans les instructions conditionnelles.For some ASP.NET Core projects, you may not be able to see some variables or use some variables in conditional statements.
  • Variables spéciales, telles que $FUNCTION ou $CALLER, ne peut pas être évaluée dans des instructions conditionnelles ou des points de journalisation pour les projets ASP.NET Core.Special variables, such as $FUNCTION or $CALLER, cannot be evaluated in conditional statements or logpoints for ASP.NET Core projects.
  • Débogage d’instantané ne fonctionne pas sur les Services d’application qui ont mise en cache locale sous tension.Snapshot debugging does not work on App Services that have Local Caching turned on.
  • Débogage des applications API d’instantané n’est pas pris en charge.Snapshot debugging API Apps is not currently supported.

Mise à niveau de site ExtensionSite Extension Upgrade

Débogage d’instantané et Application Insights varient selon un ICorProfiler, qui se charge dans le processus de site et provoque des problèmes de verrouillage de fichier pendant la mise à niveau.Snapshot Debugging and Application Insights depend on an ICorProfiler, which loads into the site process and causes file locking issues during upgrade. Nous recommandons ce processus pour ne garantir l’aucun temps d’arrêt à votre site de production.We recommend this process to ensure there is no down-time to your production site.

  • Créer un emplacement de déploiement au sein de votre application de Service et déployer votre site à l’emplacement.Create a Deployment Slot within your App Service and deploy your site to the Slot.
  • Remplacez l’emplacement de production à partir de Cloud Explorer dans Visual Studio ou à partir du portail Azure.Swap the Slot with production from Cloud Explorer in Visual Studio or from the Azure portal.
  • Arrêter le site de l’emplacement.Stop the Slot site. Cela prendra quelques secondes de tuer le processus w3wp.exe de site à partir de toutes les instances.This will take a few seconds to kill off the site w3wp.exe process from all instances.
  • Mise à niveau de l’extension de site connecteur depuis le site Kudu ou le portail Azure (Panneau de Service d’application > Outils de développement > Extensions > mises à jour).Upgrade the Slot site extension from the Kudu site or the Azure portal (App Service Blade > Development Tools > Extensions > Update).
  • Démarrer le site de l’emplacement.Start the Slot site. Nous vous recommandons de visiter le site pour le préchauffage à nouveau.We recommend visiting the site to warm it up again.
  • Remplacez l’emplacement de production.Swap the Slot with production.

Voir aussiSee also

Débogage dans Visual StudioDebugging in Visual Studio
Déboguer des applications ASP.NET en production à l’aide du débogueur de capture instantanéeDebug live ASP.NET apps using the Snapshot Debugger
FAQ pour le débogage d’instantanéFAQ for snapshot debugging