본문으로 건너뛰기

인스턴트 리플레이 버그 리포트: 이미 지나간 버그를 저장하세요

업데이트

Midge의 인스턴트 리플레이를 쓰면 버그가 일어난 뒤에도 리포트를 남길 수 있어요. 사이트에서 이 기능을 켜 두면, Midge는 페이지의 마지막 30~120초를 계속 기록해 두고, 클릭 한 번으로 그 구간을 콘솔 로그, 네트워크 요청, 사용자 동작이 붙은 버그 리포트로 저장해요. 기본은 꺼져 있고, 사이트별로 또는 모든 사이트에 직접 켜야 해요.

가끔씩만 나타나는 버그의 흔한 문제는 타이밍이에요. 드롭다운이 깜빡이고, 토스트에 엉뚱한 메시지가 뜨고, 테이블이 튀었는데, 녹화를 시작할 즈음엔 이미 사라져 있죠. 인스턴트 리플레이가 있으면 다시 재현할 필요가 없어요. 이미 기록돼 있으니까요.

작동 방식

인스턴트 리플레이는 영상을 녹화하지 않아요. 페이지 자체를 기록해요. 즉 브라우저가 그리는 요소와 텍스트의 구조인 DOM을요. Midge는 페이지의 스냅숏을 저장한 뒤, 노드 추가, 클래스 변경, 텍스트 업데이트 같은 모든 변경 사항을 스크롤, 클릭과 함께 저장해요. 리플레이 플레이어는 이 기록으로 페이지를 한 단계씩 다시 구성해요.

버퍼 길이는 30초에서 120초 사이로 직접 정해요. 새 변경 사항이 들어오면 오래된 것은 끝에서부터 빠지기 때문에 메모리 사용량은 일정 범위 안에 머물러요. 리플레이를 저장하려고 클릭하면, Midge가 현재 버퍼에 같은 구간의 콘솔·네트워크 로그를 더하고, 리포트를 만들 수 있게 해 줘요.

왜 계속 영상을 녹화하지 않나요?

화면을 항상 녹화하면서 마지막 2분을 보관하는 방식도 고민했어요. 하지만 두 가지 이유로 그렇게 하지 않기로 했어요.

  1. 캡처가 진행되는 동안 Chrome은 공유 표시를 계속 띄워요. "이 탭을 공유하는 중"이라는 표시줄이 늘 떠 있으면 거슬리고, 사용자의 안전을 위해 존재하는 경고를 무시하는 습관이 생겨요.
  2. 영상은 CPU, 메모리, 배터리를 잡아먹어요. 사용하는 모든 탭에서 쉬지 않고 프레임을 인코딩하면 브라우저가 느려지는데, 디버깅 도구가 해야 할 일과 정반대예요.

DOM 기록은 두 문제를 모두 피해요. 그래도 페이지 내용의 사본을 보관하기 때문에 로그 수집보다는 무거워요. 그래서 직접 원할 때까지는 꺼 둬요.

켜는 방법

인스턴트 리플레이는 기본으로 꺼져 있어요. 이렇게 켤 수 있어요.

  • 모든 사이트에: 하루 종일 여러 앱을 테스트한다면요.
  • 사이트별로: 예를 들어 staging.yourapp.com과 localhost에만요.

수집 제외 목록이 항상 우선이에요. 그 목록에 있는 사이트에서는 리플레이를 포함해 Midge가 아예 실행되지 않아요. 처음에는 스테이징과 로컬 개발 호스트에서만 리플레이를 켜고, 나머지는 꺼 두고, 은행과 이메일을 수집 제외 목록에 추가하는 구성이 좋아요.

리플레이 리포트에 담기는 것

저장한 리플레이는 완전한 Midge 리포트예요. 모든 녹화에는 콘솔 로그, 네트워크 요청, 사용자 동작, 기기 정보가 담겨요. 리플레이도 예외가 아니에요. 링크를 연 개발자는 이런 것들을 봐요.

  • 플레이어에서 재생되는 페이지,
  • 처리되지 않은 에러를 포함해 같은 30~120초 동안의 콘솔 메시지(콘솔 로그 참고),
  • 본문과 타이밍이 담긴 fetch, XHR, WebSocket 트래픽(네트워크 로그 참고),
  • 클릭, 페이지 이동, 입력한 필드(텍스트는 제외),
  • 브라우저, 운영체제, 창 크기, 페이지 URL.

