Versioning#

Release support#

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

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

MAJOR

Incompatible changes to the public interface

Removing support for a runtime.

MINOR

Backwards compatible changes to the public interface

Any backwards compatible or incompatible changes to the internal interface

Adding support for a runtime

PATCH

Bug fixes that are backwards compatible

Security fixes that are backwards compatible

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.

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`