속성을 사용하여 데이터 필터링

Performance Monitoring에서 속성을 사용하면 성능 데이터를 세분화하고 다양한 실제 시나리오에 따른 앱 성능에 집중할 수 있습니다.

성능 대시보드 하단에 있는 trace 테이블에서 trace 이름을 클릭하면 관심이 있는 측정항목을 드릴다운할 수 있습니다. 화면 왼쪽 상단의 필터 버튼을 사용하여 속성별로 데이터를 필터링하세요. 예를 들면 다음과 같습니다.

속성별로 필터링되는 Firebase Performance Monitoring 데이터의 이미지

앱 버전별로 필터링하여 이전 또는 최신 출시 버전에 대한 데이터를 확인합니다.
기기별로 필터링하여 구형 기기가 앱을 처리하는 방법을 알아봅니다.
국가별로 필터링하여 데이터베이스 위치가 특정 리전에 영향을 미치지 않는지 확인합니다.

속성을 기반으로 한 더욱 강력한 분석을 하려면 BigQuery로 성능 데이터를 내보내세요.

기본 속성

Performance Monitoring은 trace 유형에 따라 다양한 기본 속성을 자동으로 수집합니다.

이러한 기본 속성 외에도 커스텀 코드 trace에서 커스텀 속성을 생성하여 앱에 관련된 카테고리별로 데이터를 세분화할 수 있습니다. 예를 들어 게임이라면 게임 레벨별로 데이터를 세분화할 수 있습니다.

Apple 및 Android 앱의 기본 속성

Apple 및 Android 앱의 모든 trace는 기본적으로 다음 속성을 수집합니다.

앱 버전
국가
OS 수준
기기
무선
이동통신사

또한 네트워크 요청 trace는 다음 속성도 수집합니다.

MIME 유형

사용자 데이터 수집

사용자 데이터 수집: Performance Monitoring은 이름, 이메일 주소, 전화번호 등 어떠한 개인 식별 정보(PII)도 자체적으로 수집하지 않습니다. 개발자는 커스텀 코드 trace에서 커스텀 속성을 만들어 Performance Monitoring으로 추가 데이터를 수집할 수 있습니다. 이러한 방식으로 Performance Monitoring을 통해 수집된 데이터에는 Google이 개인을 식별할 수 있는 정보가 포함되지 않아야 합니다.

다음은 개인 식별 정보를 포함하지 않는 로그 메시지의 예시입니다.

trace.putAttribute("experiment", "A");

다음은 개인 식별 정보를 포함하는 예시입니다. 앱에서 이러한 유형의 커스텀 속성을 사용하지 마세요.

trace.putAttribute("email", user.getEmailAddress());

개인 식별 정보를 노출하는 데이터는 사전 통보 없이 삭제될 수 있습니다.

커스텀 속성 만들기

계측된 커스텀 코드 trace로 커스텀 속성을 만들 수 있습니다.

Performance Monitoring Trace API를 사용하여 커스텀 코드 trace에 커스텀 속성을 추가합니다.

커스텀 속성을 사용하려면 앱에 속성을 정의하는 코드를 추가하고 특정 커스텀 코드 trace와 연결합니다. trace 시작 시점과 중지 시점 사이에 언제든지 커스텀 속성을 설정할 수 있습니다.

다음에 유의하세요.

커스텀 속성의 이름은 다음 요구사항을 충족해야 합니다.
- 이름의 앞이나 뒤에 공백이 없고 이름 앞에 밑줄(_) 문자가 없어야 합니다.
- 공백은 사용할 수 없습니다.
- 최대 길이는 32자(영문 기준)입니다.
- 이름에 허용되는 문자는 A-Z, a-z, _입니다.
각 커스텀 코드 trace는 커스텀 속성을 최대 5개까지 기록할 수 있습니다.
Google이 개인을 식별할 수 있는 정보가 커스텀 속성에 포함되지 않도록 하세요.
이 가이드라인에 대해 자세히 알아보기
사용자 데이터 수집: Performance Monitoring은 이름, 이메일 주소, 전화번호 등 어떠한 개인 식별 정보(PII)도 자체적으로 수집하지 않습니다. 개발자는 커스텀 코드 trace에서 커스텀 속성을 만들어 Performance Monitoring으로 추가 데이터를 수집할 수 있습니다. 이러한 방식으로 Performance Monitoring을 통해 수집된 데이터에는 Google이 개인을 식별할 수 있는 정보가 포함되지 않아야 합니다.

다음은 개인 식별 정보를 포함하지 않는 로그 메시지의 예시입니다.
```
trace.putAttribute("experiment", "A");
```
다음은 개인 식별 정보를 포함하는 예시입니다. 앱에서 이러한 유형의 커스텀 속성을 사용하지 마세요.
```
trace.putAttribute("email", user.getEmailAddress());
```
개인 식별 정보를 노출하는 데이터는 사전 통보 없이 삭제될 수 있습니다.

Kotlin+KTX

Firebase.performance.newTrace("test_trace").trace {
    // Update scenario.
    putAttribute("experiment", "A")

    // Reading scenario.
    val experimentValue = getAttribute("experiment")

    // Delete scenario.
    removeAttribute("experiment")

    // Read attributes.
    val traceAttributes = this.attributes
}MainActivity.kt

Java

Trace trace = FirebasePerformance.getInstance().newTrace("test_trace");

// Update scenario.
trace.putAttribute("experiment", "A");

// Reading scenario.
String experimentValue = trace.getAttribute("experiment");

// Delete scenario.
trace.removeAttribute("experiment");

// Read attributes.
Map<String, String> traceAttributes = trace.getAttributes();MainActivity.java