# .NET Agent

## 2026 Release Notes

<table><thead><tr><th width="79.265625">Version</th><th width="179.1640625">Date</th><th>Change</th></tr></thead><tbody><tr><td>3.16.2</td><td>May 11, 2026</td><td><p><strong>New Features and Updates</strong></p><ul><li>Added a configuration option to control the footprint buffer threshold in bytes.</li><li>Added the ability to resolve BSID by application, branch, and build name in non-CD Agent modes.</li></ul><p><strong>Resolved Issues</strong></p><ul><li>Fixed an issue that caused incorrect reporting for multi-module applications.</li><li>Fixed an issue where colored execution was not properly closed when the test runner exited.</li></ul></td></tr><tr><td>3.16.1</td><td>April 20, 2026</td><td><p><strong>New Features and Updates:</strong></p><ul><li>Removed the <code>--firstModule</code> option from the scan command.</li></ul><p><strong>Resolved Issues:</strong></p><ul><li>Addressed an issue when starting the agent as a DLL on Windows.</li><li>Improved startup messaging.</li></ul></td></tr><tr><td>3.16.0</td><td>March 30, 2026</td><td><p><strong>New Features and Updates:</strong></p><ul><li>Standardized CLI parameter names to align with other SeaLights agents:<br><code>--branchName</code>, <code>--buildName</code>, <code>--failOnError</code>, <code>--scanDir</code>, <code>--scmType</code>, <code>--excludeFiles</code>, <code>--moduleName</code>, <code>--repositoryUrl</code>, <code>--disableTia</code>, <code>--file</code>, and <code>--filesFolder</code>.</li><li><p>Added command aliases for improved usability:</p><ul><li><code>completeScan</code></li><li><code>openTestStage</code> / <code>startTestStage</code></li><li><code>closeTestStage</code> / <code>endTestStage</code></li></ul></li><li>Maintained full backward compatibility by preserving all existing parameter and command names as aliases.</li><li>Activated FootprintsV6 automatically to improve coverage and diagnostics.</li><li>Simplified configuration management with a dedicated command <code>exportSettings</code> to export settings.</li><li>Updated test runner integration to use direct API calls, reducing execution delays.</li><li>mproved initialization messages for Footprints to provide clearer insights during agent startup.</li></ul><p><strong>Resolved Issues:</strong></p><ul><li>Fixed coverage collection issue.</li></ul></td></tr><tr><td>3.15.1</td><td>February 18, 2026</td><td><p><strong>New Features and Updates:</strong></p><ul><li>Added predefined apps support for PIC vs IIS and cdAgent mode.</li><li>Updated agent to .NET 10.</li></ul></td></tr><tr><td>3.15.0</td><td>February 4, 2026</td><td><p><strong>New Features and Updates:</strong></p><ul><li>Added agent console messages to improve runtime visibility and diagnostics.</li><li>Introduced a warning when re-running the <code>scan</code> command with the same <code>buildSessionId</code>.</li><li>Added support for file-based logging by specifying a log file name.</li><li>Introduced the <code>prId</code> option for the coverage collector.</li><li>Added support for using the system proxy configuration for the HTTP client.</li><li>Added a predefined session file option for the <code>instrumentIIS</code> command.</li><li>Added automatic CLI documentation generation.</li></ul><p><strong>Resolved Issues:</strong></p><ul><li>Fixed class logical path handling in the CD Agent <code>scan</code> command.</li></ul></td></tr></tbody></table>

## 2025 Release Notes

