Skip to content

Commit 9563511

Browse files
authored
Merge content from report-a-problem-minidumps page with report-a-problem-perfview page (#8826)
* Merging creating minidumps content with ETL trace page * Update headings * fix for review comment * fix for review comments
1 parent c6853c1 commit 9563511

File tree

5 files changed

+83
-89
lines changed

5 files changed

+83
-89
lines changed

.openpublishing.redirection.json

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -90,6 +90,16 @@
9090
"redirect_url": "/visualstudio/ide/how-to-report-a-problem-with-visual-studio",
9191
"redirect_document_id": false
9292
},
93+
{
94+
"source_path": "docs/ide/report-a-problem-minidumps.md",
95+
"redirect_url": "/visualstudio/ide/report-a-problem-perfview-minidumps",
96+
"redirect_document_id": false
97+
},
98+
{
99+
"source_path": "docs/ide/report-a-problem-perfview.md",
100+
"redirect_url": "/visualstudio/ide/report-a-problem-perfview-minidumps",
101+
"redirect_document_id": true
102+
},
93103
{
94104
"source_path": "docs/data-tools/additional-resources-for-troubleshooting-data-access-errors.md",
95105
"redirect_url": "/answers/products/?WT.mc_id=msdnredirect-web-msdn",

docs/ide/report-a-problem-minidumps.md

Lines changed: 0 additions & 44 deletions
This file was deleted.
Lines changed: 71 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,71 @@
1+
---
2+
description: "PerfView is a tool that creates ETL (event trace log) files based on Event Tracing for Windows) that can be useful in troubleshooting some kinds of issues with Visual Studio."
3+
title: Collect an ETL trace with PerfView and create minidumps with all call stacks
4+
ms.date: 10/11/2021
5+
ms.topic: how-to
6+
helpviewer_keywords:
7+
- "perfview"
8+
- "ETL Trace"
9+
- minidumps for Visual Studio issues"
10+
author: corob-msft
11+
ms.author: corob
12+
manager: jmartens
13+
ms.technology: vs-ide-general
14+
dev_langs:
15+
- CSharp
16+
- VB
17+
- CPP
18+
ms.workload:
19+
- "multiple"
20+
ms.description: "Collect ETL traces using perfview.exe and create minidumps to send to Microsoft, for troubleshooting issues with Visual Studio"
21+
---
22+
# Collect an ETL trace with PerfView and create minidumps with all call stacks
23+
24+
When you report a problem with Visual Studio, the Microsoft product team might ask for an ETL trace or minidumps to collect additional information for troubleshooting. Use the following steps to collect an ETL trace or to create minidumps for all call stacks.
25+
26+
## Collect an ETL trace with PerfView
27+
28+
PerfView is a tool that creates ETL (event trace log) files based on [Event Tracing for Windows](/windows/desktop/ETW/event-tracing-portal) that can be useful in troubleshooting some kinds of issues with Visual Studio. Occasionally when you report a problem, the product team might ask you to run PerfView to collect additional information.
29+
30+
### Install PerfView
31+
32+
Download PerfView from [GitHub](https://github.com/Microsoft/perfview/blob/master/documentation/Downloading.md).
33+
34+
### Run PerfView
35+
36+
1. Right-click on **PerfView.exe** in Windows Explorer and choose **Run as administrator** as admin.
37+
1. On the Collect menu, choose **Collect**.
38+
1. Check **Zip**, **Merge**, and **ThreadTime**.
39+
1. Increase **Circular MB** to 1000.
40+
1. Change **Current Dir** to save ETL traces to a specified folder and Data File if you are going to collect more than once.
41+
1. To start recording data, choose the **Start Collection** button.
42+
1. To stop recording data, choose the **Stop Collection** button. The PrefView.etl.zip file will be saved in the specified directory.
43+
44+
PerfView can store only the most recent data that fits into its buffer. Therefore, try to stop the collection as soon as possible after Visual Studio starts to freeze or slow down. Don't collect for more than 30 seconds after you hit a problem.
45+
46+
For more information, see [PerfView Tutorial on Channel9](https://channel9.msdn.com/Series/PerfView-Tutorial/PerfView-Tutorial-1-Collecting-data-with-the-Run-command).
47+
48+
## Create minidumps for a Visual Studio process with all call stacks
49+
50+
In some cases, Microsoft might ask for a minidump of a running Visual Studio process with information for all call stacks. To collect this information, perform these steps:
51+
52+
### Create the minidump file
53+
54+
1. Start a new instance of Visual Studio.
55+
1. From the main menu, choose **Debug** > **Attach To Process**.
56+
1. Check the relevant **Managed** and **Native** check boxes and press **Attach**.
57+
58+
![Attach to process](../ide/media/attach-to-process.png)
59+
60+
1. Select the other Visual Studio instance to attach to from the list of running processes.
61+
1. From the main menu, choose **Debug** > **Break All**.
62+
1. From the main menu, choose **Debug** > **Save Dump As**.
63+
64+
### Get the call stacks from the minidump
65+
66+
1. Open the dump file in Visual Studio.
67+
1. Go to **Tools** > **Options** > **Debugging** > **Symbols** and make sure that **Microsoft Symbol Servers** is checked in the **Symbol file (.pdb) locations**.
68+
1. Open the **Command** window (**View** > **Other Windows** > **Command Window**).
69+
1. Type ‘~*k’. The window displays all threads' call stacks.
70+
1. Copy all text from Command Window and save to a text file.
71+
1. Attach the txt file to the bug.

docs/ide/report-a-problem-perfview.md

Lines changed: 0 additions & 41 deletions
This file was deleted.

docs/toc.yml

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1468,12 +1468,10 @@
14681468
href: ide/how-to-report-a-problem-with-visual-studio.md
14691469
- name: Get performance issues fixed quicker
14701470
href: ide/how-to-increase-chances-of-performance-issue-being-fixed.md
1471-
- name: Create minidumps with callstacks
1472-
href: ide/report-a-problem-minidumps.md
14731471
- name: Create logs for MSBuild problems
14741472
href: ide/msbuild-logs.md
1475-
- name: Collect an ETL trace with PerfView
1476-
href: ide/report-a-problem-perfview.md
1473+
- name: Collect an ETL trace and create minidumps
1474+
href: ide/report-a-problem-perfview-minidumps.md
14771475
- name: Suggest a feature
14781476
href: ide/suggest-a-feature.md
14791477
- name: Developer Community guidelines

0 commit comments

Comments
 (0)