Flutter에서 Performance Monitoring 시작하기

이 빠른 시작에서는 Flutter 앱의 성능 특성을 파악하는 데 도움이 되는 Firebase Performance Monitoring을 설정하는 방법을 설명합니다.

시작하기 전에

아직 진행하지 않았으면 Flutter 프로젝트에서 Firebase를 구성 및 초기화합니다.

1단계: 앱에 Performance Monitoring 추가

  1. Flutter 프로젝트의 루트 디렉터리에서 다음 명령어를 실행하여 Performance Monitoring Flutter 플러그인을 설치합니다.

    flutter pub add firebase_performance

  2. Flutter 프로젝트의 루트 디렉터리에서 다음 명령어를 실행합니다.

    flutterfire configure

    이 명령어를 실행하면 Flutter 앱의 Firebase 구성이 최신 상태로 유지되고 Android의 경우 필요한 Performance Monitoring Gradle 플러그인이 앱에 추가됩니다.

  3. 완료되면 Flutter 프로젝트를 다시 빌드합니다.

    flutter run

Performance Monitoring SDK를 추가하면 Firebase에서 앱의 수명 주기와 관련된 데이터(예:앱 시작 시간) 및 HTTP/S 네트워크 요청에 대한 데이터를 자동으로 수집하기 시작합니다.

Flutter에서는 개별 Flutter 화면에 대해 자동 화면 렌더링 성능 모니터링을 사용할 수 없습니다. 단일 뷰 컨트롤러는 전체 Flutter 애플리케이션을 기본적으로 캡슐화하므로 기본 네이티브 Firebase SDK가 화면 전환을 인식하지 못합니다.

2단계: 초기 데이터 표시를 위한 성능 이벤트 생성

앱에 SDK를 성공적으로 추가하면 Firebase에서 이벤트 처리를 시작합니다. 로컬에서 개발 중인 경우에는 앱과 상호작용하여 초기 데이터 수집 및 처리를 위한 이벤트를 생성합니다.

  1. 시뮬레이터 또는 테스트 기기를 사용하여 계속해서 앱을 개발합니다.

  2. 앱을 백그라운드와 포그라운드 간에 여러 번 전환하고, 화면을 탐색하여 앱과 상호작용하거나, 네트워크 요청을 트리거하여 이벤트를 생성합니다.

  3. Firebase Console의 성능 대시보드로 이동합니다. 몇 분 이내에 초기 데이터가 표시됩니다.

    초기 데이터가 표시되지 않으면 문제 해결 팁을 검토하세요.

3단계: (선택사항) 성능 이벤트의 로그 메시지 보기

  1. 로그 메시지에 오류 메시지가 있는지 확인합니다.

    Performance Monitoring은 로그 메시지에 다음 태그를 지정하므로 로그 메시지를 필터링할 수 있도록 합니다.

    • iOS+: Firebase/Performance
    • Android: FirebasePerformance

  2. Performance Monitoring에서 성능 이벤트를 로깅 중임을 나타내는 다음 유형의 로그를 확인합니다.

    • Logging trace metric: TRACE_NAME, FIREBASE_PERFORMANCE_CONSOLE_URL
    • Logging network request trace: URL

  3. URL을 클릭하여 Firebase Console에서 데이터를 확인합니다. 대시보드에서 데이터를 업데이트하는 데 몇 분 정도 걸릴 수 있습니다.

4단계: (선택사항) 특정 코드에 대한 커스텀 모니터링 추가

앱의 특정 코드에 연결된 성능 데이터를 모니터링하려면 커스텀 코드 trace를 계측하면 됩니다.

커스텀 코드 trace를 사용하면 앱이 특정 작업 또는 일련의 작업을 완료하는 데 걸리는 시간을 파악할 수 있습니다. 예를 들면 이미지 모음을 로드하거나 데이터베이스를 쿼리하는 작업이 있습니다. 커스텀 코드 trace의 기본 측정항목은 기간이지만 캐시 적중 및 메모리 경고와 같은 커스텀 측정항목도 추가할 수 있습니다.

코드에서는 Performance Monitoring SDK에서 제공하는 API를 사용하여 커스텀 코드 trace의 시작과 끝을 정의하고 원하는 커스텀 측정항목을 추가합니다.

이러한 기능에 대한 정보와 앱에 기능을 추가하는 방법을 자세히 알아보려면 특정 코드에 대한 모니터링 추가를 참조하세요.

5단계: 앱 배포 후 결과 검토

에뮬레이터와 하나 이상의 테스트 기기를 사용하여 Performance Monitoring을 검증한 후 업데이트된 앱 버전을 사용자에게 배포할 수 있습니다.

Firebase Console의 성능 대시보드에서 성능 데이터를 모니터링할 수 있습니다.

다음 단계