리플레이의 개인정보 보호

리플레이에는 페이지 내용이 담기기 때문에, 탭 영상보다 규칙이 더 엄격해요.

  • 모든 입력값이 마스킹돼요. 어떤 입력란에 무엇을 입력했는지는 리플레이에 나타나지 않아요.
  • 페이지의 텍스트를 검사해요. 로그와 같은 패턴으로요. JWT, Luhn 검사를 통과하는 카드 번호, API 키, 개인 키는 제거되고, 이메일과 국제 전화번호는 절반만 마스킹돼요.
  • 로그도 가려져요. 비밀번호, 카드 번호, 토큰, 쿠키는 기기를 떠나기 전에 브라우저에서 가려져요.

모든 규칙은 가림 처리 페이지에 있어요. 가림 처리는 규칙 기반이라, 화면에 일반 텍스트로 표시된 특이한 형식의 민감 정보는 인식되지 않을 수 있어요. 팀이 직접 필드 이름을 추가할 수 있어요.

알아 둘 한계

DOM 리플레이는 픽셀 복사본이 아니라 재구성이에요. 대부분의 페이지는 충실하게 재생되지만, 캔버스에 그린 그림이나 페이지 안에서 재생되는 미디어처럼 DOM으로 표현되지 않는 콘텐츠는 원래 모습과 정확히 같지 않을 수 있어요. 버그가 그런 식으로 시각적인 문제라면 화면 녹화를 쓰세요.

리플레이는 실행되고 있던 시간만 담아요. 1분 전에 사이트에서 켰다면, 버퍼에는 최대 그 1분만 들어 있어요.

인스턴트 리플레이가 필요한 때

  • 원할 때 재현되지 않는 불안정한 UI 버그.
  • 일이 일어난 뒤에야 버그였다는 걸 알게 되는 탐색적 테스트.
  • 동료 앞에서 뭔가 고장 나는, 스테이징에서의 데모와 시연.

마음대로 재현할 수 있는 버그라면 일반 녹화나 표시를 넣은 스크린샷으로 충분한 경우가 많아요. 어느 쪽이든 무엇을 담아야 하는지에 대한 일반적인 조언은 버그 신고 방법을 읽어 보세요. 그리고 Midge를 쓰지 않던 팀원에게서 사건의 네트워크 쪽 정보만 필요하다면, HAR 파일을 요청하고 티켓에 올리기 전에 무료 HAR Sanitizer로 정리하세요.

Midge는 무료예요. 녹화 횟수 제한이 없고, 영상은 최대 15분까지, 워터마크도 없어요.

자주 묻는 질문

인스턴트 리플레이는 영상인가요?
아니요. 페이지 구조(DOM)의 변경 사항을 기록하고, 리플레이 플레이어에서 다시 구성해요. 영상보다 가볍고, Chrome의 화면 공유 표시가 계속 떠 있지도 않아요.
인스턴트 리플레이는 기본으로 켜져 있나요?
아니요. 직접 켜기 전까지는 꺼져 있어요. 모든 사이트에 켜거나, 고른 사이트에만 켤 수 있어요. 콘솔·네트워크 수집은 이 기능 없이도 동작해요.
얼마나 이전까지 저장할 수 있나요?
30초에서 120초 사이로 직접 정해요. 리플레이를 저장하면, 클릭한 순간을 기준으로 그만큼 이전까지의 기록을 보관해요.
인스턴트 리플레이가 제가 입력한 내용도 기록하나요?
아니요. 리플레이에서 모든 입력값은 마스킹되고, 페이지의 텍스트는 로그와 같은 가림 처리 규칙을 거치기 때문에 토큰, 카드 번호 같은 값은 제거돼요.