콘텐츠로 이동

실제 사용자 모니터링(RUM) 메트릭 탐지


현재 문서 위치

이 문서는 탐지 규칙 구성 프로세스의 두 번째 단계입니다. 구성을 완료한 후 기본 문서로 돌아가 세 번째 단계: 이벤트 알림을 계속 진행하세요.

워크스페이스 내 RUM 메트릭 데이터를 모니터링하는 데 사용되며, Web, Android, iOS, 미니프로그램(Miniapp), React Native, HarmonyOS 등 다양한 유형의 앱 성능 메트릭에 대해 임계값 범위를 설정할 수 있습니다. 메트릭이 임계값을 초과하면 시스템이 자동으로 알림을 트리거합니다.

프런트엔드 애플리케이션 성능을 모니터링해야 하는 시나리오에 적합합니다. 예를 들어 Web의 도시 차원 JS 오류율을 모니터링하거나, 미니프로그램의 페이지 로드 소요 시간, 모바일 앱의 크래시율 등을 모니터링할 수 있습니다.

탐지 구성

탐지 빈도

탐지 실행 시간 주기를 설정합니다.

  • 사전 설정 옵션: 1분, 5분, 10분, 15분, 30분, 1시간

  • 기본 선택: 5분

  • Crontab 모드: Crontab 모드로 전환을 클릭하여 사용자 지정 주기를 구성할 수 있으며, 초, 분, 시간, 일, 월, 주 등의 주기 기반으로 예약 작업 실행을 구성할 수 있습니다.

탐지 구간

각 탐지 시 조회할 데이터의 시간 범위를 설정합니다(❗️탐지 구간은 탐지 빈도보다 크거나 같아야 하며, 데이터의 실제 보고 주기와 일치해야 누락 탐지나 오탐을 방지할 수 있습니다).

탐지 빈도 탐지 구간(드롭다운 옵션)
30s 1m/5m/15m/30m/1h/3h
1m 1m/5m/15m/30m/1h/3h
5m 5m/15m/30m/1h/3h
15m 15m/30m/1h/3h/6h
30m 30m/1h/3h/6h
1h 1h/3h/6h/12h/24h
6h 6h/12h/24h
12h 12h/24h
24h 24h
  • 사용자 지정 형식: 탐지 구간을 직접 입력합니다. 예: 20m(최근 20분), 2h(최근 2시간), 1d(최근 1일).

탐지 메트릭

탐지할 메트릭 데이터를 설정하며, 현재 워크스페이스 내 단일 앱 유형의 앱 메트릭 데이터를 대상으로 구성할 수 있습니다(❗️카디널리티가 높은 필드를 탐지 차원으로 선택하지 마세요. 구성이 부적절하여 트리거 조건이 너무 느슨하면 빈번한 알림이 발생할 수 있습니다. 현재 쿼리의 최대 반환 수는 10만 건의 레코드입니다).

구성 요소

구성 항목 설명
앱 유형 RUM이 지원하는 앱 유형으로, Web, Android, iOS, Miniapp, HarmonyOS가 포함됩니다
앱 이름 선택한 앱 유형에 따라 해당 앱 목록을 가져오며, 전체 또는 지정 앱을 선택할 수 있습니다
메트릭 앱 유형에 따라 해당 성능 메트릭을 표시합니다. 자세한 내용은 아래 메트릭 설명을 참조하세요
필터 조건 메트릭의 태그를 기준으로 탐지 메트릭 데이터를 필터링하여 탐지 데이터 범위를 제한합니다. 하나 이상의 태그 필터를 추가할 수 있으며, 와일드카드 일치 및 불일치 필터 조건을 지원합니다
탐지 차원 구성 데이터의 문자열 유형(keyword) 필드는 모두 탐지 차원으로 선택할 수 있으며, 현재 탐지 차원은 최대 세 개의 필드를 선택할 수 있습니다. 여러 탐지 차원 필드의 조합으로 특정 탐지 대상을 확인할 수 있으며, 시스템은 특정 탐지 대상에 해당하는 통계 메트릭이 트리거 조건 임계값을 충족하는지 판단하고, 충족하면 이벤트를 생성합니다.

(예: 탐지 차원으로 host와 host_ip를 선택하면 탐지 대상은 {host: host1, host_ip: 127.0.0.1}이 될 수 있습니다.)
추가 정보 추가 필드는 추가 조회에만 사용되며 트리거 조건 판단에는 사용되지 않습니다. 이벤트 알림에 구성할 수 있습니다. 일치하는 값이 여러 개 감지되면 임의로 한 건의 레코드가 반환됩니다

Web / 미니프로그램 메트릭 설명

메트릭 DQL 쿼리 예시
JS 오류 수 R::error:(count(__docid) asJS 错误数) { app_id = '<应用 ID>' }
JS 오류율 Web: eval(A/B, alias='页面 JS 错误率', A="R::view:(count(view_url)) {view_error_count > 0, app_id = '<应用 ID>'}", B="R::view:(count(view_url)) { app_id = '<应用 ID>'}")

