녹화 버튼을 누르기 전 에러까지 담는 콘솔 로그 화면 녹화 도구
업데이트
Midge는 콘솔 로그까지 담는 화면 녹화 도구예요. Chrome에서 화면을 녹화하거나 스크린샷을 찍는 동안 console.log부터 처리되지 않은 예외, 처리되지 않은 Promise 거부까지 페이지가 내보내는 모든 콘솔 메시지를 스택 트레이스와 함께 수집하고, 영상과 시간 순서대로 맞춰 놓아요. Midge는 최근 콘솔 출력을 계속 버퍼에 보관하기 때문에, 녹화 버튼을 누르기 전에 발생한 에러도 리포트에 남아 있어요.
대부분의 버그 리포트가 놓치는 게 바로 이 두 번째 부분이에요. 뭔가 고장 났다는 걸 알아차렸을 때쯤이면, 에러는 아무도 열어 두지 않은 DevTools 창에서 이미 지나가 버린 뒤예요. Midge는 "콘솔 열어 놓고 다시 재현해 볼 수 있어요?"라는 단계를 없애 줘요.
수집하는 것
모든 콘솔 레벨
Midge는 log, info, warn, error, debug 호출을 타임스탬프와 전달된 값과 함께 기록해요. 경고는 생각보다 중요해요. 크래시 직전에 찍힌 React key 경고나 지원 중단 안내가 진짜 단서인 경우가 많아요.
처리되지 않은 에러
아무도 잡지 않은 예외는 console.error를 거치지 않아요. window까지 올라가고, 브라우저가 빨간색으로 출력하죠. Midge는 이런 에러도 듣고 있어서, 앱에 로깅이 전혀 없더라도 이벤트 핸들러에서 난 크래시가 리포트에 나타나요.
처리되지 않은 Promise 거부
.catch() 없이 거부된 Promise는 요즘 프런트엔드에서 가장 흔한 조용한 실패 중 하나예요. fetch가 거부됐는데 아무도 처리하지 않아서 버튼이 "아무 반응이 없는" 거죠. Midge는 이런 거부와 그 이유를 기록해요.
스택 트레이스
에러의 경우 Midge는 브라우저가 보고한 스택 트레이스를 저장해요. 보통 이런 모습이에요.
Uncaught (in promise) TypeError: Failed to fetch
at submitOrder (orders.js:88:15)
at HTMLButtonElement.onClick (checkout.js:41:9)
프로덕션 번들이 압축(minify)되어 있다면, 스택에는 브라우저가 보고한 그대로 압축된 파일 이름과 위치가 나와요. 프로덕션 리포트를 볼 때는 소스 맵을 준비해 두세요.
녹화 버튼을 누르기 전부터 수집해요
Midge는 각 페이지가 로드되기 시작할 때, 앱 자체 스크립트가 실행되기 전부터 듣기 시작해요. 그래서 시작 과정에서 발생한 에러까지 잡아요. 열려 있는 모든 탭에 대해 최근 몇 분의 콘솔 출력을 메모리에 보관해요.
화면 녹화를 시작하거나 스크린샷을 찍으면, 그 최근 기록이 함께 붙어요. 실제로는 평소처럼 일하다가 뭔가 이상하다는 걸 알아차린 다음에야 리포트를 남기기로 해도 된다는 뜻이에요. 20초 전에 뜬 빨간 에러가 타임라인에 그대로 남아 있어요.
버퍼에 대해 알아 둘 몇 가지:
- 메모리에만 있고, 탭을 닫으면 지워져요.
- 리포트를 만들지 않는 한 아무것도 컴퓨터 밖으로 나가지 않아요.
- 일반 http, https 페이지에서 동작해요. 은행 사이트나 비밀번호 관리자처럼 Midge가 절대 실행되지 않아야 하는 사이트를 추가할 수 있어요.
콘솔과 영상을 하나의 타임라인에
모든 녹화에는 콘솔 로그, 네트워크 요청, 사용자 동작, 기기 정보가 담겨요. 리포트에서 콘솔은 영상 옆에 시간 순으로 정렬돼 있어요. 모달이 열리지 않는 순간을 보면, 그걸 일으킨 클릭 몇 줄 아래에 해당 TypeError가 바로 보여요.
에러는 네트워크 활동과 자연스럽게 짝을 이뤄요. /api/orders의 500 뒤에 Cannot read properties of undefined가 이어진다면 이야기가 다 나온 거예요. 서버가 실패했고, 클라이언트는 그 실패를 처리하지 못했어요. 자세한 내용은 네트워크 로그 페이지를 참고하세요.
콘솔 출력 속 민감 정보
개발자는 특히 디버깅 중에 찍지 말아야 할 것을 로그로 남기곤 해요. 토큰, 사용자 객체 전체, 쿼리 문자열에 API 키가 들어간 요청 URL 같은 것들이요. Midge는 네트워크 데이터에 쓰는 것과 같은 가림 처리 규칙을 콘솔 텍스트에도 적용해요. 비밀번호, 카드 번호, 토큰, 쿠키는 기기를 떠나기 전에 브라우저에서 가려져요.
예를 들어 이 줄은:
auth ok: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI0MiJ9.abc123 for [email protected]
리포트에서 이렇게 보여요.
auth ok: [REDACTED] for j***@acme.com
전체 규칙 목록과 가림 처리가 잡지 못하는 것은 가림 처리 페이지에 있어요.
Midge와 콘솔을 직접 내보내는 방법 비교
Chrome DevTools에서 콘솔 출력을 직접 저장할 수도 있어요. Chrome에서 콘솔 로그 내보내는 방법 가이드에서 과정을 설명해요. 그 방법도 되긴 하지만 빈틈이 있어요. 에러가 나기 전에 DevTools가 열려 있어야 하고, 내보낸 파일은 영상 없는 일반 텍스트이며, 민감 정보를 지워 주는 것도 없어요. 로그나 HAR 파일을 직접 내보냈다면, 티켓에 첨부하기 전에 무료 HAR Sanitizer로 HAR를 한 번 정리하세요.
Midge를 쓰면 DevTools가 열려 있었든 아니든 콘솔이 수집되고, 내가 본 화면과 시간이 맞춰지며, 업로드 전에 가림 처리돼요.
이 로그를 읽는 사람들
QA 테스터는 더 이상 티켓에 스택 트레이스 조각을 붙여 넣지 않아도 돼요. 고객 지원 담당자는 콘솔이 뭔지 몰라도 에스컬레이션에 실제 에러 출력을 첨부할 수 있어요. 개발자는 정확한 에러, 스택, 주변 네트워크 호출을 한곳에서 받아요. 개발자라면 개발자를 위한 Midge를 확인해 보세요.
Midge는 무료예요. 녹화 횟수 제한이 없고, 영상은 최대 15분까지, 워터마크도 없어요.
자주 묻는 질문
- Midge는 어떤 콘솔 메시지를 수집하나요?
- log, info, warn, error, debug 다섯 레벨 모두요. console.error를 거치지 않는 처리되지 않은 예외와 처리되지 않은 Promise 거부도 스택 트레이스와 함께 기록해요.
- 녹화를 시작하기 전에 난 에러도 담을 수 있나요?
- 네. Midge는 탭마다 최근 몇 분의 콘솔 출력을 메모리에 보관해요. 그래서 에러 직후에 만든 녹화나 스크린샷에도 그 에러가 담겨요. 이 버퍼는 탭을 닫으면 지워지고, 리포트를 만들지 않는 한 기기 밖으로 나가지 않아요.
- 콘솔 메시지 속 민감 정보도 가려지나요?
- 네. JWT, 카드 번호, 알려진 형식의 API 키, 개인 키, 민감한 URL 파라미터는 콘솔 텍스트에서 제거되고, 이메일과 국제 전화번호는 절반만 마스킹돼요.
- DevTools를 열어 둬야 하나요?
- 아니요. Midge는 DevTools가 닫혀 있어도 콘솔을 수집하고, 리포트를 연 사람은 영상 옆에서 메시지를 확인해요.