- 필수 기능
- 시작하기
- Glossary
- 표준 속성
- Guides
- Agent
- 통합
- 개방형텔레메트리
- 개발자
- Administrator's Guide
- API
- Datadog Mobile App
- CoScreen
- Cloudcraft
- 앱 내
- 서비스 관리
- 인프라스트럭처
- 애플리케이션 성능
- APM
- Continuous Profiler
- 스팬 시각화
- 데이터 스트림 모니터링
- 데이터 작업 모니터링
- 디지털 경험
- 소프트웨어 제공
- 보안
- AI Observability
- 로그 관리
- 관리
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 부팅 시 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 로그 레벨은 log_level
또는 DD_LOG_LEVEL
로 활용할 수 있습니다.
옵션 | Critical 로그 | Error 로그 | Warn 로그 | Info 로그 | Debug 로그 | Trace 로그 |
---|---|---|---|---|---|---|
'OFF' | ||||||
'CRITICAL' | ||||||
'ERROR' | ||||||
'WARN' | ||||||
'INFO' | ||||||
'DEBUG' | ||||||
'TRACE' |
참조: 로그 레벨을 설정 파일에서 'OFF'
로 설정하는 경우, 값이 부적절하게 파싱(parsing)되는 경우를 막기 위해 주석을 반드시 달아야 합니다. 다른 로그 레벨에서는 주석이 부수적인 요소입니다.
추가 유용한 문서, 링크 및 기사: