EDOT .NET

The Elastic Distribution of OpenTelemetry .NET (EDOT .NET) provides an extension of the OpenTelemetry SDK for .NET.

EDOT .NET makes it easier to get started using OpenTelemetry in your .NET applications through strictly OpenTelemetry native means while also providing a smooth and rich out-of-the-box experience with Elastic Observability.

To learn more about OpenTelemetry distributions in general, visit the OpenTelemetry documentation.

Getting started

The quickest way to get started with EDOT .NET is to follow our quickstart guide. We also have guides for installing and using EDOT .NET in common application templates:

Features

With EDOT .NET, you have access to all the features of the OpenTelemetry SDK for .NET plus:

  • Access to SDK enhancements and bug fixes contributed by the Elastic team before the changes are available upstream in OpenTelemetry repositories.
  • Elastic-specific processors that ensure optimal compatibility when exporting OpenTelemetry signal data to an Elastic backend like an Elastic Observability deployment.
  • Preconfigured collection of tracing and metrics signals, applying opinionated defaults, such as which instrumentation sources are observed by default.
  • Ensuring that the OpenTelemetry protocol (OTLP) exporter is enabled by default.
  • Instrumentation assembly scanning to automatically enable instrumentation from installed contrib NuGet packages.

Instrumentation assembly scanning is not supported for applications using native AOT or single-file deployment compilation features.

.NET runtime support

EDOT .NET support all officially supported versions of .NET and .NET Framework¹ (an older Windows-based .NET implementation), except .NET Framework 3.5.

  1. Due to assembly binding issues introduced by Microsoft, we recommend at least .NET Framework 4.7.2 for best compatibility.

Compatibility matrix

Data can be exported in the OpenTelemetry-native OTLP (OpenTelemetry protocol) format via gRPC (recommended) and HTTP to self-managed, Elastic Cloud Hosted or Elastic Cloud Serverless observability backends.

For the best (and supported) experience, we recommend exporting data from EDOT .NET via the EDOT Collector.

EDOT .NET version 8.x 9.x Serverless
1.0.0 8.18.0+¹ 9.0.0+¹ 🗸 ²

1. Via the EDOT Collector.

2. Via the OTel-native ingest endpoint.

Table of contents