Skip to content

Commit 40bd03c

Browse files
committed
Update supported technologies
1 parent abf4244 commit 40bd03c

File tree

1 file changed

+47
-4
lines changed

1 file changed

+47
-4
lines changed

docs/_edot-sdks/dotnet/supported-technologies.md

+47-4
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,51 @@ nav_order: 3
55
parent: EDOT .NET
66
---
77

8-
# Technologies Supported by the EDOT .NET Agent
8+
# Technologies Supported by EDOT .NET SDK
99

10-
TODO:
11-
- Reference the upstream .NET instrumentation.
12-
- Describe differences (also in default behavior) of EDOT .NET compared to upstream.
10+
EDOT .NET is a distribution of OpenTelemetry .NET SDK, it thus inherits all the supported technologies
11+
from the [upstream SDK](https://github.com/open-telemetry/opentelemetry-dotnet).
12+
13+
## .NET Frameworks
14+
15+
This includes the currently supported Microsoft .NET frameworks:
16+
17+
| Framework | End of support |
18+
|:---------------------- |:------------------- |
19+
| .NET Framework 4.6.2 | 12th Jan 2027 |
20+
| .NET Framework 4.7 | _Not announced_ |
21+
| .NET Framework 4.7.1 | _Not announced_ |
22+
| .NET Framework 4.7.2 | _Not announced_ |
23+
| .NET Framework 4.8 | _Not announced_ |
24+
| .NET Framework 4.8.1 | _Not announced_ |
25+
| .NET 8 | 10th November 2026 |
26+
| .NET 9 | 12th May 2026 |
27+
| .NET 10 (preview)¹ | _Not announced_ |
28+
29+
1. Official support begins once this is released (generally available) in November 2025
30+
31+
For further details, see [Microsoft .NET Framework support dates](https://learn.microsoft.com/lifecycle/products/microsoft-net-framework)
32+
and [.NET Support Policy](https://dotnet.microsoft.com/platform/support/policy).
33+
34+
## Instrumentations
35+
36+
Instrumentation for .NET can occur in three main ways:
37+
38+
1. Built-in OpenTelemetry native instrumentation (the end goal for OpenTelemetry),
39+
where libraries are instrumented using the .NET APIs, requiring no bridging libraries to
40+
be observed. Many Microsoft recent libraries implement OpenTelemetry native instrumentation, and many third parties
41+
are working on such improvements. When native OTel instrumentation
42+
exists, it may be observed directly by the OpenTelemetry SDK (and, by extension, EDOT .NET) by calling
43+
`AddSource` to register the `ActivitySource` used by the instrumented code.
44+
1. [Contrib instrumentation](https://github.com/open-telemetry/opentelemetry-dotnet-contrib) packages.
45+
These packages "bridge" existing telemetry from libraries to emit or enrich OpenTelemetry spans and metrics.
46+
Some packages have no dependencies and are included with EDOT .NET [by default](./setup/edot-defaults).
47+
Others, which bring in transitive dependencies, can be added to applications and registered with the
48+
OpenTelemetry SDK. EDOT .NET provides an instrumentation assembly scanning feature to register any contrib instrumentation without code changes.
49+
1. Additional instrumentation is available for some components and libraries when using the
50+
profiler-based [zero code installation](./setup/zero-code.md), for which EDOT .NET does not add any additional
51+
instrumentation. The current list supported upstream can be found in the
52+
[.NET zero-code documentation](https://opentelemetry.io/docs/zero-code/dotnet/instrumentations/).
53+
54+
See also the EDOT .NET [opinionated defaults](./setup/edot-defaults.md) for behaviour that might differ from the
55+
OpenTelemetry NET SDK defaults.

0 commit comments

Comments
 (0)