본문으로 건너뛰기

버그 리포트마다 자동으로 담기는 크롬 네트워크 로그

업데이트

Midge는 모든 버그 리포트에 크롬 네트워크 로그를 자동으로 담아요. fetch와 XHR 요청은 헤더, 요청·응답 본문, 상태 코드, 타이밍과 함께 담기고, WebSocket 메시지는 주고받는 그대로 기록되며, 스크립트, 스타일, 이미지, 폰트는 상태, 크기, 타이밍과 함께 목록으로 보여 줘요. 개발자는 어떤 요청이든 열어 보고, cURL로 복사하거나, 전체 로그를 가림 처리된 HAR 파일로 내려받을 수 있어요.

DevTools를 열어 둘 필요도 없고, 버그를 신고하는 사람이 HAR 파일이 뭔지 알 필요도 없어요. 모든 녹화에는 콘솔 로그, 네트워크 요청, 사용자 동작, 기기 정보가 담겨요.

DevTools 네트워크 패널만으로는 부족한 이유

직접 디버깅할 때 Chrome의 Network 패널은 훌륭해요. 하지만 버그 리포트에 쓰기에는 세 가지 문제가 있어요.

  1. 요청이 일어나기 전에 열려 있어야 해요. DevTools를 열기 전에 일어난 요청은 남아 있지 않은데, 대부분은 버그를 본 다음에야 DevTools를 열어요.
  2. 페이지를 이동하면 지워져요. 누군가 "Preserve log"를 체크해 두지 않았다면요.
  3. HAR 파일에는 민감 정보가 들어 있어요. 쿠키, Authorization 헤더, 쿼리 문자열 속 토큰이 모두 파일에 들어가요. 이게 왜 문제인지는 HAR 파일에서 민감 정보 제거하는 방법 가이드에서 설명해요.

Midge는 각 페이지에서 백그라운드로 네트워크 활동을 수집하고, 최근 요청을 메모리에 보관했다가 리포트를 만들 때 붙여요. 민감 정보는 업로드 전에 제거돼요.

리포트에서 요청은 이렇게 보여요

각 요청은 영상, 콘솔과 같은 타임라인에 놓여요. 하나를 열면 전체 주고받은 내용이 보여요.

POST /api/v2/invoices HTTP/1.1
Content-Type: application/json
Authorization: [REDACTED]

{"customerId": "cus_8812", "lines": [{"sku": "PRO-M", "qty": 3}]}

HTTP/1.1 409 Conflict
Content-Type: application/json

{"error": "invoice_already_open", "invoiceId": "inv_3021"}

본문과 함께 상태 코드, 소요 시간, 요청 시작 시점도 볼 수 있어요. 요청이 영상 옆에 시간 순으로 정렬되기 때문에, 위의 409는 수십 개의 이미지 로드 사이에 묻히지 않고 그걸 일으킨 클릭 바로 뒤에 놓여요.

WebSocket 메시지

실시간 앱은 HTTP가 아니라 소켓에서 실패하는 경우가 많아요. Midge는 양방향 WebSocket 메시지를 타임스탬프와 함께 기록해요. 그래서 서버가 {"type":"price_update"}를 두 번 보냈는데 클라이언트는 첫 번째만 렌더링했다는 걸 확인할 수 있어요.

기타 리소스

스크립트, 스타일시트, 이미지, 폰트, 문서는 본문 없이 상태 코드, 크기, 타이밍과 함께 목록으로 보여 줘요. 보통은 그거면 충분해요. 배포 후 app.4f2c1.js에서 난 404나, 첫 페인트를 늦추는 3 MB짜리 히어로 이미지 같은 경우요.

GraphQL도 제대로

GraphQL은 네트워크 로그를 읽기 어렵게 만들어요. 모든 요청이 같은 /graphql 엔드포인트로 가고, 에러도 HTTP 200으로 돌아오는 경우가 많아요.

{
  "data": { "updateProfile": null },
  "errors": [{ "message": "Not authorized to update this profile", "path": ["updateProfile"] }]
}

