---
title: Python Compatibility Requirements
description: Compatibility Requirements for the Python tracer
breadcrumbs: >-
  Docs > APM > Application Instrumentation > Compatibility Requirements > Python
  Compatibility Requirements
---

# Python Compatibility Requirements

## Releases{% #releases %}

The Python APM Client library follows a [versioning policy](https://ddtrace.readthedocs.io/en/stable/versioning.html) that specifies the support level for the different versions of the library and Python runtime.

The following Python APM Client library release branches are supported:

| Release    | Support level                    | Minimum Datadog Agent |
| ---------- | -------------------------------- | --------------------- |
| `>=4.0,<5` | General Availability             | 7.28                  |
| `>=3.0,<4` | Maintenence (until May 31, 2026) | 7.28                  |
| `>=2.0,<3` | End of Life                      | 7.28                  |
| `<2`       | End of Life                      |

Support levels are defined by the following:

| Support Level                 | Support Provided                                                                                                                                     | Lifecycle Timeline                                                                                       |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| **General Availability (GA)** | New features and enhancementsAll bug and security fixes (on the latest minor release)Critical fixes backported (to the 3 most recent minor releases) | A major version is in GA for **12 months** following its initial `x.0.0` release.                        |
| **Maintenance**               | Critical security and bug fixes only                                                                                                                 | A major version enters Maintenance **12 months** after its initial release and remains for **6 months**. |
| **End of Life (EOL)**         | No updates or support                                                                                                                                | A major version becomes EOL **18 months** after its initial `x.0.0` release.                             |

The Python APM Client library supports the following Python runtimes:

| OS      | CPU                   | Runtime | Runtime version | Supported ddtrace versions |
| ------- | --------------------- | ------- | --------------- | -------------------------- |
| Linux   | x86-64, AArch64       | CPython | 3.9+            | `>=4, <5`                  |
| MacOS   | Intel, Apple Silicon  | CPython | 3.9+            | `>=4, <5`                  |
| Windows | 64bit, 32bit          | CPython | 3.9+            | `>=4, <5`                  |
| Linux   | x86-64, i686, AArch64 | CPython | 3.8+            | `>=3, <4`                  |
| MacOS   | Intel, Apple Silicon  | CPython | 3.8+            | `>=3, <4`                  |
| Windows | 64bit, 32bit          | CPython | 3.8+            | `>=3, <4`                  |
| Linux   | x86-64, i686, AArch64 | CPython | 3.7-3.13        | `>=2,<3`                   |
| MacOS   | Intel, Apple Silicon  | CPython | 3.7-3.13        | `>=2,<3`                   |
| Windows | 64bit, 32bit          | CPython | 3.7-3.13        | `>=2,<3`                   |
| Linux   | x86-64, i686, AArch64 | CPython | 2.7, 3.5-3.11   | `<2`                       |
| MacOS   | Intel, Apple Silicon  | CPython | 2.7, 3.5-3.11   | `<2`                       |
| Windows | 64bit, 32bit          | CPython | 2.7, 3.5-3.11   | `<2`                       |

## Integrations{% #integrations %}

To request support for additional libraries, contact our awesome [support team](https://docs.datadoghq.com/help).

### Web framework compatibility{% #web-framework-compatibility %}

The `ddtrace` library includes support for a number of web frameworks, including:

| Framework                                            | Supported Version                | Automatic | Library Documentation                                                                                                                        |
| ---------------------------------------------------- | -------------------------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| [asgi](http://asgi.readthedocs.io/)                  | \>= 2.0                          | no        | [https://ddtrace.readthedocs.io/en/stable/integrations.html#asgi](https://ddtrace.readthedocs.io/en/stable/integrations.html#asgi)           |
| [aiohttp](https://aiohttp.readthedocs.io) (client)   | \>= 2.0                          | yes       | [https://ddtrace.readthedocs.io/en/stable/integrations.html#aiohttp](https://ddtrace.readthedocs.io/en/stable/integrations.html#aiohttp)     |
| [aiohttp](https://aiohttp.readthedocs.io) (server)   | \>= 2.0                          | no        | [https://ddtrace.readthedocs.io/en/stable/integrations.html#aiohttp](https://ddtrace.readthedocs.io/en/stable/integrations.html#aiohttp)     |
| [Bottle](https://bottlepy.org)                       | \>= 0.11                         | no        | [https://ddtrace.readthedocs.io/en/stable/integrations.html#bottle](https://ddtrace.readthedocs.io/en/stable/integrations.html#bottle)       |
| [CherryPy](https://cherrypy.dev/)                    | \>= 11.2.0                       | no        | [https://ddtrace.readthedocs.io/en/stable/integrations.html#cherrypy](https://ddtrace.readthedocs.io/en/stable/integrations.html#cherrypy)   |
| [Django](https://www.djangoproject.com)              | \>= 1.8                          | yes       | [https://ddtrace.readthedocs.io/en/stable/integrations.html#django](https://ddtrace.readthedocs.io/en/stable/integrations.html#django)       |
| [djangorestframework](https://www.djangoproject.com) | \>= 3.4                          | yes       | [https://ddtrace.readthedocs.io/en/stable/integrations.html#django](https://ddtrace.readthedocs.io/en/stable/integrations.html#django)       |
| [Falcon](https://falconframework.org)                | \>= 1.0                          | no        | [https://ddtrace.readthedocs.io/en/stable/integrations.html#falcon](https://ddtrace.readthedocs.io/en/stable/integrations.html#falcon)       |
| [Flask](http://flask.pocoo.org)                      | \>= 0.10                         | yes       | [https://ddtrace.readthedocs.io/en/stable/integrations.html#flask](https://ddtrace.readthedocs.io/en/stable/integrations.html#flask)         |
| [FastAPI](https://fastapi.tiangolo.com/)             | \>= 0.51                         | yes       | [https://ddtrace.readthedocs.io/en/stable/integrations.html#fastapi](https://ddtrace.readthedocs.io/en/stable/integrations.html#fastapi)     |
| [Gunicorn](https://gunicorn.org/)                    | \>= 20.0.04                      | no        | [https://ddtrace.readthedocs.io/en/stable/integrations.html#gunicorn](https://ddtrace.readthedocs.io/en/stable/integrations.html#gunicorn)   |
| [Molten](https://moltenframework.com)                | \>= 0.7.0                        | yes       | [https://ddtrace.readthedocs.io/en/stable/integrations.html#molten](https://ddtrace.readthedocs.io/en/stable/integrations.html#molten)       |
| [Pylons](http://pylonsproject.org)                   | \>= 0.9.6 (dd-trace-py 1.x only) | no        | [https://ddtrace.readthedocs.io/en/v1.20.19/integrations.html#pylons](https://ddtrace.readthedocs.io/en/v1.20.19/integrations.html#pylons)   |
| [Pyramid](https://trypyramid.com)                    | \>= 1.7                          | no        | [https://ddtrace.readthedocs.io/en/stable/integrations.html#pyramid](https://ddtrace.readthedocs.io/en/stable/integrations.html#pyramid)     |
| [Sanic](https://sanic.readthedocs.io/en/latest/)     | \>= 19.6.0                       | yes       | [https://ddtrace.readthedocs.io/en/stable/integrations.html#sanic](https://ddtrace.readthedocs.io/en/stable/integrations.html#sanic)         |
| [Starlette](https://www.starlette.io/)               | \>= 0.13.0                       | yes       | [https://ddtrace.readthedocs.io/en/stable/integrations.html#starlette](https://ddtrace.readthedocs.io/en/stable/integrations.html#starlette) |
| [Tornado](http://www.tornadoweb.org)                 | \>= 4.0                          | no        | [https://ddtrace.readthedocs.io/en/stable/integrations.html#tornado](https://ddtrace.readthedocs.io/en/stable/integrations.html#tornado)     |

### Datastore compatibility{% #datastore-compatibility %}

The `ddtrace` library includes support for the following data stores:

| Datastore                                                                                               | Supported Version        | Automatic | Library Documentation                                                                                                                                                                            |
| ------------------------------------------------------------------------------------------------------- | ------------------------ | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [algoliasearch](https://www.algolia.com/doc/)                                                           | \>= 1.20.0               | yes       | [https://ddtrace.readthedocs.io/en/stable/integrations.html#algoliasearch](https://ddtrace.readthedocs.io/en/stable/integrations.html#algoliasearch)                                             |
| [asyncpg](https://magicstack.github.io/asyncpg/)                                                        | \>= 0.18.0               | yes       | [https://ddtrace.readthedocs.io/en/stable/integrations.html#asyncpg](https://ddtrace.readthedocs.io/en/stable/integrations.html#asyncpg)                                                         |
| [Cassandra](https://cassandra.apache.org)                                                               | \>= 3.5                  | yes       | [https://ddtrace.readthedocs.io/en/stable/integrations.html#cassandra](https://ddtrace.readthedocs.io/en/stable/integrations.html#cassandra)                                                     |
| [Elasticsearch](https://www.elastic.co/products/elasticsearch)                                          | \>= 1.6                  | yes       | [https://ddtrace.readthedocs.io/en/stable/integrations.html#elasticsearch](https://ddtrace.readthedocs.io/en/stable/integrations.html#elasticsearch)                                             |
| [Flask Cache](https://pythonhosted.org/Flask-Cache)                                                     | \>= 0.12                 | no        | [https://ddtrace.readthedocs.io/en/stable/integrations.html#flask-cache](https://ddtrace.readthedocs.io/en/stable/integrations.html#flask-cache)                                                 |
| [Mariadb](https://mariadb-corporation.github.io/mariadb-connector-python/index.html)                    | \>= 1.0.0                | yes       | [https://ddtrace.readthedocs.io/en/stable/integrations.html#mariadb](https://ddtrace.readthedocs.io/en/stable/integrations.html#mariadb)                                                         |
| [Memcached](https://memcached.org) [pylibmc](http://sendapatch.se/projects/pylibmc)                     | \>= 1.4                  | yes       | [https://ddtrace.readthedocs.io/en/stable/integrations.html#pylibmc](https://ddtrace.readthedocs.io/en/stable/integrations.html#pylibmc)                                                         |
| [Memcached](https://memcached.org) [pymemcache](https://pymemcache.readthedocs.io)                      | \>= 1.3                  | yes       | [https://ddtrace.readthedocs.io/en/stable/integrations.html#pymemcache](https://ddtrace.readthedocs.io/en/stable/integrations.html#pymemcache)                                                   |
| [MongoDB](https://www.mongodb.com/what-is-mongodb) [Mongoengine](http://mongoengine.org)                | \>= 0.11                 | yes       | [https://ddtrace.readthedocs.io/en/stable/integrations.html#mongoengine](https://ddtrace.readthedocs.io/en/stable/integrations.html#mongoengine)                                                 |
| [MongoDB](https://www.mongodb.com/what-is-mongodb) [Pymongo](https://pymongo.readthedocs.io/en/stable/) | \>= 3.0                  | yes       | [https://ddtrace.readthedocs.io/en/stable/integrations.html#pymongo](https://ddtrace.readthedocs.io/en/stable/integrations.html#pymongo)                                                         |
| [MySQL](https://www.mysql.com) [MySQL-python](https://pypi.org/project/MySQL-python)                    | \>= 1.2.3                | yes       | [https://ddtrace.readthedocs.io/en/stable/integrations.html#module-ddtrace.contrib.mysqldb](https://ddtrace.readthedocs.io/en/stable/integrations.html#module-ddtrace.contrib.mysqldb)           |
| [MySQL](https://www.mysql.com) [mysqlclient](https://pypi.org/project/mysqlclient)                      | \>= 1.3                  | yes       | [https://ddtrace.readthedocs.io/en/stable/integrations.html#module-ddtrace.contrib.mysqldb](https://ddtrace.readthedocs.io/en/stable/integrations.html#module-ddtrace.contrib.mysqldb)           |
| [MySQL](https://www.mysql.com) [mysql-connector](https://dev.mysql.com/doc/connector-python/en/)        | \>= 2.1                  | yes       | [https://ddtrace.readthedocs.io/en/stable/integrations.html#mysql-connector](https://ddtrace.readthedocs.io/en/stable/integrations.html#mysql-connector)                                         |
| [Opensearch](https://opensearch.org/)                                                                   | \>= 1.0                  | yes       | [https://ddtrace.readthedocs.io/en/stable/integrations.html#elasticsearch](https://ddtrace.readthedocs.io/en/stable/integrations.html#elasticsearch)                                             |
| [Postgres](https://www.postgresql.org) [aiopg](https://aiopg.readthedocs.io)                            | \>= 0.12.0, <= 0.16 | yes       | [https://ddtrace.readthedocs.io/en/stable/integrations.html#aiopg](https://ddtrace.readthedocs.io/en/stable/integrations.html#aiopg)                                                             |
| [Postgres](https://www.postgresql.org) [psycopg](https://www.psycopg.org/)                              | \>= 2.4                  | yes       | [https://ddtrace.readthedocs.io/en/stable/integrations.html#module-ddtrace.contrib.psycopg](https://ddtrace.readthedocs.io/en/stable/integrations.html#module-ddtrace.contrib.psycopg)           |
| [PyMySQL](https://pypi.org/project/PyMySQL/)                                                            | \>= 0.7                  | yes       | [https://ddtrace.readthedocs.io/en/stable/integrations.html?highlight=pymysql#pymysql](https://ddtrace.readthedocs.io/en/stable/integrations.html?highlight=pymysql#pymysql)                     |
| [PynamoDB](https://pynamodb.readthedocs.io/en/latest/)                                                  | \>= 4.0                  | yes       | [https://ddtrace.readthedocs.io/en/stable/integrations.html#pynamodb](https://ddtrace.readthedocs.io/en/stable/integrations.html#pynamodb)                                                       |
| [PyODBC](https://pypi.org/project/pyodbc/)                                                              | \>= 4.0                  | yes       | [https://ddtrace.readthedocs.io/en/stable/integrations.html#pyodbc](https://ddtrace.readthedocs.io/en/stable/integrations.html#pyodbc)                                                           |
| [Redis](https://redis.io)                                                                               | \>= 2.6                  | yes       | [https://ddtrace.readthedocs.io/en/stable/integrations.html#redis](https://ddtrace.readthedocs.io/en/stable/integrations.html#redis)                                                             |
| [Redis](https://redis.io) [redis-py-cluster](https://redis-py-cluster.readthedocs.io)                   | \>= 1.3.5                | yes       | [https://ddtrace.readthedocs.io/en/stable/integrations.html#module-ddtrace.contrib.rediscluster](https://ddtrace.readthedocs.io/en/stable/integrations.html#module-ddtrace.contrib.rediscluster) |
| [snowflake-connector-python](https://snowflake.com/)                                                    | \>= 2.1                  | no        | [https://ddtrace.readthedocs.io/en/stable/integrations.html#snowflake](https://ddtrace.readthedocs.io/en/stable/integrations.html#snowflake)                                                     |
| [SQLAlchemy](https://www.sqlalchemy.org)                                                                | \>= 1.0                  | no        | [https://ddtrace.readthedocs.io/en/stable/integrations.html#sqlalchemy](https://ddtrace.readthedocs.io/en/stable/integrations.html#sqlalchemy)                                                   |
| [SQLite3](https://www.sqlite.org)                                                                       | Fully Supported          | yes       | [https://ddtrace.readthedocs.io/en/stable/integrations.html#sqlite](https://ddtrace.readthedocs.io/en/stable/integrations.html#sqlite)                                                           |
| [Vertica](https://www.vertica.com)                                                                      | \>= 0.6                  | yes       | [https://ddtrace.readthedocs.io/en/stable/integrations.html#vertica](https://ddtrace.readthedocs.io/en/stable/integrations.html#vertica)                                                         |

**Note**: Redis 6.0+ supports inline authentication in commands such as `HELLO`, `MIGRATE`, and `ACL SETUSER`.

- **Datadog Trace Agent**: The minimum required and recommended version is `7.76.1` to ensure authentication parameters are automatically obfuscated in trace metadata.
- **Datadog Lambda Extension** (Serverless environments): The minimum required version is `v28.0.0`.

### Library compatibility{% #library-compatibility %}

The `ddtrace` library includes support for the following libraries:

| Library                                                                    | Supported Version | Automatic         | Library Documentation                                                                                                                            |
| -------------------------------------------------------------------------- | ----------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| [aiobotocore](https://pypi.org/project/aiobotocore/)                       | \>= 0.2.3         | no                | [https://ddtrace.readthedocs.io/en/stable/integrations.html#aiobotocore](https://ddtrace.readthedocs.io/en/stable/integrations.html#aiobotocore) |
| [asyncio](https://docs.python.org/3/library/asyncio.html)                  | Fully Supported   | \> Python 3.7 yes | [https://ddtrace.readthedocs.io/en/stable/integrations.html#asyncio](https://ddtrace.readthedocs.io/en/stable/integrations.html#asyncio)         |
| [Botocore](https://pypi.org/project/botocore/)                             | \>= 1.4.51        | yes               | [https://ddtrace.readthedocs.io/en/stable/integrations.html#botocore](https://ddtrace.readthedocs.io/en/stable/integrations.html#botocore)       |
| [Boto2](http://docs.pythonboto.org/en/latest)                              | \>= 2.29.0        | yes               | [https://ddtrace.readthedocs.io/en/stable/integrations.html#boto2](https://ddtrace.readthedocs.io/en/stable/integrations.html#boto2)             |
| [Celery](http://www.celeryproject.org)                                     | \>= 4.4.0         | yes               | [https://ddtrace.readthedocs.io/en/stable/integrations.html#celery](https://ddtrace.readthedocs.io/en/stable/integrations.html#celery)           |
| [Consul](https://python-consul.readthedocs.io/en/latest/)                  | \>= 0.7           | yes               | [https://ddtrace.readthedocs.io/en/stable/integrations.html#consul](https://ddtrace.readthedocs.io/en/stable/integrations.html#consul)           |
| [Futures](https://docs.python.org/3/library/concurrent.futures.html)       | Fully Supported   | yes               | [https://ddtrace.readthedocs.io/en/stable/integrations.html#futures](https://ddtrace.readthedocs.io/en/stable/integrations.html#futures)         |
| [gevent](http://www.gevent.org)                                            | \>= 20.12         | yes               | [https://ddtrace.readthedocs.io/en/stable/integrations.html#gevent](https://ddtrace.readthedocs.io/en/stable/integrations.html#gevent)           |
| [Grpc](https://grpc.io)                                                    | \>= 1.8.0         | yes               | [https://ddtrace.readthedocs.io/en/stable/integrations.html#grpc](https://ddtrace.readthedocs.io/en/stable/integrations.html#grpc)               |
| [httplib](https://docs.python.org/2/library/httplib.html)                  | Fully Supported   | no                | [https://ddtrace.readthedocs.io/en/stable/integrations.html#httplib](https://ddtrace.readthedocs.io/en/stable/integrations.html#httplib)         |
| [Logbook](https://logbook.readthedocs.io/en/stable/)                       | \>= 1.0.0         | no                | [https://ddtrace.readthedocs.io/en/stable/integrations.html#logbook](https://ddtrace.readthedocs.io/en/stable/integrations.html#logbook)         |
| [Loguru](https://loguru.readthedocs.io/en/stable/)                         | \>= 0.4.0         | no                | [https://ddtrace.readthedocs.io/en/stable/integrations.html#loguru](https://ddtrace.readthedocs.io/en/stable/integrations.html#loguru)           |
| [Jinja2](http://jinja.pocoo.org)                                           | \>= 2.7           | yes               | [https://ddtrace.readthedocs.io/en/stable/integrations.html#jinja2](https://ddtrace.readthedocs.io/en/stable/integrations.html#jinja2)           |
| [Kombu](https://kombu.readthedocs.io/en/latest)                            | \>= 4.0           | no                | [https://ddtrace.readthedocs.io/en/stable/integrations.html#kombu](https://ddtrace.readthedocs.io/en/stable/integrations.html#kombu)             |
| [Mako](https://www.makotemplates.org)                                      | \>= 0.1.0         | yes               | [https://ddtrace.readthedocs.io/en/stable/integrations.html#mako](https://ddtrace.readthedocs.io/en/stable/integrations.html#mako)               |
| [Requests](https://requests.readthedocs.io/en/master/)                     | \>= 2.08          | yes               | [https://ddtrace.readthedocs.io/en/stable/integrations.html#requests](https://ddtrace.readthedocs.io/en/stable/integrations.html#requests)       |
| [structlog](https://www.structlog.org/en/stable/)                          | \>= 20.2.0        | no                | [https://ddtrace.readthedocs.io/en/stable/integrations.html#structlog](https://ddtrace.readthedocs.io/en/stable/integrations.html#structlog)     |
| [urllib3](https://urllib3.readthedocs.io/en/stable/)                       | \>= 1.22          | no                | [https://ddtrace.readthedocs.io/en/stable/integrations.html#urllib3](https://ddtrace.readthedocs.io/en/stable/integrations.html#urllib3)         |
| [graphql-core](https://graphql-core-3.readthedocs.io/en/latest/intro.html) | \>= 2.0           | yes               | [https://ddtrace.readthedocs.io/en/stable/integrations.html#graphql](https://ddtrace.readthedocs.io/en/stable/integrations.html#graphql)         |
| [pytest](https://docs.pytest.org/en/stable/)                               | \>= 3.0           | no                | [https://ddtrace.readthedocs.io/en/stable/integrations.html#pytest](https://ddtrace.readthedocs.io/en/stable/integrations.html#pytest)           |

## Further Reading{% #further-reading %}

- [Instrument Your Application](https://docs.datadoghq.com/tracing/trace_collection/dd_libraries/python)