미니프로그램: eval(A/B, alias='JS 错误率', A="R::view:(count(view_name)) {view_error_count > 0, app_id = '<应用 ID>' }", B="R::view:(count(view_name)) { app_id = '<应用 ID>' }")
리소스 오류 수 R::resource:(count(resource_url) as资源错误数) {resource_status >=400, app_id = '<应用 ID>'}"
리소스 오류율 eval(A/B, alias='资源错误率', A="R::resource:(count(resource_url)) { resource_status >= '400',app_id = '<应用 ID>' }", B="R::resource:(count(resource_url)) { app_id = '<应用 ID>' }")
최초 렌더링 평균 시간 R::page:(avg(page_fpt)){app_id = '<应用 ID>'}
페이지 로드 평균 소요 시간 R::view:(avg(loading_time)){app_id = '<应用 ID>'}
페이지 느린 로드 횟수 R::resource:(count(resource_load)){app_id = '<应用 ID>',resource_load>8000000000,resource_type='document'}"
리소스 로드 평균 소요 시간 R::resource:(avg(resource_load) as加载耗时) {app_id = '<应用 ID>',resource_type!='document'}"
LCP (largest_contentful_paint) 지원 집계 함수: avg, percentile

R::view:(avg(largest_contentful_paint)){app_id = '<应用 ID>'}
R::view:(percentile(largest_contentful_paint,75)){app_id = '<应用 ID>'}
R::view:(percentile(largest_contentful_paint,90)){app_id = '<应用 ID>'}
R::view:(percentile(largest_contentful_paint,99)){app_id = '<应用 ID>'}
FID (first_input_delay) 지원 집계 함수: avg, percentile

R::view:(avg(first_input_delay)){app_id = '<应用 ID>'}
R::view:(percentile(first_input_delay,75)){app_id = '<应用 ID>'}
R::view:(percentile(first_input_delay,90)){app_id = '<应用 ID>'}
R::view:(percentile(first_input_delay,99)){app_id = '<应用 ID>'}
CLS (cumulative_layout_shift) 지원 집계 함수: avg, percentile

R::view:(avg(cumulative_layout_shift)){app_id = '<应用 ID>'}
R::view:(percentile(cumulative_layout_shift,75)){app_id = '<应用 ID>'}
R::view:(percentile(cumulative_layout_shift,90)){app_id = '<应用 ID>'}
R::view:(percentile(cumulative_layout_shift,99)){app_id = '<应用 ID>'}
FCP (first_contentful_paint) 지원 집계 함수: avg, percentile

R::view:(avg(first_contentful_paint)){app_id = '<应用 ID>'}
R::view:(percentile(first_contentful_paint,75)){app_id = '<应用 ID>'}
R::view:(percentile(first_contentful_paint,90)){app_id = '<应用 ID>'}
R::view:(percentile(first_contentful_paint,99)){app_id = '<应用 ID>'}

Android / iOS 메트릭 설명

메트릭 DQL 쿼리 예시
시작 소요 시간 R::action:(avg(duration)) { app_id = '<应用 ID>' ,action_type='app_cold_launch'}"
총 크래시 수 R::error:(count(error_type)) {app_id='<应用 ID>',error_source = 'logger' and is_web_view !='true'}"
총 크래시율 eval(A.a1/B.b1, alias='总崩溃率',A="R::error:(count(error_type) as a1) {app_id='<应用 ID>',error_source = 'logger',is_web_view !='true'} ",B="R::action:(count(action_name) as b1) { app_id = '<应用 ID>',action_type in [launch_cold,launch_hot,launch_warm]} ")"
리소스 오류 수 R::resource:(count(resource_url) as资源错误数) {resource_status >=400, app_id = '<应用 ID>'}"
리소스 오류율 eval(A/B, alias='资源错误率', A="R::resource:(count(resource_url)) { resource_status >= '400',app_id = '<应用 ID>' }", B="R::resource:(count(resource_url)) { app_id = '<应用 ID>' }")
평균 FPS R::view:(avg(fps_avg)) { app_id = '<应用 ID>' }"
페이지 로드 평균 소요 시간 R::view:(avg(loading_time)) { app_id = '<应用 ID>' }"
리소스 로드 평균 소요 시간 R::resource:(avg(duration)) { app_id = '<应用 ID>' }"
버벅임 횟수 R::long_task:(count(view_id)) { app_id = '<应用 ID>' }"
페이지 오류율 eval(A/B, alias='页面错误率',A="R::view:(count(view_name)) {view_error_count > 0, app_id = '<应用 ID>' }",B="R::view:(count(view_name)) { app_id = '<应用 ID>' }")"

트리거 조건

트리거 조건 및 심각도를 구성합니다. 쿼리 결과가 여러 값일 때 어느 하나의 값이 트리거 조건을 충족하면 이벤트가 생성됩니다.

치명적, 심각, 중요, 경고의 4단계 임계값과 정상 복구 조건을 구성할 수 있습니다.