<table><thead><tr><th width="78.51953125">Version</th><th width="179.34765625">Date</th><th>Change</th></tr></thead><tbody><tr><td>3.14.6</td><td>December 16, 2025</td><td><p><strong>New Features and Updates:</strong> </p><ul><li>Added beta support for the Dynatrace profiler via multiprofiler on Windows.</li><li>Added support for passing process filters via CLI arguments to the coverage collector when running in process-wrapper mode.</li></ul><p><strong>Resolved Issues:</strong></p><ul><li>Fixed an issue with default branch validation.</li></ul></td></tr><tr><td>3.14.5</td><td>December 4, 2025</td><td><p><strong>New Features and Updates:</strong> </p><ul><li>Added beta support for the Dynatrace profiler via multiprofiler on Linux. </li><li>Made <code>branchName</code> configuration optional for CD Agent.</li></ul><p><strong>Resolved Issues:</strong></p><ul><li>Fixed an edge case where footprints were missing on shutdown.</li><li>Fixed profiler compilation issued in the new .NET SDK Docker files. </li></ul></td></tr><tr><td>3.14.4</td><td>November 17, 2025</td><td><p><strong>Resolved Issues:</strong></p><ul><li>Fixed an issue where <code>ModuleId</code> was missing in the Cockpit.</li></ul></td></tr><tr><td>3.14.3</td><td>November 12, 2025</td><td><p><strong>New Features and Updates:</strong> </p><ul><li>Added support for instrumenting IIS or Windows services using PIC mode.</li><li>Added additional instrumentation tools for debugging low-level profiling issues.</li></ul></td></tr><tr><td>3.14.2</td><td>October 27, 2025</td><td><p><strong>Resolved Issues:</strong></p><ul><li>Fixed an issue that caused unnecessary execution when a test stage was set for the coverage collector. </li></ul></td></tr><tr><td>3.14.1</td><td>September 25, 2025</td><td><p><strong>New Features and Updates:</strong> </p><ul><li>Added an option to save coverage collector sessions when using the start-session command.</li></ul></td></tr><tr><td>3.14.0</td><td>September 5, 2025</td><td><p><strong>New Features and Updates:</strong> </p><ul><li>Added support for loading predefined sessions from a settings file for the coverage collector.</li><li>Improved handling of permission-related issues for the performance monitor.</li></ul><p><strong>Resolved Issues:</strong></p><ul><li>Fixed a rare CLR internal failure when requesting instrumentation before <code>CoreLib</code> was loaded.</li><li>Applied ongoing security fixes.</li></ul></td></tr><tr><td>3.13.2</td><td>August 4, 2025</td><td><p><strong>New Features and Updates:</strong> </p><ul><li>Added support for reporting parallel test events for xUnit, NUnit, and MSTest.</li><li>Added support for <code>build</code> and <code>branch</code> parameters in pull request configuration.</li><li>Added the ability to configure a profiler process filter for all agent modes.</li></ul><p><strong>Resolved Issues:</strong></p><ul><li>Fixed a rare race condition when multiple active sessions started simultaneously.</li></ul></td></tr><tr><td>3.13.1</td><td>July 21, 2025</td><td><p><strong>New Features and Updates:</strong> </p><ul><li>Added support for MSTest V1 test event reporting when using the <code>vstest.console</code> runner. </li></ul><p><strong>Resolved Issues:</strong></p><ul><li>Fixed startup logger file creation, ensuring logs are written to a single file.</li><li>Fixed PIC mode behavior to prevent attaching to the coverage collector service process.</li></ul></td></tr><tr><td>3.13.0</td><td>June 25, 2025</td><td><p><strong>New Features and Updates:</strong> </p><ul><li>Added support for parallel test stages.</li><li>Added the <code>testProjectId</code> parameter.</li><li>Improved tagging for instrumented processes.</li><li>Added the agent version to metadata headers.</li><li>Added support for the <code>--testStage</code> parameter for the <code>testListener</code> command.</li></ul><p><strong>Resolved Issues:</strong></p><ul><li>Fixed an issue with dummy execution handling.</li></ul></td></tr><tr><td>3.12.4</td><td>June 17, 2025</td><td><p><strong>Resolved Issues:</strong></p><ul><li>Fixed an issue with submitting buildmaps for the CD Agent. </li></ul></td></tr><tr><td>3.12.3</td><td>June 11, 2025</td><td><p></p><p><strong>Resolved Issues:</strong></p><ul><li>Fixed an issue with passing <code>labId</code> to the coverage collector service. </li></ul></td></tr><tr><td>3.12.2</td><td>June 4, 2025</td><td><p><strong>New Features and Updates:</strong> </p><ul><li>Added namespace suggestions during scan operations.</li></ul></td></tr><tr><td>3.12.1</td><td>May 23, 2025</td><td><p><strong>New Features and Updates:</strong> </p><ul><li>Added missing multiprofiler binaries to the Windows release.</li></ul><p><strong>Resolved Issues:</strong></p><ul><li>Fixed initial footprint handling for footprints v6.</li><li>Fixed resolving IP addresses for IPC with remote instances.</li></ul></td></tr><tr><td>3.12.0</td><td>May 7, 2025</td><td><p><strong>New Features and Updates:</strong> </p><ul><li>Upgraded the agent to .NET 9.0.</li><li>Added support for .NET 9.0 distroless images.</li></ul></td></tr><tr><td>3.11.4</td><td>April 24, 2025</td><td><p></p><p><strong>New Features and Updates:</strong> </p><ul><li>Added support for older Linux OS versions (GLIBCXX_3.4.25).</li><li>Added the ability to configure the agent remotely.</li><li>Added an alias for the <code>labId</code> environment variable.</li></ul></td></tr><tr><td>3.11.3</td><td>April 11, 2025</td><td><p><strong>New Features and Updates:</strong> </p><ul><li>Improved applied configuration logging.</li></ul><p><strong>Resolved Issues:</strong></p><ul><li>Fixed multiprofiler compatibility with Datadog on Linux.</li></ul></td></tr><tr><td>3.11.2</td><td>March 21, 2025</td><td><p><strong>New Features and Updates:</strong> </p><ul><li>Added options for selecting a profiler by runtime.</li><li>Added support for specifying wildcard filters for collector service sessions.</li></ul></td></tr><tr><td>3.11.1</td><td>March 10, 2025</td><td><p><strong>Resolved Issues:</strong></p><ul><li>Fixed an issue with submitting build maps for the CD Agent.</li><li>Fixed vulnerabilities in third-party dependencies.</li></ul></td></tr><tr><td>3.11.0</td><td>February 5, 2025</td><td><p><strong>New Features and Updates:</strong> </p><ul><li>Improved profiler logging configuration.</li><li>Added a startup logger for the collector to assist with debugging PIC mode.</li><li>Added initial support for line coverage.</li><li>Added clock synchronization support.</li></ul><p><strong>Resolved Issues:</strong></p><ul><li>Fixed a multiprofiler loading issue on Windows.</li></ul></td></tr></tbody></table>

## 2024 Release Notes

<table><thead><tr><th width="80.609375">Version</th><th width="178.640625">Date</th><th>Changes</th></tr></thead><tbody><tr><td>3.10.2</td><td>December 3, 2024</td><td><p><strong>New Features and Updates:</strong> </p><ul><li>Added support for <code>context</code> and <code>contextType</code> fields for IPC and Collector.</li><li>Added DLL target for IPC library and sample integration application.</li><li>Added IPv6 support for background test listener mode.</li></ul><p><strong>Resolved Issues:</strong></p><ul><li>Fixed representation of generic types in test names.</li></ul></td></tr><tr><td>3.10.1</td><td>October 21, 2024</td><td><p><strong>New Features and Updates:</strong> </p><ul><li>Added multi-profiler DLLs to the <code>SL.DotNet</code> package.</li><li>Security updates.</li></ul></td></tr><tr><td>3.10.0</td><td>September 30, 2024</td><td><p><strong>New Features and Updates:</strong> </p><ul><li>Added support for Footprints v6 protocol. </li></ul></td></tr><tr><td>3.9.15</td><td>September 2, 2024</td><td><p><strong>New Features and Updates:</strong></p><ul><li>Added info executor for detailed Coverage Collector Service status tracking.</li></ul><p><strong>Resolved Issues:</strong></p><ul><li>Fixed issue with pending sessions in Coverage Collector Service.</li></ul></td></tr><tr><td>3.9.14</td><td>September 2, 2024</td><td><p><strong>Resolved Issues:</strong></p><ul><li>Fixed agent startup issue on machines with configured <code>dotnet dev</code> environment. </li></ul></td></tr><tr><td>3.9.13</td><td>August 5, 2024</td><td><p><strong>New Features and Updates:</strong></p><ul><li>Added option to ignore false code modifications caused by DisplayClass index.</li></ul><p><strong>Resolved Issues:</strong></p><ul><li>Fixed issue with specifying token file over environment variables.</li></ul></td></tr><tr><td>3.9.12</td><td>July 29, 2024</td><td><p><strong>New Features and Updates:</strong></p><ul><li>Added support for running the .NET Core agent on read-only filesystems.</li><li>Security updates.</li></ul></td></tr><tr><td>3.9.10</td><td>June 24, 2024</td><td><p><strong>Resolved Issues:</strong></p><ul><li>Fixed handling of test event sending for test stages opened on integration labs.</li></ul></td></tr><tr><td>3.9.9</td><td>June 18, 2024</td><td><p><strong>New Features and Updates:</strong></p><ul><li>Added support for configuring logger using a relative path.</li></ul><p><strong>Resolved Issues:</strong></p><ul><li>Fixed issue with <code>uploadReport</code> mode.</li></ul></td></tr><tr><td>3.9.8</td><td>June 14, 2024</td><td><p><strong>New Features and Updates:</strong></p><ul><li>Improved IPC communication and keep-alive timeout handling.</li><li>Improved TIA timeout handling to respect configured limits.</li><li>Updated dependencies and security improvements.</li></ul></td></tr><tr><td>3.9.7</td><td>May 23, 2024</td><td><p><strong>New Features and Updates:</strong></p><ul><li>Added ability to start execution using <code>integrationLabId</code> without <code>bsid</code> (<code>startExecution</code> command).</li></ul></td></tr><tr><td>3.9.6</td><td>May 15, 2024</td><td><p><strong>New Features and Updates:</strong></p><ul><li>Added Sealights metadata headers to API requests.</li><li>Added <code>logDir</code> and <code>logPreset</code> options for simplified logger configuration.</li></ul><p><strong>Resolved Issues:</strong></p><ul><li>Improved memory usage of logging mechanism.</li><li>Changed default log level to <code>Info</code> .</li></ul></td></tr><tr><td>3.9.5</td><td>March 28, 2024</td><td><p><strong>New Features and Updates:</strong></p><ul><li>Added profiler attachment to service report service name tags.</li></ul><p><strong>Resolved Issues:</strong></p><ul><li>Improved handling of Collector Service responses after session start/stop.</li><li>Improved IPC connection error handling and log messages.</li></ul></td></tr><tr><td>3.9.4</td><td>March 4, 2024</td><td><p><strong>New Features and Updates:</strong></p><ul><li>Improved labId resolution for CD Agent mode.</li><li>Updated dependencies and security improvements.</li></ul></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sealights.io/knowledgebase/agent-release-notes/.net-agent/.net-core-agent.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.