dotTrace Web Help

Before you start profiling a web application make sure that:

  • IIS is installed on your computer. Otherwise you should add it.
    • Select the check box next to Internet Information Services (IIS) in Windows Components Wizard. To open the wizard, click Start, click Control Panel, click Add or Remove Programs, then click Add/Remove Windows Components. (Windows XP)
    • Select the check box next to Internet Information Services in the Windows Features dialog. To open the dialog, click Start, click Control Panel, click Programs and Features, and then click Turn Windows features on or off. (Windows 7)
  • Your web application is deployed to IIS.
  • Caching in your web browser is disabled. Alternatively, use Ctrl+F5 to manually refresh the page that is running the profiled application.

To profile a Web application using Internet Information Services
  1. Start dotTrace as a standalone application.

    Note

    Under Windows 7 run dotTrace with administrator privileges.
  2. Do one of the following:
    • On the menu bar, choose File | Profile. The Profile dialog box opens. Select IIS Application, then click OK or just double-click IIS Application.
    • Click Profile on the Home tab. Click IIS Application in the list.
    The Profiler Configuration dialog box opens. For more information, see Profiler Configuration.
  3. By default, your application is profiled on the local computer. If you want to start profiling on a remote computer, do one of the following:
    • Click Profile on remote computer to specify a remote agent url and thereby define what remote agent to use.
    • Select a remote host in the Host drop-down list and click it.
    For more information, see Profiling Remote Applications.
  4. Optionally, select the Run browser check box. After that:
    • Type the application URL in the Url text box.
    • Click the name of a browser that should be started or restarted in the Browser drop-down list.
    • If you profile on a remote computer, you can select the Open browser on remote computer check box to invoke the default browser or click the name of a browser that should be started or restarted in the Browser drop-down list. This list is updated as soon as you select the Open browser on remote computer check box.
  5. Select a profiling mode in the Profiling type drop-down list. For more information, see Choosing the Right Profiling Mode.
  6. Specify what kind of timer you want to use by selecting an item in the Measure drop-down list. For more information, see Choosing the Right Time Measurement Method.
  7. If the Start profiling immediately check box is selected, dotTrace Performance starts gathering performance data immediately after you click Run and close the current dialog. Otherwise, dotTrace Performance waits until you press Start Profiling in the dotTrace Performance Controller window. For more information, see Launching and Controlling the Profiling Process.
  8. Optionally, click the arrow to display and configure additional settings, such as High accuracy, Enable inlining, Merge threads with equal names etc.
    • Select the High accuracy check box to take into account time spent in profiler itself by taking more time samples.
    • Clear the Enable inlining check box to disable JIT-inlining in order to get call stacks that closely resemble the structure of application's source code.
    • Select the Merge threads with equals names check-box and as a result get the performance information for all threads with the same name under a single thread node in Call Tree and Threads Tree views.
    • Click Edit Filters to define in advance what functions should be filtered out and what should be profiled line by line.
    • Click Edit Symbol Search Policy to specify locations where the profiler looks for debugging information. For more information, see Edit Symbol Search Policy.
    • Select the Use profiler API check box to allow you to control profiling directly from the code of the profiled application. For more information, see Advanced Profiling Using dotTrace API.
  9. Click Run.

Warning

If you start profiling another IIS application while IIS runs, your previous profiling session is interrupted and a new one begins.
To profile a Web application using Internet Information Services Express
  1. Start dotTrace as a standalone application.
  2. Do one of the following:
    • On the menu bar, choose File | Profile. The Profile dialog box opens. Select IIS Express Application, then click OK or just double-click IIS Express Application.
    • Click Profile on the Home tab. Click IIS Express Application in the list.
    The Profiler Configuration dialog box opens. For more information, see Profiler Configuration.
  3. By default, your application is profiled on the local computer. If you want to start profiling on a remote computer, do one of the following:
    • Click Profile on remote computer to specify a remote agent url and thereby define what remote agent to use.
    • Select a remote host in the Host drop-down list and click it.
    For more information, see Profiling Remote Applications.
  4. Click one of servers in the Server drop-down list.
  5. To specify Web application to be profiled, do one of the following:
    • Click Configuration file, then click a site name in the Site drop-down list.
    • Click Application path, then type the path to the site in the Application path text box.
  6. Optionally, select the Run browser check box. After that:
    • Type the application URL in the Url text box.
    • Click the name of a browser that should be started or restarted in the Browser drop-down list.
    • If you profile on a remote computer, you can select the Open browser on remote computer check box to invoke the default browser.
  7. Select a profiling mode in the Profiling type drop-down list. For more information, see Choosing the Right Profiling Mode.
  8. Specify what kind of timer you want to use by selecting an item in the Measure drop-down list. For more information, see Choosing the Right Time Measurement Method.
  9. If the Start profiling immediately check box is selected, dotTrace Performance starts gathering performance data immediately after you click Run and close the current dialog. Otherwise, dotTrace Performance waits until you press Start Profiling in the dotTrace Performance Controller window. For more information, see Launching and Controlling the Profiling Process.
  10. Optionally, click the arrow to display and configure additional settings, such as High accuracy, Enable inlining, Merge threads with equal names etc.
    • Select the High accuracy check box to take into account time spent in profiler itself by taking more time samples.
    • Clear the Enable inlining check box to disable JIT-inlining in order to get call stacks that closely resemble the structure of application's source code.
    • Select the Merge threads with equals names check-box and as a result get the performance information for all threads with the same name under a single thread node in Call Tree and Threads Tree views.
    • Click Edit Filters to define in advance what functions should be filtered out and what should be profiled line by line.
    • Click Edit Symbol Search Policy to specify locations where the profiler looks for debugging information. For more information, see Edit Symbol Search Policy.
    • Select the Use profiler API check box to allow you to control profiling directly from the code of the profiled application. For more information, see Advanced Profiling Using dotTrace API.
  11. Click Run.

See Also

Procedures:

Reference: