支持的技术

编辑

如果您的首选技术尚未得到支持,您可以通过参与我们的 调查 为其投票。我们将根据结果为需求量最大的技术添加支持。

另一种选择是向代理的 公共 API 添加依赖项,以便以编程方式创建自定义事务和跨度。

如果您想扩展代理的自动检测功能,贡献指南 将帮助您入门。

例如,如果您的首选 HTTP 客户端库未列出,则表示这些传出 HTTP 请求将不会有跨度。如果使用的 Web 框架不受支持,则代理将不会捕获事务。

.NET 版本

编辑

该代理适用于支持 .NET Standard 2.0 的所有 .NET 版本和类型。这意味着 .NET Core 2.0 或更高版本,以及 .NET Framework 4.6.2* 或更高版本。

* 由于 Microsoft 引入的绑定问题,我们建议至少使用 .NET Framework 4.7.2 以获得最佳兼容性。

虽然此库应该在 .NET Core 2.0+ 上运行,但我们将支持范围限制为 Microsoft 当前支持的版本 - .NET 6.0 及更高版本。

Web 框架

编辑

Web 框架的自动检测意味着会为每个传入请求自动创建一个事务,并以注册路由命名。

以下 Web 框架支持自动检测

框架 支持的版本 集成

ASP.NET Core [1.0] 在 1.0 中添加。

2.1+

NuGet 包

ASP.NET(.NET Framework)在 IIS 中 [1.1] 在 1.1 中添加。

4.6.2+(IIS 7.0 或更高版本)

探查器自动检测

NuGet 包

RPC 框架

编辑

该代理支持 .NET Core 上的 gRPC,包括客户端和服务器端。代理会自动捕获每个 gRPC 调用。

不支持流式传输;对于流式传输用例,代理不会自动创建事务和跨度。

框架 支持的版本 集成

gRPC [1.7] 在 1.7 中添加。

Grpc.Net.Client 2.23.2+ (客户端)

NuGet 包

ASP.NET Core 2.1+ (服务器端)

NuGet 包

数据访问技术

编辑

以下数据访问技术支持自动检测

数据访问技术 支持的版本 集成

Azure CosmosDB [1.11] 在 1.11 中添加。

Microsoft.Azure.Cosmos 3.0.0+

NuGet 包

Microsoft.Azure.DocumentDB.Core 2.4.1+

Microsoft.Azure.DocumentDB 2.4.1+

Entity Framework Core [1.0] 在 1.0 中添加。

Microsoft.EntityFrameworkCore 2.x+

NuGet 包

Entity Framework 6 [1.2] 在 1.2 中添加。

EntityFramework 6.2+

NuGet 包

Elasticsearch [1.6] 在 1.6 中添加。

Elasticsearch.Net 7.6.0+

NuGet 包

NEST 7.6.0+

MySQL [1.12] 在 1.12 中添加。

请参阅探查器文档

探查器自动检测

MongoDB [1.9] 在 1.9 中添加。

MongoDB.Driver 2.19.0+

NuGet 包

Oracle [1.12] 在 1.12 中添加。

请参阅探查器文档

探查器自动检测

PostgreSQL [1.12] 在 1.12 中添加。

请参阅探查器文档

探查器自动检测

Redis [1.8] 在 1.8 中添加。

StackExchange.Redis 2.0.495+

NuGet 包

SqlClient

System.Data.SqlClient 2.0.495+ [1.8] 在 1.8 中添加。

NuGet 包

请参阅探查器文档 [1.12] 在 1.12 中添加。

探查器自动检测

SQLite [1.12] 在 1.12 中添加。

请参阅探查器文档

探查器自动检测

消息系统

编辑

我们支持以下消息系统的自动检测

消息系统 支持的版本 集成

Azure Service Bus [1.10] 在 1.10 中添加。

Microsoft.Azure.ServiceBus 3.0.0+

NuGet 包

Azure.Messaging.ServiceBus 7.0.0+

Azure 队列存储 [1.10] 在 1.10 中添加。

Azure.Storage.Queues 12.6.0+

NuGet 包

Kafka [1.12] 在 1.12 中添加。

请参阅探查器文档

探查器自动检测

RabbitMQ [1.12] 在 1.12 中添加。

请参阅探查器文档

探查器自动检测

网络客户端技术

编辑

网络客户端技术的自动检测意味着会为每个传出 HTTP 请求自动创建一个 HTTP 跨度,并传播跟踪标头。

框架 支持的版本 集成

System.Net.Http.HttpClient [1.0] 在 1.0 中添加。

内置

Elastic.Apm 的一部分

System.Net.HttpWebRequest [1.1] 在 1.1 中添加。

云服务

编辑

以下云服务支持自动检测

云服务 支持的版本 集成

Azure CosmosDB [1.11] 在 1.11 中添加。

Microsoft.Azure.Cosmos 3.0.0+

NuGet 包

Microsoft.Azure.DocumentDB.Core 2.4.1+

Microsoft.Azure.DocumentDB 2.4.1+

Azure Service Bus [1.10] 在 1.10 中添加。

Microsoft.Azure.ServiceBus 3.0.0+

NuGet 包

Azure.Messaging.ServiceBus 7.0.0+

Azure 存储 [1.10] 在 1.10 中添加。

Azure.Storage.Blobs 12.8.0+

NuGet 包

Azure.Storage.Queues 12.6.0+

Azure.Storage.Files.Shares 12.6.0+