디버그 모드 (Debug Mode)

Agent 로그 레벨을 DEBUG로 바꿔 더 자세한 로그를 얻는 방법을 알려드릴게요. 문제를 원인별로 파고들 때 유용하지만 인덱싱 로그가 늘어나므로 일정 시간만 켜두길 권장해요.

출처: 문서

본문

개요 (Overview)

Agent는 기본적으로 INFO 레벨로 로그를 기록해요. 로그에서 더 많은 정보를 얻고 싶다면 로그 레벨을 DEBUG로 설정할 수 있어요.

참고: 디버그 모드는 디버깅 목적으로만 사용하세요. DEBUG는 인덱싱되는 로그 수를 늘리므로 일정 시간 동안만 활성화하길 권장해요. 작업이 끝나면 로그 레벨을 다시 INFO로 되돌리세요.

Agent 전체 디버그 모드를 활성화하려면:

1. 로컬 datadog.yaml 파일을 수정해요. 운영체제별 세부 사항은 Agent 메인 설정 파일을 참고하세요.

2. # log_level: INFO를 log_level: DEBUG로 바꿔요 (주석 해제를 위해 #을 제거).

3. Datadog Agent를 재시작해요. 운영체제별 세부 사항은 Agent 명령어를 참고하세요.

4. 로그가 생성되도록 몇 분간 기다려요. 운영체제별 세부 사항은 Agent 로그 파일을 참고하세요.

컨테이너화된 Agent (Containerized Agent)

컨테이너 Agent의 디버그 모드를 활성화하려면 Agent를 시작할 때 DD_LOG_LEVEL=debug를 사용하세요.

Agent v6.19+ / v7.19+에서는 런타임에 로그 레벨을 다음과 같이 설정해요:

agent config set log_level debug

trace-agent 컨테이너는 agent 컨테이너처럼 런타임에 로그 레벨을 변경할 수 없어요. 전용 trace-agent 컨테이너는 DD_LOG_LEVEL 변수를 debug로 설정한 뒤 재배포가 여전히 필요해요.

Helm을 사용한다면 datadog-values.yaml 파일에서 logLevel: INFO를 logLevel: DEBUG로 바꾸고 재배포하세요.

Agent 로그 레벨 (Agent log level)

log_level 또는 DD_LOG_LEVEL에 사용할 수 있는 Agent 로그 레벨은 다음과 같아요:

참고: 설정 파일에서 로그 레벨을 'OFF'로 설정할 때는 값이 잘못 파싱되지 않도록 반드시 따옴표를 사용해야 해요. 다른 로그 레벨에서는 따옴표가 선택 사항이에요.

더 알아보기 (Learn more)

도움이 되는 추가 문서, 링크, 글:

• Agent flare 보내기
• Agent 체크 상태 확인하기