호환성 요구사항

최신 파이썬(Python) 트레이서는 CPython 버전 2.7 및 3.5-3.11을 지원합니다.

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

시작하기

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

계측 방법 선택

Datadog 에이전트를 배포하거나 설치 및 설정한 후 다음 단계는 애플리케이션을 계측하는 것입니다. 애플리케이션이 실행되는 인프라스트럭처, 애플리케이션을 작성한 언어 및 필요한 설정 수준에 따라 다음과 같은 방법으로 이 작업을 실행할 수 있습니다.

지원되는 배포 시나리오 및 언어는 다음 페이지를 참고하세요.

애플리케이션 계측

Kubernetes 애플리케이션에서 트레이스를 수집하는 중이라면, 다음 지침 대신 추적 라이브러리를 클러스터 에이전트 어드미션 컨트롤러를 사용해 애플리케이션에 삽입할 수 있습니다. 자세한 내용을 확인하려면 어드미션 컨트롤러를 활용해 라이브러리 삽입 지침을 참조하세요.

에이전트를 설치한 후 파이썬(Python)으로 작성한 애플리케이션을 추적하려면, pip를 사용하여 Datadog 추적 라이브러리 ddtrace을 설치합니다.

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",
)

v1로 업그레이드

ddtrace v1으로 업그레이드하려면, 자세한 내용은 라이브러리 문서의 업그레이드 지침릴리스 노트를 참조하세요.

참고 자료