디버그 모드

Agent

Agent의 로그 레벨 설정은 기본적으로 INFO입니다. 그러나 로그 레벨을 DEBUG로 설정하여 로그에서 더 많은 정보를 알아볼 수도 있습니다.

참조: 디버그 모드는 디버그 목적으로만 설계되었습니다. 디버그 모드 사용 시 인덱스화 로그의 수가 늘어나므로, DEBUG는 특정 기간에만 활성화하시길 권장합니다. 디버그를 완료했다면 로그 레벨을 다시 INFO로 설정하세요.

Agent 전체 디버그 모드를 활성화하는 방법은 다음과 같습니다.

로컬 datadog.yaml 파일을 수정하세요. 사용하는 OS에 맞게 구체적인 안내를 받으려면 Agent 주요 설정 파일을 참조하시기 바랍니다.
# log_level: INFO를 log_level: DEBUG로 치환합니다(#을 삭제해 라인의 코멘트를 해제하세요).
Datadog Agent를 재시작하세요. OS에 맞게 구체적인 안내를 확인하려면 Agent 명령어를 참조하시기 바랍니다.
몇 분 기다리시면 로그가 생성됩니다. OS에 맞는 안내를 확인하려면 Agent 로그 파일을 참조하세요.

로컬 datadog.conf 파일을 수정하세요. 사용하는 OS에 맞게 구체적인 안내를 받으려면 Agent 주요 설정 파일을 참조하시기 바랍니다.
# log_level: INFO를 log_level: DEBUG로 치환합니다(#을 삭제해 라인의 코멘트를 해제하세요).
Datadog Agent를 재시작하세요. OS에 맞게 구체적인 안내를 확인하려면 Agent 명령어를 참조하시기 바랍니다.
몇 분 기다리시면 로그가 생성됩니다. OS에 맞는 안내를 확인하려면 Agent 로그 파일을 참조하세요.

컨테이너화 Agent

컨테이너 Agent에서 디버그 모드를 활성화하려면 Agent 부팅 시 DD_LOG_LEVEL=debug를 사용하세요.

Agent v6.19/ v7.19 이상의 버전에서는 다음을 사용하여 런타임에서 Agent 로그 레벨을 설정할 수 있습니다.

agent config set log_level debug

전용 컨테이너에 trace-agent가 있는 경우, Agent 컨테이너에서 했던 것처럼 런타임에서 trace-agent 컨테이너용 로그 레벨을 변경할 수 없습니다. 전용 trace-agent 컨테이너의 경우 dd_log_level 변수를 debug로 바꾸고 재배포해야 합니다.

컨테이너에서 실행되는 Agent는 service datadog-agent restart(또는 이와 유사한 기능)으로 재시작할 수 없습니다. 도커(Docker)에서 컨테이너를 삭제하기 때문입니다. Supervisor를 사용해 컨테이너화 Agent를 재시작하세요.

/opt/datadog-agent/bin/supervisorctl -c /etc/dd-agent/supervisor.conf restart all

다음의 명령어는 디버그 로깅, Agent 재시작, 60초 대기, 이후 Flare 전송을 순서대로 활성화합니다.

sed -i '/\[Main\]/a LOG_LEVEL=DEBUG' /etc/dd-agent/datadog.conf
/opt/datadog-agent/bin/supervisorctl -c /etc/dd-agent/supervisor.conf restart all
sleep 60
/etc/init.d/datadog-agent flare <CASE_ID>

디버그 로그를 비활성화하려면 다음을 사용하세요.

sed -i '/LOG_LEVEL=DEBUG/d' /etc/dd-agent/datadog.conf
/opt/datadog-agent/bin/supervisorctl -c /etc/dd-agent/supervisor.conf restart all

또는 컨테이너를 재시작해도 됩니다.

Agent 로그 레벨

다음의 Agent 로그 레벨은 log_level 또는 DD_LOG_LEVEL로 활용할 수 있습니다.

옵션	Critical 로그	Error 로그	Warn 로그	Info 로그	Debug 로그	Trace 로그
`'OFF'`
`'CRITICAL'`
`'ERROR'`
`'WARN'`
`'INFO'`
`'DEBUG'`
`'TRACE'`

참조: 로그 레벨을 설정 파일에서 'OFF'로 설정하는 경우, 값이 부적절하게 파싱(parsing)되는 경우를 막기 위해 주석을 반드시 달아야 합니다. 다른 로그 레벨에서는 주석이 부수적인 요소입니다.

참고 자료

추가 유용한 문서, 링크 및 기사:

Agent Flare 보내기AGENT 트러블슈팅

Agent 점검의 상태 파악하기AGENT 트러블슈팅