Skip to content

Latest commit

 

History

History
139 lines (103 loc) · 3.27 KB

versioning.rst

File metadata and controls

139 lines (103 loc) · 3.27 KB

Versioning

Release support

Release :ref:`Support level<versioning_support_levels>` Minimum Datadog Agent
<2 :ref:`End of Life<versioning_support_eol>`  
>=2.0,<3 :ref:`Maintenance<versioning_support_maintenance>` 7.28
>=3.0,<4 :ref:`General Availability<versioning_support_ga>` 7.28

Support levels

Level Policy
General Availability (GA) Bug fixes are released on the most recent General Availability minor release line. New features are released periodically as minor version changes. Critical fixes are backported to the three most recent minor release lines.
Maintenance The most recent Maintenance minor release line receives critical fixes.
End-of-Life (EOL) Receives no updates or support

Release versions

The non-negative integer components of the version format (v<MAJOR>.<MINOR>.<PATCH>) are incremented by the criteria:

MAJOR

Incompatible changes to the public :ref:`interface<versioning_interfaces>`

Removing support for a :ref:`runtime<versioning_supported_runtimes>`.

MINOR

Backwards compatible changes to the public :ref:`interface<versioning_interfaces>`

Any backwards compatible or incompatible changes to the internal :ref:`interface<versioning_interfaces>`

Adding support for a :ref:`runtime<versioning_supported_runtimes>`

PATCH

Bug fixes that are backwards compatible

Security fixes that are backwards compatible

Interfaces

For semantic versioning purposes, the public API is defined as follows.

The definition of the public interface:
Any module, function, class or attribute that is not internal
The definition of the internal interface:

The ddtrace.vendor module is internal

Any package with the name internal is internal (e.g. ddtrace.internal, ddtrace.contrib.internal)

Any module, function, class or attribute that is prefixed with a single underscore is internal

Any module, function, class or attribute that is contained within an internal module is internal

Internal code may be subject to breaking changes in bug fix and minor releases.

Supported runtimes

OS CPU Runtime Runtime version Supported Release
Linux x86-64, i686, AArch64 CPython 3.7-3.13 >=2.0,<3
MacOS Intel, Apple Silicon CPython 3.7-3.13 >=2.0,<3
Windows 64bit, 32bit CPython 3.7-3.13 >=2.0,<3
Linux x86-64, i686, AArch64 CPython 2.7, 3.5-3.11 >=1.0,<2
MacOS Intel, Apple Silicon CPython 2.7, 3.5-3.11 >=1.0,<2
Windows 64bit, 32bit CPython 2.7, 3.5-3.11 >=1.0,<2