You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/debugger/debug-live-azure-virtual-machines-time-travel-debugging.md
+16-16Lines changed: 16 additions & 16 deletions
Original file line number
Diff line number
Diff line change
@@ -16,22 +16,22 @@ ms.workload:
16
16
---
17
17
# Record and replay live ASP.NET apps on Azure virtual machines using the Snapshot Debugger
18
18
19
-
The Time Travel Debugging (TTD) preview in Visual Studio Enterprise provides the ability to record a Web app running on a Azure Virtual Machine (VM) and then accurately reconstruct and replay the execution path. TTD integrates with our Snapshot Debugger offering and allows you to rewind and replay each line of code however many times you want, helping you isolate and identify problems that might only occur in production environments.
19
+
The Time Travel Debugging (TTD) preview in Visual Studio Enterprise provides the ability to record a Web app running on an Azure Virtual Machine (VM) and then accurately reconstruct and replay the execution path. TTD integrates with the Snapshot Debugger and allows you to rewind and replay each line of code any number of times you want, helping you isolate and identify problems that might only occur in production environments.
20
20
21
-
Capturing a TTD recording will not halt the application, however, recording will add significant overhead to your running process, slowing it down based on factors that include the process size and the number of active threads.
21
+
Capturing a TTD recording will not halt the application. However, the TDD recording adds significant overhead to your running process, slowing it down based on factors that include the process size and the number of active threads.
22
22
23
23
This feature is in preview for the release of Visual Studio 2019 with a go live license.
24
24
25
25
In this tutorial, you will:
26
26
27
27
> [!div class="checklist"]
28
28
> * Start the Snapshot Debugger with Time Travel Debugging enabled
29
-
> * Set a snappoint and Collect a Time Travel recording
30
-
> * Start Debugging a Time Travel recording
29
+
> * Set a snappoint and collect a time travel recording
30
+
> * Start debugging a time travel recording
31
31
32
32
## Prerequisites
33
33
34
-
* Time Travel Debugging for Azure Virtual Machines (VM) is only available for Visual Studio 2019 Enterprise or higher with the **Azure development workload**. (Under the **Individual components** tab, you find it under **Debugging and testing** > **Snapshot debugger**.)
34
+
* Time Travel Debugging for Azure Virtual Machines (VM) is only available for Visual Studio 2019 Enterprise or higher with the **Azure development workload**. (Under the **Individual components** tab, you find it under **Debugging and testing** > **Snapshot debugger**.)
35
35
36
36
If it's not already installed, install [Visual Studio 2019 Enterprise](https://visualstudio.microsoft.com/vs/).
37
37
@@ -40,7 +40,7 @@ In this tutorial, you will:
40
40
41
41
## Open your project and start the Snapshot Debugger with Time Travel Debugging enabled
42
42
43
-
1. Open the project that you would like to Collect a Time Travel recording.
43
+
1. Open the project for which you would like to collect a time travel recording.
44
44
45
45
> [!IMPORTANT]
46
46
> To start TTD, you need to open the *same version of source code* that is published to your Azure VM service.
@@ -52,24 +52,24 @@ In this tutorial, you will:
52
52
> [!IMPORTANT]
53
53
> The first time you select **Attach Snapshot Debugger** for your VM, IIS is automatically restarted.
54
54
55
-
The metadata for the **Modules**will not initially be activated, navigate to the web app and the **Start Collection** button will become active. Visual Studio is now in snapshot debugging mode.
55
+
The metadata for the **Modules**is not initially activated. Navigate to the web app and the **Start Collection** button then becomes active. Visual Studio is now in snapshot debugging mode.
> The Application Insights site extension also supports Snapshot Debugging. If you encounter a "site extension out of date" error message, see [troubleshooting tips and known issues for snapshot debugging](../debugger/debug-live-azure-apps-troubleshooting.md) for upgrading details.
61
61
62
-
The **Modules** window shows you when all the modules have loaded for the Azure VM (choose **Debug > Windows > Modules** to open this window).
62
+
The **Modules** window shows you when all the modules are loaded for the Azure VM (choose **Debug > Windows > Modules** to open this window).
63
63
64
64

65
65
66
-
## Set a snappoint and Collect a Time Travel recording
66
+
## Set a snappoint and collect a time travel recording
67
67
68
68
1. In the code editor, click the left gutter in a method you are interested in to set a snappoint. Make sure it is code that you know will execute.
69
69
70
70

71
71
72
-
1. Right-click the snappoint icon (the hollow ball) and choose **Actions**. In the Snapshot Settings window click the **Action** check box. Then click the **Collect a time travel trace to the end of this method** check box.
72
+
1. Right-click the snappoint icon (the hollow ball) and choose **Actions**. In the **Snapshot Settings** window, click the **Action** check box. Then click the **Collect a time travel trace to the end of this method** check box.
73
73
74
74

75
75
@@ -79,17 +79,17 @@ In this tutorial, you will:
79
79
80
80
## Take a snapshot
81
81
82
-
When a snappoint is turned on, it will capture a snapshot whenever the line of code where the snappoint is placed executes. This execution can be caused by a real request on your server. To force your snappoint to hit, go to the browser view of your web site and take any actions required that cause your snappoint to be hit.
82
+
When a snappoint is turned on, it captures a snapshot whenever the line of code where the snappoint is placed executes. This execution may be caused by a real request on your server. To force your snappoint to hit, go to the browser view of your web site and take any actions required that cause your snappoint to be hit.
83
83
84
-
## Start Debugging a Time Travel recording
84
+
## Start debugging a time travel recording
85
85
86
86
1. When the snappoint is hit, a snapshot appears in the Diagnostic Tools window. To open this window, choose **Debug > Windows > Show Diagnostic Tools**.
87
87
88
88

89
89
90
-
1. Click the View Snapshot link to open the Time Travel recording in the code editor.
90
+
1. Click the View Snapshot link to open the time travel recording in the code editor.
91
91
92
-
You can execute every line of code recorded by the TTD by using the **Continue** and **Reverse Continue** buttons. Additionally the Debug toolbar can be used to **Show Next Statement**, **Step Into**, **Step Over**, **Step Out**, **Step Back Into**, **Step Back Over**, **Step Back Out**.
92
+
You can execute every line of code recorded by the TTD by using the **Continue** and **Reverse Continue** buttons. Additionally, the **Debug** toolbar can be used to **Show Next Statement**, **Step Into**, **Step Over**, **Step Out**, **Step Back Into**, **Step Back Over**, **Step Back Out**.
@@ -103,11 +103,11 @@ When a snappoint is turned on, it will capture a snapshot whenever the line of c
103
103
104
104
## Set a conditional snappoint
105
105
106
-
If it is difficult to recreate a particular state in your app, consider whether the use of a conditional snappoint can help. Conditional snappoints help you avoid collecting a Time Travel recording until the app enters a desired state, such as when a variable has a particular value that you want to inspect. [You can set conditions using expressions, filters, or hit counts](../debugger/debug-live-azure-apps-troubleshooting.md).
106
+
If it is difficult to recreate a particular state in your app, consider whether the use of a conditional snappoint can help. Conditional snappoints help you avoid collecting a time travel recording until the app enters a desired state, such as when a variable has a particular value that you want to inspect. [You can set conditions using expressions, filters, or hit counts](../debugger/debug-live-azure-apps-troubleshooting.md).
107
107
108
108
## Next steps
109
109
110
-
In this tutorial, you've learned how to collect a Time Travel recording for Azure Virtual Machines. You may want to read more details about Snapshot Debugger.
110
+
In this tutorial, you've learned how to collect a time travel recording for Azure Virtual Machines. You may want to read more details about Snapshot Debugger.
111
111
112
112
> [!div class="nextstepaction"]
113
113
> [FAQ for snapshot debugging](../debugger/debug-live-azure-apps-faq.md)
0 commit comments