Skip to main content

DotnetAgent Support Matrix

warning
  1. Non-IIS applications are not within the product support scope and require users to install and verify independently.
  2. Support for .NET Core / .NET applications running on Alpine (musl libc) is available but not fully tested; use with caution and verify carefully.
  3. Support for .NET Core / .NET applications running on ARM64 architecture is available but not fully tested; use with caution and verify carefully.
  4. Custom method instrumentation collection is not supported (custom IL injection/method-level instrumentation is not within the support scope).

Operating Systems​

System TypeSupported Versions
Windows Server2008 32bit/64bit, 2008R2 32bit/64bit, 2012 R2 32bit/64bit, 2016 32bit/64bit, 2019 32bit/64bit
Windows7 32bit/64bit, 10 32bit/64bit
CentOS7+ 64bit
Debian8+ 64bit
Ubuntu19.04+ 64bit

.NET Versions​

TypeSupported Versions
.NET Framework2.0 / 3.0 / 3.5 (not thoroughly tested, install with caution)
.NET Framework4.0 / 4.5 / 4.5.1 / 4.5.2 / 4.6 / 4.6.1 / 4.7 / 4.8
.NET Core2.0 / 2.1 / 2.2 / 3.0 / 3.1
.NET5.0 / 6.0 / 7.0 / 8.0 (.NET 6.0/7.0/8.0 are supported starting from SmartAgent 9.7.0 / DotnetAgent 6.14.3)
9.0 (supported starting from SmartAgent 10.3.0 / DotnetAgent 6.16.2)

Frameworks​

FrameworkSupported Versions
ASP.NET (Web/Web Service).NET Framework 4.0 / 4.5 / 4.5.1 / 4.5.2 / 4.6 / 4.6.1 / 4.7 / 4.8
Built-in .NET Framework
WCF.NET Framework 4.0 / 4.5
Built-in .NET Framework
MVC2 / 3 / 4 / 5
Built-in .NET Framework
ASP.NET Core Web.NET Core 2.0 / 2.1 / 2.2 / 3.0 / 3.1 / .NET 5.0
Built-in ASP.NET Core

Databases​

TypeSupported Versions
OracleSystem.Data.OracleClient 1.0.8
OracleOracle.DataAccess
OracleOracle.ManagedDataAccess.Core
Asynchronous operations supported starting from SmartAgent 9.6.0 / DotnetAgent 6.14.2
Driver version: Oracle Database 11g Release 2 v11.2.0.1.0
Component version: Oracle.ManagedDataAccess.dll v23.1.0.0
OracleSystem.Data.OleDb / System.Data.Odbc
Supported starting from SmartAgent 9.6.0 / DotnetAgent 6.14.2
DLL assembly version: 6.0.0.0
Windows driver: OraOLEDB v11.2.0.2.0
Linux driver: unixODBC v2.3.1
MySQLMySql.Data (built-in .NET Framework)
Asynchronous operations supported starting from SmartAgent 9.6.0 / DotnetAgent 6.14.2
Driver version: mysqld v5.7.44
Component version: MySql.Data.dll v8.0.28.0
MySQLMySqlConnector
Asynchronous operations supported starting from DotnetAgent 6.0.0
Tested asynchronous versions: driver mysqld v5.7.44, component MySqlConnector.dll v2.0.0.0
MySQLSystem.Data (built-in .NET Framework)
MySQLSystem.Data.Odbc
Supported starting from SmartAgent 9.8.0 / DotnetAgent 6.14.4
Linux driver: mysql-connector-odbc-5.3.14-1.el7.x86_64
Windows driver: MySQL ODBC 9.4 Unicode/ANSI Driver v9.04.00.00
SQL ServerSystem.Data.OleDb
Supported starting from SmartAgent 9.8.0 / DotnetAgent 6.14.4
Windows driver: MSOLEDBSQL v18.7.4.0
SQL ServerSystem.Data.Odbc
Supported starting from SmartAgent 9.8.0 / DotnetAgent 6.14.4
Linux drivers: unixODBC v2.3.1, msodbcsql18-18.4.1.1-1.x86_64
Windows driver: ODBC Driver 18 for SQL Server v18.5.1.1
SQL ServerSystem.Data.SqlClient
Transaction Commit method tracing supported starting from SmartAgent 9.10.0 / DotnetAgent 6.15.1
Supported versions: .NET Core 2.0/2.1/2.2/3.0/3.1, .NET 5.0/6.0/7.0/8.0
SQL ServerMicrosoft.Data.SqlClient
Transaction Commit method tracing supported starting from SmartAgent 9.10.0 / DotnetAgent 6.15.1
Supported versions: .NET Core 2.0/2.1/2.2/3.0/3.1, .NET 5.0/6.0/7.0/8.0
Postgre SQLNpgsql (4.0.0+)
Postgre SQLSystem.Data.Odbc
Supported starting from SmartAgent 9.8.0 / DotnetAgent 6.14.4
Linux driver: postgresql-odbc-09.03.0100-2.el7.x86_64
Windows driver: PostgreSQL Unicode/ANSI v17.00.00.06

NoSQL​

TypeSupported Versions
RedisServiceStack.Redis (5.0.0+) / StackExchange.Redis (2.0.495+)
MemcachedEnyimMemcached (2.11+)

Remote Calls​

TypeSupported Versions
HttpWebRequest.NET Framework 4.0 / 4.5 / 4.5.1 / 4.5.2 / 4.6 / 4.6.1 / 4.7 / 4.8
Built-in .NET Framework
HttpClient.NET Framework 4.0 / 4.5 / 4.5.1 / 4.5.2 / 4.6 / 4.6.1 / 4.7 / 4.8
.NET Core 2.0 / 2.1 / 2.2 / 3.0 / 3.1 / .NET 5.0
Built-in .NET Framework, .NET Core, and .NET
Apache.NMS.ActiveMQTested versions: 1.4.1 / 1.8.0 / 1.7.2 / 2.2.0
Apache.NMS.AMQPTested version: 2.4.0
AMQP framework requires .NET Framework 4.6.1+
RabbitMQ.ClientTested versions: 6.0.0 / 5.2.0

.NET EXE Programs​

TypeNotes
ScopeWindows .NET Framework .exe program monitoring (Beta)
Supported starting from SA 9.9.1 (dotnet 6.15.0)
Not supportedSingle-file executable
Publish parameter includes: -p:PublishSingleFile=true
Not supportedTrimmed self-contained deployment
Publish parameter includes: --self-contained true -p:PublishTrimmed=true
Supported frameworksWindows .NET 5.0 / .NET 6.0 / .NET 7.0 / .NET 8.0
Microsoft.Extensions.HostingSupported starting from SA 9.11.0 (dotnet 6.15.2)
Supported framework: .NET Framework 4.6.2+
Web API 2 (HttpServer)Supported starting from SA 9.11.0 (dotnet 6.15.2)
Supported framework: .NET Framework 4.5+
TopShelfSupported starting from SA 10.0.0 (dotnet 6.16.0)
Supported frameworks: .NET Framework 4.5.2 / 4.6 / 4.6.1 / 4.7 / 4.8, .NET 5 / 6 / 7 / 8
Supported module version: TopShelf.dll 4.3.0

Other​

FeatureNotes
JS injection (Server version)Supported starting from Dotnet agent 5.5.0 (ASP.NET only); ASP.NET Core is not supported
JS injection (One version)Supported starting from Dotnet agent 6.4.0 (ASP.NET and ASP.NET Core)
Backend API blacklistSupported starting from SmartAgent 9.8.0 (DotnetAgent 6.14.4)
.NET GC activity and GC memory metricsSupported frameworks: .NET Framework 4.0+, .NET Core 3.0+, .NET 5.0+
Supported starting from SA 9.9.1 (dotnet 6.15.0)
Local custom business entry method configurationSupported starting from SA 10.4.0 (dotnet 6.16.3)
Supported frameworks: .NET Framework 4.5+, .NET Core 2.0+, .NET 5.0/6.0/7.0/8.0/9.0