본문으로 건너뛰기

개발자를 위한 버그 리포트: 직접 모았을 증거가 이미 다 있어요

업데이트

개발자를 위한 버그 리포트는 내가 직접 모았을 내용이 들어 있을 때 가장 쓸모 있어요. 스택 트레이스가 붙은 콘솔 에러, 본문이 담긴 실패한 요청, 거기까지 이어진 단계, 그리고 버그가 일어난 브라우저요. Midge는 이 모든 것을 Chrome 탭에서 자동으로 수집하고, 영상과 하나의 타임라인으로 맞추고, 업로드 전에 비밀 정보를 가려요. 그래서 리포트를 티켓, 풀 리퀘스트, AI 채팅에 붙여 넣어도 안전해요.

모든 녹화에는 콘솔 로그, 네트워크 요청, 사용자 동작, 기기 정보가 담겨요. "콘솔 좀 보내 줄 수 있어요?" 같은 메시지는 줄고, 처음 읽자마자 고치는 버그는 늘어나요.

리포트에서 얻는 것

하나의 타임라인

영상 옆에 콘솔 메시지, 네트워크 요청, 사용자 동작 패널이 모두 시간순으로 정렬돼 있어요. Save를 클릭하는 장면을 보면, 그 뒤에 이어진 PATCH /api/projects/88이 바로 거기 있고, 응답이 도착하고 몇 밀리초 뒤에 발생한 Uncaught TypeError도 함께 있어요. 첨부 파일 세 개를 오가며 순서를 짜 맞출 필요가 없어요.

스택 트레이스가 담긴 콘솔

debug부터 error까지 모든 레벨, 그리고 처리되지 않은 예외와 처리되지 않은 Promise 거부를 스택과 함께 담아요. Midge는 페이지가 로드될 때부터 수집을 시작해서 시작 시점의 에러도 포함하고, 계속 갱신되는 버퍼를 유지해서 테스터가 녹화를 누르기 전의 에러도 남아 있어요. 자세한 내용은 콘솔 로그 페이지에 있어요.

네트워크 상세 정보

fetch와 XHR 요청은 헤더, 요청·응답 본문, 상태 코드, 타이밍과 함께 담겨요. WebSocket 메시지는 양방향 모두 기록돼요. 그 밖의 리소스는 상태, 크기, 타이밍을 보여 줘요. GraphQL은 요청마다 operation 이름을 보여 주고, errors 배열이 담긴 200 응답은 따로 표시해요. 상태 코드 필터로는 놓치기 쉬운 경우니까요. 자세한 내용은 네트워크 로그 페이지에 있어요.

기기 정보

브라우저와 버전, 운영체제, 창 크기, 언어, 시간대, URL이요. 같은 환경을 구성하기에 충분하고, 독일어 로케일에서만 일어나는 버그라는 걸 알아채기에도 충분해요.

cURL로 복사

어떤 요청이든 cURL 명령어로 복사해서 터미널에서 실행할 수 있어요.

curl 'https://staging.acme.dev/api/projects/88' \
  -X PATCH \
  -H 'Content-Type: application/json' \
  -H 'Authorization: [REDACTED]' \
  --data-raw '{"name":"Q4 roadmap","archived":null}'

Authorization 헤더가 가려진 건 의도된 거예요. 내 테스트 사용자의 토큰을 넣으면, 누구도 실제 세션을 공유하지 않고 똑같은 요청을 재현할 수 있어요. 내 환경의 토큰을 살펴보고 싶다면, 무료 JWT 디코더가 어디에도 보내지 않고 클레임과 만료 시간을 보여 줘요.

가림 처리된 HAR 다운로드

성능 문제를 보거나 API 업체의 지원팀에 보내야 해서 네트워크 로그 전체가 필요하다면, HAR 파일로 다운로드하세요. 파일에는 가림 처리된 데이터가 담겨요. 무료 HAR 뷰어나 HAR를 읽는 어떤 도구로든 열 수 있어요. 누군가 DevTools에서 그대로 내보낸 HAR를 다루고 있다면, 전달하기 전에 HAR 파일에서 민감한 데이터를 제거하는 방법을 읽어 보세요.

