Problèmes connus et dépannage pour la capture instantanée de débogage dans Visual StudioTroubleshooting and known issues for snapshot debugging in Visual Studio

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

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

Si vous voyez une icône d’avertissement icône d’avertissement Snappoint avec votre snappoint au lieu de l’icône snappoint régulière, puis le snappoint 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.

N’active pas SnappointSnappoint does not turn on

Effectuez les étapes suivantes :Take these steps:

  1. Assurez-vous que vous avez la même version de code source qui a été utilisée 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, consultez la Modules fenêtre lors du débogage de l’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. Notez que le débogueur d’instantané tente de se télécharger automatiquement et d’utiliser des symboles pour votre déploiement.Note that 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 suite de 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

Effectuez les étapes suivantes :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 de capture instantanée après que le chemin d’accès des symboles a été définie.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 du Service d’applications.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, l’élément de configuration/CD avec VSTS ou Kudu, etc.) publiera les fichiers de symboles sur votre service de l’application.Most deployments (deployment through Visual Studio, CI/CD with VSTS or Kudu, etc.) will publish your symbol files along to your App Service. Définir le 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 de 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 peux pas voir l’option « Attacher le débogueur instantané » dans l’Explorateur de CloudIssue: I cannot see the "Attach Snapshot Debugger" option in the Cloud Explorer

Effectuez les étapes suivantes :Take these steps:

  • Vérifiez que le composant de débogueur de l’instantané est installé.Make sure the Snapshot Debugger component is installed. Ouvrez le programme d’installation Visual Studio et vérifiez la instantané débogueur 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 vers les Services d’application Azure 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 ne vois limitée des instantanés dans les outils de DiagnosticIssue: I only see Throttled Snapshots in the Diagnostic Tools

THROTTLED snappointThrottled snappoint

Effectuez les étapes suivantes :Take these steps:

  • Instantanés occupent très peu de mémoire, mais ont une charge dédiée.Snapshots take up very little memory but do have a commit charge. Si le débogueur de l’instantané détecte que votre serveur est soumis à une charge mémoire élevée, il ne prendra pas des instantanés.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 l’instantané, 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 Visual Studio sur le même Service d’application 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 de 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 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 logpoints 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 de l’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 de l’API de capture instantanée n’est pas pris en charge actuellement.Snapshot debugging API Apps is not currently supported.

Mise à niveau des extensions de siteSite Extension Upgrade

Débogage de l’instantané et Application Insights dépendent un ICorProfiler qui est chargé 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 vous recommandons de ce processus afin de ne garantir 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 de déployer votre site vers l’emplacement.Create a Deployment Slot within your App Service and deploy your site to the Slot.
  • Remplacez l’emplacement de production à partir de l’Explorateur de Cloud 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. Cette opération 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 à partir du site Kudu ou le portail Azure (Panneau de Service de l’application > Outils de développement > Extensions > mise à 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 direct à l’aide du débogueur de l’instantanéDebug live ASP.NET apps using the Snapshot Debugger
FAQ pour le débogage d’instantanéFAQ for snapshot debugging