iOS에서 Performance Monitoring 시작하기

시작하기 전에

아직 추가하지 않았다면 iOS 프로젝트에 Firebase를 추가합니다.

1단계: 앱에 Performance Monitoring 추가

  1. 프로젝트용으로 만든 podfile을 열거나 pod init을 실행하여 podfile을 만든 후 대상 섹션 안에 다음 줄을 추가합니다.

    pod 'Firebase/Performance'
  2. podfile 디렉터리에서 다음 명령어를 실행하여 Performance Monitoring SDK를 설치합니다.

    pod install
  3. Xcode를 사용하여 .xcworkspace 파일을 엽니다.

  4. UIApplicationDelegate에서 Firebase 모듈을 가져옵니다.

    Swift

    import Firebase

    Objective-C

    @import Firebase;
  5. 일반적으로 앱의 application:didFinishLaunchingWithOptions: 메서드에서 FirebaseApp 공유 인스턴스를 구성합니다.

    Swift

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  6. 앱을 다시 컴파일합니다.

이제 Firebase는 자동 기간 trace자동 HTTP/S 네트워크 요청을 모니터링합니다.

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

Firebase는 앱에서 이벤트 정보(예: 앱 상호작용)를 수신하면 앱에 SDK가 성공적으로 추가된 것으로 간주합니다. 로컬에서 개발 중인 경우에는 앱과 상호작용하여 SDK 감지는 물론 초기 데이터 수집 및 처리 이벤트를 생성할 수 있습니다.

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

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

  3. Firebase Console의 성능 섹션에서 Firebase가 SDK를 감지했는지 확인합니다.

    'SDK 감지됨' 메시지가 표시되지 않으면 문제해결 팁을 검토하세요.

  4. Performance Monitoring은 성능 이벤트 데이터를 성능 대시보드에 표시하기 전에 먼저 처리합니다. SDK 감지 메시지가 표시된 후 24시간 이내에 초기 데이터가 표시됩니다.

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

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

  1. 다음과 같이 디버그 로깅을 사용 설정합니다.

    1. Xcode(최소 v10.3)에서 Product(제품) > Scheme(스키마) > Edit scheme(스키마 수정)을 선택합니다.
    2. 왼쪽 메뉴에서 Run(실행)을 선택한 다음 Arguments(인수) 탭을 선택합니다.
    3. Arguments Passed on Launch(실행 시 인수 전달) 섹션에 -FIRDebugEnabled를 추가합니다.
  2. 로그 메시지에서 오류 메시지가 있는지 확인합니다.

  3. Performance Monitoring은 로그 메시지에 Firebase/Performance로 태그를 지정하여 로그 메시지를 필터링할 수 있습니다.

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

    • Recording trace: trace-name
    • Recording network trace: url

앱에서 성능 이벤트를 로깅하고 있지 않으면 문제해결 팁을 검토하세요.

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

커스텀 trace를 만들어 앱의 특정 코드에 연결된 성능 데이터를 모니터링할 수 있습니다.

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

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

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

5단계: 앱 배포 후 결과 확인

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

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

알려진 문제

  • Performance Monitoring과 GTMSQLite의 호환성 문제가 있는 것으로 알려져 있습니다. GTMSQLite를 사용하는 앱에서는 Performance Monitoring을 사용하지 않는 것이 좋습니다.
  • FirebaseApp.configure()를 호출한 후 메서드 재구성이 Performance Monitoring SDK를 방해할 수 있습니다.
  • iOS 8.0~8.2 시뮬레이터의 알려진 문제로 인해 Performance Monitoring에서 성능 이벤트를 캡처하지 못합니다. iOS 8.3 시뮬레이터 및 이후 버전에서는 이 문제가 해결되었습니다.
  • NSURLSession의 backgroundSessionConfiguration을 사용하여 설정한 연결은 연결 시간이 예상보다 깁니다. 이러한 연결은 프로세스 외부에서 실행되며 실행 시기가 처리 중인 콜백 이벤트를 반영합니다.

다음 단계