성능 모니터링 문제 해결 및 FAQ

성능 이벤트에 대한 로그 메시지를 보는 방법

1. 다음과 같이 앱의 AndroidManifest.xml 파일에 <meta-data> 요소를 추가하여 빌드 시 성능 모니터링에 대한 디버그 로깅을 활성화합니다.

   <application>
       <meta-data
         android:name="firebase_performance_logcat_enabled"
         android:value="true" />
   </application>
   

2. 오류 메시지에 대한 로그 메시지를 확인하십시오.

3. Performance Monitoring은 로그 메시지에 FirebasePerformance 태그를 지정합니다. logcat 필터링을 사용하면 다음 명령을 실행하여 기간 추적 및 HTTP/S 네트워크 요청 로깅을 구체적으로 볼 수 있습니다.

   adb logcat -s FirebasePerformance

4. Performance Monitoring이 성능 이벤트를 기록하고 있음을 나타내는 다음 유형의 로그를 확인하십시오.

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

5. Firebase 콘솔에서 데이터를 보려면 URL을 클릭하세요. 대시보드에서 데이터가 업데이트되는 데 몇 분 정도 걸릴 수 있습니다.

앱이 성능 이벤트를 기록하지 않는 경우 문제 해결 팁 을 검토하십시오.

앱에 SDK를 추가했지만 콘솔에 여전히 SDK를 추가하라는 메시지가 표시됨

Firebase는 앱에서 이벤트 정보(예: 앱 상호작용)를 수신할 때 앱에 Performance Monitoring SDK를 성공적으로 추가했는지 감지할 수 있습니다. 일반적으로 앱을 시작한 후 10분 이내에 Firebase 콘솔의 성능 대시보드 에 'SDK 감지됨' 메시지가 표시됩니다. 그런 다음 30분 이내에 대시보드에 초기 처리된 데이터가 표시됩니다.

최신 버전의 SDK를 앱에 추가한 지 10분이 지났는데도 여전히 변경 사항이 표시되지 않으면 로그 메시지 를 확인하여 Performance Monitoring이 이벤트를 로깅하고 있는지 확인하십시오. 지연된 SDK 감지 메시지 문제를 해결하려면 아래 설명된 대로 적절한 문제 해결 단계를 시도하십시오.

콘솔에 SDK가 감지되었다고 표시되지만 데이터가 표시되지 않음

성능 모니터링은 성능 이벤트 데이터를 성능 대시보드 에 표시하기 전에 처리합니다.

'SDK 감지됨' 메시지가 표시된 후 24시간 이 지났는데도 여전히 데이터가 표시되지 않으면 알려진 중단이 있는지 Firebase 상태 대시보드 를 확인하세요. 서비스 중단이 없으면 Firebase 지원팀에 문의하세요 .

앱이 성능 이벤트를 기록하지 않습니다.

성능 이벤트에 대한 로그 메시지 가 표시되지 않는 경우 다음 문제 해결 단계를 시도해 보세요.

1. 다음과 같이 Performance Monitoring Gradle 플러그인 설정을 확인합니다.

   1. 플러그인을 올바르게 추가 했는지 확인하십시오. 구체적으로 다음을 확인하십시오.

      • 모듈(앱 수준) build.gradle 파일에 플러그인( apply plugin: 'com.google.firebase.firebase-perf' )을 추가했습니다.
      • 플러그인의 클래스 경로 종속성( classpath 'com.google.firebase:perf-plugin:1.4.2' )을 프로젝트 수준 build.gradle 파일에 포함했습니다.

   2. 다음 플래그 중 하나를 통해 플러그인이 비활성화 되지 않았는지 확인하십시오.

      • 모듈(앱 수준) build.gradle 파일에서 instrumentationEnabled
      • firebasePerformanceInstrumentationEnabled 파일에서 gradle.properties

2. AndroidManifest.xml 파일에서 다음 플래그 중 하나를 통해 Performance Monitoring SDK가 비활성화 되지 않았는지 확인합니다.

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

3. 런타임 시 성능 모니터링이 비활성화 되지 않았는지 확인하십시오.

4. 앱에서 사용 중지된 항목을 찾을 수 없으면 Firebase 지원팀에 문의 하세요.

성능 대시보드에 화면 추적 데이터가 없습니다.

화면 렌더링 추적 데이터가 누락된 경우 다음 문제 해결 단계를 시도해 보세요.

1. 최신 버전의 Android SDK(v20.3.1)를 사용하고 있는지 확인하세요. 화면 렌더링 추적은 v15.2.0 이상에서만 사용할 수 있습니다.

2. 화면에 대해 하드웨어 가속 을 수동으로 비활성화하지 않았는지 확인합니다.

3. DexGuard 또는 Jack을 사용하고 있지 않은지 확인하십시오. 성능 모니터링은 이러한 도구 체인과 호환되지 않습니다.

   • DexGuard는 앱 시작, 앱 인 포그라운드 및 앱 인 백그라운드 추적의 자동 수집을 비활성화합니다. 그러나 앱에서 DexGuard를 사용하는 경우 모든 사용자 지정 코드 추적 이 정상적으로 작동해야 합니다.

   • Jack 은 더 이상 사용되지 않으며 일반적으로 앱에서 사용하면 안 됩니다.

성능 대시보드에 사용자 지정 추적 데이터가 없습니다.

자동으로 수집된 추적에 대한 성능 데이터가 표시되지만 사용자 지정 코드 추적에 대한 성능 데이터는 표시되지 않습니까? 다음 문제 해결 단계를 시도해 보십시오.

1. Trace API 를 통해 맞춤 코드 추적을 계측한 경우 추적 설정, 특히 다음을 확인하세요.

   • 사용자 지정 코드 추적 및 사용자 지정 메트릭의 이름은 다음 요구 사항을 충족해야 합니다. 선행 또는 후행 공백, 선행 밑줄( _ ) 문자 및 최대 길이는 32자입니다.
   • 모든 추적을 시작하고 중지해야 합니다. 시작되지 않았거나 중지되지 않았거나 시작되기 전에 중지된 모든 추적은 기록되지 않습니다.

2. @AddTrace 표기법 을 통해 사용자 지정 코드 추적을 계측한 경우 Performance Monitoring Gradle 플러그인 설정을 확인하세요.

   1. 플러그인을 올바르게 추가 했는지 확인하십시오. 구체적으로 다음을 확인하십시오.

      • 모듈(앱 수준) build.gradle 파일에 플러그인( apply plugin: 'com.google.firebase.firebase-perf' )을 추가했습니다.
      • 플러그인의 클래스 경로 종속성( classpath 'com.google.firebase:perf-plugin:1.4.2' )을 프로젝트 수준 build.gradle 파일에 포함했습니다.

   2. 다음 플래그 중 하나를 통해 플러그인이 비활성화 되지 않았는지 확인하십시오.

      • 모듈(앱 수준) build.gradle 파일에서 instrumentationEnabled
      • firebasePerformanceInstrumentationEnabled 파일에서 gradle.properties

3. 로그 메시지 를 확인하여 Performance Monitoring이 예상되는 사용자 지정 코드 추적을 기록하고 있는지 확인하세요.

4. Performance Monitoring에서 이벤트를 로깅하지만 24시간 후에도 데이터가 표시되지 않으면 Firebase 지원팀에 문의하세요 .

성능 대시보드에 네트워크 요청 데이터가 없습니다.

네트워크 요청 데이터가 누락된 경우 다음 문제 해결 단계를 시도하십시오.

1. Android 앱의 경우 Performance Monitoring Gradle 플러그인은 HTTP/S 네트워크 요청의 자동 모니터링 을 제공하는 계측을 활성화합니다. 다음을 확인하십시오.

   1. 플러그인을 올바르게 추가 했는지 확인하십시오. 구체적으로 다음을 확인하십시오.

      • 모듈(앱 수준) build.gradle 파일에 플러그인( apply plugin: 'com.google.firebase.firebase-perf' )을 추가했습니다.
      • 플러그인의 클래스 경로 종속성( classpath 'com.google.firebase:perf-plugin:1.4.2' )을 프로젝트 수준 build.gradle 파일에 포함했습니다.

   2. 다음 플래그 중 하나를 통해 플러그인이 비활성화 되지 않았는지 확인하십시오.

      • 모듈(앱 수준) build.gradle 파일에서 instrumentationEnabled
      • firebasePerformanceInstrumentationEnabled 파일에서 gradle.properties

