|
| 1 | +# Runtime support policy for .NET APM |
| 2 | + |
| 3 | +Datadog APM for .NET is built upon dependencies defined in specific versions of the host operating system, .NET runtime, certain .NET libraries, and the Datadog Agent/API. When these versions are no longer supported by their maintainers, Datadog APM for .NET limits its support for these as well. |
| 4 | + |
| 5 | +## Levels of support |
| 6 | + |
| 7 | +| **Level** | **Support provided** | |
| 8 | +|--------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |
| 9 | +| <span id="support-unsupported">Unsupported</span> | No implementation. [Contact our customer support team for special requests.](https://www.datadoghq.com/support/) | |
| 10 | +| <span id="support-beta">Beta</span> | Initial implementation. May not yet contain all features. Support for new features, bug & security fixes provided on a best-effort basis. | |
| 11 | +| <span id="support-ga">General Availability (GA)</span> | Full implementation of all features. Full support for new features, bug & security fixes. | |
| 12 | +| <span id="support-maintenance">Maintenance</span> | Full implementation of existing features. Does not receive new features. Support for bug & security fixes only. | |
| 13 | +| <span id="support-legacy">Legacy</span> | Legacy implementation. May have limited function, but no maintenance provided. [Contact our customer support team for special requests.](https://www.datadoghq.com/support/) | |
| 14 | +| <span id="support-eol">End-of-life (EOL)</span> | No support. | |
| 15 | + |
| 16 | +## Package versioning |
| 17 | + |
| 18 | +Datadog APM for .NET practices [semantic versioning](https://semver.org/). |
| 19 | + |
| 20 | +As this relates to downgrading runtime support, it implies: |
| 21 | + |
| 22 | + - **Major version updates** (e.g. `1.0.0` to `2.0.0`) may change support for any runtime from [Beta](#support-beta)/[GA](#support-ga) to [Maintenance](#support-maintenance)/[Legacy](#support-legacy)/[EOL](#support-eol). |
| 23 | + - **Minor version updates** (e.g. `1.0.0` to `1.1.0`) will not change support for any runtime. |
| 24 | + - **Patch version updates** (e.g. `1.0.0` to `1.0.1`) will not change support for any runtime. |
| 25 | + |
| 26 | +## Supported .NET runtimes |
| 27 | + |
| 28 | +| **Engine** | **.NET version** | **Support level** | **Package version** | **MICROSOFT END OF LIFE** | |
| 29 | +|-----------------|------------------|-----------------------|----------------------|---------------------------| |
| 30 | +| .NET Core | .NET 6 | [GA](#support-ga) | Latest (>= `2.0.0`) | | |
| 31 | +| | .NET 5 | [GA](#support-ga) | Latest (>= `1.27.0`) | | |
| 32 | +| | .NET Core 3.1 | [GA](#support-ga) | Latest | 12/03/2022 | |
| 33 | +| | .NET Core 2.1 | [GA](#support-ga) | Latest | 08/21/2021 | |
| 34 | +| .NET FRAMEWORK | 4.8 | [GA](#support-ga) | Latest | | |
| 35 | +| | 4.7.2 | [GA](#support-ga) | Latest | | |
| 36 | +| | 4.7 | [GA](#support-ga) | Latest | | |
| 37 | +| | 4.6.2 | [GA](#support-ga) | Latest | | |
| 38 | +| | 4.6.1 | [GA](#support-ga) | Latest | 04/26/2022 | |
| 39 | +| | 4.6 | [EOL](#support-eol) | < `2.0.0` | 04/26/2022 | |
| 40 | +| | 4.5.2 | [EOL](#support-eol) | < `2.0.0` | 04/26/2022 | |
| 41 | +| | 4.5.1 | [EOL](#support-eol) | < `2.0.0` | 01/12/2016 | |
| 42 | +| | 4.5.0 | [EOL](#support-eol) | < `2.0.0` | 01/12/2016 | |
| 43 | + |
| 44 | +## Supported operating systems |
| 45 | + |
| 46 | +| **OS** | **Support level** | **Package version** | |
| 47 | +|----------------|-----------------------|---------------------| |
| 48 | +| Linux x86-64 | [GA](#support-ga) | Latest | |
| 49 | +| Windows x86-64 | [EOL](#support-ga) | Latest | |
| 50 | +| Alpine | [GA](#support-ga) | Latest | |
| 51 | +| MacOS | Dev environments only | Latest | |
| 52 | + |
| 53 | +## Supported Datadog Agent versions |
| 54 | + |
| 55 | +| **Datadog Agent version** | **Package version** | |
| 56 | +|--------------------------------------------------------------------------|---------------------| |
| 57 | +| [7.x](https://docs.datadoghq.com/agent/basic_agent_usage/?tab=agentv6v7) | Latest | |
| 58 | +| [6.x](https://docs.datadoghq.com/agent/basic_agent_usage/?tab=agentv6v7) | Latest | |
| 59 | +| [5.x](https://docs.datadoghq.com/agent/basic_agent_usage/?tab=agentv5) | Latest | |
| 60 | + |
| 61 | +## Additional resources |
| 62 | + |
| 63 | +``` |
| 64 | +DEV: Consider adding/removing links to other useful resources here. |
| 65 | + Especially to where one may get more information about what's supported. |
| 66 | +``` |
| 67 | + |
| 68 | +- [Datadog Customer support](https://www.datadoghq.com/support/) |
| 69 | +- [Datadog APM for .NET Setup Documentation](https://docs.datadoghq.com/tracing/setup_overview/setup/ruby/) |
| 70 | +- [Datadog APM for .NET GitHub repository](https://github.com/DataDog/dd-trace-rb) |
0 commit comments