어디든 붙여 넣어도 안전한 가림 처리

버그 리포트는 어디에나 붙여 넣어져요. 티켓, Slack 스레드, 풀 리퀘스트 설명, 코딩 어시스턴트와의 채팅까지요. 비밀번호, 카드 번호, 토큰, 쿠키는 기기를 떠나기 전에 브라우저에서 가려져요. 여기에는 다음이 포함돼요.

  • Authorization, Cookie, Set-Cookie 헤더, 그리고 이름에 token, secret, session, auth가 들어간 모든 헤더,
  • access_token, code, signature 같은 민감한 URL 파라미터,
  • password, otp, cvv, client_secret 같은 본문 필드,
  • JWT, Luhn 검사를 통과하는 카드 번호, 개인 키, 그리고 Stripe, AWS, GitHub, Slack, Google, OpenAI, Anthropic의 API 키.

요청 ID처럼 무작위로 보이는 값은 일부러 남겨 둬요. 그래야 대응하는 서버 로그를 찾을 수 있으니까요. 가림 처리는 규칙 기반이에요. 앱에 자체 비밀 필드가 있다면 워크스페이스 목록에 추가하세요. 전체 규칙은 가림 처리 페이지에 있어요.

코딩 에이전트와 함께 쓰기

Midge에는 https://midge.dev/mcp에 MCP 서버가 있어서, Claude Code, Cursor 같은 에이전트가 리포트의 콘솔, 네트워크, 사용자 동작을 직접 읽을 수 있어요. 리포트 링크를 채팅에 붙여 넣으면, 에이전트가 get_console, get_network, get_user_actions 같은 읽기 전용 도구로 필요한 것을 가져와요. 에이전트는 브라우저로 로그인하거나, Settings › Account › AI assistants에서 만든 토큰을 써요. 실패한 요청을 cURL로 복사하거나 가림 처리된 HAR를 첨부하는 방법도 여전히 쓸 수 있어요. 어느 쪽이든 데이터는 이미 정리된 상태예요.

팀에게서 더 나은 리포트 받기

아무리 좋은 도구라도 결국 사람들이 무엇을 담느냐에 달려 있어요. 테스터와 지원팀에게 버그 리포트 작성법 가이드를 공유하고, 화면 녹화 도구를 알려 주세요. Midge는 무료예요. 녹화 횟수 제한이 없고, 영상은 최대 15분까지, 워터마크도 없으니 아무도 녹화를 아껴 쓸 필요가 없어요.

자주 묻는 질문

개발자가 Midge 리포트를 열면 무엇을 보나요?
영상이나 스크린샷, 그리고 그 옆에 시간순으로 정렬된 콘솔 메시지, 네트워크 요청, 사용자 동작, 기기 정보요. 요청에는 헤더, 본문, 상태 코드, 타이밍이 표시돼요.
실패한 요청을 다시 실행할 수 있나요?
네. 수집된 요청은 무엇이든 cURL 명령어로 복사할 수 있어요. 인증 헤더와 쿠키는 가림 처리되어 있으니, 실행하기 전에 내 테스트 계정의 토큰을 넣으세요.
Midge 리포트를 공개 이슈나 AI 채팅에 붙여 넣어도 안전한가요?
Midge는 업로드 전에 비밀번호, 카드 번호, 토큰, 쿠키, 알려진 형식의 API 키를 제거해요. 가림 처리는 규칙 기반이라 특이한 내용은 직접 확인해야 하지만, 흔한 비밀 정보는 이미 사라진 상태예요.
제 디버깅에도 Midge를 쓸 수 있나요?
네. 직접 발견한 버그를 녹화해 두면 팀원에게 빠르게 넘기거나, 나중에 로그가 그대로 남은 상태로 다시 볼 수 있어요.