dotTrace 2017.1 Help

Starting Remote Profiling Session

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 are not blocked by the firewall.
      If you use Windows Firewall, open Control Panel | Windows Firewall | Advanced settings | Inbound Rules and check that connections are allowed in the Agent.Remote.WebServer rules.
  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.
Last modified: 24 August 2017