2. 네트워크 라이브러리 비호환성을 확인하십시오. Performance Monitoring은 OkHttp 3.xx, Java의 URLConnection 및 Apache HttpClient와 같은 네트워킹 라이브러리를 사용하는 네트워크 요청에 대한 지표를 자동으로 수집합니다.

   네트워크 요청에 대한 사용자 지정 모니터링을 추가 할 수 있습니다.

3. 다음 사항에 유의하십시오.

   • 코드의 동작과 코드에서 사용하는 네트워킹 라이브러리에 따라 Performance Monitoring은 완료된 네트워크 요청에 대해서만 보고할 수 있습니다. 이는 열려 있는 HTTP/S 연결이 보고되지 않을 수 있음을 의미합니다.

   • 성능 모니터링은 DexGuard 및 Jack과 호환되지 않습니다.

     • DexGuard는 HTTP/S 네트워크 요청 모니터링을 비활성화합니다.
     • Jack 은 더 이상 사용되지 않으며 일반적으로 앱에서 사용하면 안 됩니다.

   • Performance Monitoring은 잘못된 Content-Type 헤더가 있는 네트워크 요청에 대해 보고하지 않습니다. 그러나 Content-Type 헤더가 없는 네트워크 요청은 여전히 ​​허용됩니다.

네트워크 요청 데이터가 예상대로 집계되지 않음

Performance Monitoring이 URL 패턴에서 네트워크 요청 데이터를 집계하는 방법 에 대해 자세히 알아보세요.

맞춤 URL 패턴 을 사용해 볼 수도 있습니다!

Project 홈의 성능 카드에 있는 주요 문제는 어떻게 되었나요?

설정한 임계값을 초과하면 자동으로 알려주는 최신 경고 도입에 대한 후속 조치로 주요 문제 를 최근 경고 로 대체했습니다. 문제는 이제 더 이상 사용되지 않으며 경고로 대체됩니다.

성능 카드 상단의 앱 선택기는 최근 경고 아래의 경고 항목을 필터링합니다. 선택한 앱에 대한 가장 최근 알림 3개만 표시됩니다.

경고에 대한 자세한 내용은 성능 문제에 대한 경고 설정을 참조하십시오.

콘솔에서 문제에 대한 임계값을 설정하는 기능은 어떻게 되었습니까?

Performance Monitoring은 정의된 임계값을 초과하는 메트릭에 대한 경고 를 지원합니다. 성능 메트릭에 대해 이러한 구성 가능한 임계값과 혼동을 피하기 위해 문제 에 대한 임계값을 구성하는 기능을 제거했습니다.

Firebase 콘솔의 세부정보 및 측정항목 정보는 어떻게 되었나요?

문제 해결 방법을 개선하기 위해 세부 정보 및 지표 페이지를 새로 디자인된 중앙 집중식 사용자 인터페이스(UI)로 교체했습니다. 이 새로운 문제 해결 UI는 세부 정보 및 메트릭이 제공하는 것과 동일한 핵심 기능을 제공합니다. 문제 해결에 대한 자세한 내용 은 특정 추적에 대한 추가 데이터 보기 를 참조하십시오.

샘플 수가 예상과 다른 이유는 무엇입니까?

Performance Monitoring은 앱의 사용자 기기에서 성능 데이터를 수집합니다. 애플리케이션에 사용자가 많거나 앱에서 많은 양의 성능 활동을 생성하는 경우 성능 모니터링은 데이터 수집을 기기의 하위 집합으로 제한하여 처리된 이벤트 수를 줄일 수 있습니다. 이러한 한도는 이벤트 수가 적더라도 측정항목 값이 여전히 사용자의 앱 경험을 나타내도록 충분히 높습니다.

수집하는 데이터의 양을 관리하기 위해 Performance Monitoring은 다음 샘플링 옵션을 사용합니다.

