There are two ways to capture coverage from the app/service processes using the SeaLights .NET Core agent

  1. By running the process with our agent using the testListener option

  2. By running the SeaLights .NET Core agent as a background listener

The Background Listener option allows you to capture coverage from any application - without changing the command used to run it, but this requires a few more steps than the testListener option.

Running the process with the SeaLights .NET Core agent using the testListener option

To capture coverage from a single application, you can run it with the SeaLights .NET agent, which will capture coverage from it when it runs, and tests are run against it.

dotnet ./sl-dotnet-agent/SL.DotNet.dll testListener --buildSessionIdFile buildSessionId.txt --target c:\MyApplication\App.exe --workingDir c:\WorkingDir --targetArgs "-Flag1 true MyTest.dll"
POWERSHELL

The sample command above is replacing the regular command used to startup the application captured: c:\MyApplication\App.exe -Flag1 true MyTest.dll executed from the c:\WorkingDir directory

See SeaLights .NET - Command reference: Starting the Test Listener for full parameters details . 

Running the SeaLights .NET Core agent as a background listener

To capture coverage from any application without changing the command you use to run it, you can run the SeaLights .NET agent as a background process, which will capture coverage from any process with the SeaLights .NET agent defined as a profiler.

Starting the SeaLights .NET Core agent background listener

To run the background process, you need to use the startBackgroundTestListener flag and provide a unique session key:

dotnet ./sl-dotnet-agent/SL.DotNet.dll startBackgroundTestListener --buildSessionIdFile buildSessionId.txt --testListenerSessionKey SL_CovCollectorAgent
POWERSHELL

Setting the SeaLights .NET Core agent as a profiler

Now, you need to run (all) your processes - i.e. including your application - with the SeaLights .NET Core agent defined as a profiler. This is done by setting the following environment variables in the shell used to run your process:

.NET Core / Windows

.NET Core / Linux

CORECLR_ENABLE_PROFILING=1
CORECLR_PROFILER={01CA2C22-DC03-4FF5-8350-59E32A3536BA}
CORECLR_PROFILER_PATH_32=SL.DotNet.ProfilerLib.Windows_x86.dll
CORECLR_PROFILER_PATH_64=SL.DotNet.ProfilerLib.Windows_x64.dll
SL_CollectorId=SL_CovCollectorAgent
SL_LogDir=/tmp/logs
SL_LogLevel=6
POWERSHELL 
CORECLR_ENABLE_PROFILING=1
CORECLR_PROFILER={3B1DAA64-89D4-4999-ABF4-6A979B650B7D}
CORECLR_PROFILER_PATH_32=libSL.DotNet.ProfilerLib.Linux.so
CORECLR_PROFILER_PATH_64=libSL.DotNet.ProfilerLib.Linux.so
SL_CollectorId=SL_CovCollectorAgent
SL_LogDir=/tmp/logs
SL_LogLevel=6
BASH

You should unset the environment variables before running any process that you do not want to capture coverage from

Stopping the SeaLights .NET Core agent background listener

Once you have finished collecting coverage from the process, you need to stop the background listener. This is done by using the stopBackgroundTestListener flag with the session key previously used

dotnet ./sl-dotnet-agent/SL.DotNet.dll stopBackgroundTestListener --buildSessionIdFile buildSessionId.txt --testListenerSessionKey SL_CovCollectorAgent
POWERSHELL

See 'SeaLights .NET - command reference' for full parameter details of all the commands listed above.