오류 문구만으로는 어디에서 멈췄는지 알기 어려웠어요
고객 PC에서 동작하는 검색 프로그램은 개발자 환경과 같은 화면을 본다고 가정할 수 없어요. ‘추가 결과를 읽지 못했다’는 메시지만으로는 로딩이 시작되지 않은 것인지, 새 카드가 생겼는데 읽지 못한 것인지 판단하기 어려워요.
반복 중단을 개선하면서 다음에 같은 문제가 발생하면 판단 근거를 함께 받을 수 있도록 진단을 보강했어요. 사용자는 오류 팝업이나 상시 진단 메뉴에서 ZIP을 저장하고, 발생 시각과 당시 작업을 적어 전달할 수 있어요.
실행·검색·시도·관측을 연결했어요
한 번의 수집 실행에는 여러 작품과 플랫폼 검색이 있어요. 같은 검색을 다시 시도할 수도 있으므로 실행 전체, 검색 작업, 개별 시도와 관측의 식별자를 나눴어요.
| 식별자 | 구분하는 대상 |
|---|---|
| RunId | 한 수집 회차 |
| JobId | 작품·검색어·플랫폼에 대응하는 검색 작업 |
| AttemptId | 같은 작업을 시작하거나 재개한 개별 시도 |
| TraceId | 최초 탐색·추가 로딩 등의 관측 기록 |
페이지 번호와 식별자를 함께 남기면 팝업에 표시된 실패를 해당 검색 시도와 연결할 수 있어요. 재개 전후 기록이 섞여도 어느 시도에서 실패했는지 따라갈 수 있고요.
화면 내용 대신 판단에 필요한 관측을 남겼어요
검색 추적에는 경과 시간, 판독 횟수, 신규 결과 식별자 개수, 결과 카드·로딩 요소 개수와 스크롤 위치를 남겨요. 실제 결과 식별자나 제목·URL을 추적 로그에 그대로 저장하지 않고, 신규 결과가 있었는지 판단할 수 있는 개수 중심으로 기록해요.
브라우저가 이미 요청한 검색의 HTTP 상태도 관측에 활용해요. 추적을 위해 같은 검색을 한 번 더 요청하거나 응답 본문을 저장하지는 않아요. 최초 화면 판독 실패와 추가 로딩 실패는 코드로 나눠요. 그러면 ‘제한 응답이 있었는가’, ‘로딩 요소는 있었는가’, ‘결과 개수가 바뀌었는가’를 함께 살펴볼 수 있어요.
작업 폴더를 통째로 압축하지 않았어요
진단 ZIP은 허용한 JSON·TXT 항목을 구성해서 만들어요. 기본 자료에는 앱·환경·설정·실행·오류 기록이 들어가고, 작품명과 수집 URL은 사용자가 선택한 경우에만 추가해요. 기록 속 경로·URL·인증 값에는 가림 처리를 적용해요.
브라우저 프로필과 쿠키, 고객 원본 엑셀, 화면 캡처와 기존 백업은 진단 ZIP에 넣지 않아요. 특히 검색 창의 로그인 세션이 있는 폴더와 오류 분석용 자료는 분리해야 했어요.
진단 전달 흐름
- 01오류 팝업 또는 진단 메뉴 열기
- 02상황 설명과 작품명·URL 포함 여부 선택
- 03허용 항목으로 진단 ZIP 저장
- 04사용자가 담당자에게 파일 전달
저장 후 폴더를 열어 만든 파일을 찾을 수 있게 했어요. 프로그램이 자동 전송하는 방식은 아니며, ZIP을 보냈다고 프로그램이 자동 수정되는 것도 아니에요. 전달된 관측을 확인한 뒤 필요한 수정과 검증을 진행해요.
기록을 보관하는 한계도 안내했어요
로그는 계속 쌓아 두지 않고 용량에 따라 교체해요. 기본 진단 이벤트는 약 2 MiB마다 교체해 최신 두 파일을 보관하고, 기록 실패 시에는 프로세스 메모리의 최근 기록을 활용해요. 강제 종료 직전 기록은 남지 않을 수 있어요.
따라서 오류가 난 직후 ZIP을 저장해 두는 것이 좋아요. 파일을 전달하는 시점은 나중이어도 되지만, 며칠 뒤 만든 ZIP 하나에 이전 오류가 모두 남는다고 볼 수는 없어요. 같은 증상이 반복되면 대표 자료와 발생 시각·빈도를 함께 전달하는 편이 분석에 도움이 돼요.
기록의 유용성과 포함 경계를 함께 검증했어요
기존 테스트는 재시작 뒤에도 검색 추적을 읽을 수 있는지, 가림 처리 후에도 경과 시간과 개수 같은 수치가 남는지 확인해요. 로그 교체와 쓰기 실패 시 최근 관측이 유지되는지도 검사해요. 지원 기능 테스트에서는 기본 ZIP과 작품명·URL을 선택한 ZIP의 구성을 나눠 검증해요.
진단을 자세하게 만드는 기준은 자료를 많이 모으는 양이 아니었어요. 실패한 시도를 찾아가고, 다음 수정 방향을 결정할 수 있는 관측을 남기는 것이었어요.