인앱 버그 리포트: 흔들어서 신고하고, 네트워크와 로그는 자동으로
업데이트
Midge SDK는 내 앱 안에 Report a bug(버그 신고) 흐름을 넣어 줘요. 앱을 쓰던 사람이 휴대폰을 흔들거나 내가 만든 버튼을 탭하고, 화면을 녹화하면서 무엇이 잘못됐는지 말하면 돼요. 리포트는 그동안 앱이 한 일과 함께 Midge 워크스페이스에 도착해요. HTTP 요청과 응답, 로그 메시지, 기기 정보, 그리고 사용자 ID나 요금제처럼 내가 설정한 맥락까지요.
"제 휴대폰에서 결제가 안 돼요"라고만 적힌 지원 티켓과, Pay 탭, /api/orders에서 돌아온 502, 사용자의 요금제를 하나의 타임라인에 보여 주는 티켓의 차이예요.
세 플랫폼, 하나의 워크스페이스
| 플랫폼 | 추가 방법 | 네트워크 수집 |
|---|---|---|
| 웹사이트와 웹 앱 | <script> 태그 하나 | fetch와 XMLHttpRequest |
| iPhone과 iPad (iOS 17+) | Swift 패키지 | URLSession |
| Android (API 26+) | Kotlin 라이브러리 | OkHttp, HttpURLConnection, Volley, 또는 Midge.network() |
모든 SDK는 녹화 링크로 전송하기 때문에, 리포트는 팀이 Chrome 확장 프로그램, Mac 앱, iPhone과 Android 앱으로 만든 리포트와 같은 워크스페이스에 모여요.
iOS에서 설정하기
import MidgeSDK
@main
struct ShopApp: App {
init() {
Midge.start(link: "rl_YOUR_TOKEN")
}
}
이제 휴대폰을 흔들면 신고 화면이 열려요. 직접 만든 버튼으로 열려면 Midge.report()를 호출하세요. 전체 설정 방법: iOS SDK 문서.
Android에서 설정하기
class ShopApplication : Application() {
override fun onCreate() {
super.onCreate()
Midge.start(this, link = "rl_YOUR_TOKEN")
}
}
val client = OkHttpClient.Builder()
.addInterceptor(Midge.okHttpInterceptor())
.build()
HttpURLConnection이나 Volley를 쓰는 코드는 url.openConnection() 대신 Midge.openConnection(url)을 호출해요. 전체 설정 방법: Android SDK 문서.
웹에서 설정하기
<script src="https://midge.dev/sdk/v1.js" data-link="YOUR_LINK_TOKEN" async></script>
사이트 구석에 Report a bug 버튼이 나타나요. 전체 설정 방법: 웹사이트 SDK 문서.
리포트에 담기는 것
- 화면 녹화: 내 앱 화면만 담아요. 다른 앱과 알림은 녹화되지 않아요.
- 네트워크 요청: 헤더, 최대 64 KB까지의 본문, 상태, 타이밍이 함께 담겨요.
- 로그: iOS에서는 앱의
Logger,os_log,NSLog메시지, Android에서는 앱 자체의 logcat 줄, 웹에서는 콘솔이에요.Midge.log()로 직접 줄을 추가할 수도 있어요. - 기기: 앱 이름, 버전과 빌드, 기기 모델, OS 버전, 언어, 시간대.
Midge.metadata()로 설정한 메타데이터, 그리고Midge.user()로 설정한 신고자의 이름과 이메일.
최근 몇 분간의 요청은 메모리에만 보관되고, 사용자가 Send를 탭하기 전에는 아무것도 전송되지 않아요.
기기에서 가림 처리
무엇이든 휴대폰이나 브라우저를 떠나기 전에, Midge는 비밀번호, 토큰, 쿠키, 인증 헤더, 카드 번호를 제거하고, 이메일과 전화번호를 마스킹하고, 워크스페이스에서 지정한 숨김 필드 이름을 적용해요. 모바일에서도 Chrome 확장 프로그램과 같은 가림 처리 코드가 실행되기 때문에, 토큰은 어디서든 똑같은 방식으로 걸러져요. 가림 처리를 참고하세요.
내 앱만 보낼 수 있어요
웹에서는 워크스페이스에서 인증한 도메인에서만 SDK가 전송해요. 모바일에서는 소유자나 관리자가 앱의 bundle id 또는 application id를 워크스페이스에 등록해요. 그 밖의 앱에서는 신고 화면에 그 사실이 표시되고, 아무것도 전송되지 않아요.
직접 만들지 않는 이유
텍스트 상자 내용을 메일로 보내는 "피드백 보내기" 양식은 쉽게 만들 수 있어요. 어려운 건 그다음에 개발자에게 필요한 모든 것이에요. 사용자가 한 일을 담은 녹화, 실패한 요청과 그 응답 본문, 그 주변의 로그 줄, 그리고 그 어디에도 고객의 비밀번호나 카드 번호가 들어 있지 않다는 확신이요. 이걸 세 플랫폼에서 만들고, 가림 처리하고, 저장하는 건 그 자체로 하나의 프로젝트예요. Midge를 쓰면 앱마다 코드 몇 줄이면 되고, 리포트는 팀이 이미 일하는 곳으로 도착해요.
리포트에서 수정까지
각 리포트는 midge.dev에서 영상과 로그를 나란히 보여 주고, 재현 단계가 담긴 AI 요약, 그리고 연동을 통해 클릭 한 번으로 Jira, Linear, GitHub, Slack에 넘기는 기능을 제공해요. Claude Code나 Cursor 같은 코딩 에이전트는 Midge의 MCP 서버로 같은 리포트를 읽어요.
Midge는 무료예요. 녹화 횟수 제한이 없고, 영상은 최대 15분까지, 워터마크도 없어요.
자주 묻는 질문
- SDK는 어떤 플랫폼을 지원하나요?
- 웹사이트와 웹 앱은 스크립트 태그로, iPhone·iPad 앱(iOS 17 이상)은 Swift 패키지로, Android 앱(Android 8.0, API 26 이상)은 Kotlin 라이브러리로 지원해요.
- 사용자는 신고 화면을 어떻게 여나요?
- 모바일 앱에서는 휴대폰을 흔들거나, Midge.report()를 호출하는 직접 만든 Report a bug 버튼으로 열어요. 웹에서는 스크립트가 추가하는 Report a bug 버튼이나 직접 만든 버튼으로 열어요.
- 어떤 네트워크 요청이 수집되나요?
- iOS에서는 URLSession 요청이요. Android에서는 인터셉터를 통한 OkHttp(Retrofit, Coil, Ktor의 OkHttp 엔진 포함), HttpURLConnection, Volley, 그리고 Midge.network()를 통한 그 밖의 모든 클라이언트요. 웹에서는 fetch와 XMLHttpRequest예요.
- 민감한 데이터가 Midge로 전송되나요?
- 아니요. 비밀번호, 토큰, 쿠키, 카드 번호, 그리고 워크스페이스에서 지정한 숨김 필드는 무엇이든 전송되기 전에 기기에서 가림 처리돼요. Chrome 확장 프로그램과 같은 코드로요.
- 모바일 SDK는 지금 쓸 수 있나요?
- 웹사이트 SDK는 모든 워크스페이스에서 쓸 수 있어요. iOS와 Android SDK는 얼리 액세스 단계예요. 앱 이름을 적어 [email protected]로 메일을 보내면 이용할 수 있어요.