콘텐츠로 이동

Android 애플리케이션 데이터 수집


애플리케이션 데이터를 Guance로 수집한 후 Guance 콘솔에서 사용자 지정 시나리오 구성 및 이상 탐지 이벤트 구성을 수행할 수 있습니다.

데이터 유형

Guance의 실제 사용자 모니터링(RUM)은 여섯 가지 데이터 유형을 포함합니다. 이 중 Android 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_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 수집기 버전 정보
sdk_pkg_info string 수집기 버전 정보 집합으로, SDK 내부 모듈 버전 정보를 포함합니다.

애플리케이션 속성

필드 유형 설명
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
application_uuid string 애플리케이션 고유 식별자입니다.

사용자 & 세션 속성

필드 유형 설명
userid string 미로그인 사용자는 임의 UUID를 userid로 사용하고, 로그인 사용자는 애플리케이션 백엔드에서 생성된 사용자 ID를 사용합니다.
visitor_id string 선택 사항, SDK가 자동 생성하는 익명 방문자 식별자입니다. 기본값은 비활성화되어 있으며, FTRUMConfig.setVisitorIdConfig(...)에 유효한 구성을 전달하면 네이티브 RUM 데이터에 이 필드가 연결됩니다. 프로세스 단위로 영속화되며 기본 유효 기간은 24시간이고, FTSdk.resetVisitorId()를 통해 직접 재설정할 수 있습니다. 자세한 내용은 방문자 식별자 Visitor ID를 참조하세요.
user_name string 선택 사항, 사용자 이름입니다.
user_email string 선택 사항, 사용자 이메일입니다.
session_id string 세션 ID이며, 15분 이상 작업이 없으면 새로운 session_id가 생성됩니다.
session_type string 세션 유형입니다. 참고 값: user & synthetics
user: RUM 기능에서 생성된 데이터,
synthetics: 헤드리스 신서틱 테스트에서 생성된 데이터.
is_signin boolean 등록 사용자인지 여부, 속성 값: T & F.
session_has_replay boolean 현재 세션이 Session Replay 데이터와 연결되어 있는지 여부.

기기 & 해상도 속성

필드 유형 설명
device string 모바일 기기 제조사
model string 모바일 기기 모델
device_uuid string 모바일 기기 고유 ID입니다. ANDROID_ID를 사용하여 생성합니다.
os string 운영 체제 정보
os_version string 운영 체제 버전
os_version_major string 운영 체제 주요 버전
screen_size string 화면 해상도
arch 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 관련 데이터는 서버 측 세션 차원에서 집계된 데이터이며, Android SDK가 네이티브로 직접 보고하는 measurement가 아닙니다.

속성

필드 유형 설명
session_id string 세션 ID
session_type string 세션 유형입니다. 참고 값: user & synthetics
user: RUM 기능에서 생성된 데이터,
synthetics: 헤드리스 신서틱 테스트에서 생성된 데이터.
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 페이지 이름

메트릭

필드 유형 설명
loading_time number(ns) 페이지 로드 시간
time_spent number(ns) 페이지 체류 시간
network_settled_time number(ns) View 시작부터 선택된 초기 Resource 중 가장 늦게 종료된 시점까지의 간격입니다.
기본적으로 해당 View에서 Resource 시작 시간 - View 시작 시간 < 100 ms를 충족하는 모든 요청을 선택하며, 정확히 100 ms인 경우는 포함하지 않습니다. '초기 Resource'는 첫 번째 요청이 아니라 요청 그룹입니다.
interaction_to_next_view_time number(ns) 새 View 시작 시간에서 이전 View의 마지막 유효 상호작용 시간을 뺀 값이며, 결과는 새 View에 기록됩니다.
기본적으로 시간 차이가 0보다 크고 3000 ms보다 작아야 하며, 0 또는 3000 ms인 경우에는 이 필드를 생성하지 않습니다.
is_active boolean 사용자가 아직 활성 상태인지 판단합니다. 참고 값: true & false
session_sample_rate number RUM 세션 샘플링 비율
session_on_error_sample_rate number 오류 세션 샘플링 비율
sampled_for_error_session boolean 현재 세션이 오류 샘플링 세션인지 여부, 참고 값: true & false
sampled_for_error_replay boolean 현재 세션이 오류 Session Replay 샘플링인지 여부, 참고 값: true & false
session_error_timestamp number(ns) 세션에서 오류 샘플링이 트리거된 오류 발생 시간

network_settled_time 및 interaction_to_next_view_time은 네이티브 View에만 적용되며, WebView의 Browser SDK 메트릭 계산은 변경하지 않습니다.