• 온디바이스 속도 제한 : 디바이스에서 갑작스러운 트레이스 버스트를 보내는 것을 방지하기 위해 디바이스에서 보내는 코드 및 네트워크 요청 트레이스의 수를 10분마다 300개의 이벤트로 제한합니다. 이 접근 방식은 대량의 성능 데이터를 보낼 수 있는 루프 계측으로부터 장치를 보호하고 단일 장치가 성능 측정을 왜곡하지 않도록 합니다.

• 동적 샘플링 : Performance Monitoring은 모든 앱 사용자에 대해 앱당 코드 추적에 대해 약 1억 개의 이벤트와 네트워크 요청 추적에 대해 1억 개의 이벤트를 수집합니다. 기기에서 동적 샘플링 속도를 가져와(Firebase 원격 구성 사용) 무작위 기기가 추적을 캡처하고 전송해야 하는지 여부를 결정합니다. 샘플링 대상으로 선택되지 않은 장치는 이벤트를 전송하지 않습니다. 동적 샘플링 속도는 앱별로 다르며 수집된 데이터의 전체 양이 한도 미만으로 유지되도록 조정됩니다.

  사용자 세션은 사용자 장치에서 자세한 추가 데이터를 전송하므로 데이터를 캡처하고 전송하려면 더 많은 리소스가 필요합니다. 사용자 세션의 영향을 최소화하기 위해 Performance Monitoring에서 세션 수를 제한할 수도 있습니다.

• 서버 측 속도 제한 : 앱이 샘플링 제한을 초과하지 않도록 하기 위해 Performance Monitoring은 서버 측 샘플링을 사용하여 기기에서 수신한 일부 이벤트를 삭제할 수 있습니다. 이러한 유형의 제한이 지표의 효율성을 변경하지는 않지만 다음을 포함하여 사소한 패턴 변화를 일으킬 수 있습니다.

  • 추적 수는 코드 조각이 실행된 횟수와 다를 수 있습니다.
  • 코드에서 밀접하게 결합된 트레이스는 각각 샘플 수가 다를 수 있습니다.

콘솔의 문제 탭은 어떻게 되었습니까?

설정한 임계값을 초과하면 자동으로 알려주는 알림 기능으로 문제 탭을 대체했습니다. 더 이상 임계값 상태를 확인하기 위해 Firebase 콘솔을 수동으로 확인할 필요가 없습니다. 경고에 대해 알아보려면 성능 문제에 대한 경고 설정을 참조하십시오.

콘솔의 장치 및 네트워크 탭은 어떻게 되었습니까? 해당 페이지에 있었던 추적을 보려면 어떻게 해야 합니까?

Firebase 콘솔의 Performance Monitoring 섹션을 재설계하여 대시보드 탭에 주요 측정항목과 모든 트레이스를 한 공간에 표시할 수 있습니다. 재설계의 일환으로 장치 및 네트워크 페이지를 제거했습니다.

대시보드 탭 하단에 있는 추적 테이블에는 장치 및 네트워크 탭에 표시되는 것과 동일한 정보가 모두 있지만 특정 지표에 대한 백분율 변경을 기준으로 추적을 정렬하는 기능을 포함하여 몇 가지 기능이 추가되었습니다. 특정 추적에 대한 모든 메트릭과 데이터를 보려면 추적 테이블에서 추적 이름을 클릭하십시오.

추적 테이블의 다음 하위 탭에서 추적을 확인합니다.

• 네트워크 요청 추적(기본 및 사용자 지정 모두) - 네트워크 요청 하위 탭
• 사용자 지정 코드 추적 — 사용자 지정 추적 하위 탭
• 앱 시작, 포그라운드 앱, 백그라운드 앱 추적 - 사용자 정의 추적 하위 탭
• 화면 렌더링 추적 — 화면 렌더링 하위 탭
• 페이지 로드 추적 - 페이지 로드 하위 탭

trace 테이블과 측정항목 및 데이터 보기에 대한 자세한 내용은 콘솔 개요 페이지( iOS+ | Android | Web )를 참조하세요.

느리고 고정된 프레임 수가 예상한 것과 다른 이유는 무엇입니까?

