dotMemory 2024.1 Help

Profile .NET Core or .NET Application

Windows

  1. Run dotMemory as a standalone application. The dotMemory Home window will open.

  2. Add a run configuration – the configuration that tells dotMemory how to run the profiled application:

    1. Under Choose what you want to profile, New Process Run, click Add run configuration Add run configuration.

    2. In the New Run Configuration wizard, choose .NET and .NET Core and click Next.

    3. Specify application options:

      • Path to the application executable (if it's a self-contained deployment) or to a library file (if it is a framework-dependent deployment).

      • Command-line Arguments for the executable (if required).

      • A full path to the application Working directory (by default, it's the same directory where the executable is located).

      • Set environment variables lets you run the profiled application with specific environment variables. Each variable must be specified on a new line.

    4. Click Save.

  3. Make sure the created run configuration is selected in the New Process Run list.

  4. Under Choose how you want to profile it, specify profiling options:

  5. Click Start. This will start the profiling session.

  6. Go through a particular workflow in your application (if you want to check it on potential memory issues) or reproduce a particular memory issue. Collect memory snapshots using the Get Snapshot button. Learn more about how to control the profiling session

  7. After you collect the data, either close the profiled application or detach the profiler using the Detach button.

  8. Analyze the collected snapshots.

  1. Download dotMemory command-line profiler.

  2. Unzip the archive and open the profiler directory.

  3. Use the command-line profiler to start the profiling session and get memory snapshots. For example, to instantly get a snapshot of a running application:

    dotMemory.exe get-snapshot MyApp --with-max-mem

    To start MyApp and take snapshots periodically:

    dotMemory.exe start --trigger-timer=30s c:\MyApp\MyApp my-app-arg1
  4. Learn more about profiling with the command-line profiler.

Linux and macOS

  1. Run dotMemory as a standalone application. The dotMemory Home window will open.

  2. Add a run configuration – the configuration that tells dotMemory how to run the profiled application:

    1. Under Choose what you want to profile, New Process Run, click Add run configuration Add run configuration.

    2. In the New Run Configuration wizard, choose .NET and .NET Core and click Next.

    3. Specify application options:

      • Path to the application executable (if it's a self-contained deployment) or to a library file (if it's a framework-dependent deployment).

      • Command-line Arguments for the executable (if required).

      • A full path to the application Working directory (by default, it is the same directory where the executable is located).

      • Set environment variables lets you run the profiled application with specific environment variables. Each variable must be specified on a new line.

      • If you profile a web application and want its URL to be opened once the profiling starts, select Open URL and specify the URL. The in browser parameter lets you select a browser for opening the URL.

    4. Click Save.

  3. Make sure the created run configuration is selected in the New Process Run list.

  4. Under Choose how you want to profile it, specify profiling options:

  5. Click Start. This will start the profiling session.

  6. Go through a particular workflow in your application (if you want to check it on potential memory issues) or reproduce a particular memory issue. Collect memory snapshots using the Get Snapshot button. Learn more about how to control the profiling session

  7. After you collect the data, either close the profiled application or detach the profiler using the Detach button.

  8. Analyze the collected snapshots.

  1. Download dotMemory command-line profiler.

  2. Unzip the archive and open the profiler directory.

  3. Use the command-line profiler to start the profiling session and get memory snapshots. For example, to instantly get a snapshot of a running application:

    ./dotMemory.sh get-snapshot MyApp --with-max-mem

    To start MyApp and take snapshots periodically:

    ./dotMemory.sh start --trigger-timer=30s ~/MyApp/MyApp my-app-arg1
  4. Learn more about profiling with the command-line profiler.

Last modified: 10 April 2024