시작하기
Firebase Analytics DebugView 사용 방법
업데이트 2026-09-042 분 분량
짧은 답
기기 하나를 디버그 모드로 두고 DebugView를 열어 앱을 써보세요. 몇 초 안에 이벤트가 뜹니다. 안 뜬다면 문제는 보고서가 아니라 SDK 설정에 있습니다.
Analytics의 다른 화면들은 기다리게 하거나 추측하게 만듭니다. DebugView는 둘 다 요구하지 않습니다. 내가 지정한 기기 하나에서 온 이벤트를, 도착하는 대로, 순서대로 보여주니까요. "우리 앱이 뭐라도 보내고는 있나"에 대한 예/아니오 답이 필요할 때 그 답을 주는 화면입니다.
DebugView는 무엇을 위한 화면인가
DebugView는 보고용이 아니라 개발용 도구입니다. 세 가지를 빠르게 답하기 위해 있습니다. SDK가 보내고 있는가, 내가 의도한 이벤트 이름으로 보내고 있는가, 매개변수가 제대로 붙어 있는가. 사용자 수를 읽는 곳이 아닙니다.
| 화면 | 범위 | 쓰는 목적 |
|---|---|---|
| DebugView | 내가 지정한 기기 하나 | 설정과 이벤트 형태 확인 |
| 실시간 | 전체 사용자, 최근 시간 창 | 지금 활동 중인 사람이 있는지 보기 |
| 일반 보고서 | 전체 사용자, 처리 완료 | 며칠·몇 주 단위 추세 읽기 |
디버그 모드 켜기
기기는 기본적으로 DebugView에 나타나지 않습니다. 디버그 기기로 표시해 주어야 하고, 방법은 빌드하는 플랫폼마다 다릅니다. 각 플랫폼의 최신 방법은 Firebase 문서에 있습니다. 여기서 중요한 건 플래그를 외우는 게 아니라 그 표시가 무엇을 하는지 이해하는 것입니다.
기기 표시하기
플랫폼별 방법에 따라 테스트 기기가 디버그 모드로 보고되도록 설정합니다.
DebugView 열기
Firebase 콘솔의 Analytics 아래에 있습니다. 최근에 확인된 디버그 기기 목록이 나옵니다.
기기 선택
여러 대가 보이면 본인 기기를 고릅니다. 목록이 비어 있다면 현재 디버그 기기로 보고 중인 기기가 없다는 뜻입니다.
의도적으로 앱 사용하기
화면을 옮겨 다니고 확인하려는 이벤트를 실제로 발생시키면서 목록이 채워지는지 봅니다.
팁: 한 번에 하나씩 확인하세요. 화면 다섯 개를 연달아 누르면 읽을 수 없는 목록이 쌓입니다. 동작 하나를 하고 무엇이 도착하는지 보면, 어떤 동작이 어떤 이벤트를 만들었는지 정확히 알 수 있습니다.
보이는 내용 읽기
이벤트는 이름과 매개변수를 달고 도착합니다. 항목이 떴다는 사실 외에 세 가지를 더 확인할 만합니다.
- 이벤트 이름이 의도한 것과 정확히 같은지 — 대소문자를 구분하고, 오타는 조용히 배포됩니다
- 자동 수집 이벤트가 내 이벤트와 함께 보이는지 — SDK가 일부만이 아니라 온전히 붙었다는 신호입니다
- 매개변수에 기대한 값이 들어 있는지 — 개발 중에 남긴 빈 문자열이나 임시값이 아닌지
주의: 디버그 트래픽은 테스트가 실제 숫자를 왜곡하지 않도록 일반 보고와 분리됩니다. 그게 목적이긴 하지만, 동시에 디버그 모드로 켜둔 기기는 정작 읽는 보고서에서 빠진다는 뜻이기도 합니다. 확인이 끝나면 꺼 주세요.
DebugView가 알려주지 못하는 것
이벤트가 기기를 떠나 정상적으로 접수되었다는 것까지는 확인해 줍니다. 그 이벤트가 보고서로 처리된 뒤 어떻게 보일지는 말해주지 않습니다. DebugView는 잘 되는데 하루 뒤 보고서가 비어 있다면, 보통 두 번째 버그가 아니라 처리 지연입니다.
Appnaly와의 관계
Appnaly는 처리가 끝난 Google Analytics 데이터를 읽기 때문에, DebugView는 Appnaly보다 완전히 앞 단계에 있습니다. DebugView가 비어 있으면 그 뒤의 어떤 것도 보여줄 수 없고, Appnaly 안에서 바꿀 수 있는 설정도 없습니다. 반대로 DebugView에 이벤트가 뜬다면 흐름의 시작은 정상이라는 뜻이고, 그래도 비어 있다면 남은 원인은 연결, 권한, 처리 시간 중 하나입니다.
앱이 조용해 보일 때 가장 먼저 확인할 만한 이유가 여기 있습니다. "앱이 안 보내고 있다"와 나머지 모든 가능성을 갈라주는 유일한 화면이기 때문입니다.
Firebase를 처음 설정하시나요? 이 숫자들이 나오기 전에 무엇이 갖춰져야 하는지는 설정 가이드에서 안내합니다.
Firebase Analytics 설정 가이드