Skip to content

Snapshot Debugger updates tied to VS15.5 #315

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Oct 10, 2017
Merged

Snapshot Debugger updates tied to VS15.5 #315

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
b9ead51
Snapshot Debugger updates tied to VS15.5
nikhilrj Oct 10, 2017
3e9529f
minor capitalization changes
Mikejo5000 Oct 10, 2017
d9cfd4a
Merge branch 'master' into patch-2
Mikejo5000 Oct 10, 2017
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 7 additions & 10 deletions docs/debugger/debug-live-azure-applications.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -39,25 +39,23 @@ Snapshot collection is available for the following web apps running in Azure App
- ASP.NET applications running on .NET Framework 4.6.1 or later.
- ASP.NET Core applications running on .NET Core 2.0 or later on Windows.

Additionally, the Snapshot Debugger is only available for **Visual Studio Enterprise**.
Additionally, the Snapshot Debugger is only available for **Visual Studio 2017 Enterprise (15.5+)**.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

#1.


> [!NOTE]
> With some additional configuration, Application Insights can automatically capture snapshots when your app hits an exception. For more information, see [Debug snapshots on exceptions in .NET apps](/azure/application-insights/app-insights-snapshot-debugger). Application Insights supports Service Fabric apps in addition to Azure App Service.

## Start the Snapshot Debugger

1. Install the [Visual Studio Enterprise 15.4 Preview](https://www.visualstudio.com/en-us/news/releasenotes/vs2017-preview-relnotes) or later. Ensure that your installation contains the Azure development workload.
1. Install the [Visual Studio Enterprise 15.5 Preview](https://www.visualstudio.com/en-us/news/releasenotes/vs2017-preview-relnotes) or later.

2. Install the [Snapshot Debugger extension](http://aka.ms/snapshotdebuggervsix) for Visual Studio. This extension will enable you to set snappoints and logpoints against apps running in Azure App Services.
2. Launch VS and open Cloud Explorer from **View > Cloud Explorer**. Then update to the latest Cloud Explorer from the **Tools > Extensions and Updates...** menu in **Updates > Visual Studio Marketplace**.

3. Launch VS and open Cloud Explorer from **View > Cloud Explorer**. Then update to the latest Cloud Explorer from the **Tools > Extensions and Updates...** menu in **Updates > Visual Studio Marketplace**.

4. Open the project you would like to snapshot debug.
3. Open the project you would like to snapshot debug.

> [!NOTE]
> In order to snapshot debug, you need to open the **same version of source code** that is published to your Azure Azure App Service.

5. In the Cloud Explorer, right click the Azure App Service your project is deployed to and select **Attach Snapshot Debugger** to start the Snapshot Debugger.
4. In the Cloud Explorer, right click the Azure App Service your project is deployed to and select **Attach Snapshot Debugger** to start the Snapshot Debugger.

![Launch the snapshot debugger](../debugger/media/snapshot-launch.png "Launch the snapshot debugger")

Expand Down Expand Up @@ -176,11 +174,10 @@ You can uninstall the Snapshot Debugger from Visual Studio by uninstalling it fr

## Known Issues

* Snapshot debugging with multiple Visual Studio clients against the same App Service is not currently supported.
* Roslyn IL Optimizations are not fully supported in ASP.NET Core projects. For some ASP.NET Core projects, you may not be able to see some variables or use some variables in conditional statements.
* Special variables, ie *$FUNCTION* or *$CALLER*, cannot be evaluated in conditional statements or logpoints for ASP.NET Core projects.
* Snapshot Debugging does not work on App Services which have [Local Caching](https://docs.microsoft.com/en-us/azure/app-service/app-service-local-cache) turned on.
* Snapshot Debugging against [deployment slots](https://docs.microsoft.com/en-us/azure/app-service-web/web-sites-staged-publishing) is not currently supported.
* Snapshot Debugging with multiple Visual Studio clients against the same App Service is not currently supported.
* Snapshot debugging does not work on App Services which have [Local Caching](https://docs.microsoft.com/en-us/azure/app-service/app-service-local-cache) turned on.


## See Also
Expand Down