Datadog의 애플리케이션 성능 모니터링(APM 또는 ‘트레이싱’이라고 합니다)을 사용하면 백엔드 애플리케이션 코드에서 트레이스를 수집할 수 있습니다. 이번 초보자용 가이드에서는 첫 트레이스를 Datadog로 가져오는 방법을 설명합니다.
참조: Datadog APM은 다양한 언어와 프레임워크로 사용할 수 있습니다. 자세한 내용은 애플리케이션 계측 문서를 참조하세요.
계정이 없다면 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://s3.amazonaws.com/dd-agent/scripts/install_script_agent7.sh)"
상태 명령어를 사용해 에이전트가 실행 중인지 확인합니다.
sudo datadog-agent status
몇 분 후, Datadog의 인프라스트럭처 목록을 확인하여 에이전트가 계정에 연결되었는지 검증하세요.
최적의 경험을 위해서는 Datadog 사이트의 빠른 시작 안내에 안내된 나머지 단계를 따르세요.
service, env, version 태그를 설정하세요.최신 버전의 에이전트 v6와 v7에서는 APM이 기본으로 활성화되어 있습니다. 에이전트의 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 설정을 자세히 알아보려면 범위 설정용 주요 태그 지정 가이드를 참고하세요.
애플리케이션을 설정하기 전에 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을 확인하세요.
Additional helpful documentation, links, and articles:
