supported-technologies.asciidoc

Note	For the best reading experience, please view this documentation at elastic.co

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.

Note	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.

.NET versions

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.

Important

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.

Web frameworks

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 added[1.0]	2.1+	NuGet package
ASP.NET (.NET Framework) in IIS added[1.1]	4.6.2+ (IIS 7.0 or newer)	Profiler auto instrumentation or NuGet package

RPC Frameworks

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 added[1.7]	Grpc.Net.Client 2.23.2+ (client side)	NuGet package
	ASP.NET Core 2.1+ (server side)	NuGet package

Data access technologies

Automatic instrumentation is supported for the following data access technologies

Data access technology	Supported versions	Integration
Azure CosmosDB added[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 added[1.0]	Microsoft.EntityFrameworkCore 2.x+	NuGet package
Entity Framework 6 added[1.2]	EntityFramework 6.2+	NuGet package
Elasticsearch added[1.6]	Elasticsearch.Net 7.6.0+	NuGet package
	NEST 7.6.0+
MySQL added[1.12]	See profiler documentation	Profiler auto instrumentation
MongoDB added[1.9]	MongoDB.Driver 2.19.0+	NuGet package
Oracle added[1.12]	See profiler documentation	Profiler auto instrumentation
PostgreSQL added[1.12]	See profiler documentation	Profiler auto instrumentation
Redis added[1.8]	StackExchange.Redis 2.0.495+	NuGet package
SqlClient	System.Data.SqlClient 2.0.495+ added[1.8]	NuGet package
	See profiler documentation added[1.12]	Profiler auto instrumentation
SQLite added[1.12]	See profiler documentation	Profiler auto instrumentation

Messaging systems

We support automatic instrumentation for the following messaging systems

Messaging system	Supported versions	Integration
Azure Service Bus added[1.10]	Microsoft.Azure.ServiceBus 3.0.0+	NuGet package
	Azure.Messaging.ServiceBus 7.0.0+
Azure Queue Storage added[1.10]	Azure.Storage.Queues 12.6.0+	NuGet package
Kafka added[1.12]	See profiler documentation	Profiler auto instrumentation
RabbitMQ added[1.12]	See profiler documentation	Profiler auto instrumentation

Networking client-side technologies

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 added[1.0]	built-in	part of Elastic.Apm
System.Net.HttpWebRequest added[1.1]

Cloud services

Automatic instrumentation for the following cloud services

Cloud service	Supported versions	Integration
Azure CosmosDB added[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 added[1.10]	Microsoft.Azure.ServiceBus 3.0.0+	NuGet package
	Azure.Messaging.ServiceBus 7.0.0+
Azure Storage added[1.10]	Azure.Storage.Blobs 12.8.0+	NuGet package
	Azure.Storage.Queues 12.6.0+
	Azure.Storage.Files.Shares 12.6.0+