HarmonyOS 앱 데이터 수집
앱 데이터가 Guance에 수집된 후에는 Guance 콘솔에서 사용자 정의 시나리오를 구성하고 이상 탐지 이벤트를 설정할 수 있습니다.
데이터 유형
Guance의 실제 사용자 모니터링(RUM)은 여섯 가지 데이터 유형을 포함합니다. 이 중 HarmonyOS SDK는 view, resource, error, long_task, action의 다섯 가지 데이터를 네이티브로 직접 보고하며, session은 세션 차원 기반의 집계 데이터입니다.
| 유형 |
설명 |
| session |
사용자 세션 정보 기록으로, 현재 세션에서 세션 차원 기반의 사용자 페이지, 리소스, 액션, 오류, 긴 작업 관련 방문 데이터가 집계됩니다. |
| view |
사용자가 모바일 앱 페이지를 방문할 때마다 조회 기록이 생성됩니다. 사용자가 동일한 페이지에 머무는 동안 리소스, 긴 작업, 오류 및 액션 기록은 view_id 속성을 통해 관련 RUM 뷰에 연결됩니다. |
| resource |
사용자가 페이지를 방문할 때 로드되는 리소스 정보 기록입니다. |
| error |
모바일 앱에서 발생한 예외 또는 크래시입니다. |
| long_task |
앱에서 메인 스레드를 지정된 지속 시간 임계값보다 오래 차단하는 작업이 있으면 긴 작업 이벤트가 생성됩니다. |
| action |
모바일 앱의 사용자 활동(앱 시작, 클릭, 스와이프, 뒤로 가기 등)을 기록합니다. 각 액션에는 고유한 action_id가 추가됩니다. |
전역 속성
RUM의 시나리오 구성 및 이벤트 알림은 아래 전역 속성을 통해 조회할 수 있습니다.
SDK 속성
| 필드 |
유형 |
설명 |
sdk_name |
string |
수집기 이름, 고정 이름: df_harmonyos_rum_sdk |
sdk_version |
string |
수집기 버전 정보 |
sdk_pkg_info |
string |
수집기 버전 정보 집합으로, SDK 내부 모듈 버전 정보를 포함합니다. |
앱 속성
| 필드 |
유형 |
설명 |
app_id |
string |
필수, 사용자 접속 앱 고유 ID 식별자이며, Guance 콘솔에서 모니터링을 생성할 때 자동으로 생성됩니다. |
env |
string |
필수, 환경 필드. 속성 값: prod/gray/pre/common/local. 이 중: prod: 프로덕션 환경 gray: 그레이 환경 pre: 사전 릴리스 환경 common: 일상 환경 local: 로컬 환경 |
version |
string |
필수, 버전 번호. |
service |
string |
선택 사항, 소속 비즈니스 또는 서비스 이름. 고정 이름: df_rum_harmonyos |
application_uuid |
string |
앱 고유 식별자, 동일한 Build의 앱은 UUID가 동일합니다. |
사용자 & 세션 속성
| 필드 |
유형 |
설명 |
userid |
string |
미로그인 사용자는 임의 UUID를 userid로 사용하고, 로그인 사용자는 앱 백엔드에서 생성한 사용자 ID를 사용합니다. |
user_name |
string |
선택 사항, 사용자 이름. |
user_email |
string |
선택 사항, 사용자 이메일. |
session_id |
string |
세션 ID. 사용자 작업이 15분을 초과하여 없거나 세션이 4시간을 초과하여 지속되면 갱신됩니다. |
session_type |
string |
세션 유형. 참고 값: user & synthetics user: RUM 기능에서 생성된 데이터; synthetics: 헤드리스 신서틱 테스트에서 생성된 데이터. |
is_signin |
boolean |
등록 사용자인지 여부, 속성 값: T & F. |
기기 & 해상도 속성
| 필드 |
유형 |
설명 |
device |
string |
모바일 기기 제조사 |
model |
string |
모바일 기기 모델 |
device_uuid |
string |
모바일 기기 고유 ID |
os |
string |
운영 체제 정보, HarmonyOS로 고정 |
os_version |
string |
운영 체제 버전 |
os_version_major |
string |
운영 체제 주요 버전 |
screen_size |
string |
화면 해상도 |
arch |
string |
시스템 아키텍처(예: aarch64) |
지리 & 네트워크 속성
| 필드 |
유형 |
설명 |
network_type |
string |
네트워크 연결 유형, 속성 값 참고: wifi & 2g & 3g & 4g & 5g & unknown(알 수 없는 네트워크) & unreachable(네트워크 사용 불가) |
사용자 정의 속성
전역 속성 외에도 사용자 정의 속성(SDK는 사용자 정의 태그 데이터 지정을 지원합니다)을 통해 시나리오를 구성하고 이벤트 알림을 설정할 수 있습니다. 사용자 정의 속성은 전역 속성이 아니며, 사용자 정의 속성을 통해 사용자의 앱 이용 전 과정을 추적하고, 사용자에게 영향을 준 방문 상황을 찾아 발견하며, 사용자 방문 성능을 모니터링할 수 있습니다.
기타 데이터 유형 속성
Session
Session 관련 데이터는 서버 측 세션 차원의 집계 데이터이며, HarmonyOS SDK가 네이티브로 직접 보고하는 measurement가 아닙니다.
속성
| 필드 |
유형 |
설명 |
session_id |
string |
세션 ID |
session_type |
string |
세션 유형. 참고 값: user & synthetics user: RUM 기능에서 생성된 데이터; synthetics: 헤드리스 신서틱 테스트에서 생성된 데이터. |
has_replay |
boolean |
현재 세션이 세션 리플레이 데이터와 연결되어 있는지 여부 |
View
속성
| 필드 |
유형 |
설명 |
view_id |
string |
페이지를 방문할 때마다 생성되는 고유 ID |
view_referrer |
string |
페이지 소스, 페이지의 상위 |
view_name |
string |
페이지 이름 |
지표
| 필드 |
유형 |
설명 |
loading_time |
number(ns) |
페이지 로드 시간 |
time_spent |
number(ns) |
페이지 체류 시간 |
is_active |
boolean |
사용자가 아직 활성 상태인지 여부, 참고 값: true & false |
session_has_replay |
boolean |
현재 페이지가 세션 리플레이 데이터와 연결되어 있는지 여부 |
통계 지표
| 필드 |
유형 |
설명 |
view_error_count |
number |
페이지 로드 시 발생한 오류 횟수 |
view_resource_count |
number |
페이지 로드 시 요청한 리소스 수 |
view_long_task_count |
number |
페이지 로드 시 발생한 긴 작업 수 |
view_long_task_rate |
number |
페이지 수명 주기 내 긴 작업 소요 시간 비율, 범위 [0,1] |
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 |
선택 사항, 페이지 메모리 최대값 |
battery_current_avg |
number |
선택 사항, 페이지 배터리 전류 평균값 |
battery_current_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_id |
string |
Resource의 안정적인 고유 ID |
resource_url |
string |
리소스 URL |
resource_url_host |
string |
리소스 URL 도메인 부분 |
resource_url_path |
string |
리소스 URL path 부분 |
resource_url_path_group |
string |
리소스 URL path 그룹 |
resource_type |
string |
리소스 유형 |
resource_method |
string |
리소스 요청 방식 |
resource_status |
string |
리소스 요청 반환 상태 값 |
resource_status_group |
string |
리소스 요청 반환 상태 그룹 값 |
resource_host_ip |
string |
리소스 URL 접속 대상 IP |
trace_id |
string |
분산 추적 ID(분산 추적 활성화 시 선택 사항) |
span_id |
string |
분산 추적 Span ID(분산 추적 활성화 시 선택 사항) |
response_connection |
string |
응답 연결 유형(선택 사항) |
response_content_type |
string |
응답 콘텐츠 유형(선택 사항) |
response_content_encoding |
string |
응답 콘텐츠 인코딩(선택 사항) |
resource_http_protocol |
string |
리소스 요청에 사용된 HTTP 프로토콜(선택 사항) |
resource_connection_reuse |
boolean |
리소스 요청이 연결을 재사용하는지 여부(선택 사항) |
session_has_replay |
boolean |
현재 리소스가 세션 리플레이 데이터와 연결되어 있는지 여부 |
지표
| 필드 |
유형 |
설명 |
resource_size |
number |
리소스 크기, 기본 단위: byte |
resource_dns |
number(ns) |
리소스 로드 DNS 조회 시간 계산 방식: nameLookupTimeMs * 1000000 |
resource_tcp |
number(ns) |
리소스 로드 TCP 연결 시간 계산 방식: ((tlsHandshakeTimeMs ?? connectTimeMs) - nameLookupTimeMs) * 1000000 |
resource_ssl |
number(ns) |
리소스 로드 SSL 연결 시간 계산 방식: (tlsHandshakeTimeMs - connectTimeMs) * 1000000 |
resource_ttfb |
number(ns) |
리소스 로드 요청 응답 시간 계산 방식: (startTransferTimeMs - preTransferTimeMs) * 1000000 |
resource_trans |
number(ns) |
리소스 로드 콘텐츠 전송 시간 계산 방식: (totalTimeMs - tlsHandshakeTimeMs) * 1000000 |
resource_first_byte |
number(ns) |
리소스 로드 첫 바이트 시간 계산 방식: (startTransferTimeMs - preTransferTimeMs) * 1000000 |
duration |
number(ns) |
리소스 로드 시간 계산 방식: totalTimeMs * 1000000 |
resource_request_size |
number |
리소스 요청 크기, 기본 단위: byte |
resource_dns_time |
object |
리소스 DNS 조회 시간, 형식: {duration: number(ns), start: number(ns)} |
resource_connect_time |
object |
리소스 연결 소요 시간, 형식은 resource_dns_time과 동일 |
resource_first_byte_time |
object |
리소스 로드 첫 바이트 시간, 형식은 resource_dns_time과 동일 |
resource_ssl_time |
object |
리소스 SSL 연결 소요 시간, 형식은 resource_dns_time과 동일 |
resource_download_time |
object |
리소스 다운로드 소요 시간, 형식은 resource_dns_time과 동일 |
request_header |
string |
리소스 요청 헤더 |
response_header |
string |
리소스 응답 헤더 |
네트워크 스냅샷 지표
| 필드 |
유형 |
설명 |
network_available |
boolean |
리소스 요청 시작 시 네트워크 사용 가능 여부 |
network_validated |
boolean |
리소스 요청 시작 시 네트워크가 시스템 검증을 통과했는지 여부 |
network_downlink_kbps |
number |
리소스 요청 시작 시 네트워크 다운링크 대역폭, 단위: kbps |
network_uplink_kbps |
number |
리소스 요청 시작 시 네트워크 업링크 대역폭, 단위: kbps |
network_signal_strength |
number |
리소스 요청 시작 시 네트워크 신호 강도, 값의 기준은 네트워크 유형에 따라 달라집니다 |
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 |
오류 유형, 예: js_crash, native_crash, anr_error, anr_crash, network_error, custom |
error_situation |
string |
오류 발생 시 앱 상태, 네이티브 보고 참고 값: run, background, unknown |
session_has_replay |
boolean |
현재 오류가 세션 리플레이 데이터와 연결되어 있는지 여부 |
type=network인 경우 다음 Network Error 속성이 추가됩니다.
| 필드 |
유형 |
설명 |
resource_id |
string |
대응하는 Resource의 안정적인 고유 ID |
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 |
오류 스택 |
foreground_crash_free_duration |
number(ns) |
포그라운드 무크래시 지속 시간 |
background_crash_free_duration |
number(ns) |
백그라운드 무크래시 지속 시간 |
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 |
버벅임 스택 |
session_has_replay |
boolean |
현재 긴 작업이 세션 리플레이 데이터와 연결되어 있는지 여부 |
Action
View 속성
| 필드 |
유형 |
설명 |
view_id |
string |
페이지를 방문할 때마다 생성되는 고유 ID |
view_referrer |
string |
페이지 소스, 페이지의 상위 |
view_name |
string |
페이지 이름 |
Action 속성
| 필드 |
유형 |
설명 |
action_id |
string |
사용자 페이지 액션 시 생성되는 고유 ID |
action_name |
string |
액션 이름 |
action_type |
string |
액션 유형(예: click, launch_cold) |
app_launch_type |
string |
콜드 스타트 액션의 시작 유형, 참고 값: foreground(포그라운드 소스에서 시작), background(백그라운드 소스에서 시작), foreground_and_background(포그라운드 소스에서 시작, 첫 프레임 전에 백그라운드로 진입했다가 포그라운드로 복귀). ft-sdk 0.1.18 이상 버전에서 지원 |
지표
| 필드 |
유형 |
설명 |
duration |
number(ns) |
페이지 액션 소요 시간 |
app_pre_application_init_time |
object |
콜드 스타트 시 프로세스 시작부터 앱 초기화까지의 단계, 형식: {start: number(ns), duration: number(ns)} |
app_application_init_time |
object |
콜드 스타트 시 앱 초기화부터 첫 UIAbility 생성까지의 단계, 형식은 위와 동일 |
app_first_frame_init_time |
object |
콜드 스타트 시 첫 UIAbility 생성부터 첫 렌더링 프레임까지의 단계, 형식은 위와 동일 |
session_has_replay |
boolean |
현재 액션이 세션 리플레이 데이터와 연결되어 있는지 여부 |
통계 지표
| 필드 |
유형 |
설명 |
action_long_task_count |
number |
액션 관련 긴 작업 횟수 |
action_resource_count |
number |
액션 관련 리소스 요청 횟수 |
action_error_count |
number |
액션 관련 오류 횟수 |