| title | Get Full Memory Dump to troubleshoot SSMS |
|---|---|
| Description | Troubleshooting an SSMS hang or crash by collecting a full memory dump |
| ms.prod | sql |
| ms.prod_service | sql-tools |
| ms.technology | ssms |
| ms.topic | conceptual |
| ms.assetid | c28ffa44-7b8b-4efa-b755-c7a3b1c11ce4 |
| author | markingmyname |
| ms.author | maghan |
| ms.reviewer | dineth, sstein |
| ms.custom | seo-lt-2019 |
| ms.date | 05/17/2019 |
[!INCLUDEApplies to]
In this article, you learn how to capture diagnostic information to troubleshoot a crash or a hang that you experienced from SQL Server Management Studio (SSMS).
To capture diagnostic information to troubleshoot, follow the steps below.
-
Download ProcDump.
-
Unzip the download into a folder.
-
Open a Command Prompt (such as
cmd.exe), and run the following command.<PathToProcDumpFolder>\procdump.exe -e -h -ma -w ssms.exeIt should prompt you to accept a license agreement, select Agree.
-
Start SQL Server Management Studio (SSMS) if not started already.
-
Reproduce your issue.
-
The text should appear in the cmd prompt about writing the dump file, wait for that to finish.
-
Create a new folder and copy the *.dmp file that is written out to that folder.
-
Copy the following files into the same folder.
- "C:\Windows\Microsoft.NET\Framework\v4.0.30319\mscordacwks.dll"
- "C:\Windows\Microsoft.NET\Framework\v4.0.30319\SOS.dll"
- "C:\Windows\Microsoft.NET\Framework\v4.0.30319\clr.dll"
-
Zip up the folder.
You can also get the Full Memory Dump of SSMS when it throws an OutOfMemoryException (can be any managed exception).
To capture diagnostic information to troubleshoot an OutOfMemoryException from SSMS, Follow the steps below.
-
Download ProcDump.
-
Unzip the download into a folder.
-
Open Command Prompt and run the following command.
<PathToProcDumpFolder>\procdump.exe -e 1 -f System.OutOfMemoryException -ma -w ssms.exe
It should prompt you to accept a license agreement, select Agree.
-
Start SQL Server Management Studio if not started already.
-
Repro the issue.
-
The text should appear in the cmd prompt about writing the dump file, wait for that to finish.
-
Create a new folder and copy the *.dmp file that is written out to that folder.
-
Copy the following files into the same folder.
- "C:\Windows\Microsoft.NET\Framework\v4.0.30319\mscordacwks.dll"
- "C:\Windows\Microsoft.NET\Framework\v4.0.30319\SOS.dll"
- "C:\Windows\Microsoft.NET\Framework\v4.0.30319\clr.dll"
-
Zip up the folder.
-
To share the information with the SSMS Team, log the issue at https://aka.ms/sqlfeedback.
-
Then share the memory dump file collected to OneDrive (or equivalent) where the file can be collected.
[!Important] Memory dump files may contain sensitive information.