등급 구성 설명
치명적 Result >= [值]일 때 최고 등급 알림으로, 즉시 처리해야 합니다
심각 Result >= [值]일 때 높은 등급 알림으로, 우선 처리해야 합니다
중요 Result >= [值]일 때 중간 등급 알림으로, 주의가 필요합니다
경고 Result >= [值]일 때 낮은 등급 알림으로, 유의해야 합니다
정상 [N]회 탐지에서 이벤트가 생성되지 않음 탐지 규칙이 적용된 후, 구성한 사용자 지정 탐지 횟수 내에서 데이터 탐지 결과가 이상(치명적, 심각, 중요, 경고)에서 정상으로 복구되면 복구 알림 이벤트가 트리거됩니다.
❗️ 복구 알림 이벤트는 알림 음소거의 제한을 받지 않습니다. 복구 알림 이벤트 탐지 횟수를 설정하지 않으면 알림 이벤트가 복구되지 않으며, 계속 이벤트 > 미복구 이벤트 목록에 나타납니다

자세한 내용은 이벤트 등급 설명을 참조하세요.

고급 옵션

연속 트리거 판단

활성화하면 트리거 조건을 지속적으로 충족할 때만 이벤트가 생성되어 순간적인 변동으로 인한 오탐을 방지합니다(❗️최대 구성 상한은 10회입니다).

대량 알림 보호

시스템에서 기본적으로 활성화됩니다.

단일 탐지에서 생성된 알림 수가 사전 설정 임계값을 초과하면 시스템이 자동으로 상태별 집계 정책으로 전환합니다: 더 이상 알림 대상별로 개별 처리하지 않고, 이벤트 상태에 따라 소량의 요약 알림을 생성하여 푸시합니다.

이렇게 하면 알림의 적시성을 보장하면서 알림 노이즈를 크게 줄이고, 과도한 알림 처리로 인한 타임아웃 위험을 방지할 수 있습니다.

이 스위치가 켜져 있으면 이후 모니터가 이상을 감지하여 생성한 이러한 이벤트 상세에는 이력 및 연관 이벤트가 표시되지 않습니다.

데이터 공백

탐지 메트릭의 탐지 구간 내 쿼리 결과가 비어 있을 때의 처리 정책입니다:

옵션 설명
이벤트 트리거 안 함(기본값) 데이터가 없을 때 이벤트를 트리거하지 않으며, 데이터 누락이 허용되는 시나리오에 적합합니다.
쿼리 결과를 0으로 간주 빈 데이터를 0 값으로 간주하고, 구성된 트리거 조건에 따라 이상 이벤트 생성 여부를 계속 판단합니다.
데이터 공백 이벤트 트리거 동일 대상이 매 회차 공백일 때 데이터 공백 이벤트를 한 번 생성하며, 복구 후 다시 공백이 되면 재생성할 수 있습니다.
데이터 공백 이벤트 지속 트리거 동일 대상이 공백 조건을 지속적으로 충족하면 데이터가 복구될 때까지 탐지 빈도에 따라 공백 이벤트를 생성합니다. 구성 방법은 데이터 공백을 참조하세요.
치명적 이벤트 트리거 데이터가 없을 때 치명적 등급 이벤트를 트리거합니다.
심각 이벤트 트리거 데이터가 없을 때 심각 등급 이벤트를 트리거합니다.
중요 이벤트 트리거 데이터가 없을 때 중요 등급 이벤트를 트리거합니다.
경고 이벤트 트리거 데이터가 없을 때 경고 등급 이벤트를 트리거합니다.
복구 이벤트 트리거 데이터가 없을 때 복구 이벤트를 트리거합니다.

이벤트 트리거 동작을 선택한 후 공백 지속 시간을 입력합니다. ≥ 탐지 구간의 시간 간격으로 설정하는 것이 좋습니다. 공백과 이상 조건이 동시에 충족되면 시스템은 공백 처리 결과를 우선 적용합니다.

트리거 조건, 데이터 공백, 정보 생성을 동시에 구성한 경우 다음 우선순위에 따라 트리거를 판단합니다: 데이터 공백 > 트리거 조건 > 정보 이벤트 생성.

즉, 먼저 공백 여부를 판단하고, 다음으로 임계값 트리거 여부를 판단하며, 마지막으로 정보 이벤트 생성 여부를 판단합니다.

정보 생성

이 옵션을 활성화하면 정보 생성 조건을 구성해야 합니다. 탐지 결과가 '치명적', '심각', '중요', '경고' 중 어느 임계값도 트리거하지 않았고 정보 생성 조건을 충족할 때만 시스템이 '정보' 이벤트를 기록합니다.

정상 상태 변화나 낮은 우선순위의 정보를 기록해야 하는 시나리오에 적합합니다.

후속 구성

위 탐지 구성을 완료한 후 다음을 계속 구성하세요:

  1. 이벤트 알림: 이벤트 제목, 내용, 알림 대상, 데이터 공백 처리 및 연관 인시던트를 정의합니다.

  2. 알림 구성: 알림 정책을 선택하고 알림 대상 및 음소거 주기를 설정합니다.

  3. 연관: 대시보드를 연관시켜 데이터를 빠르게 이동하여 확인할 수 있습니다.

  4. 권한: 작업 권한을 설정하여 이 모니터를 편집/삭제할 수 있는 사용자를 제어합니다.

문서 평가

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