Collect diagnostic data while testing
Azure Test Plans | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 | TFS 2017
Collect diagnostic data while testing your apps. This data will be included in the bugs you file during the test. You can collect diagnostic data from web apps and from desktop apps, and view it in Azure Test Plans or Team Foundation Server.
- You must connect to a project. If you don't have a project yet, create one.
- You must be added to a project. To get added, Add users to a project or team.
- To request or provide feedback, you must have Stakeholder access or higher.
- To add or modify bugs or other work item types, you must have the Edit work items in this node permission set to Allow under the corresponding Area Path.
- To add new tags, you must have the Create tag definition permission set to Allow.
To learn more, see Set permissions and access for testing.
Collect diagnostic data from web and desktop apps
For web apps under test, you can use web-based Microsoft Test Runner. For desktop apps, download and install the Test Runner desktop client to collect the following data on demand:
Capture annotated screenshots from your app:
Open Test Runner and choose the Capture screenshot icon. Ensure that the app from which you want to capture data is selected.
Drag to select the area of the screen you want to capture, or just capture the full screen.
If required, edit the title of the screenshot and add annotations and text to it using the icons in the toolbar.
Save your screenshot.
Image action log
Capture your interactions with the web or desktop app as an image action log that provides context:
Open or switch to the Test Runner and choose the Capture user actions... icon. Ensure that the app from which you want to capture data is selected.
The Test Runner will now record all the actions you take on the app's browser tab or in the desktop app.
If you create a bug while recording your actions, all the data collected up to that point will be included in the bug.
Finish capturing your actions by choosing the Stop button. The action log is added to the test results as an attachment.
Choose the ActionLog... link at the bottom of the window to view the data captured in the action log.
The log opens in your web browser.
Capture screen recordings from your apps:
Open or switch to the Test Runner and choose the Record screen icon.
Choose the entire screen, or choose an app to start recording.
If you create a bug while recording your screen, the recording automatically stops and is added to the bug.
Finish recording your actions by choosing the Stop button. The recording is added to the test results as an attachment.
If you do not stop the recording after ten minutes, it stops automatically and is saved as an attachment to your test results. Restart the recording the Record screen icon if required.
Choose the ScreenRecording... link at the bottom of the window to view the captured recording.
View the diagnostic data
When you create a bug while capturing diagnostic data, all the data captured up to that point is included in the bug that is created. You can view it before you save the bug.
If you want to collect advanced diagnostic data such as code coverage, IntelliTrace, and Test Impact data in addition to the data items listed above, you must configure the data collectors and other run settings in Microsoft Test Manager and run your tests using Microsoft Test Manager. For more details, see Run manual tests with Microsoft Test Manager.
If you have an older version of Microsoft Test Manager, we recommend you upgrade to the latest version. However, if you have Microsoft Test Manager 2015 or an earlier version installed, you can choose Microsoft Test Runner 2015 and earlier when you launch the test runner using Run with options. You must configure the data collectors and other run settings in Microsoft Test Manager and specify these as the default settings for the test plan. For more details, see Run manual tests with Microsoft Test Manager.