크래시 로그·애널리틱스에서 기기 모델 확인하는 법
앱을 운영하다 보면 크래시 리포트나 애널리틱스에 iPhone15,2,
iPad13,16 같은 식별자가 잔뜩 찍힙니다. 정작 "이게 어떤 기종인가"는
바로 알려 주지 않는 경우가 많습니다. 이 글에서는 대표적인 도구별로 식별자를 어디서 찾고,
어떻게 실제 기종으로 연결하는지 정리합니다.
1. 크래시 리포트에서 찾기
대부분의 크래시 수집 도구는 리포트마다 기기 정보를 함께 기록합니다.
- Apple 크래시 로그(.crash / .ips): 상단 헤더의
Hardware Model필드에 식별자가 그대로 들어 있습니다. - Firebase Crashlytics: 이슈 상세의 "기기" 탭, Device model 항목에서 확인할 수 있습니다.
- Sentry: 이벤트의
device.model태그에 식별자가 저장됩니다(일부 SDK는 기종명을 함께 보강해 주기도 합니다).
2. 애널리틱스에서 찾기
애널리틱스 도구는 기기 모델을 차원(dimension)으로 제공합니다. GA4·Amplitude·Mixpanel 등에서 Device model 또는 그와 비슷한 이름의 항목을 보면 됩니다. 이때 도구에 따라 마케팅 기종명을 보여 주는 곳도 있고, 원시 식별자를 그대로 노출하는 곳도 있습니다. 식별자가 보인다면 이 사이트에서 변환하세요.
3. 코드·기기에서 직접 얻기
직접 식별자를 읽어야 한다면 시스템 정보를 조회합니다. iOS에서는 uname() 또는
sysctlbyname("hw.machine", ...) 호출이 식별자를 돌려줍니다(시뮬레이터에서는
arm64/x86_64 처럼 다른 값이 나올 수 있습니다).
서버 로그를 분석할 때는 User-Agent 만으로는 식별자가 나오지 않으므로, 앱에서 식별자를 명시적으로
수집해 두는 편이 좋습니다.
4. 식별자를 기종명으로 변환하기
식별자를 확보했다면 이 사이트 검색 페이지에 그대로 붙여 넣으면 됩니다. 반대로 "iPhone 14 Pro의 식별자가 뭐였더라?"처럼 기종명에서 식별자를 찾는 것도 같은 검색창에서 양방향으로 됩니다. 한글로 "아이폰 14 프로"라고 입력해도 검색되도록 만들어 두었습니다.
실무 팁
대량의 로그를 다룰 때는 식별자 → 기종명 매핑 테이블을 코드에 내장하거나 빌드 시점에 주입해 두면 리포트를 사람이 읽기 좋은 형태로 자동 변환할 수 있습니다. 이 사이트의 데이터 역시 공개 데이터(clo4 apple_device_identifiers)를 기반으로 빌드 시 생성되므로, 같은 방식으로 여러분의 파이프라인에도 적용할 수 있습니다. 식별자 개념 자체가 낯설다면 애플 기기 식별자란 무엇인가를 먼저 읽어 보세요.
※ 본 가이드의 데이터와 절차는 비공식 참고용이며, 도구의 UI는 버전에 따라 달라질 수 있습니다.