느린 렌더링 프레임 및 정지된 프레임은 60Hz의 가정된 장치 재생 빈도로 계산됩니다. 장치 새로 고침 빈도가 60Hz 미만인 경우 초당 렌더링되는 프레임 수가 적기 때문에 각 프레임의 렌더링 시간이 느려집니다. 렌더링 시간이 느리면 더 많은 프레임이 더 느리게 렌더링되거나 정지되기 때문에 더 느리거나 정지된 프레임이 보고될 수 있습니다. 그러나 장치 재생 빈도가 60Hz보다 높으면 각 프레임의 렌더링 시간이 더 빨라집니다. 이로 인해 보고되는 느리거나 정지된 프레임이 줄어들 수 있습니다. 이것은 Performance Monitoring SDK의 현재 제한 사항입니다.

조각 추적을 볼 수 없는 이유는 무엇입니까?

앱 활동 외에 프래그먼트의 성능을 보려면 앱에서 Performance Monitoring Android SDK 버전 20.1.0 이상을 사용하고 있는지 확인하세요. 자세한 내용은 앱에 성능 모니터링 추가 를 참조하십시오.

프래그먼트 및 활동과 관련된 추적을 어떻게 이해합니까?

각 프래그먼트 및 활동 추적은 애플리케이션에 정의된 클래스 이름을 기반으로 합니다. 각 화면 추적에는 st 접두어와 클래스 이름이 차례로 포함됩니다. Firebase 콘솔에서 접두사가 제거됩니다. 자세한 내용 은 화면 렌더링 성능 데이터에 대해 알아보기(Apple 및 Android 앱) 를 참조하십시오.

다른 추적보다 조각 추적이 적은 이유는 무엇입니까?

성능 모니터링은 장치에서 수집된 모든 이벤트에서 이벤트 샘플링을 수행합니다. 이 접근 방식을 통해 성능 지표를 제공하기 위해 사용자 장치에서 필요한 최소한의 이벤트를 수집할 수 있습니다.

내 응용 프로그램의 렌더링 성능에 문제가 있을 때 어떻게 알림을 받습니까?

Performance Monitoring을 사용하면 관심 있는 메트릭에 대한 알림을 설정할 수 있습니다. 생성된 화면 렌더링 추적의 경우 느리고 정지된 프레임 백분율이 설정한 임계값을 초과할 때 알리도록 경고를 설정할 수 있습니다.

Performance Monitoring Gradle 플러그인을 활성화한 후 빌드 시간이 길어졌습니다. 이것을 어떻게 개선할 수 있습니까?

Android용 Performance Monitoring은 바이트코드 계측을 사용하여 HTTP/S 네트워크 요청 모니터링 과 같은 몇 가지 즉시 사용 가능한 기능을 제공합니다. 컴파일의 일부로 프로세스는 애플리케이션의 네트워크 요청 성능을 측정하는 데 중요한 코드를 계측하기 위해 앱의 모든 클래스(종속성 포함)를 반복해야 합니다.

다음은 빌드 시간 증가에 대한 몇 가지 주요 원인입니다.

• 클래스 또는 파일 수
• 각 클래스의 크기(코드 라인)
• 기계 구성
• 초기 빌드 대 후속 빌드(후속 빌드는 일반적으로 초기 빌드보다 빠름)

빌드 시간을 최적화하려면 코드 모듈화 를 고려하십시오.

성능 모니터링 플러그인 v1.3.3 부터 증분 빌드 처리 및 라이브러리 입력 캐싱을 크게 개선하는 데 집중했습니다. 최신 빌드 시간 개선 사항을 받으려면 최신 버전의 플러그인 (v1.4.2)을 사용해야 합니다 .

긴 빌드 시간을 피하려면 디버그 빌드에 대한 성능 모니터링 플러그인을 로컬에서 비활성화 할 수 있습니다. 그러나 이 접근 방식은 앱의 네트워크 요청에 대한 성능 측정이 누락될 수 있으므로 프로덕션 빌드에는 권장되지 않습니다.

Performance Monitoring Gradle 플러그인과 호환되지 않는 라이브러리로 인해 빌드 오류가 발생하면 어떻게 해야 하나요?