Midge는 GraphQL 요청마다 UpdateProfile 같은 operation 이름을 옆에 보여 주고, errors 배열이 들어 있는 200 응답을 표시해요. 상태 코드 필터로는 가려졌을 실패가 실패로 표시돼요.

cURL로 복사

수집된 요청은 어떤 것이든 cURL 명령으로 복사할 수 있어서, 백엔드 개발자가 터미널에서 다시 실행해 같은 응답을 확인할 수 있어요. 가림 처리가 먼저 이뤄지기 때문에 Authorization 헤더와 쿠키는 [REDACTED]로 들어가요. 내 테스트 계정의 토큰으로 바꿔 넣고 실행하세요. 일부러 이렇게 만들었어요. 버그 리포트가 작동하는 세션을 넘겨주는 일은 절대 없어야 하니까요.

가림 처리된 HAR 내보내기

HAR 파일을 원하는 팀이나 업체도 있어요. Midge에서는 리포트의 네트워크 로그를 HAR로 내려받을 수 있고, 파일에는 가림 처리된 데이터가 들어 있어요. 무료 HAR 뷰어로 열어 보거나, 키가 유출될 걱정 없이 API 제공업체 지원 티켓에 첨부할 수 있어요. DevTools에서 바로 내보낸 HAR가 있다면, 확장 프로그램과 같은 규칙을 쓰는 HAR Sanitizer로 정리하세요.

가려지는 것

비밀번호, 카드 번호, 토큰, 쿠키는 기기를 떠나기 전에 브라우저에서 가려져요. 네트워크 데이터에서는 이런 뜻이에요.

  • Authorization, Cookie, Set-Cookie, API 키·CSRF 헤더, 그리고 이름에 token, secret, session, auth 같은 단어가 들어간 모든 헤더.
  • access_token, code, api_key, signature 같은 민감한 URL 파라미터.
  • 중첩된 필드를 포함해 password, otp, cvv, iban, card_number 같은 본문 필드.
  • 페이로드 어디에 있든 JWT, Luhn 검사를 통과하는 카드 번호, 알려진 형식의 API 키.

이메일과 국제 전화번호는 절반만 마스킹돼요. 전체 목록은 가림 처리 페이지에 있어요.

한계

요청·응답 본문은 fetch, XHR, WebSocket에 대해서만 수집하고, 다른 리소스 유형은 메타데이터만 보여 줘요. Chrome 밖의 앱에서 나는 트래픽은 리포트에 포함되지 않고, 수집 제외 목록에 추가한 사이트에서는 Midge가 실행되지 않아요. 일회성 조사를 위해 브라우저 수준의 전체 수집이 필요하다면 Chrome에서 네트워크 트래픽 수집하기 가이드에서 DevTools를 쓰는 방법을 다뤄요.

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

자주 묻는 질문

Midge는 어떤 요청을 수집하나요?
fetch와 XHR 요청을 헤더, 요청·응답 본문, 상태 코드, 타이밍과 함께 수집하고, WebSocket 메시지도 기록해요. 스크립트, 스타일시트, 이미지, 폰트, 문서 같은 다른 리소스는 상태, 크기, 타이밍과 함께 목록으로 보여 줘요.
네트워크 로그를 HAR 파일로 내보낼 수 있나요?
네. 리포트의 네트워크 로그를 HAR 파일로 내려받을 수 있고, 내려받은 파일에는 원래 값이 아니라 가림 처리된 데이터가 들어 있어요.
Midge는 GraphQL을 어떻게 다루나요?
GraphQL 요청마다 operation 이름을 보여 주고, HTTP 200을 반환했지만 errors 배열이 들어 있는 응답을 표시해요. 상태 코드 필터로는 놓치는 실패예요.
cURL로 복사하면 인증 토큰도 들어가나요?
아니요. Authorization 헤더와 쿠키는 업로드 전에 가려지기 때문에, 복사한 명령에는 그 자리에 [REDACTED]가 들어가요. 실행할 때 직접 토큰을 넣으세요.