network_settled_time은 첫 화면 렌더링 완료 또는 페이지 상호작용 가능을 의미하지 않습니다. 요청 종료 후에도 데이터 처리와 렌더링이 필요할 수 있으며, 기본 윈도우 밖에서 시작된 요청은 계산에 포함되지 않습니다. 예를 들어 두 초기 요청이 View 시작 후 각각 150 ms와 400 ms에 종료되면, 기록 조건을 충족한 뒤 이 필드는 두 요청 소요 시간의 합이 아닌 400000000입니다.

시간 윈도우를 조정하거나 판단 조건을 사용자 지정하거나 메트릭을 비활성화하려면 View 소요 시간 메트릭 사용자 지정 규칙을 참조하세요.

통계 메트릭

필드 유형 설명
view_error_count number 페이지를 로드할 때마다 발생한 오류 수
view_resource_count number 페이지를 로드할 때마다 요청한 리소스 수
view_long_task_count number 페이지를 로드할 때마다 발생한 긴 작업 수
view_long_task_rate 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 선택 사항, 페이지 메모리 최대 사용량
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 작업 이름

Resource 속성

필드 유형 설명
resource_url string 리소스 URL
resource_id string 리소스 고유 ID
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_host_ip string 리소스 URL 방문 대상 IP
response_connection string 리소스 응답 헤더 Connection 값
response_content_type string 리소스 응답 헤더 Content-Type 값
response_content_encoding string 리소스 응답 헤더 Content-Encoding 값
resource_http_protocol string 리소스 요청에 사용된 HTTP 프로토콜
resource_connection_reuse boolean 리소스 요청의 연결 재사용 여부
span_id string 애플리케이션 성능 모니터링(APM) 트레이스 Span ID
trace_id string APM 트레이스 Trace ID
session_has_replay boolean 현재 리소스가 Session Replay 데이터와 연결되어 있는지 여부

메트릭

필드 유형 설명
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) 리소스 로드 시간
계산 방식: duration(responseEnd-startTime)
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 작업 이름

Error 속성

필드 유형 설명
error_source string 오류 소스, 참고 값: logger | network
error_type string 오류 유형
logger error type: java_crash | native_crash | anr_error | anr_crash
network error type: network_error
error_situation string 오류 발생 시점, 참고 값: startup(시작 시) 및 run(실행 중)

type=network일 때 다음 Network Error 속성이 추가됩니다.

필드 유형 설명
resource_status string 리소스 요청이 반환한 상태 값
resource_status_group string 리소스 요청이 반환한 상태 그룹 값
resource_id string 리소스 고유 ID
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 선택 사항, 현재 휴대폰 배터리 잔량
carrier string 선택 사항, 이동통신 사업자
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 작업 이름

메트릭

필드 유형 설명
duration number(ns) 버벅임 지속 시간
long_task_stack string 버벅임 스택
session_has_replay boolean 현재 긴 작업이 Session Replay 데이터와 연결되어 있는지 여부

Action

View 속성

필드 유형 설명
view_id string 페이지를 방문할 때마다 생성되는 고유 ID
view_referrer string 페이지 소스, 페이지의 상위 항목
view_name string 페이지 이름

Action 속성

필드 유형 설명
action_id string 사용자 페이지 작업 시 생성되는 고유 ID
action_name string 작업 이름
action_type string 작업 유형(콜드/웜 시작, click 클릭 등 작업)
app_launch_type string 콜드 스타트 Action의 시작 유형, 참고 값: foreground(포그라운드 시작) 및 background(백그라운드 시작). ft-sdk 1.7.2 이상 버전에서 지원됩니다.

메트릭

필드 유형 설명
duration number(ns) 페이지 작업 소요 시간
app_pre_application_init_time object 콜드 스타트 시 프로세스 시작부터 Application.onCreate() 이전까지의 초기화 소요 시간, 형식: {duration: number(ns), start: number(ns)}
app_application_init_time object 콜드 스타트 시 Application.onCreate()부터 첫 번째 Activity preOnCreate()까지의 초기화 소요 시간, 형식은 app_pre_application_init_time과 같습니다.
app_first_frame_init_time object 콜드 스타트 시 첫 번째 Activity preOnCreate()부터 첫 프레임 렌더링 완료까지의 소요 시간, 형식은 app_pre_application_init_time과 같습니다.
session_has_replay boolean 현재 작업이 Session Replay 데이터와 연결되어 있는지 여부

통계 메트릭

필드 유형 설명
action_long_task_count number 작업과 연결된 긴 작업 수
action_resource_count number 작업과 연결된 리소스 요청 수
action_error_count number 작업과 연결된 오류 수

문서 평가

이 페이지가 도움이 되었나요?