Android용 Performance Monitoring은 바이트코드 계측을 사용하여 HTTP/S 네트워크 요청 모니터링 과 같은 몇 가지 즉시 사용 가능한 기능을 제공합니다. 컴파일의 일부로 프로세스는 애플리케이션의 네트워크 요청 성능을 측정하는 데 중요한 코드를 계측하기 위해 앱의 모든 클래스(종속성 포함)를 반복해야 합니다.

Performance Monitoring 플러그인과 통합한 후 JSR/RET are not supported with computeFrames option 또는 유사한 오류와 같은 빌드 오류가 발생하는 경우 Performance Monitoring Gradle 플러그인과 호환되지 않는 라이브러리에 대한 종속성도 있기 때문일 수 있습니다.

이 문제를 해결하려면 다음 단계에 따라 호환되지 않는 클래스/라이브러리가 계측되지 않도록 제외할 수 있습니다.

1. Performance Monitoring Gradle 플러그인의 최신 버전(최소 v1.4.0 )으로 업데이트합니다.
2. Android Gradle 플러그인 버전을 v7.2.0 이상으로 업데이트하세요.
3. 모듈(앱 수준) build.gradle 파일에 다음 플래그를 추가하여 호환되지 않는 클래스/라이브러리가 계측되지 않도록 제외합니다.

   android {
     // ...
     androidComponents {
       onVariants(selector().all(), {
           instrumentation.excludes.add("example.incompatible.library")
       })
     }
   }
   

   Android Gradle 플러그인 Instrumentation API의 exclude 속성에 대해 자세히 알아보려면 Instrumentation 을 참조하세요.

호환되지 않는 라이브러리로 인해 빌드 오류가 발생하면 Github 문제를 제출 하여 성능 모니터링 플러그인에서 계측되지 않도록 제외할 수 있도록 하십시오.

내 Performance Monitoring 데이터를 BigQuery로 내보내는 데 예상보다 오래 걸립니다. 실시간 아님?

Firebase Performance Monitoring에 BigQuery 통합을 사용하도록 설정한 경우 하루가 끝나고(태평양 표준시 기준) 12~24시간 후에 데이터가 BigQuery로 내보내집니다.

예를 들어 4월 19일의 데이터는 4월 20일 오후 12시에서 자정(모든 날짜와 시간은 태평양 표준시) 사이에 BigQuery에서 사용할 수 있습니다.

What does "near real-time" performance data mean?

Firebase Performance Monitoring processes collected performance data as it comes in, which results in near real-time data display in the Firebase console. Processed data displays in the console within a few minutes of its collection, hence the term "near real-time".

To take advantage of near real-time data processing, make sure your app uses a real-time compatible SDK version .

How do I get near real-time performance data for my app?

To take advantage of near real-time data processing, you only need to make sure that your app uses a Performance Monitoring SDK version that's compatible with real-time data processing.

These are the real-time compatible SDK versions:

• iOS — v7.3.0 or later
• tvOS — v8.9.0 or later
• Android — v19.0.10 or later (or Firebase Android BoM v26.1.0 or later)
• Web — v7.14.0 or later

Note that we always recommend using the latest version of SDK, but any version listed above will enable Performance Monitoring to process your data in near real time.

Which versions of the Performance Monitoring SDK are considered real-time compatible?

These are the SDK versions compatible with real-time data processing:

• iOS — v7.3.0 or later
• tvOS — v8.9.0 or later
• Android — v19.0.10 or later (or Firebase Android BoM v26.1.0 or later)
• Web — v7.14.0 or later

Note that we always recommend using the latest version of SDK, but any version listed above will enable Performance Monitoring to process your data in near real time.

What if I don't update my app to use a real-time compatible SDK version?

If your app doesn't use a real-time compatible SDK version, you will still see all your app's performance data in the Firebase console. However, the display of performance data will be delayed by roughly 36 hours from the time of its collection.

I've updated to a real-time compatible SDK version, but some of my users are still on old versions of my app. Do I continue to see their performance data in the Firebase console?

Yes! Regardless of which SDK version an app instance uses, you'll see performance data from all your users.

However, if you're looking at recent data (less than roughly 36 hours old), then the displayed data is from users of app instances using a real-time compatible SDK version. The non-recent data, though, includes performance data from all versions of your app.