Agent Connection check failed 로그 과다 생성

Agent Connection check failed 로그 과다 생성

 

1. 이슈 개요

  • 제목: Agent 로그 과다 생성 문제 ('Connection check failed')

  • 버전: 10.1.11, 10.2.4 미만 버전

  • 상태: 해결 (10.1.11, 10.2.4 버전에서 수정 완료)

2. 이슈 상세

증상

https://querypie.atlassian.net/browse/QCP-3559

  1. 특정 사용자의 Agent 로그가 하루에 2~5GB씩 쌓이는 현상 발생.

  2. 로그 분석 결과, PC 잠금 해제 (Session is unlocked) 또는 절전 모드 해제 (Resume) 직후 약 1분 동안 아래와 같은 경고(WRN) 메시지가 수백만 건 이상 반복적으로 기록됨.

    [WRN] <AgentWindowView> Connection check failed: The request message was already sent. Cannot send the same request message multiple times. [WRN] <AgentWindowView> Connection check failed: The request was canceled due to the configured HttpClient.Timeout of 3 seconds elapsing.
  3. 로그 파일 크기가 4GB에 도달하면 [동일파일명]_001.log 형식으로 새 파일이 생성되며 계속 증가함.

재현 방법 (내부 테스트 기반)

  • 테스트 환경: QueryPie 버전 10.2.4, Agent Session Timeout 값이 충분히 큰 값(예: 20분 이상)으로 설정된 상태

  • 사전 절차: 로컬 PC의 기존 Agent 로그 삭제 (rm -rf ~/.querypie-agent/logs 또는 해당 폴더 내용 수동 삭제)

  1. QueryPie Agent를 실행하고 로그인합니다.

  2. PC의 Wi-Fi(네트워크 연결)를 끕니다.

  3. PC 화면을 잠금 상태(OS 로그인 화면)로 전환합니다.

  4. 약 10분 정도 대기합니다.

  5. PC 화면 잠금을 해제하고 약 1분간 대기합니다.

  6. Agent 로그 폴더 (~/.querypie-agent/logs)의 파일 크기를 확인합니다.

    • 재현 성공 시: 수백 MB 이상의 용량을 가진 로그 파일이 생성됩니다. (정상 기대 결과는 수 KB 이내)

3. 원인 분석

  • Agent가 특정 조건(로그인 절차 미완료 후 대기, 네트워크 단절 후 재연결, PC 절전/잠금 해제 등)에서 서버와의 연결 상태를 확인하는 로직을 비정상적으로 반복 실행하는 문제가 있었습니다.

  • 특히, PC 잠금 해제 또는 절전 모드 해제 시 네트워크 상태 변화를 감지하고 연결 확인을 시도하는 과정에서, 이전 요청이 완료되지 않았거나 내부 상태 오류로 인해 동일한 요청을 매우 짧은 시간 안에 과도하게 반복 전송하며 관련 오류 로그를 대량으로 기록했습니다.

4. 해결 방법

  • QueryPie Agent 버전 10.1.11, 10.2.4 이상으로 업데이트하면 해당 문제가 해결됩니다.