모바일 앱 크래시·ANR 잡기 — Sentry로 크래시프리율·심볼리케이션·릴리스 헬스 관리

ANR과 메인스레드 블로킹은 크래시와 뭐가 다른가

ANR(Application Not Responding)은 앱이 죽는 게 아니라 멈추는 것이다. Android에서 메인(UI) 스레드가 일정 시간(입력 이벤트 기준 약 5초) 응답하지 않으면 시스템이 ANR로 판정하고 "앱이 응답하지 않습니다" 다이얼로그를 띄운다. 크래시는 스택트레이스가 명확한데, ANR은 "그 순간 메인 스레드가 뭘 하고 있었나"를 봐야 해서 추적 감각이 다르다.

iOS에는 ANR이라는 공식 용어는 없지만 대응물이 있다. 앱이 실행 상태인데 응답이 없으면 워치독이 죽이는 게 있고(대표적으로 시작 시 20초 넘으면 0x8badf00d, 읽으면 "ate bad food"), Sentry는 이걸 App Hang으로 잡는다. 둘 다 원인은 대개 같다. 메인 스레드에서 하면 안 되는 걸 하는 것.

Sentry Android SDK는 ANR 감지가 기본 켜져 있지만, 멈춘 순간의 스택을 제대로 받으려면 최신 SDK의 ANR v2(Android 11+의 ApplicationExitInfo 기반)를 쓰는 게 훨씬 정확하다. iOS App Hang은 명시적으로 켜준다.

// iOS — SentrySDK 초기화
SentrySDK.start { options in
    options.dsn = "https://examplePublicKey@o0.ingest.sentry.io/0"
    options.enableAppHangTracking = true
    options.appHangTimeoutInterval = 2.0  // 2초 이상 멈추면 App Hang으로 보고
    options.enableAutoSessionTracking = true  // 릴리스 헬스용 세션
    options.tracesSampleRate = 0.2
}

실무 팁 하나. ANR이 많이 잡히는 앱을 열어보면 십중팔구 onCreate나 Application 초기화에서 SharedPreferences를 동기로 읽거나, JSON을 메인에서 파싱하거나, DB 마이그레이션을 UI 스레드에서 돌린다. 나는 App Hang timeout을 일부러 2초로 낮게 잡아둔다. 기본값(iOS 2초, 하지만 관대하게 쓰는 팀 많음)보다 공격적으로 잡아야 "사용자는 느리다고 느끼는데 워치독은 안 죽이는" 구간이 보인다.

재현 안 되는 크래시, breadcrumb으로 역추적하기

breadcrumb은 크래시 직전까지 앱에서 일어난 일들의 타임라인이다. 화면 전환, 네트워크 요청, 버튼 탭, 로그 출력 같은 게 시간순으로 쌓여서 크래시 이벤트에 붙는다. 스택트레이스가 "어디서"를 알려준다면 breadcrumb은 "어쩌다가"를 알려준다. 재현이 안 되는 크래시는 이 "어쩌다가"가 유일한 단서인 경우가 많다.

SDK가 자동으로 남기는 것(네비게이션, HTTP, 시스템 이벤트)만으로도 상당히 유용하지만, 진짜 힘을 발휘하는 건 도메인 이벤트를 직접 심을 때다. 예를 들어 결제 플로우라면 "장바구니 진입 → 쿠폰 적용 → 결제수단 선택 → 결제 요청" 같은 상태를 breadcrumb으로 남긴다. 그러면 크래시 유저의 90%가 "쿠폰 적용 직후"에 몰려 있는 게 보이고, 재현 시나리오가 순식간에 좁혀진다.

// Kotlin — 도메인 breadcrumb + 사용자 컨텍스트
Sentry.addBreadcrumb(
    Breadcrumb().apply {
        category = "checkout"
        message = "coupon applied"
        level = SentryLevel.INFO
        setData("couponId", coupon.id)
        setData("cartTotal", cart.total)
    }
)

// 크래시를 특정 조건으로 검색 가능하게 태그/컨텍스트 추가
Sentry.configureScope { scope ->
    scope.setTag("membership", user.grade)   // 검색/필터용
    scope.setContexts("experiment", mapOf("checkout_v2" to true))
}

# CI — 릴리스 등록 + 커밋 연결 + 배포 마킹
VERSION="com.myapp@4.3.0+412"

sentry-cli releases new "$VERSION"
# 커밋 연결 → 어떤 커밋이 이 크래시를 유발했는지 suspect commit 추적
sentry-cli releases set-commits "$VERSION" --auto
sentry-cli releases finalize "$VERSION"

# 실제 스토어 배포 시점 기록 (채택률 곡선의 기준점)
sentry-cli releases deploys "$VERSION" new -e production