트레이싱 시작하기

개요

Datadog의 애플리케이션 성능 모니터링(APM 또는 ‘트레이싱’이라고 합니다)을 사용하면 백엔드 애플리케이션 코드에서 트레이스를 수집할 수 있습니다. 이번 초보자용 가이드에서는 첫 트레이스를 Datadog로 가져오는 방법을 설명합니다.

참조: Datadog APM은 다양한 언어와 프레임워크로 사용할 수 있습니다. 자세한 내용은 애플리케이션 계측 문서를 참조하세요.

Datadog 계정

계정이 없다면 Datadog 계정을 만드세요.

Datadog 에이전트

Datadog 에이전트를 설치하기 전에, 다음 명령어를 사용하여 Vagrant Ubuntu 22.04 가상머신을 설치하세요. Vagrant에 대해 더 자세히 알아보려면 시작하기 페이지를 참고하세요.

vagrant init ubuntu/jammy64
vagrant up
vagrant ssh

호스트 상에 Datadog 에이전트를 설치하려면 Datadog API 키와 함께 업데이트된 원라인 설치 명령어를 사용하세요.

DD_API_KEY=<DATADOG_API_KEY> DD_SITE="" bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)"

검증

상태 명령어를 사용해 에이전트가 실행 중인지 확인합니다.

sudo datadog-agent status

몇 분 후, Datadog의 인프라스트럭처 목록을 확인하여 에이전트가 계정에 연결되었는지 검증하세요.

Datadog APM

앱에 안내된 설명서를 따릅니다(권장).

최적의 경험을 위해서는 Datadog 사이트의 빠른 시작 안내에 안내된 나머지 단계를 따르세요.

  • 배포 설정(이번 경우는 호스트 기반의 배포)을 다루는 단계별 안내를 따릅니다.
  • 동적으로 service, env, version 태그를 설정하세요.
  • 연속적 프로파일러를 활성화하면 설정 트레이스를 100% 수집하고 설정 중에 트레이스 ID를 삽입합니다.

애플리케이션 성능 모니터링(APM) 활성화

최신 버전 Agent v6 및 v7의 경우 애플리케이션 성능 모니터링(APM) 이 기본적으로 활성화되어 있습니다. Agent datadog.yaml 설정 파일에서 확인할 수 있습니다:

# apm_config:
##   Whether or not the APM Agent should run
#   enabled: true

trace-agent.log에서도 확인할 수 있습니다.

# /var/log/datadog/trace-agent.log:
2019-03-25 20:33:18 INFO (run.go:136) - trace-agent running on host ubuntu-jammy
2019-03-25 20:33:18 INFO (api.go:144) - listening for traces at http://localhost:8126
2019-03-25 20:33:28 INFO (api.go:341) - no data received
2019-03-25 20:34:18 INFO (service.go:63) - total number of tracked services: 0

환경 이름

최상의 경험을 위해 환경 변수DD_ENV를 사용하여 서비스의 트래이서를 통해 env를 설정하는 것을 권장합니다.

또한 트레이서에서 로그 삽입이 활성화된 경우 env는 트레이스와 로그 전체에 일관적으로 적용됩니다. 이 부분을 자세히 알고 싶으신 분은 통합형 서비스 태그 지정 설명을 참조하시기 바랍니다.

또는 datadog.yaml을 업데이트하여 환경 이름을 지정하고 apm_config에서 env를 설정할 수 있습니다. APM의 env 설정을 자세히 알아보려면 범위 설정용 주요 태그 지정 가이드를 참고하세요.

APM 애플리케이션

설치

애플리케이션을 설정하기 전에 Ubuntu 가상머신에 pip, flask, ddtrace를 설치하세요.

sudo apt-get install python-pip
pip install flask
pip install ddtrace

생성

우분투 가상머신에서 다음 콘텐츠로 hello.py 애플리케이션을 생성하세요.

from flask import Flask
app = Flask(__name__)

@app.route('/')
def index():
    return 'hello world'

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=5050)

실행

ddtrace를 사용하여 hello.py를 실행합니다. 이는 Datadog에서 애플리케이션을 자동으로 계측합니다.

export DD_SERVICE=hello
ddtrace-run python hello.py

이제 다음과 유사한 출력값을 보게 됩니다.

* Serving Flask app "hello" (lazy loading)
  ...
* Running on http://0.0.0.0:5050/ (Press CTRL+C to quit)

테스트

애플리케이션을 테스트하고 curl을 사용하여 Datadog에 트레이스를 보냅니다. 애플리케이션이 (위와 같이) 실행 중인 것이 보입니다. 별도의 명령 프롬프트에서 다음을 실행하세요.

vagrant ssh
curl http://0.0.0.0:5050/

이제 다음과 같은 출력값이 표시됩니다.

hello world

몇 분 후, Datadog hello 서비스 아래에 트레이스가 표시됩니다. Service Catalog나 trace list을 확인하세요.

Tracing Services List

참고 자료

Additional helpful documentation, links, and articles:

애플리케이션 언어를 선택해주세요설명서 more more APM UI 사용하기설명서 more more 애플리케이션 성능 모니터링 소개학습 센터 more more 대화형 세션에 참여해 애플리케이션 성능 모니터링(APM)에 대한 이해도를 향상하세요.기반 활성화 more more