Skip to content

Commit bc4cdc3

Browse files
authored
Merge pull request #315 from nikhilrj/patch-2
Snapshot Debugger updates tied to VS15.5
2 parents 27081b8 + d9cfd4a commit bc4cdc3

File tree

1 file changed

+7
-10
lines changed

1 file changed

+7
-10
lines changed

docs/debugger/debug-live-azure-applications.md

Lines changed: 7 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -39,25 +39,23 @@ Snapshot collection is available for the following web apps running in Azure App
3939
- ASP.NET applications running on .NET Framework 4.6.1 or later.
4040
- ASP.NET Core applications running on .NET Core 2.0 or later on Windows.
4141

42-
Additionally, the Snapshot Debugger is only available for **Visual Studio Enterprise**.
42+
Additionally, the Snapshot Debugger is only available for **Visual Studio 2017 Enterprise (15.5+)**.
4343

4444
> [!NOTE]
4545
> 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.
4646
4747
## Start the Snapshot Debugger
4848

49-
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.
49+
1. Install the [Visual Studio Enterprise 15.5 Preview](https://www.visualstudio.com/en-us/news/releasenotes/vs2017-preview-relnotes) or later.
5050

51-
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.
51+
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**.
5252

53-
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**.
54-
55-
4. Open the project you would like to snapshot debug.
53+
3. Open the project you would like to snapshot debug.
5654

5755
> [!NOTE]
5856
> In order to snapshot debug, you need to open the **same version of source code** that is published to your Azure Azure App Service.
5957
60-
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.
58+
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.
6159

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

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

177175
## Known Issues
178176

177+
* Snapshot debugging with multiple Visual Studio clients against the same App Service is not currently supported.
179178
* 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.
180179
* Special variables, ie *$FUNCTION* or *$CALLER*, cannot be evaluated in conditional statements or logpoints for ASP.NET Core projects.
181-
* 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.
182-
* Snapshot Debugging against [deployment slots](https://docs.microsoft.com/en-us/azure/app-service-web/web-sites-staged-publishing) is not currently supported.
183-
* Snapshot Debugging with multiple Visual Studio clients against the same App Service is not currently supported.
180+
* 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.
184181

185182

186183
## See Also

0 commit comments

Comments
 (0)