C++ Agent Parameter Reference Table

SeaLights C++ Agent – Configuration Parameters Reference

A concise lookup table for every configuration parameter and the ways you can provide it.

Table Legend

Column Definitions

• Timing - At which phase in the workflow can the parameter be configured

• Usage Mode - In which agent usage mode the parameter can be used

Timing Values

• 🔧 Config - Typically set during SL.Agent.Cpp config command

• 🔧⚡ Either - Can be set during config or runtime (commonly deferred for deployment flexibility)

Usage Mode Values

• Coverage Listener Mode (AUT) - Used when instrumenting applications to collect coverage data

• Test Runner Mode - Used when instrumenting test frameworks to collect test execution details

• Both - Used in either operating mode

Parameter	Timing	Usage Mode	Config File key	CLI Flags	Environment Variables	Description	Default
Authentication token	🔧⚡ Either	Both	—	--token | --tokenFile	SL_TOKEN | SL_TOKENFILE	Raw token or path to token file (required)	—
Build session ID	🔧 Config	Both	—	--buildSessionId | --buildSessionIdFile	SL_BUILDSESSIONID| SL_BUILDSESSIONFILE	Build-session identifier	—
Application name	🔧 Config	Coverage Listener Mode (AUT)	appName	--appName	SL_APPNAME	Display name in Sealights	—
Build name	🔧 Config	Coverage Listener Mode (AUT)	buildName	--buildName	SL_BUILDNAME	Build identifier (auto-generated if omitted)	—
Branch name	🔧 Config	Coverage Listener Mode (AUT)	branchName	--branchName	SL_BRANCHNAME	Git branch for build	Unspecified
Proxy URL	🔧⚡ Either	Both	proxyUrl	--proxy-url | --proxy	SEALIGHTS_PROXY_URL	HTTP/HTTPS proxy	—
Collector URL	🔧⚡ Either	Both	collectorUrl	--collector-url | --collector | -c	SEALIGHTS_COLLECTOR_URL	Override backend collector	—
Packages included	🔧 Config	Coverage Listener Mode (AUT)	include	--include	SL_INCLUDE	Globs of C++ packages to instrument	—
Packages excluded	🔧 Config	Coverage Listener Mode (AUT)	exclude	--exclude	SL_EXCLUDE	Packages to skip	—
Logging enabled	🔧⚡ Either	Both	loggingEnables	--loggingEnabled	SL_LOGGING_ENABLED	Boolean	false
Log level	🔧⚡ Either	Both	logLevel	--logLevel	SL_LOGLEVEL	silent | debug | info | warn | error	info
Log directory	🔧⚡ Either	Both	logDir	--logDir	SL_LogDir	Folder where the logs will be saved
Lab ID	🔧⚡ Either	Both	labId	--labId	SL_LABID	Group related executions
Test stage	🔧⚡ Either	Both	testStage	--test-stage	SL_TEST_STAGE	Stage name shown in UI
Test Listener Session ID	🔧⚡ Either	Both	testListenerSessionKey	--testListenerSessionKey
Agent address			agentAddress	--agentAddress	SL_AGENT_ADDRESS	If the AUT and the Test Runner are on different machines, enter the IP of the Test Runner machine
Agent port			agentPort	--agentPort	SL_AGENT_PORT	Port of the Test Runner machine
Bin directory	🔧 Config	Coverage Listener Mode (AUT)	binDir	--binDir	SL_BINDIR	Path to the source folder

A blank “Config File key” means that particular parameter cannot be set inside settings.json; use flags or env vars instead.

Parameters That Can Be Deferred to Runtime

In the above table, the parameters with a "Timing" value of "Either" do not need to be set during SL.Agent.Cpp config command; they can be set later at runtime using environment variables.

1. These parameters are optional during the config phase

2. They can be set during config if desired, but it's not required

3. They have the flexibility to be set at runtime via environment variables instead