Python Compatibility Requirements


The Python APM Client library follows a versioning policy that specifies the support level for the different versions of the library and Python runtime.

Two release branches are supported:

ReleaseSupport level
>=1.0,<2General Availability

And the library supports the following runtimes:

OSCPURuntimeRuntime versionSupport ddtrace versions
Linuxx86-64, i686, AArch64CPython2.7, 3.5-3.10<2
MacOSIntel, Apple SiliconCPython2.7, 3.5-3.10<2
Windows64bit, 32bitCPython2.7, 3.5-3.10<2


To request support for additional libraries, contact our awesome support team.

Web framework compatibility

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

FrameworkSupported VersionAutomaticLibrary Documentation
asgi>= 2.0no
aiohttp (client)>= 2.0yes
aiohttp (server)>= 2.0no
Bottle>= 0.11no
CherryPy>= 11.2.0no
Django>= 1.8yes
djangorestframework>= 3.4yes
Falcon>= 1.0no
Flask>= 0.10yes
FastAPI>= 0.51yes
Molten>= 0.7.0yes
Pylons>= 0.9.6no
Pyramid>= 1.7no
pytest>= 3.0no
Sanic>= 19.6.0yes
Starlette>= 0.13.0yes
Tornado>= 4.0no

Datastore compatibility

The ddtrace library includes support for the following data stores:

DatastoreSupported VersionAutomaticLibrary Documentation
algoliasearch>= 1.20.0yes
asyncpg>= 0.18.0yes
Cassandra>= 3.5yes
Elasticsearch>= 1.6yes
Flask Cache>= 0.12no
Mariadb>= 1.0.0yes
Memcached pylibmc>= 1.4yes
Memcached pymemcache>= 1.3yes
MongoDB Mongoengine>= 0.11yes
MongoDB Pymongo>= 3.0yes
MySQL MySQL-python>= 1.2.3yes
MySQL mysqlclient>= 1.3yes
MySQL mysql-connector>= 2.1yes
Postgres aiopg>= 0.12.0, <= 0.16yes
Postgres psycopg>= 2.4yes
PyMySQL>= 0.7yes
PynamoDB>= 4.0yes
PyODBC>= 4.0yes
Redis>= 2.6yes
Redis redis-py-cluster>= 1.3.5yes
SQLAlchemy>= 1.0no
SQLite3Fully Supportedyes
Vertica>= 0.6yes

Library compatibility

The ddtrace library includes support for the following libraries:

LibrarySupported VersionAutomaticLibrary Documentation
aiobotocore>= 0.2.3no
asyncioFully Supported> Python 3.7 yes
Botocore>= 1.4.51yes
Boto2>= 2.29.0yes
Celery>= 3.1yes
Consul>= 0.7yes
FuturesFully Supportedyes
gevent>= 1.0no
Grpc>= 1.8.0yes
httplibFully Supportedno
Jinja2>= 2.7yes
Kombu>= 4.0no
Mako>= 0.1.0yes
Requests>= 2.08yes
urllib3>= 1.22no
graphql-core>= 2.0yes

Further Reading

Additional helpful documentation, links, and articles: