Flutter 애플리케이션 데이터 수집
소개
Flutter 데이터 수집은 Android/iOS 네이티브 프레임워크에 의존합니다. Android/iOS 데이터 수집과 비교하기 위해 아래 취소선 표시 항목은 구현되지 않은 부분입니다.
데이터 유형
Guance의 실제 사용자 모니터링(RUM)에는 여섯 가지 데이터 유형이 포함됩니다.
| 유형 |
설명 |
| session |
사용자 세션 정보 기록입니다. 현재 세션에서는 세션 차원의 사용자 페이지, 리소스, 액션, 오류, 긴 작업 관련 방문 데이터가 생성됩니다. |
| view |
사용자가 모바일 애플리케이션의 페이지를 방문할 때마다 뷰 기록이 생성됩니다. 사용자가 동일한 페이지에 머무르는 동안 리소스, 긴 작업, 오류 및 액션 기록은 view_id 속성을 통해 관련 RUM 뷰에 연결됩니다. |
| resource |
사용자가 페이지를 방문할 때 로드되는 리소스 정보 기록입니다. |
| error |
모바일 애플리케이션에서 발생한 예외 또는 크래시입니다. |
| long_task |
애플리케이션에서 메인 스레드를 지정된 지속 시간 임계값 이상 차단하는 모든 작업에 대해 긴 작업 이벤트가 생성됩니다. |
| action |
모바일 애플리케이션의 사용자 활동(애플리케이션 시작, 클릭, 스와이프, 뒤로 가기 등)을 기록합니다. 각 액션에는 고유한 action_id가 연결됩니다. |
전역 속성
RUM의 시나리오 구성과 이벤트 알림은 모두 아래 전역 속성을 통해 조회할 수 있습니다.
SDK 속성
| 필드 |
유형 |
설명 |
sdk_name |
string |
수집기 이름, 고정 이름:
df_macos_rum_sdk
df_linux_rum_sdk
df_windows_rum_sdk
df_web_rum_sdk
df_miniapp_rum_sdk
df_ios_rum_sdk
df_android_rum_sdk |
sdk_version |
string |
수집기 버전 정보 |
애플리케이션 속성
| 필드 |
유형 |
설명 |
app_id |
string |
필수, RUM 애플리케이션 고유 ID 식별자로, Guance 콘솔에서 모니터를 생성할 때 자동으로 생성됩니다. |
env |
string |
필수, 환경 필드. 속성 값: prod/gray/pre/common/local. 각 값의 의미는 다음과 같습니다: prod: 프로덕션 환경 gray: 카나리 환경 pre: 프리 릴리스 환경 common: 일반 환경 local: 로컬 환경 |
version |
string |
필수, 버전 번호. |
service |
string |
선택 사항, 소속 비즈니스 또는 서비스 이름. 고정 이름:
df_rum_ios
df_rum_android
df_rum_windows
df_rum_linux |
사용자 & 세션 속성
| 필드 |
유형 |
설명 |
userid |
string |
로그인하지 않은 사용자는 임의의 uuid를 userid로 사용하고, 로그인 사용자는 애플리케이션 백엔드에서 생성된 사용자 id를 사용합니다. |
user_name |
string |
선택 사항, 사용자 이름. |
user_email |
string |
선택 사항, 사용자 이메일. |
session_id |
string |
세션 id입니다. 15분 이상 작업이 없으면 새로운 session_id가 생성됩니다. |
session_type |
string |
세션 유형. 참고 값: user & synthetics user: RUM 기능에서 생성된 데이터; synthetics: headless 테스트에서 생성된 데이터. |
is_signin |
boolean |
등록 사용자인지 여부, 속성 값: T & F. |
기기 & 해상도 속성
| 필드 |
유형 |
설명 |
device |
string |
모바일 기기 제조사 |
model |
string |
모바일 기기 모델 |
device_uuid |
string |
모바일 기기 고유 ID, Android:ANDROID_ID, iOS:UIDevice.identifierForVendor를 사용하여 생성 |
os |
string |
운영 체제 정보 |
os_version |
string |
운영 체제 버전 |
os_version_major |
string |
운영 체제 주요 버전 |
screen_size |
string |
화면 해상도 |
지리 & 네트워크 속성
| 필드 |
유형 |
설명 |
ip |
string |
사용자 방문 IP 주소 |
isp |
string |
통신사 |
network_type |
string |
네트워크 연결 유형, 속성 값 참고: wifi & 2g & 3g & 4g & 5g & unknown(알 수 없는 네트워크) & unreachable(네트워크 사용 불가) |
country |
string |
국가 |
country_iso_code |
string |
국가 iso_code |
province |
string |
도 |
city |
string |
도시 |
사용자 정의 속성
전역 속성 외에도 사용자 정의 속성(SDK는 사용자가 사용자 정의 tag 데이터를 추가하는 것을 지원합니다)을 통해 시나리오를 구성하고 이벤트 알림을 설정할 수 있습니다. 사용자 정의 속성은 전역 속성이 아니며, 사용자 정의 속성을 통해 사용자가 애플리케이션을 방문하는 전체 과정을 추적하고, 사용자가 영향을 받은 방문 상황을 식별 및 발견하며, 사용자 방문 성능을 모니터링할 수 있습니다.
기타 데이터 유형 속성
Session
속성
| 필드 |
유형 |
설명 |
session_id |
string |
세션 id |
session_type |
string |
세션 유형. 참고 값: user & test user: RUM 기능에서 생성된 데이터; test: headless 테스트에서 생성된 데이터. |
session_referrer |
string |
세션 소스입니다. 일반적으로 소스가 기록된 페이지 주소입니다. |
session_first_view_id |
string |
현재 세션의 첫 번째 페이지 view_id |
session_first_view_name |
string |
현재 세션의 첫 번째 페이지 URL |
session_last_view_id |
string |
현재 세션의 마지막 방문 페이지 view_id |
session_last_view_name |
string |
현재 세션의 마지막 페이지 URL |
통계 메트릭
| 필드 |
유형 |
설명 |
time_spent |
number(ns) |
현재 세션 지속 시간 |
session_view_count |
number |
현재 세션과 연결된 view_id 수 |
session_error_count |
number |
현재 세션에서 발생한 오류 수 |
session_resource_count |
number |
현재 세션에서 로드된 리소스 수 |
session_action_count |
number |
현재 세션의 사용자 액션 수 |
session_long_task_count |
number |
현재 세션에서 발생한 긴 작업 수 |
View
속성
| 필드 |
유형 |
설명 |
view_id |
string |
페이지를 방문할 때마다 생성되는 고유 ID |
view_referrer |
string |
페이지 소스, 페이지의 상위 |
view_name |
string |
페이지 이름 |
Action 속성
| 필드 |
유형 |
설명 |
action_id |
string |
사용자가 페이지에서 액션을 수행할 때 생성되는 고유 ID |
action_name |
string |
액션 이름 |
action_type |
string |
액션 유형(콜드/웜 시작, click 클릭 등 액션) |
메트릭
| 필드 |
유형 |
설명 |
loading_time |
number(ns) |
페이지 로드 시간입니다. Flutter 페이지는 수동으로 starView()를 호출하기 전에 createView(viewName, duration)를 호출하여 설정할 수 있습니다. SDK 0.5.8부터는 현재 View가 시작된 후 종료되기 전에 updateViewLoadingTime(duration)를 호출하여 업데이트할 수도 있습니다. Flutter 자동 라우팅은 비즈니스 로드 소요 시간을 자동으로 측정하지 않습니다. |
network_settled_time |
number(ns) |
SDK 0.5.8부터 지원됩니다. 초기 네트워크 요청 소요 시간: View 시작부터 선택된 초기 Resource 중 가장 늦은 유효 종료 시점까지의 시간 간격이며, 네이티브 기본 매칭 규칙을 사용합니다. 조건에 맞는 유효한 요청이 없으면 생성되지 않습니다. |
time_spent |
number(ns) |
페이지 체류 시간 |
is_active |
boolean |
사용자가 아직 활성 상태인지 여부, 참고 값: true & false |
통계 메트릭
| 필드 |
유형 |
설명 |
view_error_count |
number |
각 페이지 로드 시 발생한 오류 수 |
view_resource_count |
number |
각 페이지 로드 시 요청된 리소스 수 |
view_long_task_count |
number |
각 페이지 로드 시 생성된 긴 작업 수 |
view_action_count |
number |
페이지 조회 과정에서의 액션 수 |
모니터링 메트릭
| 필드 |
유형 |
설명 |
cpu_tick_count |
number |
선택 사항, 해당 페이지의 CPU 틱 수 |
cpu_tick_count_per_second |
number |
선택 사항, 초당 평균 CPU 틱 수 |
fps_avg |
number |
선택 사항, 페이지의 평균 초당 프레임 수 |
fps_mini |
number |
선택 사항, 페이지의 최소 초당 프레임 수 |
memory_avg |
number |
선택 사항, 페이지 메모리 사용량 평균 |
memory_max |
number |
선택 사항, 페이지 메모리 피크 |
Resource
View 속성
| 필드 |
유형 |
설명 |
view_id |
string |
페이지를 방문할 때마다 생성되는 고유 ID |
view_referrer |
string |
페이지 소스, 페이지의 상위 |
view_name |
string |
페이지 이름 |
Action 속성
| 필드 |
유형 |
설명 |
action_id |
string |
사용자가 페이지에서 액션을 수행할 때 생성되는 고유 ID |
action_name |
string |
액션 이름 |
action_type |
string |
액션 유형(콜드/웜 시작, click 클릭 등 액션) |
Resource 속성
| 필드 |
유형 |
설명 |
resource_url |
string |
리소스 URL |
resource_url_host |
string |
리소스 URL 도메인 부분 |
resource_url_path |
string |
리소스 URL path 부분 |
resource_url_query |
string |
리소스 URL query 부분 |
resource_url_path_group |
string |
리소스 URL path 그룹 |
resource_type |
string |
리소스 카테고리 |
resource_method |
string |
리소스 요청 방식 |
resource_status |
string |
리소스 요청 반환 상태 값 |
resource_status_group |
string |
리소스 요청 반환 상태 그룹 값 |
메트릭
| 필드 |
유형 |
설명 |
resource_size |
number |
리소스 크기, 기본 단위: byte |
resource_dns |
number(ns) |
리소스 로드 DNS 조회 시간 계산 방식: domainLookupEnd - domainLookupStart |
resource_tcp |
number(ns) |
리소스 로드 TCP 연결 시간 계산 방식: connectEnd - connectStart |
resource_ssl |
number(ns) |
리소스 로드 SSL 연결 시간 계산 방식: connectEnd - secureConnectStart |
resource_ttfb |
number(ns) |
리소스 로드 요청 응답 시간 계산 방식: responseStart - requestStart |
resource_trans |
number(ns) |
리소스 로드 콘텐츠 전송 시간 계산 방식: responseEnd - responseStart |
resource_first_byte |
number(ns) |
리소스 로드 첫 패킷 시간 계산 방식: responseStart - domainLookupStart |
duration |
number(ns) |
리소스 로드 시간입니다. startResource() / stopResource()를 통해 전체 소요 시간을 기록합니다. |
request_header |
string |
리소스 요청 헤더 |
response_header |
string |
리소스 응답 헤더 |
Error
View 속성
| 필드 |
유형 |
설명 |
view_id |
string |
페이지를 방문할 때마다 생성되는 고유 ID |
view_referrer |
string |
페이지 소스, 페이지의 상위 |
view_name |
string |
페이지 이름 |
Action 속성
| 필드 |
유형 |
설명 |
action_id |
string |
사용자가 페이지에서 액션을 수행할 때 생성되는 고유 ID |
action_name |
string |
액션 이름 |
action_type |
string |
액션 유형(콜드/웜 시작, click 클릭 등 액션) |
Error 속성
| 필드 |
유형 |
설명 |
error_source |
string |
오류 소스, 참고 값: logger & network |
error_type |
string |
오류 유형 logger error type: flutter_crash | java_crash | native_crash | anr_error | anr_crash | ios_crash network error type:network_error |
error_situation |
string |
오류 발생 시점, 참고 값: startup(시작 시) 및 run(실행 시) |
type=network인 경우 다음 Network Error 속성이 추가됩니다.
| 필드 |
유형 |
설명 |
resource_status |
string |
리소스 요청 반환 상태 값 |
resource_url |
string |
리소스 URL |
resource_url_host |
string |
리소스 URL 도메인 부분 |
resource_url_path |
string |
리소스 URL path 부분 |
resource_url_path_group |
string |
리소스 URL path 그룹 |
resource_method |
string |
리소스 요청 방식 |
Error 모니터링 속성
| 필드 |
유형 |
설명 |
memory_total |
string |
선택 사항, 메모리 총량 |
memory_use |
number |
선택 사항, 메모리 사용률 |
cpu_use |
number |
선택 사항, CPU 사용률 |
battery_use |
number |
선택 사항, 현재 휴대폰의 배터리 잔량 |
locale |
string |
현재 시스템 언어 |
메트릭
| 필드 |
유형 |
설명 |
error_message |
string |
오류 메시지 |
error_stack |
string |
오류 스택 |
Long Task
View 속성
| 필드 |
유형 |
설명 |
view_id |
string |
페이지를 방문할 때마다 생성되는 고유 ID |
view_referrer |
string |
페이지 소스, 페이지의 상위 |
view_name |
string |
페이지 이름 |
Action 속성
| 필드 |
유형 |
설명 |
action_id |
string |
사용자가 페이지에서 액션을 수행할 때 생성되는 고유 ID |
action_name |
string |
액션 이름 |
action_type |
string |
액션 유형(콜드/웜 시작, click 클릭 등 액션) |
메트릭
| 필드 |
유형 |
설명 |
duration |
number(ns) |
버벅임 지속 시간 |
long_task_message |
string |
버벅임 정보 |
long_task_stack |
string |
버벅임 스택 |
Action
View 속성
| 필드 |
유형 |
설명 |
view_id |
string |
페이지를 방문할 때마다 생성되는 고유 ID |
view_referrer |
string |
페이지 소스, 페이지의 상위 |
view_name |
string |
페이지 이름 |
Action 속성
| 필드 |
유형 |
설명 |
action_id |
string |
사용자가 페이지에서 액션을 수행할 때 생성되는 고유 ID |
action_name |
string |
액션 이름 |
action_type |
string |
액션 유형(콜드/웜 시작, click 클릭 등 액션) |
메트릭
| 필드 |
유형 |
설명 |
duration |
number(ns) |
페이지 액션 소요 시간 |
통계 메트릭
| 필드 |
유형 |
설명 |
action_long_task_count |
number |
액션과 연결된 긴 작업 수 |
action_resource_count |
number |
액션과 연결된 리소스 요청 수 |
action_error_count |
number |
액션과 연결된 오류 수 |