Article ID: 931370 - View products that this article applies to.
This article describes the features and availability of the Debug Diagnostics 1.1 tool . Additionally, this article describes how to use the Debug Diagnostics 1.1 tool to analyze and resolve application issues.
The Debug Diagnostics 1.1 tool is designed to help troubleshoot performance issues in any Win32 user-mode process. For example, the Debug Diagnostics 1.1 tool can help you troubleshoot an application that stops responding (hangs) or crashes, performs slowly, leaks memory, or has memory fragmentation issues. The Debug Diagnostics 1.1 tool also includes debugging scripts for Microsoft Internet Information Services (IIS) applications, Web data access components, Microsoft COM+ applications, and related Microsoft technologies.
The Debug Diagnostics Tool (DebugDiag) version 1.2 is now available. To obtain the Debug Diagnostic Tool v1.2, visit the following Microsoft Web site:
Debug Diagnostic Tool v1.2Note The Debug Diagnostics 1.0 tool is available as part of the IIS Diagnostics Toolkit 1.0 or as a stand-alone tool.
The Debug Diagnostics 1.1 tool uses Microsoft Component Object Model (COM) objects to provide an extensible object model. The Debug Diagnostics 1.1 tool includes a script host and a built-in reporting framework.
Components of the Debug Diagnostics 1.1 tool
The Debugging ServiceThe Debugging Service (Dbghost.exe) performs the following actions:
The Debugger HostThe Debugger Host (Dbghost.exe) hosts the Windows Symbolic Debugger Engine (Dbgeng.dll). The Debugger Host attaches processes to the Windows Symbolic Debugger Engine and generates memory dumps. The Debugger Host also hosts the primary module that is used to analyze memory dumps.
Note The Debugger Host is not dependent on the Debug Diagnostic service (Dbgsvc.exe).
The user interfacesThe user interfaces (Debugdiag.exe and Debugdiaganalysisonly.exe) in the Debug Diagnostics 1.1 tool are interfaces that are used to analyze memory dumps, automate creating control scripts, and display the status of running processes. These processes include services.
The Debug Diagnostics 1.1 tool includes three views:
How to use the Debug Diagnostics 1.1 toolBefore you start the Debug Diagnostics 1.1 tool, you must identity the kind of issue that you are experiencing. For example, determine whether the application stops responding, crashes, performs slowly, or leaks memory. After you know the kind of issue, you can configure the Debug Diagnostics 1.1 tool to gather the correct data. Then, you can use the data to determine and resolve the cause of the problem.
Debug a process crashTypically, a process crash indicates that an unhandled exception in a process or code that is running in a process has terminated the process. To debug a process crash, create a crash rule on the process. You can attach the Debug Diagnostics 1.1 tool to a specific process. The Debug Diagnostics 1.1 tool monitors the process for any exception or custom breakpoint that causes the process to terminate unexpectedly. When a crash occurs, a memory dump file is created in the folder that is specified in the rule.
For more information about how to create a crash rule, click the following article number to view the article in the Microsoft Knowledge Base:
(http://support.microsoft.com/kb/919789/ )How to use the Debug Diagnostics tool to troubleshoot an IIS process that stops unexpectedly
Debug a process that stops responding or a slow performance issueUse one of the following methods.
Method 1: Create a hang ruleThe hang monitoring feature is designed to troubleshoot IIS process performance issues. For example, you can create a hang rule to troubleshoot an issue in which pages in a Web application take longer than expected to load or do not load at all.
When you create a hang rule and then specify a process and URL to monitor, you must also specify a ping interval and a response time-out value. The Debug Diagnostics 1.1 tool sends a request to the server at configured intervals. If the server does not respond before the configured time-out, a memory dump file is generated for the specified process.
For more information about how to create a hang rule, click the following article number to view the article in the Microsoft Knowledge Base:
(http://support.microsoft.com/kb/919791/ )How to use the Debug Diagnostics Tool to troubleshoot high CPU usage by a process in IIS
Method 2: Manually create a memory dump file for the processWhen the process stops responding or performs slowly, you can manually create a memory dump file. To manually create a memory dump file for a process, right-click the process in the Processes view, and then click Create Full Userdump.
Debug memory or handle usageUse one of the following methods.
Method 1: Create a leak ruleWhen you create a leak rule against a process, the Leaktrack.dll file is injected into the process to track memory usage and handle usage over time. When you configure a memory leak rule or a handle leak rule, you can configure the Debug Diagnostics 1.1 tool to generate the memory dump file that is based on time or memory usage.
Method 2: Manually create a memory dump fileTo do this, right-click the process in the Processes view, and then click Monitor For Leaks. When the process grows to a problem size, right-click the process, and then click Create Full Userdump.
For more information about how to create a memory and handle leak rule, click the following article number to view the article in the Microsoft Knowledge Base:
(http://support.microsoft.com/kb/919790/ )How to use the IIS Debug Diagnostics tool to troubleshoot a memory leak in an IIS process
Analyze memory dump filesThe Debug Diagnostics 1.1 tool can analyze a memory dump file and generate a report file that includes the analysis. Additionally, the report file includes recommendations to resolve the problems that are identified.
The Debug Diagnostics 1.1 tool uses analysis scripts to analyze the process dump file. The following analysis scripts are used most frequently:
Article ID: 931370 - Last Review: May 7, 2012 - Revision: 3.0