본문 바로가기
WIKI 기술 지식 베이스

Agent 체크 문제 해결 (Troubleshoot an Agent Check)

원문 보기 위키 갱신

Agent 체크에 문제가 생겼을 때 사용할 수 있는 명령어와 systemd 도구를 통해 통합 문제를 진단하고 해결하는 방법을 알려드릴게요.

출처: 문서

본문

Agent 체크에 문제가 있다면 아래 명령어를 사용해 더 자세한 문제 해결 정보를 얻을 수 있어요.

참고: 아래 예시의 <CHECK_NAME>은 어떤 Agent 체크로든 바꿔 넣을 수 있어요. 예를 들어 activemq, ceph, elastic처럼요. 정확한 Agent 체크 이름은 통합 문서에서 확인하세요.

참고: 문제 해결 중에 서비스 체크를 임시로 비활성화하려면 /conf.d/<CHECK_NAME>.d/conf.yaml 파일 이름을 .yaml이나 .yml이 아닌 다른 확장자(예: conf.yaml.disable)로 바꿔두세요.

Linux

Agent 체크를 테스트하려면 다음을 실행해요:

sudo -u dd-agent datadog-agent check <CHECK_NAME>

레이트 메트릭(rate metric)도 포함하려면 명령어에 --check-rate를 추가하세요. 예를 들어 Agent v6.x에서는:

sudo -u dd-agent datadog-agent check <CHECK_NAME> --check-rate

문제가 계속되면 flare와 함께 Datadog 지원팀에 문의하세요.

Windows

관리자(run as admin) 권한으로 PowerShell 명령줄에서 올바른 <CHECK_NAME>을 넣어 다음 스크립트를 실행해요:

Agent 버전 6.12 이상:

& "$env:ProgramFiles\Datadog\Datadog Agent\bin\agent.exe" check <CHECK_NAME>

Agent 버전 6.11 이하:

& "$env:ProgramFiles\Datadog\Datadog Agent\embedded\agent.exe" check <CHECK_NAME>

Systemd

systemd를 사용하는 시스템에서는 journalctl로 디버깅을 도울 수 있어요.

아래 명령어는 Datadog Agent의 상태를 보여줘요.

sudo systemctl status datadog-agent

Agent가 시작에 실패했고 추가 정보가 나오지 않는다면, 다음 명령어로 Datadog Agent 서비스의 모든 로그를 표시해요. 필요하면 -r을 사용해 로그를 역순으로 출력할 수 있어요.

sudo journalctl -u datadog-agent.service

더 알아보기 (Learn more)

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