Skip to content

Commit 83bfd9a

Browse files
committed
edits to Time Travel debugging
1 parent d87ba94 commit 83bfd9a

File tree

1 file changed

+16
-16
lines changed

1 file changed

+16
-16
lines changed

docs/debugger/debug-live-azure-virtual-machines-time-travel-debugging.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -16,22 +16,22 @@ ms.workload:
1616
---
1717
# Record and replay live ASP.NET apps on Azure virtual machines using the Snapshot Debugger
1818

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.
2020

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.
2222

2323
This feature is in preview for the release of Visual Studio 2019 with a go live license.
2424

2525
In this tutorial, you will:
2626

2727
> [!div class="checklist"]
2828
> * 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
3131
3232
## Prerequisites
3333

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**.)
3535

3636
If it's not already installed, install [Visual Studio 2019 Enterprise](https://visualstudio.microsoft.com/vs/).
3737

@@ -40,7 +40,7 @@ In this tutorial, you will:
4040

4141
## Open your project and start the Snapshot Debugger with Time Travel Debugging enabled
4242

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.
4444

4545
> [!IMPORTANT]
4646
> 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:
5252
> [!IMPORTANT]
5353
> The first time you select **Attach Snapshot Debugger** for your VM, IIS is automatically restarted.
5454
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.
5656

5757
![Snapshot debugging mode](../debugger/media/snapshot-message.png)
5858

5959
> [!NOTE]
6060
> 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.
6161
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).
6363

6464
![Check the Modules window](../debugger/media/snapshot-modules.png)
6565

66-
## Set a snappoint and Collect a Time Travel recording
66+
## Set a snappoint and collect a time travel recording
6767

6868
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.
6969

7070
![Set a snappoint](../debugger/media/time-travel-debugging-set-snappoint-settings.png)
7171

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.
7373

7474
![Collect a time travel trace to the end of the method](../debugger/media/time-travel-debugging-set-snappoint-action.png)
7575

@@ -79,17 +79,17 @@ In this tutorial, you will:
7979

8080
## Take a snapshot
8181

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.
8383

84-
## Start Debugging a Time Travel recording
84+
## Start debugging a time travel recording
8585

8686
1. When the snappoint is hit, a snapshot appears in the Diagnostic Tools window. To open this window, choose **Debug > Windows > Show Diagnostic Tools**.
8787

8888
![Open a snappoint](../debugger/media/snapshot-diagsession-window.png)
8989

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.
9191

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**.
9393

9494
![Start Debugging](../debugger/media/time-travel-debugging-step-commands.png)
9595

@@ -103,11 +103,11 @@ When a snappoint is turned on, it will capture a snapshot whenever the line of c
103103

104104
## Set a conditional snappoint
105105

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).
107107

108108
## Next steps
109109

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.
111111

112112
> [!div class="nextstepaction"]
113113
> [FAQ for snapshot debugging](../debugger/debug-live-azure-apps-faq.md)

0 commit comments

Comments
 (0)