DotnetAgent 支持矩阵
注意
- 非 IIS 的应用不在产品支持范围内,需要用户自行安装并验证。
- 支持在 Alpine(musl libc)上运行的 .NET Core / .NET 应用,但未做全量测试,使用时请谨慎验证。
- 支持在 ARM64 架构下运行的 .NET Core / .NET 应用,但未做全量测试,使用时请谨慎验证。
- 不支持自定义方法插码采集(自定义 IL 注入/方法级插桩不在支持范围)。
操作系统
| 系统类型 | 支持版本 |
|---|---|
| Windows Server | 2008 32bit/64bit 、 2008R2 32bit/64bit 、 2012 R2 32bit/64bit 、 2016 32bit/64bit 、2019 32bit/64bit |
| Windows | 7 32bit/64bit 、 10 32bit/64bit |
| CentOS | 7+ 64bit |
| Debian | 8+ 64bit |
| Ubuntu | 19.04+ 64bit |
.NET 版本
| 类型 | 支持版本 |
|---|---|
| .NET Framework | 2.0 / 3.0 / 3.5(未详细测试,谨慎安装) |
| .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 / 6.0 / 7.0 / 8.0(从 SmartAgent 9.7.0 / DotnetAgent 6.14.3 开始支持 .NET 6.0/7.0/8.0) 9.0(从 SmartAgent 10.3.0 / DotnetAgent 6.16.2 开始支持) |
支持的框架
| 框架类型 | 支持版本 |
|---|---|
| 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 .NET Framework 框架内置 |
| WCF | .NET Framework 4.0 / 4.5 .NET Framework 框架内置 |
| MVC | 2 / 3 / 4 / 5 .NET Framework 框架内置 |
| ASP.NET Core Web | .NET Core 2.0 / 2.1 / 2.2 / 3.0 / 3.1 / .NET 5.0 ASP.NET Core 框架内置 |
数据库
| 类型 | 支持版本 |
|---|---|
| Oracle | System.Data.OracleClient 1.0.8 |
| Oracle | Oracle.DataAccess |
| Oracle | Oracle.ManagedDataAccess.Core 从 SmartAgent 9.6.0 / DotnetAgent 6.14.2 开始支持异步操作 驱动版本:Oracle Database 11g Release 2 v11.2.0.1.0 组件版本:Oracle.ManagedDataAccess.dll v23.1.0.0 |
| Oracle | System.Data.OleDb / System.Data.Odbc 从 SmartAgent 9.6.0 / DotnetAgent 6.14.2 开始支持 dll 程序集版本:6.0.0.0 Windows 驱动:OraOLEDB v11.2.0.2.0 Linux 驱动:unixODBC v2.3.1 |
| MySQL | MySql.Data(.NET Framework 框架内置) 从 SmartAgent 9.6.0 / DotnetAgent 6.14.2 开始支持异步操作 驱动版本:mysqld v5.7.44 组件版本:MySql.Data.dll v8.0.28.0 |
| MySQL | MySqlConnector 从 DotnetAgent 6.0.0 开始支持异步操作 已测试支持异步的版本:驱动 mysqld v5.7.44,组件 MySqlConnector.dll v2.0.0.0 |
| MySQL | System.Data(.NET Framework 框架内置) |
| MySQL | System.Data.Odbc 从 SmartAgent 9.8.0 / DotnetAgent 6.14.4 开始支持 Linux 驱动:mysql-connector-odbc-5.3.14-1.el7.x86_64 Windows 驱动:MySQL ODBC 9.4 Unicode/ANSI Driver v9.04.00.00 |
| SQL Server | System.Data.OleDb 从 SmartAgent 9.8.0 / DotnetAgent 6.14.4 开始支持 Windows 驱动:MSOLEDBSQL v18.7.4.0 |
| SQL Server | System.Data.Odbc 从 SmartAgent 9.8.0 / DotnetAgent 6.14.4 开始支持 Linux 驱动:unixODBC v2.3.1、msodbcsql18-18.4.1.1-1.x86_64 Windows 驱动:ODBC Driver 18 for SQL Server v18.5.1.1 |
| SQL Server | System.Data.SqlClient 从 SmartAgent 9.10.0 / DotnetAgent 6.15.1 开始支持事务 Commit 方法采集 支持版本:.NET Core 2.0/2.1/2.2/3.0/3.1,.NET 5.0/6.0/7.0/8.0 |
| SQL Server | Microsoft.Data.SqlClient 从 SmartAgent 9.10.0 / DotnetAgent 6.15.1 开始支持事务 Commit 方法采集 支持版本:.NET Core 2.0/2.1/2.2/3.0/3.1,.NET 5.0/6.0/7.0/8.0 |
| Postgre SQL | Npgsql(4.0.0+) |
| Postgre SQL | System.Data.Odbc 从 SmartAgent 9.8.0 / DotnetAgent 6.14.4 开始支持 Linux 驱动:postgresql-odbc-09.03.0100-2.el7.x86_64 Windows 驱动:PostgreSQL Unicode/ANSI v17.00.00.06 |
NoSQL
| 类型 | 支持版本 |
|---|---|
| Redis | ServiceStack.Redis(5.0.0+) / StackExchange.Redis(2.0.495+) |
| Memcached | EnyimMemcached(2.11+) |
远程调用
| 类型 | 支持版本 |
|---|---|
| HttpWebRequest | .NET Framework 4.0 / 4.5 / 4.5.1 / 4.5.2 / 4.6 / 4.6.1 / 4.7 / 4.8 .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 .NET Framework、.NET Core、.NET 框架内置 |
| Apache.NMS.ActiveMQ | 已测试版本:1.4.1 / 1.8.0 / 1.7.2 / 2.2.0 |
| Apache.NMS.AMQP | 已测试版本:2.4.0 AMQP 框架最低要求:.NET Framework 4.6.1+ |
| RabbitMQ.Client | 已测试版本:6.0.0 / 5.2.0 |
.NET exe程序
| 类型 | 支持说明 |
|---|---|
| 功能范围 | Windows .NET 框架开发的 exe 程序监控(Beta) 从 SA 9.9.1(dotnet 6.15.0)开始支持 |
| 不支持 | 单文件可执行文件(Single-file executable) publish 参数包含: -p:PublishSingleFile=true |
| 不支持 | 经过剪裁的自包含部署(Trimmed self-contained deployment) publish 参数包含: --self-contained true -p:PublishTrimmed=true |
| 支持框架 | Windows .NET 5.0 / .NET 6.0 / .NET 7.0 / .NET 8.0 |
| Microsoft.Extensions.Hosting | 从 SA 9.11.0(dotnet 6.15.2)开始支持 支持框架:.NET Framework 4.6.2+ |
| Web API 2(HttpServer) | 从 SA 9.11.0(dotnet 6.15.2)开始支持 支持框架:.NET Framework 4.5+ |
| TopShelf | 从 SA 10.0.0(dotnet 6.16.0)开始支持 支持框架:.NET Framework 4.5.2 / 4.6 / 4.6.1 / 4.7 / 4.8、.NET 5 / 6 / 7 / 8 支持模块版本:TopShelf.dll 4.3.0 |
其他
| 功能 | 说明 |
|---|---|
| JS 注入(Server 版本) | 从 Dotnet 探针 5.5.0 开始支持(仅 ASP.NET),ASP.NET Core 不支持 |
| JS 注入(One 版本) | 从 Dotnet 探针 6.4.0 开始支持(同时支持 ASP.NET 和 ASP.NET Core) |
| 后台接口黑名单 | 从 SmartAgent 9.8.0(DotnetAgent 6.14.4)开始支持 |
| .NET GC 活动指标和 GC 内存指标采集 | 支持框架:.NET Framework 4.0+、NET Core 3.0+,.NET 5.0+ 从 SA 9.9.1(dotnet 6.15.0)开始支持 |
| 本地配置自定义业务入口方法 | 从 SA 10.4.0(dotnet 6.16.3)开始支持 支持框架:.NET Framework 4.5+、.NET Core 2.0+、.NET 5.0/6.0/7.0/8.0/9.0 |