본문 바로가기
WIKI 기술 지식 베이스

Python 호환성 요구사항 (Python Compatibility Requirements)

원문 보기 위키 갱신

Datadog Python APM Client 라이브러리의 호환성 요구사항을 안내해요.

출처: 문서

본문

릴리스 (Releases)

Python APM Client 라이브러리는 라이브러리와 Python 런타임의 서로 다른 버전에 대한 지원 수준을 지정하는 버전 관리 정책을 따르고 있어요.

다음 Python APM Client 라이브러리 릴리스 브랜치가 지원돼요:

릴리스 지원 수준 최소 Datadog Agent
>=4.0,<5 GA 7.63.0
>=3.0,<4 유지보수(2026년 5월 31일까지) 7.28
>=2.0,<3 EOL 7.28
<2 EOL

지원 수준은 다음과 같이 정의돼요:

지원 수준 제공되는 지원 수명주기 타임라인
GA (General Availability) - 새 기능과 개선 사항
  • 모든 버그·보안 수정(최신 마이너 릴리스 기준)
  • 중요 수정 백포트(가장 최근 3개 마이너 릴리스로) | 메이저 버전은 초기 x.0.0 릴리스 이후 12개월 동안 GA 상태예요. | | 유지보수 (Maintenance) | - 중요 보안·버그 수정만 | 메이저 버전은 초기 릴리스 12개월 후 유지보수 단계에 들어가 6개월 동안 지속돼요. | | EOL (End of Life) | - 업데이트나 지원 없음 | 메이저 버전은 초기 x.0.0 릴리스 18개월 후 EOL이 돼요. |

Python APM Client 라이브러리는 다음 Python 런타임을 지원해요:

OS CPU 런타임 런타임 버전 지원되는 ddtrace 버전
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)

추가 라이브러리 지원을 요청하려면 훌륭한 지원팀에 문의하세요.

웹 프레임워크 호환성 (Web framework compatibility)

ddtrace 라이브러리는 다음을 포함한 여러 웹 프레임워크를 지원해요:

프레임워크 지원 버전 자동 라이브러리 문서
asgi >= 2.0 아니요 https://ddtrace.readthedocs.io/en/stable/integrations.html#asgi
aiohttp(클라이언트) >= 2.0 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#aiohttp
aiohttp(서버) >= 2.0 아니요 https://ddtrace.readthedocs.io/en/stable/integrations.html#aiohttp
Bottle >= 0.11 아니요 https://ddtrace.readthedocs.io/en/stable/integrations.html#bottle
CherryPy >= 11.2.0 아니요 https://ddtrace.readthedocs.io/en/stable/integrations.html#cherrypy
Django >= 1.8 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#django
djangorestframework >= 3.4 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#django
Falcon >= 1.0 아니요 https://ddtrace.readthedocs.io/en/stable/integrations.html#falcon
Flask >= 0.10 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#flask
FastAPI >= 0.51 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#fastapi
Gunicorn >= 20.0.04 아니요 https://ddtrace.readthedocs.io/en/stable/integrations.html#gunicorn
Molten >= 0.7.0 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#molten
Pylons >= 0.9.6 (dd-trace-py 1.x 전용) 아니요 https://ddtrace.readthedocs.io/en/v1.20.19/integrations.html#pylons
Pyramid >= 1.7 아니요 https://ddtrace.readthedocs.io/en/stable/integrations.html#pyramid
Sanic >= 19.6.0 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#sanic
Starlette >= 0.13.0 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#starlette
Tornado >= 4.0 아니요 https://ddtrace.readthedocs.io/en/stable/integrations.html#tornado

데이터 저장소 호환성 (Datastore compatibility)

ddtrace 라이브러리는 다음 데이터 저장소를 지원해요:

데이터 저장소 지원 버전 자동 라이브러리 문서
algoliasearch >= 1.20.0 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#algoliasearch
asyncpg >= 0.18.0 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#asyncpg
Cassandra >= 3.5 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#cassandra
Elasticsearch >= 1.6 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#elasticsearch
Flask Cache >= 0.12 아니요 https://ddtrace.readthedocs.io/en/stable/integrations.html#flask-cache
Mariadb >= 1.0.0 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#mariadb
Memcached pylibmc >= 1.4 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#pylibmc
Memcached pymemcache >= 1.3 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#pymemcache
MongoDB Mongoengine >= 0.11 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#mongoengine
MongoDB Pymongo >= 3.0 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#pymongo
MySQL MySQL-python >= 1.2.3 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#module-ddtrace.contrib.mysqldb
MySQL mysqlclient >= 1.3 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#module-ddtrace.contrib.mysqldb
MySQL mysql-connector >= 2.1 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#mysql-connector
Opensearch >= 1.0 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#elasticsearch
Postgres aiopg >= 0.12.0, <= 0.16 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#aiopg
Postgres psycopg >= 2.4 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#module-ddtrace.contrib.psycopg
PyMySQL >= 0.7 예 https://ddtrace.readthedocs.io/en/stable/integrations.html?highlight=pymysql#pymysql
PynamoDB >= 4.0 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#pynamodb
PyODBC >= 4.0 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#pyodbc
Redis >= 2.6 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#redis
Redis redis-py-cluster >= 1.3.5 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#module-ddtrace.contrib.rediscluster
snowflake-connector-python >= 2.1 아니요 https://ddtrace.readthedocs.io/en/stable/integrations.html#snowflake
SQLAlchemy >= 1.0 아니요 https://ddtrace.readthedocs.io/en/stable/integrations.html#sqlalchemy
SQLite3 완전 지원 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#sqlite
Vertica >= 0.6 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#vertica

참고: Redis 6.0+는 HELLO, MIGRATE, ACL SETUSER 같은 명령에서 인라인 인증을 지원해요.

  • Datadog Trace Agent: 인증 매개변수가 트레이스 메타데이터에서 자동으로 난독화되도록 보장하는 최소 권장 버전은 7.76.1이에요.
  • Datadog Lambda Extension(서버리스 환경): 최소 필요 버전은 v28.0.0이에요.

라이브러리 호환성 (Library compatibility)

ddtrace 라이브러리는 다음 라이브러리를 지원해요:

라이브러리 지원 버전 자동 라이브러리 문서
aiobotocore >= 0.2.3 아니요 https://ddtrace.readthedocs.io/en/stable/integrations.html#aiobotocore
asyncio 완전 지원 > Python 3.7 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#asyncio
Botocore >= 1.4.51 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#botocore
Boto2 >= 2.29.0 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#boto2
Celery >= 4.4.0 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#celery
Consul >= 0.7 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#consul
Futures 완전 지원 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#futures
gevent >= 20.12 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#gevent
Grpc >= 1.8.0 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#grpc
httplib 완전 지원 아니요 https://ddtrace.readthedocs.io/en/stable/integrations.html#httplib
Logbook >= 1.0.0 아니요 https://ddtrace.readthedocs.io/en/stable/integrations.html#logbook
Loguru >= 0.4.0 아니요 https://ddtrace.readthedocs.io/en/stable/integrations.html#loguru
Jinja2 >= 2.7 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#jinja2
Kombu >= 4.0 아니요 https://ddtrace.readthedocs.io/en/stable/integrations.html#kombu
Mako >= 0.1.0 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#mako
Requests >= 2.08 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#requests
structlog >= 20.2.0 아니요 https://ddtrace.readthedocs.io/en/stable/integrations.html#structlog
urllib3 >= 1.22 아니요 https://ddtrace.readthedocs.io/en/stable/integrations.html#urllib3
graphql-core >= 2.0 예 https://ddtrace.readthedocs.io/en/stable/integrations.html#graphql
pytest >= 3.0 아니요 https://ddtrace.readthedocs.io/en/stable/integrations.html#pytest

더 알아보기 (Learn more)