파이썬(Python) 애플리케이션 추적

문서 > APM > 애플리케이션 계측 > 자동 계측 > Add the Datadog Tracing Library > 파이썬(Python) 애플리케이션 추적

호환성 요구 사항

Datadog의 파이썬(Python) 버전과 프레임워크 지원(레거시 및 유지 보수 버전 포함) 전체 목록을 확인하려면 호환성 요구사항 페이지를 참고하세요.

시작하기

시작하기 전에 먼저 에이전트를 설치하고 구성했는지 확인하세요.

애플리케이션의 계측

Datadog Agent를 설치하고 구성한 후 다음 단계는 추적 라이브러리를 애플리케이션에 직접 추가하여 계측하는 것입니다. 호환성 정보에 대해 자세히 알아보세요.

Python으로 작성된 애플리케이션 추적을 시작하려면 pip를 사용하여 Datadog Tracing 라이브러리를 설치하세요.

pip install ddtrace

참고: 해당 명령을 실행하려면 pip 18.0.0 버전 이상이 필요합니다. 우분투(Ubuntu) , 데비안(Debian) 또는 다른 패키지 매니저의 경우 아래의 명령으로 pip 버전을 업데이트합니다.

pip install --upgrade pip

그런 다음 포함된 ddtrace-run 명령을 사용하여 파이썬(Python) 애플리케이션을 계측합니다. 해당 기능을 사용하려면 파이썬(Python) 엔트리 포인트 명령어 앞에 ddtrace-run을 붙입니다.

예를 들어, 애플리케이션이 python app.py로 시작되는 경우 다음을 참조합니다.

ddtrace-run python app.py

설정을 완료한 후 애플리케이션에서 트레이서를 실행하는 도중 ddtrace-run --info을 실행하여 해당 설정이 예상대로 작동하는지 점검할 수 있습니다. 해당 명령 출력에 런타임 중 코드에서 변경된 설정 변경 사항은 반영되지 않는다는 점에 유의하세요.

구성

필요한 경우 통합 서비스 태깅 설정을 포함하여 필요에 따라 애플리케이션 성능 원격 측정 데이터를 전송하도록 추적 라이브러리를 설정합니다. 자세한 내용을 확인하려면 라이브러리 설정을 참조하세요.

트레이스 연결은 다음과 같은 코드로도 설정할 수 있습니다.

from ddtrace import tracer

# 네트워크 소켓
tracer.configure(
    https=False,
    hostname="custom-hostname",
    port="1234",
)

# Unix 도메인 소켓 설정
tracer.configure(
    uds_path="/var/run/datadog/apm.socket",
)

스탯 연결은 다음과 같은 코드로도 설정할 수 있습니다.

from ddtrace import tracer

# 네트워크 소켓
tracer.configure(
  dogstatsd_url="udp://localhost:8125",
)

# Unix 도메인 소켓 설정
tracer.configure(
  dogstatsd_url="unix:///var/run/datadog/dsd.socket",
)