Links
Comment on page

WCrash 사용하기

1. 시작하기

IMQA WCrash는 웹 브라우저 애플리케이션에서 발생하는 문제에 대해 에러 정보를 수집해주고 있습니다. https://imqa.io 에 가입하고 프로젝트를 만든 후 웹 사이트를 모니터링 해보세요.

1.1. IMQA WCrash 소개

다양한 사용자의 웹 브라우저에서 발생하는 문제에 대해 에러 정보를 실시간으로 수집하는 솔루션입니다. IMQA WCrash는 국내의 성능 전문가들이 만든 크래시 리포트 솔루션입니다. 웹 사이트에서 발생하는 문제와 실시간 에러 정보를 IMQA WCrash를 통해 모니터링 해보세요.

1.2. 지원 환경

IMQA는 다음과 같은 환경에서 원활하게 이용하실 수 있으며, 지원하는 브라우저 및 해상도는 다음과 같습니다.

브라우저

IMQA는 SaaS형 서비스를 제공하고 있습니다. 다음과 같은 웹 브라우저 환경에서 원활하게 이용할 수 있습니다.
지원 브라우저
지원 버전
권장 해상도
Google Chrome(권장)
Ver 81.0.4044.92
1920x1080
Mozilla FireFox
Ver 75.0
1920x1080
Internet Explorer
Ver 11.0.180
1920x1080
Safari
Ver 13.1
1920x1080
최적의 성능과 사용자 경험을 위해서 Google Chrome 최신 버전 사용을 권고합니다.

1.3. 로그인

http://imqa.io 홈페이지 상단 메뉴 오른쪽의 [바로 시작하기]를 클릭하면 로그인 페이지가 새 탭으로 표시됩니다.
메일 주소와 비밀번호를 입력 후 [로그인]을 클릭합니다.
비밀번호를 5회 이상 틀릴 경우 계정이 잠깁니다. 다시 계정을 활성화하려면 ‘비밀번호 변경’ 절차를 통해 비밀번호를 초기화합니다.

2. 프로젝트 리스트

프로젝트 리스트에서 새 프로젝트를 등록하여 IMQA에 웹 브라우저 애플리케이션을 연결할 수 있습니다. 팀 기능을 통해 여러 프로젝트를 묶어서 관리하거나, 사용자 권한 설정 등 전반적인 프로젝트의 관리가 가능합니다.

2.1. 개요

IMQA WPM은 웹 브라우저 애플리케이션의 메인 URL을 프로젝트로 등록하여 서비스를 이용할 수 있습니다. 프로젝트 리스트는 다음과 같이 구성됩니다.
❶ 상단 바 ❷ 팀 바 ❸ 프로젝트 리스트 ❹ 리스트 뷰/카드 뷰 ❺ 프로젝트 생성 ❻ 프로젝트 카드

상단 바

❶ 로고 클릭 시 프로젝트 리스트의 메인으로 이동합니다.
❷ 회원 메뉴 로그인 계정의 회원 메뉴가 표시됩니다.
  • IMQA 가이드: IMQA의 가이드 문서를 확인할 수 있습니다. 클릭 시 브라우저 새 탭으로 표시합니다.
  • 사용자 설정: 사용자 이름과 비밀번호를 변경할 수 있습니다. 브라우저 시간대는 IMQA 분석 정보의 표시 기준 시간을 변경할 수 있습니다.
로그인 사용자가 시간대를 자동으로 가져오지 못하는 환경에 있을 경우, IMQA의 시간 정보가 제대로 표현되지 않을 수 있습니다. 브라우저 시간대로 접속한 지역에 맞는 GMT 표준 시간으로 수동 설정할 수 있습니다.
  • 언어 설정: IMQA의 표시 언어를 변경합니다. 한국어와 영어, 일본어로 변경할 수 있습니다.
  • 로그아웃: 계정을 로그아웃합니다.

프로젝트 리스트

❶ 리스트 뷰/카드 뷰 프로젝트 카드의 표시 방식을 변경합니다. 기본은 리스트 뷰로 표시합니다.
  • 리스트 뷰: 프로젝트를 목록형으로 표시합니다. 정렬을 변경하거나 프로젝트 요약 지표를 확인할 수 있습니다.
  • 카드 뷰: 관리하고 있는 프로젝트가 많은 경우 빠르게 프로젝트를 찾을 수 있습니다.
❷ 프로젝트 생성 현재 위치에 프로젝트를 생성합니다.
❸ 설정 *팀에서만 표시 [설정] 아이콘 클릭 시 팀 관리 메뉴를 표시합니다.
❹ 헤더(정렬) *리스트 뷰에서만 표시 기본은 프로젝트 이름 순으로 정렬되며 플랫폼, 패키지 이름 / URL로 정렬할 수 있습니다.

2.2. 팀

❶ 팀 생성 ❷ 팀 탭 ❸ 팀 관리

팀 생성

원하는 팀 이름을 입력한 후 [저장]을 클릭하면 팀이 생성됩니다.

팀 탭

소속된 팀을 전부 확인 할 수 있으며, 팀을 선택 하면 아래와 같이 팀 관련 설정 페이지가 제공됩니다.
팀 이름 수정 뿐 만 아니라 이메일 주소를 입력하여 팀 멤버로 추가할 수 있습니다.
이메일 주소로 추가의 경우 IMQA에 회원가입이 되어있는 사용자만 추가할 수 있습니다.

팀 관리

팀 이름 수정 및 팀 삭제를 하실 수 있습니다. 팀 삭제의 경우에는 팀만 삭제될 뿐, 소속된 프로젝트는 삭제되지 않으니 안심하셔도 됩니다.

2.3. 프로젝트 생성

로그인 후 프로젝트 생성을 통해 IMQA에 웹 브라우저 애플리케이션을 연결할 수 있습니다.
프로젝트 리스트 오른쪽 상단의 [+] 아이콘을 클릭하면 프로젝트를 생성할 수 있는 팝업이 표시됩니다.
  1. 1.
    IMQA WPM 서비스와 팀을 선택하고 프로젝트 이름, 메인 도메인 URL을 입력합니다.
  • 프로토콜: 웹 사이트 메인 URL의 프로토콜을 선택합니다. http 또는 https를 선택할 수 있습니다.
  • 메인 도메인: 프로토콜을 제외한 웹 사이트의 메인 도메인을 입력하세요. (예: imqa.io)
메인 도메인 URL은 프로토콜 및 포트번호, 대소문자를 구분하며 * 문자를 포함할 수 없습니다. 프로젝트 생성 후 변경이 불가능하니 확인 후 입력하세요. URL을 잘못 입력하여 변경하시려면 프로젝트를 삭제하시고 다시 생성해 주세요.
  1. 2.
    정보 작성이 완료되면 [프로젝트 생성]을 클릭합니다.
  2. 3.
    프로젝트 키가 포함된 설치 코드가 발급되었습니다. 설치 코드를 웹 페이지 HTML <head> 태그에 붙여 넣어주세요. IMQA WPM 설치 가이드를 참고하여 원하는 수집 옵션을 설치 코드 아래에 삽입할 수도 있습니다.
설치 코드를 웹 브라우저 애플리케이션에 삽입 후 웹 페이지에 접속하고 프로젝트 리스트 페이지를 새로고침 해주세요.
교차 도메인 설정을 통해 서브 도메인 (예: m.imqa.io) 별도 구성되어 있을 경우나 CORS (교차 출처 리소스 공유) 접근이 필요할 경우 허용할 출처를 지정할 수 있습니다. 교차 도메인 설정에 대한 자세한 내용은 ‘IMQA WPM 사용자 가이드 > 2.4. 프로젝트 관리 > 교차 도메인 설정'을 참고하세요.

프로젝트 카드

생성된 프로젝트 카드에서는 프로젝트 정보와 설치 및 설정에 필요한 요약 정보를 확인하고, 서비스로 이동할 수 있습니다.
❶ 플랫폼 아이콘 플랫폼 정보를 아이콘으로 표시합니다.
❷ 프로젝트 정보 프로젝트 이름, 패키지 이름 / URL을 표시합니다. 클릭 시 ‘서비스 > 대시보드’로 이동합니다.
❸ 서비스 아이콘 MPM, Crash, WPM, WCrash 서비스 정보를 아이콘으로 표시합니다. 클릭 시 ‘서비스 > 대시보드’로 이동합니다.
❹ 프로젝트 관리 […] 아이콘 클릭 시 프로젝트 관리 메뉴를 표시합니다.
❺ 요약 정보 표시/숨김 [∨] 아이콘 클릭 시 요약 정보를 표시합니다. [∧] 아이콘 클릭 시 요약 정보를 닫습니다.
❻ WPM 프로젝트 요약 정보 IMQA WPM 설치 및 설정에 필요한 요약 정보를 표시합니다. 설치 코드를 다시 복사할 수 있으며, 교차 도메인 설정 과정을 확인할 수 있습니다.
요약 정보를 통해 IMQA WPM의 설치부터 서비스 이용까지의 전반적인 과정을 파악할 수 있습니다.

2.4. 프로젝트 관리

[…] 아이콘 클릭 시 프로젝트 관리 메뉴를 표시합니다. 프로젝트 정보 확인 및 수정과 삭제, 교차 도메인과 URL 패턴을 설정할 수 있습니다. 일부 메뉴는 프로젝트 권한 사용자에게만 표시됩니다.
❶ 프로젝트 정보 생성한 프로젝트 정보를 확인할 수 있고, 프로젝트 멤버를 관리할 수 있습니다.
❷ 팀 변경 *프로젝트 매니저 이상 프로젝트가 소속될 팀을 변경할 수 있습니다. 팀 멤버로 소속된 팀으로만 변경 가능합니다.
❸ 교차 도메인 설정 IMQA에서 분석할 메인 도메인 외에 교차 도메인을 설정할 수 있습니다. 서브 도메인 (예: m.imqa.io) 별도 구성되어 있을 경우나 CORS (교차 출처 리소스 공유) 접근이 필요할 경우 허용할 출처를 지정할 수 있습니다.
❹ URL 패턴 설정 웹 사이트 URL의 패턴을 찾고, 원하는 형태로 대체하여 IMQA로 수집할 수 있습니다. URL의 숫자, 식별자 (예: 유입ID, 사용자ID, 검색어 등) 대체나 유사한 페이지를 의미 있는 집계 단위로 묶을 수 있습니다.
❺ 프로젝트 이름 수정 *프로젝트 매니저 이상 프로젝트의 이름을 변경할 수 있습니다.
❻ 프로젝트 삭제 *프로젝트 생성자 이상 프로젝트를 삭제할 수 있습니다.
프로젝트를 삭제할 경우 기존의 데이터가 전부 삭제됩니다. 반드시 삭제 전에 반드시 확인 후 삭제를 진행해주세요.

프로젝트 정보

프로젝트 정보에서 생성한 프로젝트 정보를 확인할 수 있고, 프로젝트 멤버를 관리할 수 있습니다.
❶ 프로젝트 멤버 이메일 주소 프로젝트 멤버 사용자의 이메일 주소를 표시합니다. 프로젝트를 생성한 사용자는 제일 상단에 표시됩니다.
❷ 프로젝트 권한 프로젝트의 권한을 아이콘으로 표시합니다. 프로젝트 보기 및 관리 역할을 표시합니다.
프로젝트 권한
아이콘
프로젝트 보기
멤버 추가 / 제거
멤버 권한 변경
프로젝트 삭제
Owner
O
O
O
O
Manager
O
O
X
X
Member
O
X
X
X
  • 프로젝트 생성자 Owner: 프로젝트를 생성한 사용자 1계정에게 부여되며, 전반적인 프로젝트 관리 권한이 있습니다.
  • 프로젝트 매니저 Manager: 프로젝트의 멤버 추가와 본인을 제외한 하위 권한 사용자의 제거가 가능합니다.
  • 프로젝트 멤버 Member: 프로젝트를 볼 수 있습니다.
❸ 프로젝트 멤버 권한 변경 *프로젝트 생성자 이상 / 멤버 제거 *프로젝트 매니저 이상
  1. 1.
    이메일 주소 옆 [Ⓜ] 아이콘을 클릭하면 프로젝트 매니저로 추가할 수 있습니다.
  2. 2.
    [Ⓜ] 아이콘을 다시 클릭하면 프로젝트 매니저에서 제거합니다.
  3. 3.
    이메일 주소 옆 [-] 아이콘을 클릭하면 해당 사용자를 프로젝트에서 제거합니다.
❹ 프로젝트 멤버 추가 *프로젝트 매니저 이상
  1. 1.
    이메일 주소 밑 [프로젝트 멤버 추가]를 클릭하면 현재 프로젝트 멤버가 아닌 팀 멤버와 ‘이메일 주소' 입력 영역이 표시됩니다.
  2. 2.
    프로젝트 멤버가 아닌 팀 멤버의 이메일 주소 옆 [+] 아이콘을 클릭하여 프로젝트 멤버로 추가합니다.
❺ 이메일 추가 *프로젝트 매니저 이상
이메일 주소를 입력하고 [+] 아이콘을 클릭하여 프로젝트 멤버로 추가합니다.
이메일 추가의 경우 IMQA에 회원가입이 되어있는 사용자만 추가할 수 있습니다.

교차 도메인 설정

IMQA에서 분석할 메인 도메인 외에 교차 도메인을 설정할 수 있습니다. 서브 도메인 (예: m.imqa.io) 별도 구성되어 있을 경우나 CORS (교차 출처 리소스 공유) 접근이 필요할 경우 허용할 출처를 지정할 수 있습니다.
  1. 1.
    기본 프로젝트 생성 시 입력한 메인 도메인 URL이 설정되어 있으며, 웹 사이트 구성에 따라 서브 도메인 또는 교차 출처 리소스 공유 접근을 허용할 출처를 입력합니다.
  • 허용 도메인 설정 예시)
허용 도메인 URL에 접근을 허용할 도메인 목록을 지정합니다. (예: http://localhost:8080)
1줄로 구분하여 입력할 수 있으며, 프로토콜 및 포트번호, 대소문자를 구분하고 * 문자를 포함할 수 없습니다.
  1. 2.
    허용 도메인 목록을 입력하고 [저장]을 클릭합니다.
  2. 3.
    입력한 허용 도메인 목록에서 데이터를 실시간으로 수집하도록 설정되며, IMQA에서 확인할 수 있습니다.
IMQA WebAgent는 기본적으로 사용자의 웹 브라우저 애플리케이션 구성에서 중요한 단위에서만 데이터 수집이 가능하도록 지원하며, 설치 코드 복제에 의한 라이선스 보호 등을 위하여 허용된 도메인에서만 데이터를 수집합니다. 메인 도메인 URL 외 성능 데이터 수집을 원하는 도메인이 있다면 교차 도메인 설정 기능을 통한 허용 도메인 목록 설정이 필요합니다.

URL 패턴 설정

웹 사이트 URL의 패턴을 찾고, 원하는 형태로 대체하여 IMQA로 수집할 수 있습니다. URL의 숫자, 식별자 (예: 유입ID, 사용자ID, 검색어 등) 대체나 유사한 페이지를 의미 있는 집계 단위로 묶을 수 있습니다.
IMQA WPM은 기본적으로 사용자가 접속한 원시 URL 데이터를 수집합니다. 사용자가 웹 사이트 이용시, 여러 식별자, 검색어 등으로 URL이 파편화 될 가능성이 높은 페이지의 경우 URL 패턴 설정을 통해 유의미한 집계/분석 단위 정의를 하시는 것을 권장합니다.
❶ URL 패턴 웹 사이트 URL의 경로 또는 쿼리 파라미터에서 원하는 형태로 대체할 패턴을 입력합니다. 경로와 쿼리 파라미터 단위를 입력할 수 있습니다. 우선순위가 높은 URL 패턴부터 적용되며, 쿼리 파라미터는 ’키=값’ 형태로 입력되어야 합니다.
  1. 1.
    웹 사이트 URL 구성에 따라 경로 또는 쿼리 파라미터에서 묶고 싶은 단위에 변수 {group} 를 포함하여 입력합니다.
  2. 2.
    웹 사이트 URL 구성에 따라 경로 또는 쿼리 파라미터에서 풀고 싶은 단위에 변수 {value} 를 포함하여 입력합니다.
  3. 3.
    URL 패턴을 입력하고 [+] 아이콘을 클릭합니다.
  • URL 패턴 설정 예시 1) “상품 상세 페이지 URL인 ‘products’ 경로 다음의 숫자를 묶어서 하나의 페이지로 집계/분석하고 싶어요. 쿼리 파라미터는 상세하게 구분하지 않아도 돼요.”
  1. 1.
    특정 ‘경로'에 적용할 URL 패턴을 변수 {group} 를 포함하여 입력합니다.
  2. 2.
    설정 시점부터 수집되는 URL을 원하는 형태로 대체하여 IMQA에서 ‘페이지' 단위로 확인할 수 있습니다.
  • URL 패턴 설정 예시 2) “메인 페이지로 유입되는 유형을 구분하고 싶어요. URL 쿼리 파라미터에 붙는 외부 유입ID ‘fbclid’, ‘NaPm’, ‘gclid’는 표시하고, 값은 상세하게 구분하지 않아도 돼요.”
  1. 1.
    특정 ‘경로'와 ‘쿼리 파라미터’에 적용할 URL 패턴을 변수 {group} 를 포함하여 입력합니다.
  2. 2.
    설정 시점부터 수집되는 URL을 원하는 형태로 대체하여 IMQA에서 ‘페이지' 단위로 확인할 수 있습니다.
  • URL 패턴 설정 예시 3) “베스트 상품 목록 페이지에서 카테고리별 유형을 구분하고 싶어요. ‘best’ 경로의 URL 쿼리 파라미터에 붙는 카테고리ID ‘category_id’ 와 값을 구분하고, 나머지 쿼리 파라미터는 상세하게 구분하지 않아도 돼요.”
  1. 1.
    특정 ‘경로'와 ‘쿼리 파라미터’에 적용할 URL 패턴을 변수 {value} 를 포함하여 입력합니다.
  2. 2.
    설정 시점부터 수집되는 URL을 원하는 형태로 대체하여 IMQA에서 ‘페이지' 단위로 확인할 수 있습니다.
❷ 우선순위 URL 패턴을 적용할 순서를 나타냅니다. 우선순위가 높은 URL 패턴부터 적용되며, 순서를 변경할 수 있습니다.
  • 우선순위 설정 예시) “상품 상세 페이지 URL인 ‘products’ 경로 다음의 숫자를 묶는 패턴을 적용 중인데, 메인 ~ 상품 상세 페이지로 이동하는 유형인 내부 유입ID ‘flow’와 외부 유입ID ‘fbclid’로 접속하는 경우를 추가로 구분하고 싶어요.”
  1. 1.
    우선순위가 높은 ‘경로'에 적용되는 URL 패턴이 우선 적용됩니다.
  2. 2.
    특정 ‘경로'와 ‘쿼리 파라미터’에 적용할 URL 패턴의 우선순위를 높게 변경합니다.
  3. 3.
    설정 이후, ‘쿼리 파라미터'에 적용되는 URL 패턴이 우선 적용되어 원하는 형태로 대체됩니다.
❸ URL 패턴 프로젝트에 설정된 전체 URL 패턴을 목록으로 표시합니다.
❹ 우선순위 변경 마우스 드래그로 URL 패턴 적용 순서를 조정할 수 있습니다.
❺ 삭제 추가한 URL 패턴을 삭제합니다. 삭제 시 해당 URL 패턴 항목이 삭제되며, 더 이상 URL 패턴이 적용되지 않습니다.
적용할 URL 패턴과 우선순위 설정이 끝나면 [저장]을 클릭합니다. 설정 시점부터 수집되는 URL을 원하는 형태로 대체하여 IMQA에서 ‘페이지' 단위로 확인할 수 있습니다.

3. 대시보드

IMQA WCrash 대시보드는 웹 애플리케이션에서 발생한 웹 크래시의 상황을 파악할 수 있습니다. 주간 유저 현황과 크래시 발생 수, 상세한 에러 정보를 확인할 수 있으며 브라우저별 에러 발생 현황, 특정 에러 누적 횟수를 확인하기 편리합니다.

3.1. 개요

IMQA WCrash 대시보드는 다음과 같이 구성됩니다.
❶ 상단 바(공통) ❷ 프로젝트 정보 ❸ 주간 요약 정보 ❹ 일간 에러 ❺ 브라우저별 분포 ❻ 에러 테이블

상단 바(공통)

❶ 로고 클릭 시 프로젝트 리스트의 메인으로 이동합니다.
❷ WCrash 메뉴 클릭 시 각 WCrash 메뉴 페이지로 이동합니다.
❸ WPM 아이콘 프로젝트 생성 시 WPM 서비스를 생성했을 경우 표시되며, 클릭 시 동일한 앱의 ‘WPM > 대시보드' 페이지로 이동합니다.
❹ 프로젝트 네비게이션 현재 위치한 프로젝트에서 다른 프로젝트로 이동할 수 있습니다. [홈] 아이콘을 클릭하면 프로젝트 리스트로 이동하며 프로젝트 변경 시 해당 프로젝트의 ‘서비스 > 대시보드’로 이동합니다.
❺ 회원 메뉴 로그인 계정의 회원 메뉴가 표시됩니다.
  • IMQA 가이드: IMQA의 가이드를 확인할 수 있습니다. 클릭 시 브라우저 새 탭으로 표시합니다.
  • 사용자 설정: 사용자 이름과 비밀번호를 변경할 수 있습니다. 브라우저 시간대는 IMQA 분석 정보의 표시 기준 시간을 변경할 수 있습니다.
로그인 사용자가 시간대를 자동으로 가져오지 못하는 환경에 있을 경우, IMQA의 시간 정보가 제대로 표현되지 않을 수 있습니다. 브라우저 시간대로 접속한 지역에 맞는 GMT 표준 시간으로 수동 설정할 수 있습니다.
  • 로그아웃: 계정을 로그아웃합니다.

3.2. 프로젝트 정보

프로젝트 정보를 확인할 수 있습니다.

3.3. 주간 요약 정보

웹 사이트에서 최근 1주일간 발생한 웹 크래시, 이용자 수, 방문 수를 확인할 수 있습니다. 이를 통해 웹 사이트가 정상 동작 중인지 판단할 수 있습니다.
  • 이용자 수 : 최근 1주일 동안의 사용자 수를 카운트합니다. 중복을 제외한 순 사용자를 의미합니다.
  • 방문 수 : 최근 1주일 동안의 웹 사이트 접속 수를 카운트합니다. 이용자가 웹 사이트에 접속하여 시작한 세션의 수를 의미합니다.
  • 웹 크래시 : 최근 1주일 동안의 웹 에러 로그 발생 수를 카운트합니다.
성능 지표
산출 구간
산출 값
병합 방식
이용자 수
최근 1주일
사용자 수
카운트
방문 수
최근 1주일
세션 수
카운트
웹 크래시
최근 1주일
웹 에러 로그 발생 수
카운트
빠른 파악을 위해 1,000단위를 ‘1K’로 요약 표시하며, 실제 데이터는 ‘K’로 요약 표시된 숫자에 마우스 포인터를 올리면 표시되는 툴팁으로 확인할 수 있습니다.

3.4. 일간 에러

웹 사이트에서 최근 1주일간 일별 에러 발생 수를 기록하여 특정 날짜의 에러 발생 추이와 발생 수를 확인할 수 있습니다.
  • 웹 크래시 발생 수 : 최근 1주일 동안의 일별 웹 에러 로그 발생 수를 카운트합니다.
특정 날짜에 에러 발생 수가 급격하게 증가했다면, 해당 날짜 전/후로 변동 요인이 있었는지 확인해보세요.

3.5. 브라우저별 비율

웹 사이트에서 최근 1주일간 에러 발생 비율 상위 6개 브라우저와 에러 수를 확인할 수 있습니다. 이를 통해 어떤 브라우저에서 에러가 많이 발생했는지를 빠르게 파악할 수 있습니다.
  • 브라우저: 에러가 발생한 브라우저 명을 표시합니다.
  • 에러 수: 브라우저별 에러 발생 수를 카운트합니다.
브라우저는 웹 사이트에 접속했을 때 사용자의 User-Agent 정보를 기반으로 표시합니다. ‘Chrome’ ‘Safari’ ‘Microsoft Edge’ ‘Firefox’ ‘Samsung Browser’ 등으로 구분됩니다. 특정되지 않은 브라우저의 경우, ‘Unknown’으로 표시될 수 있습니다.

3.6. 에러 테이블

웹 사이트에서 최근 1주일간 발생한 에러를 확인할 수 있습니다. 현재 상태, 누적 발생 수, 에러 명, 마지막 발생 일시를 표시합니다. 이를 통해 발생한 에러를 빠르게 파악할 수 있으며, ‘에러별 상세 페이지’로 이동할 수 있습니다.
❶ 헤더(정렬) 기본은 최근 발생한 에러 순으로 정렬되며 상태, 누적 횟수, 발생일시로 정렬할 수 있습니다.
❷ 에러 웹 사이트에서 최근 1주일간 발생한 에러를 표시합니다. [항목]클릭 시 ‘에러 상세’ 페이지로 이동합니다.
  • 상태: ‘신규’, ‘처리’, ‘완료’, ‘마감’으로 표시되며 ‘에러 상세’ 페이지에서 변경할 수 있습니다.
  • 누적: 해당 에러의 발생 누적 횟수를 카운트합니다.
  • 에러 명: 에러 타입, 사용자 정의 에러 메시지, 코드 라인 번호를 표시합니다. 목록 상단 에러 3개를 빨간색으로 표시합니다.
  • 발생일시: 해당 에러의 마지막 발생 일시를 표시합니다.
상세한 웹 에러 분석을 위해 원하는 에러 메시지를 지정하여 사용자 정의 에러를 수집할 수 있습니다. 사용자 정의 에러 메시지 지정에 대한 자세한 내용은 ‘IMQA WPM/WCrash 설치 가이드 > 2.5. [WCrash] Custom Web Crash 발생' > 사용자 정의 에러 메시지 지정'을 참고하세요.

4. 에러 상세

IMQA WCrash 에러 상세는 특정 에러가 어떤 페이지 URL에서 얼마나 발생했고, 어떤 사용자 환경에서 주로 발생했는지 분석할 수 있습니다. 호출 스택과 에러 발생 위치 등을 확인하고 관리자는 해당 에러에 태그를 달거나 처리 과정을 기록, 확인할 수 있습니다.

4.1. 개요

‘대시보드'와 ‘에러 검색'에서 특정 에러를 클릭하면 이동할 수 있으며, IMQA WCrash 에러 상세는 다음과 같이 구성됩니다.
❶ 에러 정보 ❷ 에러 발생 현황 ❸ 사용자 정보 ❹ 태그 ❺ 호출 스택

4.2. 에러 정보

에러 정보와 누적 횟수를 확인하고 관리자가 처리 과정을 기록, 확인할 수 있습니다.
❶ 에러 정보 에러 타입, 사용자 정의 에러 메시지, 페이지, 코드 라인 번호를 표시합니다.
  • 에러 인스턴스: 해당 에러의 캐치된 에러 인스턴스명을 표시합니다.
에러 타입
설명
Error
사용자가 설정한 에러 타입입니다.
EvalError
eval()에서 발생하는 오류입니다.
RangeError
변수의 유효한 범위를 벗어났을 경우 생성되는 오류입니다.
ReferenceError
잘못된 참조를 했을 경우 생성되는 오류입니다.
SyntaxError
잘못된 구문이 존재하는 경우 오류입니다.
TypeError
유효한 자료형이 아닐 경우 해당 타입의 오류입니다.
URIError
encodeURI()decodeURI() 함수에 부적절한 매개변수를 넘겨준 경우 생성되는 오류입니다.
AggregateError
여러 오류를 하나의 오류로 감싸는 오류 형태입니다.
  • 사용자 정의 에러 메시지: 특정 에러 타입 에러가 생성될 때 사용자가 지정한 메시지를 표시합니다.
  • 페이지: 해당 에러가 발생한 페이지 URL을 표시합니다.
  • 코드 라인 번호: 해당 에러의 라인 넘버를 확인 할 수 있습니다.
상세한 웹 에러 분석을 위해 원하는 에러 메시지를 지정하여 사용자 정의 에러를 수집할 수 있습니다. 사용자 정의 에러 메시지 지정에 대한 자세한 내용은 ‘IMQA WPM/WCrash 설치 가이드 > 2.5. [WCrash] Custom Web Crash 발생 > 사용자 정의 에러 메시지 지정'을 참고하세요.
❷ 상태 담당자 확인 후 에러의 처리 상태를 변경할 수 있습니다. 클릭 시 상태를 변경할 수 있는 옵션을 표시합니다. 상태 변경 기준은 별도로 정해져 있지는 않으며 관리자 판단 후 아래와 같이 설정할 수 있습니다.
  • 신규: 새롭게 발생된 에러일 경우
  • 처리: 담당자 원인 파악 후 처리 중일 경우
  • 완료: 담당자 처리 업무가 완료되었을 경우
  • 마감: 관리자 확인 후 해당 에러 처리 업무를 완료시킬 경우
상태 변경을 진행한 에러는 동일한 에러가 발생한 경우에도 상태가 유지됩니다.
❸ 누적 해당 에러의 발생 총 누적 횟수를 표시합니다.

4.3. 일별 에러 발생 수

최근 1주일간 해당 에러의 일별 에러 발생 수를 기록하여 특정 날짜의 에러 발생 추이와 발생 수를 확인할 수 있습니다.
  • 에러 발생 수: 최근 1주일 동안의 일별 에러 발생 수를 카운트합니다.
Y축은 에러 발생 수를 의미합니다. 해당 에러 처리 후에도 재발생했는지 파악하기 용이합니다. 또한 특정 날짜에 에러 발생 수가 급격하게 증가했다면, 해당 날짜 전/후로 변동 요인이 있었는지 확인해보세요.

4.4. 사용자 정보

최근 1주일간 해당 에러가 어떤 사용자 환경에서 많이 발생했는지를 표시합니다.
  • 디바이스: 해당 에러가 발생한 사용자의 디바이스 환경을 표시합니다. 사용자 접속 OS에 따라 ‘Desktop’과 ‘Mobile’로 분류하여 표시됩니다.
  • OS: 해당 에러가 발생한 사용자의 OS를 표시합니다.
  • 브라우저/버전: 해당 에러가 발생한 사용자의 브라우저와 버전을 표시합니다.
사용자 정보는 웹 사이트에 접속했을 때 사용자의 User-Agent 정보를 기반으로 표시합니다. IMQA WPM은 사용자들이 주로 사용하는 OS와 브라우저로 크게 구분하고 있습니다. OS의 경우, ‘Windows’ ‘macOS’ ‘Android’ ‘iOS’ ‘Linux’ 등으로 구분됩니다.
브라우저의 경우, ‘Chrome’ ‘Safari’ ‘Microsoft Edge’ ‘Firefox’ ‘Samsung Browser’ 등으로 구분됩니다. 특정되지 않은 OS나 브라우저의 경우, ‘Unknown’으로 표시될 수 있습니다.

4.5. 태그

해당 에러에 대한 추가 정보를 자유롭게 태그로 관리할 수 있습니다.
  1. 1.
    태그에 원하는 태그 이름을 입력하고 [+] 아이콘을 클릭합니다. 최대 15자까지 입력할 수 있습니다.
  2. 2.
    아래 빈 영역에 등록한 태그가 표시됩니다. [X] 아이콘을 클릭해서 삭제할 수 있습니다.
등록한 태그는 ‘에러 검색' 페이지에서 검색어로 활용할 수 있습니다. 타겟 사용자 환경으로 태그를 관리하거나 발생 상황, 키워드 기록 등으로 활용해보세요. 하나의 에러에는 같은 이름의 태그를 등록할 수 없습니다.

4.6. 호출 스택

에러 발생 스택 정보를 확인할 수 있습니다. 이를 통해 에러의 원인과 발생 위치를 확인할 수 있습니다. 스택에 관련된 정보를 파일 형태로 다운로드하여 구성원과 공유할 수 있습니다.
❶ 에러 발생 스택 에러 스택 정보 중 상위 스택 라인을 표시합니다.
❷ 스택 정보 스택 정보를 표시합니다. 이를 통해 보다 정확하게 에러의 원인을 파악하는 데에 참고할 수 있습니다.
❸ 원본 다운로드 선택한 스레드의 스택 정보를 ‘.txt’ 파일 형태로 다운로드하여 구성원과 공유할 수 있습니다. [원본 다운로드]를 클릭하면 ‘Crash_stacktrace.txt’ 파일을 ‘Download’ 폴더에 저장합니다.

5. 에러 검색

IMQA WCrash 에러 검색은 선택한 기간 동안 발생했던 에러들을 검색할 수 있습니다. 상태, 사용자 환경, 태그 등으로 검색할 수 있고 해당 에러 상세 페이지로 빠르게 이동할 수 있습니다.

5.1. 개요

IMQA WCrash 에러 검색은 다음과 같이 구성됩니다.
❶ 필터 ❷ 에러 테이블

5.2. 필터

날짜, 상태, 디바이스, OS , 브라우저, 태그로 에러 테이블에 표시되는 에러를 필터링할 수 있습니다.
❶ 날짜 기본 ‘7일’로 설정되어 있으며, 최대 30일까지 발생한 에러로 필터링할 수 있습니다. 바 위에 마우스 드래그 시 최대 날짜 변경이 가능합니다.
❷ 상태 기본 ‘전체’로 설정되어 있으며, ‘에러 상세’ 페이지에서 설정한 상태로 필터링할 수 있습니다.
❸ 디바이스 기본 ‘전체’로 설정되어 있으며, ‘Desktop’ 또는 ‘Mobile’로 필터링할 수 있습니다.
❹ OS 기본 ‘전체’로 설정되어 있으며, 가장 에러가 많이 발생한 OS 4개와 그 외로 필터링할 수 있습니다.
❺ 브라우저 기본 ‘전체’로 설정되어 있으며, 가장 에러가 많이 발생한 브라우저 4개와 그 외로 필터링할 수 있습니다.
❻ 태그
기본 ‘전체’로 설정되어 있으며, 선택 클릭시 ‘에러 상세’ 페이지에서 설정한 전체 태그 목록에서 선택해 필터링할 수 있습니다. 원하는 태그를 선택하면 필터 조건으로 추가됩니다. [X] 아이콘을 클릭해서 삭제할 수 있습니다.

5.3. 에러 테이블

필터에서 선택한 조건으로 에러를 확인할 수 있습니다. 현재 상태, 누적 발생 수, 에러 명, 태그와 마지막 발생일시를 표시합니다. 이를 통해 발생한 에러를 빠르게 파악할 수 있으며, ‘에러별 상세 페이지’로 이동할 수 있습니다.
❶ 헤더(정렬) 기본은 최근 발생한 에러 순으로 정렬되며 상태, 누적 횟수, 발생일시로 정렬할 수 있습니다.
❷ 에러 필터에서 선택한 조건으로 에러를 표시합니다. [에러 항목]클릭 시 ‘에러 상세’ 페이지로 이동합니다.
  • 상태: ‘에러 상세’ 페이지에서 설정한 상태를 표시합니다.
  • 누적: 해당 에러의 발생 누적 횟수를 카운트합니다.
  • 이름: 에러 타입, 사용자 정의 에러 메시지를 표시합니다.
  • 태그: ‘에러 상세’ 페이지에서 설정한 태그를 표시합니다.
  • 발생일시: 해당 에러의 마지막 발생 일시를 표시합니다.

6. 통계

IMQA WCrash 통계는 측정된 에러를 기반으로 다양한 통계 지표를 표시합니다. 어떤 에러가 얼마나 발생했고, 어떤 사용자 환경에서 주로 발생했는지 분석할 수 있습니다. 또한 클래스, 디바이스, 브라우저, 페이지 기준으로 분석할 수 있습니다.

6.1. 개요

IMQA WCrash 통계는 다음과 같이 구성됩니다.
❶ 일별 에러 발생 현황 ❷ 디바이스/OS/브라우저-버전별 비율 ❸ 디바이스-브라우저별 에러 발생 수 ❹ 에러 비율 상위 10 클래스(에러 타입) ❺ 에러 상위 10 브라우저 ❻ 에러 비율 상위 10 페이지

6.2. 일별 에러 발생 현황

최근 15일간 일별 에러 발생 수를 기록하여 특정 날짜의 에러 발생 추이와 발생 수를 확인할 수 있습니다.
  • 웹 크래시 발생 수 : 최근 15일 동안의 일별 웹 에러 로그 발생 수를 카운트합니다.
특정 날짜에 에러 발생 수가 급격하게 증가했다면, 해당 날짜 전/후로 변동 요인이 있었는지 확인해보세요. 또한 해당 날짜의 이용자 수와 방문 수를 함께 파악하면 어떤 원인으로 에러가 많이 발생했는지 지표 해석에 도움이 됩니다.

6.3. 디바이스/OS/브라우저-버전별 비율

최근 15일간 발생했던 에러의 디바이스, OS, 브라우저-버전별 비율을 확인할 수 있습니다. (저장 기간은 고객사 별로 상이 할 수 있습니다.)

6.4. 디바이스-브라우저별 에러 발생 수

최근 15일간 발생했던 에러의 디바이스별 브라우저의 비율을 누적 막대그래프를 통해 특정 디바이스에서 발생하는 에러 발생 수와 브라우저의 최적화 정도를 파악할 수 있습니다. (저장 기간은 고객사 별로 상이 할 수 있습니다.)
누적 막대그래프로 디바이스를 기준으로 총 에러 발생 수와 여러 브라우저의 비율을 파악할 수 있습니다. ‘Desktop’ 또는 ‘Mobile’ 막대에 마우스 포인터를 올리면 툴팁이 표시됩니다.
  • 총 에러 발생 수: 특정 브라우저에서 발생한 에러 수를 카운트합니다.
표시된 툴팁에서는 각 브라우저 별 에러 발생 수를 확인할 수 있습니다.
  • 브라우저 별 에러 발생 수: 각 브라우저에서 발생한 에러 수를 카운트합니다.
디바이스별 브라우저 비율의 지표로 다음과 같이 해석할 수 있습니다.
  1. 1.
    어떤 브라우저에서 많은 에러가 발생했는지 알 수 있습니다.
  2. 2.
    어떤 디바이스에서 많은 에러가 발생했는지 알 수 있습니다.
  3. 3.
    디바이스를 기준으로 어떤 브라우저에서 많은 에러가 발생했는지 알 수 있습니다.
예를 들어, Desktop에서는 Chrome 브라우저에서 많은 에러가 발생하였으나, Mobile에서는 Safari 브라우저의 에러 비율이 높았다면, 실제 사용자 접속 디바이스별 브라우저 최적화 우선순위를 조정할 수 있습니다.

6.5. 에러 비율 상위 10 클래스(에러 타입)

최근 15일간 에러 발생 비율 상위 10개의 클래스(에러 타입)에서 발생했던 에러의 비율을 확인할 수 있습니다. (저장 기간은 고객사 별로 상이 할 수 있습니다.)
  • 에러 발생 비율: 각 클래스(에러 타입)에서 발생한 에러 발생 비율을 표시합니다.
어떤 클래스에서 에러가 많이 발생했는지 판단할 수 있습니다.

6.6. 에러 상위 10 브라우저

최근 15일간 에러가 많이 발생한 상위 10개의 브라우저에서 발생했던 에러 발생 수를 확인할 수 있습니다. (저장 기간은 고객사 별로 상이 할 수 있습니다.)
  • 에러 발생 수: 각 브라우저에서 발생한 에러 발생 수를 카운트합니다.
어떤 브라우저에서 에러가 많이 발생했는지 판단할 수 있습니다. 이를 통해 브라우저 최적화 우선순위를 조정할 수 있습니다. ‘Unknown’는 브라우저 정보가 특정되지 않았음을 의미합니다. 사용자가 많이 사용하지 않는 브라우저 또는 신규 브라우저 등이 있습니다.

6.7. 에러 비율 상위 10 페이지

최근 15일간 에러 발생 비율 상위 10개의 페이지 URL에서 발생했던 에러의 비율을 확인할 수 있습니다. (저장 기간은 고객사 별로 상이 할 수 있습니다.)
  • 에러 발생 비율: 각 페이지에서 발생한 에러 발생 비율을 표시합니다.
어떤 페이지에서 에러가 많이 발생했는지 판단할 수 있습니다. 비즈니스 상 중요한 페이지라면 빠른 개선이 필요하다고 판단할 수 있습니다.
Last modified 1mo ago