How to use the Debug Diagnostics Tool to troubleshoot high CPU usage by a process in IIS

If an IIS process uses a high percentage of available CPU cycles, we recommend that you create a full memory dump file of the IIS process when IIS processes client requests. You can use the Debug Diagnostics Tool to capture and to analyze memory dump files when IIS processes client requests.

Step 1: Download and then install the Debug Diagnostics Tool v1.2

To download and then install the Debug Diagnostics Tool, visit the following Microsoft Web site:

Step 2: Configure Performance Monitor logging

To configure Performance Monitor logging, follow these steps:

1. Click Start, click Run, type the path of the Debug Diagnostics Tool, and then click OK.
   
   Note By default, the Debug Diagnostics Tool is located in the following folder:
   C:\Program Files\DebugDiag
2. On the Tools menu, click Options and Settings.
3. On the Performance Log tab, click Enable Performance Counter Data Logging, and then click OK.
   
   Note The value in the Data Sampling Interval box depends on when the high CPU usage issue occurs. The size of the log grows as the data is gathered. Contact a Microsoft Support Professional for information about how to configure the value in the Data Sampling Interval box.

Step 3: Disable Debug Exception Catching

Note If you are configuring the Debug Diagnostics Tool to use the tool with IIS 6.0 or higher, go to "Step 4: Create a dump file."

If you are configuring the Debug Diagnostics Tool to use the tool with IIS 5.1 or with IIS 5.0, disable Debug Exception Catching. To do this, follow these steps:

1. Click Start, click Run, type Inetmgr.exe, and then click OK.
2. Right-click the computer that you want to configure, and then click Properties.
3. In the Master Properties list, click WWW Service, and then click Edit.
4. On the Home Directory tab, click Configuration.
5. On the Process Options tab, click to clear the Enable debug exception catching check box, and then click OK.

Step 4: Create a dump file

To create a dump file, use one of the following methods.

Method 1: Create a hang rule

To create a hang rule, follow these steps:

1. Click Start, click Run, type the path of the Debug Diagnostics Tool, and then click OK.
   
   Note By default, the Debug Diagnostics Tool is located in the following folder:
   C:\Program Files\DebugDiag
2. On the Rules tab, click Add Rule.
3. Click Performance, and then HTTP Response Times, and then click Next.
4. Click Add URL, select either the ETW or Ping options, type the URL of the Web site in which you experience the issue, set the appropriate timeout and Ping times, and then click OK. Then, click Yes to test the URL.
5. Click OK, and then click Next.
6. Click Add Dump Target.
7. In the Target Type list, click the target type that you want, click OK, and then click Next.
8. Type a name for the rule, type a path for the user dump file location, and then click Next.
9. Click Activate the rule now, and then click Finish.
   
   On the Rules tab, notice that the rule is Active in the Status column.

Method 2: Create an IIS Hang Dump file manually

To create an IIS Hang Dump file manually, follow these steps:

1. Click Start, click Run, type the path of the Debug Diagnostics Tool, and then click OK.
   
   Note By default, the Debug Diagnostics Tool is located in the following folder:
   C:\Program Files\DebugDiag
2. On the Tools menu, click Create IIS/COM+ Hang Dump.

Method 3: Create a user dump file for a process in the Debug Diagnostics Tool

To create a user dump file for a process, follow these steps:

1. Click Start, click Run, type the path of the Debug Diagnostics Tool, and then click OK.
   
   Note By default, the Debug Diagnostics Tool is located in the following folder:
   C:\Program Files\DebugDiag
2. On the Processes tab, right-click the process that you want to troubleshoot, and then click Create Full Userdump.

Step 5: Disable Performance Monitor logging

Approximately two minutes after the user dump file capture process is finished, disable Performance Monitor logging. To do this, follow these steps:

1. Click Start, click Run, type the path of the Debug Diagnostics Tool, and then click OK.
   
   Note By default, the Debug Diagnostics Tool is located in the following folder:
   C:\Program Files\DebugDiag
2. On the Tools menu, click Options and Settings.
3. On the Performance Log tab, click Disable Performance Counter Data Logging.

Step 6: Analyze the dump file

To analyze the dump file, follow these steps:

1. Click Start, click Run, type the path of the Debug Diagnostics Tool, and then click OK.
   
   Note By default, the Debug Diagnostics Tool is located in the following folder:
   C:\Program Files\DebugDiag
2. On the Advanced Analysis tab, click Add Data Files.
3. Locate and then click the dump file that you want to analyze. Click Open.
4. On the Advanced Analysis tab, click Crash/Hang Analyzers, and then click Start Analysis.
5. Review the report that is displayed in Microsoft Internet Explorer. A copy of this report is also stored in the following folder:
   C:\Program Files\DebugDiag\Reports

Note If you want to troubleshoot a custom .dll file, include the custom .pdb files. To include the custom .pdb files, click Tools, click Options and Settings, click Folder and Search Paths, type the path in the Symbol Search Path for Debugging box, and then click OK.