dotTrace 2020.3 Help

Start Profiling Session

Your starting point in dotTrace is the Home window. Here you can start new profiling sessions or open snapshots collected in recent sessions.

Starting a profiling session on a local computer

To start profiling of an application

  1. Choose Profile Local App in the left panel.

  2. In the central panel in Profile Application, select the type of application you are going to profile.

  3. In the right panel, configure profiling settings as described in Configuring Profiling Session.

  4. Click Run.

To start profiling of an already running application

  1. Choose Attach to Running App in the left panel.

  2. Do one of the following:

    • In the central panel in the list of processes, select the .NET process you are going to profile.
      If a process you are looking for is missing, click Refresh to update the list of processes and/or click Show All Processes to grant dotTrace administrative permissions (this will show more processes running in the system).

    • Drag the Attach icon Attach icon onto the application you want to attach to.

  3. In the right panel, configure profiling settings as described in Configuring Profiling Session. Note that Tracing and Line-by-line profiling types are not supported when you attach the profiler to a process.

  4. Click Run.

Starting a profiling session on a remote computer

You can profile .NET applications not only on the local computer, but on a remote computer as well. Moreover, in order to profile remotely, you do not have to install dotTrace on a remote computer. Nevertheless, remote profiling requires a number of preparation steps on the remote computer.

dotTrace uses the HTTP-based web service for remote profiling. This allows avoiding the majority of authentication problems and problems with firewalls.

To start a profiling session on a remote computer

  1. On the remote computer, do the following:

    • Copy the RemoteAgent.zip archive from the dotTrace installation directory on your local computer (by default, C:\Users\[username]\AppData\Local\JetBrains\Installations\dotTrace[N]) to any directory on the remote computer.

    • Unpack the archive on the remote computer.

    • Start Remote Agent from the console on the remote computer.

    • Ensure that inbound connections to Remote Agent (by default, it uses port 9100) are not blocked by the firewall.

  2. On the local computer, start dotTrace as a standalone application.

  3. Choose Profile Remote in the left panel.

  4. In the central panel, specify the address of the remote agent service in Remote Agent URL.
    By default, the URL is net.tcp://[remote_computer_IP_address]:9100/RemoteAgent. However, you can change the default port and virtual directory of the service using Remote Agent's command line options. Run ' RemoteAgent.exe /help' for more details.

  5. Click Connect to establish connection with the remote host.

  6. In the central panel, do one of the following:

    • If you want to profile an application, select an application type in Profile Application.

    • If you want to profile an already running process, select a particular process in Attach to Process.

  7. In the right panel, configure profiling settings as described in Configuring Profiling Session.

  8. Click Run.

Starting a recent profiling session

Another convenient and quick way to start profiling is to use one of the recent profiling configurations.

To start profiling with recently used configuration

  1. Choose the Recent | Launches tab.
    For the convenience, the list of recent launches is also grouped by profiled applications. Thus, alternatively, you can choose a particular application name in the Recent tab.

  2. In the central panel find the required profiling configuration and click the corresponding Run button *.

Last modified: 08 March 2021