Supported technologies
If your favorite technology is not supported yet, you can vote for it by participating in our survey. We will use the results to add support for the most requested technologies.
Another option is to add a dependency to the agent’s public API in order to programmatically create custom transactions and spans.
If you want to extend the auto-instrumentation capabilities of the agent, the contributing guide should get you started.
If, for example, the HTTP client library of your choice is not listed, it means that there won’t be spans for those outgoing HTTP requests. If the web framework you are using is not supported, the agent will not capture transactions.
The agent works on every .NET flavor and version that supports .NET Standard 2.0. This means .NET Core 2.0 or newer, and .NET Framework 4.6.2* or newer.
** Due to binding issues introduced by Microsoft, we recommend at least .NET Framework 4.7.2 for best compatibility.*
While this library should work on .NET Core 2.0+, we limit our support to only those versions currently supported by Microsoft - .NET 6.0 and newer.
Automatic instrumentation for a web framework means a transaction is automatically created for each incoming request and it is named after the registered route.
Automatic instrumentation is supported for the following web frameworks
| Framework | Supported versions | Integration |
|---|---|---|
| ASP.NET Core [1.0] | 2.1+ | NuGet package |
| ASP.NET (.NET Framework) in IIS [1.1] | 4.6.2+ (IIS 7.0 or newer) | Profiler auto instrumentation or NuGet package |
The agent supports gRPC on .NET Core both on the client and the server side. Every gRPC call is automatically captured by the agent.
Streaming is not supported; for streaming use-cases, the agent does not create transactions and spans automatically.
| Framework | Supported versions | Integration |
|---|---|---|
| gRPC [1.7] | Grpc.Net.Client 2.23.2+ (client side) | NuGet package |
| ASP.NET Core 2.1+ (server side) | NuGet package |
Automatic instrumentation is supported for the following data access technologies
| Data access technology | Supported versions | Integration |
|---|---|---|
| Azure CosmosDB [1.11] | Microsoft.Azure.Cosmos 3.0.0+ | NuGet package |
| Microsoft.Azure.DocumentDB.Core 2.4.1+ | ||
| Microsoft.Azure.DocumentDB 2.4.1+ | ||
| Entity Framework Core [1.0] | Microsoft.EntityFrameworkCore 2.x+ | NuGet package |
| Entity Framework 6 [1.2] | EntityFramework 6.2+ | NuGet package |
| Elasticsearch [1.6] | Elasticsearch.Net 7.6.0+ | NuGet package |
| NEST 7.6.0+ | ||
| MySQL [1.12] | See profiler documentation | Profiler auto instrumentation |
| MongoDB [1.9] | MongoDB.Driver 2.19.0+ | NuGet package |
| Oracle [1.12] | See profiler documentation | Profiler auto instrumentation |
| PostgreSQL [1.12] | See profiler documentation | Profiler auto instrumentation |
| Redis [1.8] | StackExchange.Redis 2.0.495+ | NuGet package |
| SqlClient | System.Data.SqlClient 2.0.495+ [1.8] | NuGet package |
| See profiler documentation [1.12] | Profiler auto instrumentation | |
| SQLite [1.12] | See profiler documentation | Profiler auto instrumentation |
We support automatic instrumentation for the following messaging systems
| Messaging system | Supported versions | Integration |
|---|---|---|
| Azure Service Bus [1.10] | Microsoft.Azure.ServiceBus 3.0.0+ | NuGet package |
| Azure.Messaging.ServiceBus 7.0.0+ | ||
| Azure Queue Storage [1.10] | Azure.Storage.Queues 12.6.0+ | NuGet package |
| Kafka [1.12] | See profiler documentation | Profiler auto instrumentation |
| RabbitMQ [1.12] | See profiler documentation | Profiler auto instrumentation |
Automatic instrumentation for networking client-side technology means an HTTP span is automatically created for each outgoing HTTP request and tracing headers are propagated.
| Framework | Supported versions | Integration |
|---|---|---|
| System.Net.Http.HttpClient [1.0] | built-in | part of Elastic.Apm |
| System.Net.HttpWebRequest [1.1] |
Automatic instrumentation for the following cloud services
| Cloud service | Supported versions | Integration |
|---|---|---|
| Azure CosmosDB [1.11] | Microsoft.Azure.Cosmos 3.0.0+ | NuGet package |
| Microsoft.Azure.DocumentDB.Core 2.4.1+ | ||
| Microsoft.Azure.DocumentDB 2.4.1+ | ||
| Azure Service Bus [1.10] | Microsoft.Azure.ServiceBus 3.0.0+ | NuGet package |
| Azure.Messaging.ServiceBus 7.0.0+ | ||
| Azure Storage [1.10] | Azure.Storage.Blobs 12.8.0+ | NuGet package |
| Azure.Storage.Queues 12.6.0+ | ||
| Azure.Storage.Files.Shares 12.6.0+ |