본문으로 건너뛰기

화면 녹화, 콘솔·네트워크 로그가 담긴 GitHub Issues 버그 리포트

업데이트

GitHub Issues는 많은 제품 팀과 오픈소스 프로젝트가 코드 바로 옆에서 버그를 관리하는 곳이에요. Midge를 쓰면 팀의 누구든 콘솔 로그, 네트워크 요청, 기기 정보와 함께 버그를 녹화하고, Send to GitHub를 클릭해 AI가 작성한 요약, 재현 단계, 예상 원인, 녹화 링크가 담긴 이슈를 만들 수 있어요.

이렇게 작동해요

  1. 앱을 한 번만 설치하세요. 워크스페이스 관리자가 Midge에서 Settings › Workspace › Integrations를 열고 GitHub의 Connect를 클릭해요. GitHub에서 Midge Bug Reports 앱을 설치하고 이슈를 만들 수 있는 저장소를 고르라고 안내해요. Midge는 그 설치가 정말 그 관리자의 것인지 GitHub 로그인으로 확인한 뒤에 저장하고, 관리자는 버그를 보낼 저장소를 골라요.
  2. 버그를 녹화하세요. Chrome 확장 프로그램, Mac용 Midge, 또는 iPhone용 Midge로 화면을 녹화하거나 스크린샷을 찍어요. 리포트에는 콘솔, 네트워크 요청, 클릭, 기기 정보가 담겨요.
  3. GitHub로 보내세요. 리포트에서 Send to GitHub를 클릭하세요. 앱이 이슈를 만들고, 리포트에는 만들어진 이슈가 표시돼요.

GitHub 이슈에 담기는 내용

GitHub는 Markdown을 렌더링하기 때문에, 다른 걸 열지 않아도 이슈만으로 잘 읽혀요.

  • 영상, 콘솔·네트워크 패널이 있는 Midge 리포트 링크,
  • AI 요약,
  • 녹화에서 한 동작을 바탕으로 번호를 매겨 초안을 쓴 재현 단계,
  • 예상 원인,
  • 페이지 URL, 그리고 콘솔 에러와 실패한 요청의 개수.

맨 끝에는 요약을 가림 처리된 로그로부터 AI가 작성했다는 안내가 붙어요.

내 말이 먼저

리포트를 보낼 때 신고자가 직접 입력한 내용, 예를 들어 기대 결과나 어떤 계정을 썼는지 같은 내용은 이슈에서 링크 바로 아래, AI 요약보다 앞에 들어가요. 버그를 직접 본 사람이 먼저 말하고, 요약은 그 사람이 적지 않은 부분을 채워요.

최소한의 권한

Midge Bug Reports 앱은 내가 고른 저장소에 대해 issues: write와 metadata: read만 요청하고, 그 밖에는 아무것도 요청하지 않아요. 코드, 풀 리퀘스트, Actions는 읽을 수 없고, 언제든 GitHub 설정에서 저장소를 빼거나 앱을 제거할 수 있어요.

비밀 정보는 저장소에 들어가지 않아요

공개 저장소에서는 이슈 내용도 공개돼요. Midge는 로그가 브라우저나 휴대폰을 떠나기 전에 비밀번호, 토큰, 쿠키, 인증 헤더, 카드 번호를 제거하고, 이메일과 전화번호는 마스킹해요. 이슈는 그렇게 가림 처리된 로그로 작성돼요. 녹화 자체는 자체 공유 설정과 함께 Midge에 남아요. "Workspace members"(워크스페이스 멤버)나 "Only me"(나만)로 설정하면 이슈가 공개되어 있어도 녹화는 비공개로 유지돼요. 가림 처리를 참고하세요.

이슈에서 수정까지

개발자는 이슈를 열고, 녹화로 넘어가서, 버그가 일어난 바로 그 순간의 실패한 요청과 스택 트레이스를 확인해요. 코딩 에이전트와 함께 일한다면 같은 링크를 Claude Code나 Cursor에 넣으면 돼요. 에이전트가 Midge의 MCP 서버로 콘솔, 네트워크 요청, 재현 단계를 읽어요.

이런 팀이 써요

  • 모든 걸 GitHub에서 관리하고, 버그 때문에 도구를 하나 더 들이고 싶지 않은 작은 제품 팀.
  • 엔지니어들이 이미 지켜보는 저장소로 버그를 등록하는 QA와 지원팀.
  • "안 돼요"뿐인 이슈 대신 로그가 붙은 리포트를 받고 싶은 메인테이너.

연동 없이 쓰기

모든 리포트에는 만들 때 자동으로 복사되는 링크가 있어요. 어떤 이슈, 풀 리퀘스트, 디스커션에 붙여 넣어도 같은 리포트가 열려요.

관련 페이지

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

자주 묻는 질문

Midge GitHub App에는 어떤 권한이 있나요?
설치할 때 고른 저장소에 대해 Issues: write와 metadata: read 권한만 있어요. 코드를 읽거나 변경할 수 없어요.
이슈 작성자는 누구로 표시되나요?
Midge Bug Reports 앱이요. 이슈에는 Midge 리포트 링크가 걸리고, 리포트에서 누가 녹화했는지 확인할 수 있어요.
비공개 저장소에서도 쓸 수 있나요?
네, 앱이 설치된 저장소라면 어디서든 돼요. 이슈에는 리포트 링크가 걸린다는 점을 기억하고, 필요한 사람들이 열 수 있도록 리포트의 공유 설정을 맞춰 두세요.
GitHub Enterprise Server나 GitLab도 지원하나요?
아니요, GitHub.com만 지원해요. 서명된 웹훅을 쓰면 자체 제작한 작은 서비스로 다른 곳에도 이슈를 만들 수 있어요.