라이브 테일 트러블슈팅 (Live Tail Troubleshooting)

Live Tail 페이지에 오류가 표시되거나 로그가 로드되지 않으면 다음 트러블슈팅 단계를 시도해 보세요.

출처: 문서

본문

• 브라우저의 시크릿 모드로 Live tail 보기를 열어 로그를 볼 수 있는지 확인해요.
• 다른 브라우저를 사용해 Live Tail이 로그를 로드하는지 확인해요.
• 다른 팀원이 Live Tail 보기에서 로그를 볼 수 있는지 확인해요.
• Live Tail이 로그를 로드하지 못하게 차단하는 네트워크 제한, VPN 구성, 바이러스 백신 소프트웨어가 있는지 확인해요:
  • 로컬 또는 회사 네트워크가 live.logs.datadoghq.com에서 들어오는 인바운드 트래픽을 허용하는지 확인해요.
  • Datadog IP 접두사는 IP ranges 엔드포인트에서 찾아요.

요청 추적 (Trace requests)

Traceroute는 패킷이 소스에서 목적지까지 가는 경로를 테스트하는 데 도움을 주는 도구예요. traceroute를 사용해 Live Tail 로드에 영향을 줄 수 있는 클라이언트 측 네트워크 문제를 식별할 수 있어요.

Linux 또는 MacOS에서 Live Tail 로그의 경로를 검사하려면 다음 명령을 실행해요:

traceroute live.logs.datadoghq.com

어느 시점에서든 요청이 타임아웃되면 그 요청이 클라이언트와 Datadog 서버 사이 어딘가에서 차단된 것이에요. 네트워크 관리 팀에 이 문제를 해결하도록 요청해요.

경로의 한 단계가 * * *로 표시되면 호스트가 traceroute에 응답하지 않았거나, 라우터가 해당 프로토콜에 응답하지 않았을 수 있어요. * * * 패턴이 항상 타임아웃을 의미하는 건 아니에요. -I 옵션으로 디스커버리 프로토콜을 ICMP/PING으로 바꾸면 더 상세한 결과를 얻을 수 있어요.

브라우저와 DNS 캐시 지우기

브라우저 캐시

브라우저 캐시를 지우면 Live Tail 문제에 도움이 될 수 있어요. 예를 들어 Google Chrome에서 캐시를 지우려면 Google 계정 도움말을 참고해요.

DNS 캐시

DNS 캐시를 지우면 Live Tail 문제에 도움이 될 수 있어요.

Google Chrome으로 DNS 캐시를 지우려면:

1. Google Chrome 브라우저를 실행해요.
2. 주소창에 chrome://net-internals/#dns를 입력하고 Enter를 눌러요.
3. Clear host cache를 클릭해요.

브라우저 플러그인과 확장 프로그램 확인하기

브라우저 플러그인과 확장 프로그램(광고 차단기 포함)이 때때로 Live Tail을 방해할 수 있어요:

• 브라우저나 운영체제에 광고 차단기 앱이 설치되어 있는지 확인해요. 발견된 광고 차단기를 제거하거나 비활성화한 다음 Live Tail에서 로그를 볼 수 있는지 확인해요.
• 브라우저 플러그인과 확장 프로그램을 일시 중지·중지·제거해요.

액세스 확인하기

logs_live_tail 권한이 있는 역할이 할당되어 있는지 확인해요. 자세한 내용은 Datadog 역할과 권한을 참고해요.

관리자가 Datadog 조직에 로그 제한 쿼리 (RBAC)를 구성했는지 확인해요. Live Tail에서 쿼리하는 로그에 접근하는 데 필요한 권한이 없다면 아무 로그도 보이지 않아요. 이 로그에 접근할 수 있어야 한다고 생각되면 Datadog 계정 관리자에게 연락해 필요한 권한을 부여받아요.

로그 타임스탬프 확인하기

Live Tail에 나타날 것으로 예상하는 로그가 보이지 않는다면, 로그의 타임스탬프가 Live Tail 창의 15분 기간 안에 있는지 확인해요. 로그 타임스탬프가 UTC와 맞다면 실시간으로 보낸 로그는 지정된 15분 기간 안에 나타나야 해요.

종종 타임스탬프가 UTC와 다른 로컬 시간을 가진 호스트에서 전송되면, 이 시간대 오프셋이 Datadog에서 로그가 표시되는 방식에 불일치를 만들 수 있어요.

처리 중에 두 가지 방식으로 발생할 수 있어요:

• Logs Pipeline에 Date Remapper 프로세서를 사용 중이라면, 프로세서가 참조하는 속성이 UTC 시간을 반영하는지 확인해요.
• 로그가 JSON으로 전송되면, JSON Preprocessing에 나열된 속성에 반영되는 경우 자동 파싱이 date 속성을 추출해요.

로그의 타임스탬프를 반영하는 속성이 UTC가 아닌 시간대에 있다면, 날짜 파싱을 Grok Parser로 사용해 시간대를 이동시키는 방법도 있지만, JSON Preprocessing으로 파싱된 속성에는 동작하지 않아요. 이 속성들은 Preprocessing 밖에서 수정해야 해요.

지원 티켓 만들기

위의 트러블슈팅 단계로 Live Tail 문제가 해결되지 않으면 지원 티켓을 만들어요. 가능하면 다음 정보를 지원 티켓에 포함해요:

운영체제와 브라우저 세부 정보

• 브라우저 이름과 버전
• 플러그인 및/또는 확장 프로그램
• 운영체제 이름과 버전

HAR 파일

Google Chrome에서 HAR 파일을 생성하려면 웹 세션 트래픽 캡처를 참고해요.

HAR 파일을 지원 티켓에 첨부해요.

스크린샷과 녹화

• 브라우저 콘솔의 스크린샷을 찍어요.
  • Google Chrome에서는 DevTools를 참고해 브라우저 콘솔을 열어요.
• 문제의 동작을 보여주는 짧은 비디오를 녹화해요.