Docs » Instrument back-end applications to send spans to Splunk APM » Instrument .NET applications for Splunk Observability Cloud (OpenTelemetry) » OpenTelemetry .NET instrumentation compatibility and requirements

OpenTelemetry .NET instrumentation compatibility and requirements 🔗

Meet the following requirements to instrument .NET applications for Splunk Observability Cloud:

Ensure you are using supported .NET versions 🔗

The Splunk Distribution of OpenTelemetry .NET supports the following .NET versions:

  • .NET 6.0 and higher

  • .NET Framework 4.6.2 and higher

Supported libraries 🔗

The Splunk Distribution of OpenTelemetry .NET instruments the following libraries.

Caution

This is a beta distribution. Use it for evaluation purposes only. Don’t use it in production environments. Some features might have restrictions, limited stability, or might change in next versions. Limited support is provided on best-effort basis.

Traces instrumentations 🔗

Library

Supported versions

Instrumentation ID

ASP.NET Framework (.NET Framework)
MVC / WebApi (Only integrated pipeline mode supported)

See Ensure you are using supported .NET versions

ASPNET

ASP.NET Core

See Ensure you are using supported .NET versions

ASPNETCORE

Azure SDK

Azure. prefixed packages, released after October 1, 2021

AZURE

Elastic.Clients.Elasticsearch

8.0.0 and higher

ELASTICSEARCH

Microsoft.EntityFrameworkCore
(Not supported on .NET Framework)

6.0.12 and higher

ENTITYFRAMEWORKCORE

GraphQL
(Not supported on .NET Framework)

7.5.0 and higher

GRAPHQL

Grpc.Net.Client

2.52.0 to 3.0.0

GRPCNETCLIENT

System.Net.Http.HttpClient and
System.Net.HttpWebRequest

See Ensure you are using supported .NET versions

HTTPCLIENT

MassTransit
(Not supported on .NET Framework)

8.0.0 and higher

MASSTRANSIT

MongoDB.Driver.Core
(Not supported on .NET Framework)

2.13.3 to 3.0.0

MONGODB

MySqlConnector

2.0.0 and higher

MYSQLCONNECTOR

MySql.Data
(Not supported on .NET Framework)

8.1.0 and higher

MYSQLDATA

Npgsql

6.0.0 and higher

NPGSQL

NServiceBus

8.0.0 and higher

NSERVICEBUS

Microsoft.Data.SqlClient and
System.Data.SqlClient

Version 3.* is not supported on .NET Framework

SQLCLIENT

Quartz
(Not supported on .NET Framework 4.7.1 and lower)

3.4.0 and higher

QUARTZ

StackExchange.Redis
(Not supported on .NET Framework)

2.0.405 to 3.0.0

STACKEXCHANGEREDIS

System.ServiceModel
(Service side not supported on .NET)

4.7.0 and higher
of System.ServiceModel.Primitives

WCFCLIENT for client side instrumentation and
WCFSERVICE for service side instrumentation

Metrics instrumentations 🔗

Library

Supported versions

Instrumentation ID

ASP.NET Framework

See Ensure you are using supported .NET versions

ASPNET
(Requires the trace instrumentation)

ASP.NET Core

See Ensure you are using supported .NET versions

ASPNETCORE
(Automatically activates Microsoft.AspNetCore.Hosting.HttpRequestIn spans.)

System.Net.Http.HttpClient and
System.Net.HttpWebRequest

See Ensure you are using supported .NET versions

HTTPCLIENT

OpenTelemetry.Instrumentation.Runtime

See Ensure you are using supported .NET versions

NETRUNTIME

NServiceBus

8.0.0 and higher

NSERVICEBUS

OpenTelemetry.Instrumentation.Process

See Ensure you are using supported .NET versions

PROCESS

Logs instrumentations 🔗

Library

Supported versions

Instrumentation ID

Microsoft.Extensions.Logging 6.0.0 and higher
(Not supported on .NET Framework)

6.0.0 and higher

ILOGGER
(Requires the trace instrumentation)

Install and configure the Splunk Distribution of OpenTelemetry Collector 🔗

The Splunk Distribution of OpenTelemetry .NET exports application traces and spans to the Splunk Distribution of OpenTelemetry Collector, which also collects system metric data and logs, including profiling data.

To send application traces and spans to Splunk Observability Cloud, install the Splunk Distribution of OpenTelemetry Collector for your platform. The following distributions are available: