Python 애플리케이션 트레이싱 (Tracing Python Applications)

원문 보기 위키 갱신 2026.10.05

Python 애플리케이션에 Datadog SDK(ddtrace)를 설치하고 계측해 트레이스를 Datadog으로 보내는 방법이에요.

출처: 문서

본문

Datadog의 Python 버전·프레임워크 지원(레거시·유지보수 버전 포함) 전체 목록은 호환성 요구사항 페이지를 참고하세요.

Datadog Agent를 설치·구성한 다음 단계는 애플리케이션에 SDK를 직접 추가해 계측하는 거예요. 호환성 정보에 대해 더 알아보세요.

Python으로 작성된 애플리케이션을 트레이싱하려면 pip로 Datadog SDK인 ddtrace를 설치하세요.

pip install ddtrace

참고: 이 명령은 pip 버전 18.0.0 이상이 필요해요. Ubuntu, Debian 또는 다른 패키지 관리자라면 다음 명령으로 pip 버전을 업데이트하세요.

pip install --upgrade pip

그다음 Python 애플리케이션을 계측하려면 포함된 ddtrace-run 명령을 사용하세요. Python 진입점 명령 앞에 ddtrace-run을 붙이면 돼요.

예를 들어 애플리케이션을 python app.py로 시작한다면:

ddtrace-run python app.py

설정을 마치고 SDK를 애플리케이션과 함께 실행한 뒤에는 ddtrace-run --info를 실행해 구성이 예상대로 동작하는지 확인할 수 있어요. 이 명령의 출력은 런타임 중 코드에서 변경된 구성은 반영하지 않는다는 점을 참고하세요.

SDK는 환경 변수로 구성할 수 있어요. Agent 호스트, 포트, 기타 설정을 지정하는 데 권장되는 방식이에요.

Unified Service Tagging을 포함한 전체 구성 옵션 목록은 라이브러리 구성 문서를 참고하세요.

버전 4.0.0은 Python 3.8 지원을 중단하고, 더 이상 사용되지 않는 API를 제거하며, Django 같은 프레임워크의 기본 동작을 변경해요.

전체 마이그레이션 가이드는 dd-trace-py v4로 마이그레이션을 참고하세요.

버전 3.0.0은 Python 3.7 지원을 중단하고, 더 이상 사용되지 않는 API를 제거하며, 구성 이름을 정리해요.

전체 마이그레이션 가이드는 dd-trace-py v3로 마이그레이션을 참고하세요.

도움이 되는 추가 문서, 링크, 글: