로그는 DNS, TCP 연결, TLS 또는 프로토콜 핸드셰이크, 규칙 매칭 및 제어 인터페이스 단계로 나누어 판단해야 합니다. 첫 번째 실패 기록을 찾은 뒤 lookup, dial, handshake 등의 키워드로 위치를 확인하세요. 한 번의 재현에 필요한 로그 구간만 남기고 클라이언트, 코어 및 시스템 버전을 함께 기록하세요. 공유하기 전에 URL, token, secret, IP 및 노드 자격 증명을 가립니다.
어느 로그 행부터 읽어야 하는지 확인
재현 작업 시점부터 첫 번째 오류를 찾고 lookup, dial, handshake, parse, unauthorized로 실패 위치를 판단하세요.
- 오류에 lookup, dial, connect, handshake, unauthorized 또는 parse가 포함되어 있는지 확인
- 구독 업데이트, 노드 연결 또는 Dashboard 접속 중 어느 단계에서 오류가 발생하는지 확인(참고: 런타임 제어)
- 특정 도메인이나 특정 노드에서만 오류가 발생하는지 확인
- 로그 수준이 충분하면서도 과도하지 않은지 확인
오류 단계에 따라 계속 점검
- 먼저 오류 발생 시점과 작업 확인
- 키워드로 오류 단계 판단
- 전체 구독 URL, token, 노드 비밀번호 및 실제 IP에서 민감 정보를 제거한 뒤 공유(참고: 보안 FAQ)
- 재현할 때 클라이언트 버전, 코어 버전, 시스템 버전 및 구성 출처 기록
debug 로그는 짧은 문제 해결에 적합하며 장기간 켜두지 않는 것이 좋습니다.
로그에는 도메인, IP, 노드 이름, 구독 URL 또는 secret이 포함될 수 있습니다.
마지막 행만 캡처하면 문제를 파악하기에 부족한 경우가 많습니다.