# 대시보드

IMQA Crash 대시보드는 앱 버전 별 발생한 크래시의 상황을 파악할 수 있습니다. 앱 버전 별 주간 유저 현황과 크래시 발생 수, 상세한 에러 정보를 확인할 수 있으며 특정 에러에 사전 설정한 에러 등급과 누적 횟수를 확인하기 편리합니다. 

{% hint style="warning" %}
현재 Custom 유형 에러 발생 목록 확인은 ‘[에러 검색](https://docs.imqa.io/imqa-guide/user-guide/crash/error-search)’ 페이지를 통해서만 가능합니다.
{% endhint %}

## 1. 개요 <a href="#overview" id="overview"></a>

![](https://3726060384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzFyCopc6yAp3UcEYW6la%2Fuploads%2FvyPJawAbaaiOUWpt2hcn%2FCrash%20dashboard_202403_m1.png?alt=media\&token=9c2a6e58-0eed-45a5-8171-31566d60b18b)

IMQA Crash 대시보드는 다음과 같이 구성됩니다.

**❶ 상단 바(공통)**\
**❷ 프로젝트 정보** \
**❸ 주간 요약 정보**\
**❹ 일간 에러**\
**❺ 등급 별 분포**\
**❻ 주간 에러 상위 50**

### 상단 바 <a href="#topbar" id="topbar"></a>

![](https://lh3.googleusercontent.com/JLUGw7-gRhzP9h3ak93I46iM-Pby0JVNi8R9vB9Ngj8fVLPkUp20YVuyZzzy970j7MwTjmCpWHBaC86gS8chSWFY50Ai5hnrsKZxKzF1drYwqrXTZIKEXiSfAOmo6qslgii-UNL0qdt4VOLd_A)

**❶ 로고**\
클릭 시 프로젝트 리스트의 메인으로 이동합니다.

**❷ Crash 메뉴**\
클릭 시 각 Crash 메뉴 페이지로 이동합니다.

**❸ MPM 아이콘**\
프로젝트 생성 시 MPM 서비스를 생성했을 경우 표시되며, 클릭 시 동일한 앱의 ‘MPM > 대시보드' 페이지로 이동합니다.

**❹ 프로젝트 네비게이션**\
현재 위치한 프로젝트에서 다른 프로젝트로 이동할 수 있습니다. \[홈] 아이콘을 클릭하면 프로젝트 리스트로 이동하며 프로젝트 변경 시 해당 앱의 ‘서비스 > 대시보드’로 이동합니다. 설정한 비교 대상 프로젝트가 있을 경우, 상단에 표시됩니다.

{% hint style="info" %}
비교 대상 프로젝트 설정은 MPM 서비스에서 설정할 수 있으며, 자세한 내용은은 '[MPM 사용하기 > 관리 > 프로젝트 관리 > 프로젝트 정보 > 비교 대상 프로젝트](https://docs.imqa.io/imqa-guide/mpm/management#project-info)'를 참고하세요.
{% endhint %}

![](https://lh3.googleusercontent.com/4VHjiuV_rBGevcjx5d4ZGnfbFVR4ROG31OYWUgBF6n6cMx-xw2noqHqyes0UMKDGDcVfc-CRMK0-zEAd4RvTD23MofydGr0eIXaRBTNLU6NsNoXEiMNwXIukz6LD-GmNJhkoJo1Pf8pPOAPG8A)

❺ **회원 메뉴**\
로그인 계정의 회원 메뉴가 표시됩니다.&#x20;

* **IMQA 가이드**: IMQA의 가이드를 확인할 수 있습니다. 클릭 시 브라우저 새 탭으로 표시합니다.
* **사용자 설정**: 사용자 이름과 비밀번호를 변경할 수 있습니다. 브라우저 시간대는 IMQA 분석 정보의 표시 기준 시간을 변경할 수 있습니다.
* **로그아웃**: 계정을 로그아웃합니다.

{% hint style="warning" %}
로그인 사용자가 시간대를 자동으로 가져오지 못하는 환경에 있을 경우, IMQA의 시간 정보가 제대로 표현되지 않을 수 있습니다. **브라우저 시간대**로 접속한 지역에 맞는 GMT 표준 시간으로 수동 설정할 수 있습니다.
{% endhint %}

## 2. 프로젝트 정보 <a href="#project-info" id="project-info"></a>

프로젝트 정보를 확인하고 앱 버전을 변경할 수 있습니다. 앱 버전 변경 시 대시보드의 정보를 선택한 앱 버전으로 갱신합니다.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfJtSELaN5E6USTckjw6AsyKg85JagQcCBXa2fS_FC4hRO9d4yuGt3HXvbJqJGHfeCh80miIsmFs68cF3dcLHmpHMja6RV-XjAsf1EllOQXH8MRQ-0mqv-R_xagkqOk2DoJoXy3hFgmvJwYKP1ElmSunsNC?key=kIOJPAU9cQv0nEn7725tQQ" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
앱의 관리 주기에 맞게 IMQA에서 주로 모니터링할 앱 버전을 지정할 수 있습니다. 앱 버전 관리에 대한 자세한 내용은 '[Crash 사용하기 > 프로젝트 리스트 > 전체 프로젝트 관리 > 앱 버전 관리](https://docs.imqa.io/imqa-guide/user-guide/project-list#app-version)'를 참고하세요.
{% endhint %}

## 3. 주간 요약 정보 <a href="#weekly" id="weekly"></a>

특정 앱 버전의 최근 1주일간 발생한 크래시, 이용자 수, 앱 실행 수를 확인할 수 있습니다. 이를 통해 앱이 정상 작동 중인지 판단할 수 있습니다. 웹/하이브리드 앱의 경우 ‘웹 크래시'가 추가 표시됩니다.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcNp1Yw0JTZQ5UCrv6f7tvfhz246XDArBcDiLU_rttYbC9ufVvQ6YpwgSBhS1eptSAsSlUMxuNLaHw4hBdnf-bVYGeKHJVNSGZakWreutD2l1V-AuZJseFBj9lwEqRY7pOhUY04iSjyD73Hz9Z66tjta_7X?key=kIOJPAU9cQv0nEn7725tQQ" alt=""><figcaption></figcaption></figure>

* **이용자 수** 1w: 최근 1주일 동안의 이용자 수를 카운트합니다. 중복을 제외한 순 사용자를 의미합니다.
* **실행 수** 1w: 최근 1주일 동안의 앱 실행 수를 카운트합니다.
* **크래시** 1w: 최근 1주일 동안의 크래시 발생 수(ANR, 웹 크래시를 제외한 크래시 수)를 카운트합니다.&#x20;
* **웹 크래시** 1w: 최근 1주일 동안의 웹 에러 로그 발생 수를 카운트합니다.
* **ANR** 1w: 최근 1주일 동안의 ANR 에러 발생 수를 카운트합니다. <mark style="color:red;">\*안드로이드 프로젝트</mark>

<table><thead><tr><th width="150" align="center">성능 지표</th><th width="163" align="center">산출 구간</th><th align="center">산출 값</th><th align="center">병합 방식</th></tr></thead><tbody><tr><td align="center">이용자 수</td><td align="center">최근 1주일</td><td align="center">사용자 수</td><td align="center">카운트</td></tr><tr><td align="center">실행 수</td><td align="center">최근 1주일</td><td align="center">앱 실행 수</td><td align="center">카운트</td></tr><tr><td align="center">크래시</td><td align="center">최근 1주일</td><td align="center">크래시 발생 수</td><td align="center">카운트</td></tr><tr><td align="center">웹 크래시</td><td align="center">최근 1주일</td><td align="center">웹 에러 로그 발생 수</td><td align="center">카운트</td></tr><tr><td align="center">ANR</td><td align="center">최근 1주일</td><td align="center">ANR 에러 발생 수</td><td align="center">카운트</td></tr></tbody></table>

빠른 파악을 위해 1,000단위를 ‘1K’로 요약 표시하며, 실제 데이터는 ‘K’로 요약 표시된 숫자에 마우스 포인터를 올리면 표시되는 툴팁으로 확인할 수 있습니다.

{% hint style="info" %}
평균적으로 주간 실행 수 대비 크래시 발생 수가 10%가 넘어갈 경우 이상 현상이라고 판단할 수 있습니다. 예를 들어 앱 실행 수 10,000건 대비 크래시 발생 수가 1,000건 이상일 경우, 빠른 점검이 필요하다는 것을 의미합니다.
{% endhint %}

## 4. 일간 에러 <a href="#daily" id="daily"></a>

특정 앱 버전의 최근 1주일간 일별 에러 발생 수를 기록하여 특정 날짜의 에러 발생 추이와 발생 수를 확인할 수 있습니다. 웹/하이브리드 앱의 경우 ‘Web Crash'가 추가 표시됩니다.&#x20;

<figure><img src="https://lh7-us.googleusercontent.com/sLFSuqLBKAWLDqRoveBfpw_BChmd9yc4uGclulAFKkhSZXuA4ymdVDnWh2tWHWy-xj1_jqCAsSSc1dMDWqrkFkj89K21bhIq_DEif3PizDbfPMIXx9q4r2cRyI9HszSf5Bw4x2qbEdXKS4AE4ozIxVU" alt=""><figcaption></figcaption></figure>

* **크래시 발생 수**: 최근 1주일 동안의 일별 크래시 발생 수(ANR, 웹 크래시를 제외한 크래시 수)를 카운트합니다.
* **웹 크래시 발생 수**: 최근 1주일 동안의 일별 웹 에러 로그 발생 수를 카운트합니다.
* **ANR 에러 발생 수**: 최근 1주일 동안의 일별  ANR 에러 발생 수를 카운트합니다. <mark style="color:red;">\*안드로이드 프로젝트</mark>

{% hint style="info" %}
특정 날짜에 에러 발생 수가 급격하게 증가했다면, 해당 앱 버전에 어떤 변동이 있었는지 확인해보세요. 또한 해당 날짜의 이용자 수와 앱 실행 수를 함께 파악하면 어떤 원인으로 에러가 많이 발생했는지 지표 해석에 도움이 됩니다.
{% endhint %}

## 5. **등급별 비율** <a href="#rank" id="rank"></a>

특정 앱 버전의 최근 1주일간 발생한 에러 등급과 비율을 확인할 수 있습니다. 에러 종류와 등급은 SDK에서 설정이 가능합니다. Exception 객체 별 에러 등급을 설정할 경우, 해당 Exception이 발생했을 때 등급과 함께 표시합니다. \
'[Android > Crash 설정 > Custom Crash 발생](https://docs.imqa.io/imqa-guide/installation/android/crash-sdk-setting#custom-crash)'을 참고하세요.

![](https://lh5.googleusercontent.com/OelEEcTA7vkPD6Gu7QDXZSA9YzaiQ83SBR3At6_T8jocLdnNjMhzvXwWjhoClfNq0IzuQMX1TXHsF5YPh1kozTeiz8Zt8epqTVu7MzkP4hpO1K6nWCDHSLt7vbq8Uz6Dugt4JBjQXSo6cHxqWA)

에러 종류와 등급은 별도로 정해져 있지는 않으며 앱의 구성에 따라 변경하여 설정 가능합니다. 아래와 같이 설정할 수 있습니다.

* <mark style="color:red;">**Unhandled**</mark>: 기본이 되는 에러 등급으로 처리하지 못한 크래시일 경우
* <mark style="color:green;">**위험**</mark>: 앱에 상당한 영향을 주는 크래시일 경우
* **메이저**: 앱에 영향이 있는 크래시일 경우
* <mark style="color:blue;">**마이너**</mark>: 앱에 큰 영향이 없는 크래시일 경우

{% hint style="warning" %}
현재 Unhandled 이외의 등급 설정은 안드로이드 SDK에서만 지원합니다.
{% endhint %}

## **6.** 주간 에러 상위 50 <a href="#table" id="table"></a>

특정 앱 버전의 최근 1주일간 발생한 에러를 누적순, 발생일시순으로 확인할 수 있습니다. 에러 등급, 누적 발생 수, 크래시 명, 현재 상태와 마지막 발생 일시를 표시합니다. 이를 통해 발생한 에러를 빠르게 파악할 수 있으며, ‘통합 에러 상세’ 페이지로 이동할 수 있습니다. 최대 50개 항목이 표시됩니다.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcOoo3uiZfNonzIvJ9oOwCte20AAlqLt39TKVUJRfOu1fDY3FcFfE1IwU7ige_F_55Ri4ezqG9ygL8D--145N-qkNiuM6MBnPTSeL-3kBZT6hieGVtgjX7B1PNyV1ewY0JqhAgcWriQeAyG4SqMc6n_ilI-?key=kIOJPAU9cQv0nEn7725tQQ" alt=""><figcaption></figcaption></figure>

❶ **정렬**\
기본은 최근 1주일간 누적순으로 최대 50개 항목이 표시되며 '누적순', '발생일시순'으로 변경할 수 있습니다. 정렬 변경시 선택한 기준으로 목록을 표시합니다.

❷ **에러**\
특정 앱 버전의 최근 1주일간 발생한 에러를 표시합니다. \[항목]클릭 시 ‘통합 에러 상세’ 페이지로 이동합니다.

* **등급**: SDK에서 사전 정의한 에러의 등급을 표시합니다.
* **누적**: 해당 에러의 발생 누적 횟수를 카운트합니다.
* **에러**: 에러 명, 클래스 명, 코드 라인 번호를 표시합니다. 웹 크래시의 경우, 에러 타입, 사용자 정의 에러 메시지, 코드 라인 번호를 표시합니다. 목록 상단 크래시 3개를 빨간색으로 표시합니다.
* **상태**: ‘신규’, ‘처리’, ‘완료’, ‘마감’으로 표시되며 ‘통합 에러 상세’ 페이지에서 변경할 수 있습니다.
* **발생일시**: 해당 에러의 마지막 발생 일시를 표시합니다.

{% hint style="info" %}
**‘Unknown Error’**&#xB294; 특정할 수 있는 에러 정보가 제대로 수집되지 않았음을 의미합니다. SIGABRT, SIGTRAP 등 특정 Exception Type에서 에러 명이 수집되지 않는 경우 등이 있습니다.
{% endhint %}

❸ **에러 유형 필터**\
기본 ‘전체’로 설정되어 있으며, 안드로이드 프로젝트의 경우, ’크래시’와 ‘ANR’로 에러를 필터링할 수 있습니다. 웹/하이브리드 앱의 경우 에러를 ‘크래시’, ‘웹 크래시'로 필터링할 수 있습니다.