시작하기

Firebase Analytics DebugView 사용 방법

업데이트 2026-09-143 분 분량

짧은 답

기기 하나를 디버그 모드로 두고 DebugView를 열어 앱을 써보세요. 몇 초 안에 이벤트가 뜹니다. 안 뜬다면 문제는 보고서가 아니라 SDK 설정에 있습니다.

Analytics의 다른 화면들은 기다리게 하거나 추측하게 만듭니다. DebugView는 둘 다 요구하지 않습니다. 내가 지정한 기기 하나에서 온 이벤트를, 도착하는 대로, 순서대로 보여주니까요. "우리 앱이 뭐라도 보내고는 있나"에 대한 예/아니오 답이 필요할 때 그 답을 주는 화면입니다.

DebugView는 무엇을 위한 화면인가

DebugView는 보고용이 아니라 개발용 도구입니다. 세 가지를 빠르게 답하기 위해 있습니다. SDK가 보내고 있는가, 내가 의도한 이벤트 이름으로 보내고 있는가, 매개변수가 제대로 붙어 있는가. 사용자 수를 읽는 곳이 아닙니다.

화면범위쓰는 목적
DebugView내가 지정한 기기 하나설정과 이벤트 형태 확인
실시간전체 사용자, 최근 시간 창지금 활동 중인 사람이 있는지 보기
일반 보고서전체 사용자, 처리 완료며칠·몇 주 단위 추세 읽기

디버그 모드 켜기

기기는 기본적으로 DebugView에 나타나지 않습니다. 디버그 기기로 표시해 주어야 하고, 방법은 플랫폼마다 다릅니다. Firebase 문서에 나온 설정은 다음과 같습니다.

플랫폼디버그 모드 켜기끄기
Androidadb shell setprop debug.firebase.analytics.app PACKAGE_NAMEadb shell setprop debug.firebase.analytics.app .none.
iOSXcode 스킴의 실행 인수(Arguments Passed On Launch)에 -FIRDebugEnabled 추가-FIRDebugDisabled로 바꾸기

참고: 디버그 모드는 직접 끄기 전까지 계속 유지됩니다. 앱을 닫는다고 풀리지 않기 때문에, 잊어버린 테스트 폰이 몇 주 동안 디버그 이벤트를 보내는 일이 생깁니다.

  1. 기기 표시하기

    플랫폼에 맞는 설정을 적용해 테스트 기기가 디버그 모드로 보고되도록 합니다.

  2. DebugView 열기

    Firebase 콘솔의 Analytics 아래에 있습니다. 최근에 확인된 디버그 기기 목록이 나옵니다.

  3. 기기 선택

    여러 대가 보이면 본인 기기를 고릅니다. 목록이 비어 있다면 현재 디버그 기기로 보고 중인 기기가 없다는 뜻입니다.

  4. 의도적으로 앱 사용하기

    화면을 옮겨 다니고 확인하려는 이벤트를 실제로 발생시키면서 목록이 채워지는지 봅니다.

팁: 한 번에 하나씩 확인하세요. 화면 다섯 개를 연달아 누르면 읽을 수 없는 목록이 쌓입니다. 동작 하나를 하고 무엇이 도착하는지 보면, 어떤 동작이 어떤 이벤트를 만들었는지 정확히 알 수 있습니다.

보이는 내용 읽기

이벤트는 이름과 매개변수를 달고 도착합니다. 항목이 떴다는 사실 외에 세 가지를 더 확인할 만합니다.

  • 이벤트 이름이 의도한 것과 정확히 같은지 — 대소문자를 구분하고, 오타는 조용히 배포됩니다
  • 자동 수집 이벤트가 내 이벤트와 함께 보이는지 — SDK가 일부만이 아니라 온전히 붙었다는 신호입니다
  • 매개변수에 기대한 값이 들어 있는지 — 개발 중에 남긴 빈 문자열이나 임시값이 아닌지

주의: 디버그 모드 기기의 이벤트가 자동으로 데이터에서 빠지는 것은 아닙니다. Firebase 문서에 따르면 이 이벤트는 기본적으로 일일 BigQuery 내보내기에 포함되며, 보고서에서 테스트 트래픽을 빼려면 Google Analytics에서 개발자 트래픽 데이터 필터를 설정하라고 안내합니다. 확인이 끝나면 디버그 모드를 끄세요.

DebugView가 알려주지 못하는 것

이벤트가 기기를 떠나 정상적으로 접수되었다는 것까지는 확인해 줍니다. 그 이벤트가 보고서로 처리된 뒤 어떻게 보일지는 말해주지 않습니다. DebugView는 잘 되는데 하루 뒤 보고서가 비어 있다면, 보통 두 번째 버그가 아니라 처리 지연입니다.

실제 데이터 중 얼마가 테스트인지도 알려주지 않습니다. 테스트 기기를 어떻게 표시하고 걸러낼지는 따로 정해야 하며, 테스트 사용자와 실제 사용자를 구분하는 글에서 다룹니다.

Appnaly와의 관계

Appnaly는 처리가 끝난 Google Analytics 데이터를 읽기 때문에, DebugView는 Appnaly보다 완전히 앞 단계에 있습니다. DebugView가 비어 있으면 그 뒤의 어떤 것도 보여줄 수 없고, Appnaly 안에서 바꿀 수 있는 설정도 없습니다. 반대로 DebugView에 이벤트가 뜬다면 흐름의 시작은 정상이라는 뜻이고, 그래도 비어 있다면 남은 원인은 연결, 권한, 처리 시간 중 하나입니다.

앱이 조용해 보일 때 가장 먼저 확인할 만한 이유가 여기 있습니다. "앱이 안 보내고 있다"와 나머지 모든 가능성을 갈라주는 유일한 화면이기 때문입니다.

Firebase를 처음 설정하시나요? 이 숫자들이 나오기 전에 무엇이 갖춰져야 하는지는 설정 가이드에서 안내합니다.

Firebase Analytics 설정 가이드

함께 읽을 글