Firebase Summit에서 발표된 모든 내용을 살펴보고 Firebase로 앱을 빠르게 개발하고 안심하고 앱을 실행하는 방법을 알아보세요. 자세히 알아보기

성능 문제에 대한 알림 설정

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

성능 모니터링 알림을 사용하여 코드 변경 또는 네트워크 요청으로 인해 앱의 성능이 저하되는 경우 프로젝트 구성원에게 알립니다.

이벤트 성능이 설정된 임계값을 초과할 때 알려주는 앱에 대한 알림을 설정하고 사용자 지정할 수 있습니다.

알림을 트리거하는 것은 무엇입니까?

앱의 측정항목이 Firebase 콘솔에서 지정된 백분위수(해당하는 경우)에 대해 정의한 임계값을 초과하면 알림이 트리거됩니다. 앱이 실시간 호환 SDK 버전을 사용하는 경우에만 알림이 트리거됩니다.

앱 시작 시간

앱 시작 시간에 대한 알림을 구성할 때 다음 조건이 모두 참인 경우 알림이 트리거됩니다.

  • Firebase는 지난 1시간 동안 앱의 최신 버전에 대한 _app_start 추적 샘플을 100 개 이상 기록했습니다.
  • _app_start 추적 기간이 지난 1시간 동안 구성된 백분위수에 대해 앱의 정의된 임계값을 초과했습니다.
  • 앱의 최신 버전에서 이전에 동일한 임계값에 대해 발생한 경고가 없습니다.

사용자 지정 코드 추적

사용자 지정 코드 추적 메트릭에 대한 경고를 구성할 때 다음 조건이 모두 참인 경우 경고가 트리거됩니다.

  • Firebase는 지난 1시간 동안 앱의 최신 버전에 대한 맞춤 코드 추적 샘플을 100 개 이상 기록했습니다.
  • 추적 기간이 지난 1시간 동안 구성된 백분위수에 대해 앱의 정의된 임계값을 초과했습니다.
  • (iOS+ 및 Android만 해당) 앱의 최신 버전에서 이전에 동일한 임계값에 대해 발생한 경고가 없습니다.
  • (웹 전용) 지난 3일 동안 동일한 임계값에 대해 이전에 발생한 경고가 없습니다.

네트워크 요청

네트워크 요청 메트릭에 대한 경고를 구성할 때 다음 조건이 모두 참인 경우 경고가 트리거됩니다.

  • Firebase는 지난 1시간 동안 앱의 모든 버전에서 URL 패턴과 일치하는 샘플을 100 개 이상 기록했습니다.
  • 메트릭의 집계된 값이 지난 1시간 동안 정의된 임계값을 초과했습니다.
    • 응답 시간 : 집계된 값이 구성된 백분위수에 대해 설정된 임계값을 초과했습니다.
    • 성공률 : (iOS+/Android만 해당) 집계된 값이 모든 사용자에 대해 설정된 임계값 미만이었습니다.
  • 지난 3일 동안 동일한 임계값에 대해 이전에 발생한 경고가 없습니다.

화면 렌더링

화면 렌더링 메트릭에 대한 경고를 구성할 때 다음 조건이 모두 참인 경우 경고가 트리거됩니다.

  • Firebase는 지난 1시간 동안 앱의 최신 버전에 대한 화면 렌더링의 샘플 샘플을 100 개 이상 기록했습니다.
  • 메트릭의 집계된 값이 지난 1시간 동안 정의된 임계값을 초과했습니다.
    • 정지된 프레임 : 집계된 값이 설정된 임계값을 초과했습니다.
    • 느린 프레임 : 집계된 값이 설정된 임계값을 초과했습니다.
  • 앱의 최신 버전에서 이전에 동일한 임계값에 대해 발생한 경고가 없습니다.

페이지 로드

페이지 로드 메트릭에 대한 경고를 구성할 때 다음 조건이 모두 참인 경우 경고가 트리거됩니다.

  • Firebase는 지난 1시간 동안 앱의 페이지 로드 샘플을 100 개 이상 기록했습니다.
  • 메트릭의 집계된 값이 지난 1시간 동안 구성된 백분위수에 대해 정의된 임계값을 초과했습니다.
    • 첫 번째 입력 지연 : 집계된 값이 설정된 임계값 및 구성된 백분위수를 초과했습니다.
    • 첫 번째 콘텐츠 페인트 : 집계된 값이 설정된 임계값 및 구성된 백분위수를 초과했습니다.
    • 첫 번째 페인트 : 집계된 값이 설정된 임계값 및 구성된 백분위수를 초과했습니다.
  • 지난 3일 동안 동일한 임계값에 대해 이전에 발생한 경고가 없습니다.

알림 구성 , 기본 백분위수 , 특정 유형의 추적 및 측정항목에 대한 알림 설정 모범 사례 에 대해 자세히 알아보세요.

기타 성능 측정항목 또는 Slack , JiraPagerDuty 와의 기본 제공 Firebase 통합에 대한 알림은 Performance Monitoring 알림에 사용할 수 없습니다.

알림 받기

기본 알림 받기

기본적으로 Firebase는 이메일을 통해 Performance Monitoring 알림을 보낼 수 있습니다.

이 기본 메커니즘을 통해 성능 모니터링 알림을 받으려면 firebaseperformance.config.update 권한이 있어야 합니다. 다음 역할에는 기본적으로 이 필수 권한이 ​​포함됩니다.

경고 및 해당 설정은 프로젝트 전체에 적용됩니다. 즉, 기본적으로 모든 프로젝트 멤버(이메일 그룹이 아니며 알림을 수신하는 데 필요한 권한이 있음)는 성능 알림이 트리거될 때 이메일을 받게 됩니다.

자신의 계정에 대한 알림 켜기/끄기

자신의 계정에 대해 다른 프로젝트 구성원에게 영향을 주지 않고 성능 모니터링 알림을 켜거나 끌 수 있습니다. 알림을 받으려면 여전히 필요한 권한이 필요합니다.

성능 모니터링 알림을 켜거나 끄려면 다음 단계를 따르십시오.

  1. Firebase 콘솔의 오른쪽 상단에서 Firebase 알림 으로 이동합니다.
  2. 그런 다음 으로 이동하여 성능 모니터링 알림에 대한 계정 기본 설정 을 지정합니다.

타사 서비스에 대한 고급 알림 설정

Firebase용 Cloud Functions를 사용하여 팀에서 선호하는 알림 채널로 Performance Monitoring 알림을 보낼 수도 있습니다. 예를 들어 느린 앱 시작 시간에 대한 경고 이벤트를 캡처하고 경고 정보를 Discord, Slack 또는 Jira와 같은 타사 서비스에 게시하는 함수를 작성할 수 있습니다.

Firebase용 Cloud Functions를 사용하여 고급 알림 기능을 설정하려면 다음 단계를 따르세요.

  1. 다음 작업을 포함하는 Firebase용 Cloud Functions를 설정 합니다.

    1. Node.js 및 npm을 다운로드합니다.
    2. Firebase CLI를 설치하고 로그인합니다.
    3. Firebase CLI를 사용하여 Firebase용 Cloud Functions를 초기화합니다.
  2. Performance Monitoring에서 경고 이벤트를 캡처하고 이벤트 페이로드를 처리 하는 기능을 작성하고 배포합니다 (예: Discord의 메시지에 경고 정보 게시).

캡처할 수 있는 모든 성능 경보 이벤트에 대해 알아보려면 성능 모니터링 경보 에 대한 참조 문서로 이동하십시오.

유효하지 않은 경고 자동 제거

Performance Monitoring은 데이터가 유효하고 알림이 활성 상태인지 확인하기 위해 알림의 유효성을 검사합니다. 경고는 다음 중 하나에 해당하는 경우 유효한 것으로 간주됩니다.

  • Performance Monitoring이 지난 90일 동안 데이터를 수신한 리소스 ID에 대해 경고가 생성됩니다.
  • 맞춤 URL 패턴에 대해 최근에 알림이 생성되었습니다. 사용자 지정 URL 패턴을 만들고 알림을 설정한 후 90일 동안 해당 패턴에 대한 데이터를 보낼 수 있습니다. 90일 기간 내에 데이터가 전송되지 않으면 Performance Monitoring에서 해당 경고를 제거합니다. 사용자 지정 URL 패턴에 대한 자세한 내용은 고객 URL 패턴 아래 데이터 집계 를 참조하세요.

이러한 조건 중 하나라도 충족되지 않으면 Performance Monitoring에서 경고를 제거합니다.

경고 구성

Performance Monitoring 알림을 구성하려면 firebaseperformance.config.update 권한이 있어야 합니다. Firebase Performance Admin , Firebase Quality Admin , Firebase Admin , 프로젝트 소유자 또는 편집자 역할에는 기본적으로 이 필수 권한이 ​​포함됩니다.

아직 수행하지 않은 경우 앱에 최신 Performance Monitoring SDK를 추가합니다. 자세한 내용은 , Android , AppleFlutter 플랫폼용 시작 가이드를 참조하세요.

등록된 각 앱에서 추적 테이블 또는 대시보드 보고서 카드 를 사용하여 모니터링하려는 각 메트릭에 대한 경고를 구성합니다. 각 앱에는 서로 다른 임계값이 있는(또는 전혀 경고가 없는) 서로 다른 경고 세트가 있을 수 있습니다.

Traces 테이블에서 경고 구성

  1. Firebase 콘솔에서 Performance Monitoring 대시보드 으로 이동한 다음 알림을 구성할 앱을 선택합니다.

  2. 화면 하단의 Traces 테이블까지 아래로 스크롤합니다.

  3. 경고를 설정하려는 추적 유형의 탭을 선택한 후 해당 행을 찾습니다.

  4. 행의 맨 오른쪽에서 더보기 메뉴( )를 열고 알림 설정 을 선택합니다.

  5. 화면의 지침에 따라 앱의 경고 임계값 및 백분위수(해당하는 경우)를 설정하거나 경고를 켜거나 끕니다. 기본 백분위수는 Android 및 iOS의 경우 90위, 웹의 경우 75위입니다. 기본 백분위수에 대한 자세한 내용은 대시보드에서 주요 지표 추적 을 참조하십시오.

대시보드 보고서 카드에서 경고 구성

  1. Firebase 콘솔에서 Performance Monitoring 대시보드 으로 이동한 다음 알림을 구성하려는 앱을 선택합니다.

  2. 보고서 카드 탭에서 알림을 구성할 측정항목 카드를 찾습니다.

  3. 원하는 측정항목 카드에서 더보기 메뉴( )를 열고 알림 설정 을 선택합니다.

  4. 화면의 지침에 따라 앱의 경고 임계값 및 백분위수(해당하는 경우)를 설정하거나 경고를 켜거나 끕니다. 기본 백분위수는 Android 및 iOS의 경우 90위, 웹의 경우 75위입니다. 기본 백분위수에 대한 자세한 내용은 대시보드에서 주요 지표 추적 을 참조하십시오.

성능 경고 설정을 위한 모범 사례

네트워크 요청

Firebase는 다음 중 하나일 수 있는 URL 패턴에 따라 유사한 네트워크 요청의 데이터를 집계합니다.

  • 맞춤 URL 패턴 이라고 하는 사용자 정의 패턴입니다.

  • 자동 URL 패턴 이라고 하는 Firebase 파생 패턴입니다.
    이러한 패턴은 앱의 최신 사용 동작에 따라 시간이 지남에 따라 변경될 수 있습니다.

맞춤 URL 패턴에 대한 알림 설정

구성한 사용자 지정 URL 패턴에 대한 알림을 설정하는 것이 좋습니다. Firebase는 먼저 요청을 맞춤 URL 패턴과 일치시키려고 시도하므로 유사한 요청이 동일한 URL 패턴에 더 일관되게 매핑됩니다. 이렇게 하면 특정 요청 패턴이 앱에 중요한 것으로 이미 식별되었기 때문에 사용자 지정 URL 패턴에 대한 알림이 팀에 더 의미 있고 효과적입니다.

자동 URL 패턴에 대한 알림 설정

자동 URL 패턴에 대한 알림을 설정할 때 자동 URL 패턴이 며칠 동안 안정화되었는지 확인하세요. 자동 URL 패턴은 시간이 지남에 따라 변경될 수 있으며 경보 구성은 새 URL 패턴으로 이어지지 않습니다. 이로 인해 관심 있는 패턴에 대한 알림이 잘못되거나 누락될 수 있습니다. 이 패턴이 안정적인지 확인하기 위해 사용자 정의 URL 패턴 생성을 고려할 수도 있습니다.

웹 페이지 로드

웹 지표 측정을 위한 권장 임계값에 대해 알아보려면 Core Web Vitals 설명서를 참조하십시오.

화면 렌더링

최적의 앱 경험을 보장하려면 사용자 세션에 느리고 고정된 프레임이 없어야 합니다. Performance Monitoring은 1%보다 큰 고정 프레임에 대한 경고를 설정하고 5%를 초과하는 느린 프레임에 대한 경고를 설정하도록 권장합니다. 성능 경고 구성 중에 이러한 값이 기본 설정으로 표시됨을 알 수 있습니다. 과도하게 느리거나 정지된 프레임 및 기타 앱 성능 모범 사례에 대해 자세히 알아보려면 Google Play 지침 을 참조하십시오.