> For the complete documentation index, see [llms.txt](https://docs.imqa.io/imqa-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.imqa.io/imqa-guide/user-guide/data/wcrash.md).

# WCrash 데이터 읽기

## 1. 대시보드

WCrash 대시보드에서는 웹 애플리케이션에서 발생한 웹 크래시의 상황을 파악할 수 있습니다. 주간 유저 현황, 크래시 발생 수, 상세 에러 정보를 확인하는 방법을 통해 효율적으로 에러를 관리해 보세요.

<figure><img src="/files/0YBYBKV0fYlMuHQnDukR" alt=""><figcaption></figcaption></figure>

### 1.1. 한눈에 파악하는 주간 크래시 현황

주간 요약 정보와 일간 에러 그래프를 통해 최근 1주일간 발생한 웹 크래시 및 이용 현황과 에러 발생 추이를 확인할수 있습니다.

#### (1) 주간 요약 정보

최근 1주일간 웹 크래시 발생수를 한 눈에 파악할 수 있습니다. 빠른 파악을 위해 1,000단위를 ‘1K’로 요약 표시하며, 실제 데이터는 ‘K’로 표시된 숫자에 마우스 포인터를 올리면 툴팁을 통해 확인할 수 있습니다.

<figure><img src="/files/OsY8CRN7FTbsPeBCYQTx" alt=""><figcaption></figcaption></figure>

#### (2) 웹 크래시 발생 비율

웹 사이트가 안정적으로 운영 중인지 빠르게 확인이 필요할 땐 <mark style="color:red;">방문 수 대비 웹 크래시 발생 비율</mark>을 확인해 보세요. 평균적으로 <mark style="color:red;">주간 방문 수 대비 웹 크래시 발생 수가 10%가 넘을 경우, 이상 현상으로 판단할 수 있습니다.</mark> 예를 들어, 위의 경우 주간 방문 수: 96,127회, 주간 웹 크래시 발생 수: 598건으로 주간 방문 수 대비 주간 웹 크래시 발생 비율은 약 0.62%입니다. 이 경우 비교적 안정적으로 운영되고 있다고 판단할 수 있습니다.

#### (3) 일별 에러

최근 1주일간 웹 크래시 추이를 그래프를 통해 한눈에 확인할 수 있습니다.

<figure><img src="/files/kCgudvewx6HBs6pqOFwa" alt=""><figcaption></figcaption></figure>

**특정 일자에 에러 발생 수가 많은 경우**\
그래프에서 특정 일자에만 에러 발생  수가 많은 경우에는 반드시 확인 및 개선이 필요합니다. 아래 2가지 사항에 대해서도 반드시 확인해 보세요.

**➊ 기존 페이지 수정/업데이트, 신규 페이지 추가 사항 확인**\
웹사이트 변동 사항에 따른 에러 발생일 수 있으므로 확인이 필요합니다. 예를 들어 특정 일자에 기존 페이지 수정, 신규 페이지 추가 등 업데이트가 있었다면, 업데이트로 인한 에러가 발생한 것은 아닌지, 주요 원인을 빠르게 파악하여 추적해 볼 수 있습니다.&#x20;

**➋ 이용자 수, 방문 수 확인**\
이용자 수, 방문 수가 많을 경우 전체 데이터 수가 많기 때문에 상대적으로 웹 크래시 발생 수도 많을 수 있습니다. 따라서 해당 일자의 이용자 수와 실행 수를 확인하고 발생 비율을 파악해야 합니다.

{% hint style="info" %}
**Q. IMQA WCrash에서는 타 솔루션 대비 웹 크래시 발생 수가 더 많이 나와요.**

A. 데이터를 일부 수집하는 타 솔루션과는 달리 IMQA는 모든 데이터를 수집, 보관합니다. 따라서 <mark style="color:red;">누락 없이 모든 웹 크래시 발생 현황을 확인할 수 있기 때문에</mark> 타 크래시 솔루션 보다 더 많은 발생 수를 확인할 수 있습니다. &#x20;
{% endhint %}

### 1.2. 에러 테이블

특정 앱 버전의 최근 1주일간 발생한 모든 에러를 확인할 수 있습니다. 에러 등급, 누적 발생 수, 크래시 명, 현재 상태와 마지막 발생 일시를 표시합니다.&#x20;

<figure><img src="/files/8bsFtDKHayIVBwFoJ1FB" alt=""><figcaption></figcaption></figure>

전체 에러 중 <mark style="color:red;">누적순으로 정렬하여 누적이 가장 많은 에러부터 확인이 필요</mark>합니다. 에러에 대한 누적 수는 해당 에러를 경험한  사용자 수를 의미합니다. 위의 상황의 경우, 738명의 사용자가 동일한 에러를 경험했다고 판단할 수 있습니다. (동일 에러이기 때문에 에러 자체는 1개이므로 에러 테이블에는 1개의 에러만 표시되고, 누적은 5개로 표시) 따라서 <mark style="color:red;">누적 수가 많다는 것은 그만큼 많은 사용자가 해당 에러를 경험했다는 것을 의미하므로 빠른 해결이 필요</mark>합니다.&#x20;

## 2. 에러 상세

IMQA WCrash 에러 상세는 특정 에러가 어떤 페이지 URL에서 얼마나 발생했고, 어떤 사용자 환경에서 주로 발생했는지 분석할 수 있습니다. 아래 내용을 통해 해당 에러에 대한 정보를 어떻게 읽고 분석하는지 확인해 보세요.

<figure><img src="/files/RJJTjswZyXk3Mf87RDnB" alt=""><figcaption></figcaption></figure>

### 2.1. 사용자 정보(환경별 에러 발생 파악)

최근 1주일간 해당 에러가 어떤 사용자 환경에서 많이 발생했는지를 확인할 수 있습니다. 사용 환경에 따른 개선 사항을 파악해 보세요.&#x20;

<figure><img src="/files/smKiaz6PzRVHBV1JlJDG" alt=""><figcaption></figcaption></figure>

**➊ 분류 구분 없이 1종인 경우**\
디바이스(Desktop, Mobile), OS, 브라우저/버전에서 1종만 뜬다면 현재 해당 에러는 특정 디바이스(Desktop, Mobile), OS, 브라우저/버전에서만 발생하는 문제라고 파악할 수 있습니다.&#x20;

**➋ 분류가 많은 경우**\
각 기준별 데이터가 다양하다면 다양한 환경에서 해당 에러를 경험했다고 판단할 수 있습니다.&#x20;

{% hint style="info" %}

* 사용자 정보는 웹 사이트에 접속했을 때 사용자의 User-Agent 정보를 기반으로 표시됩니다.\
  \- **OS**: Window, macOS, Android, iOS, Linux 등으로 구분\
  \- **브라우저**: Chrome, Samsung Browser, Safari, Microsoft Edge, Firefox 등으로 구분\
  \- 특정되지 않은 OS나 브라우저는 Unknown으로 표시될 수 있음
  {% endhint %}

### 2.2. 태그

에러별 구분을 위해 해당 에러에 대한 태그를 작성할 수 있습니다. 등록된 태그는 '에러 검색' 페이지에서 검색어로 사용할 수 있어 관리가 용이합니다.

<figure><img src="/files/2zByvs8XglFkkZdBc1Sb" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
타겟 사용자 환경으로 태그를 관리하거나 발생 상황, 높은 자원 사용량 기록 등으로 활용해 보세요.
{% endhint %}

### 2.3. 에러 상태

에러 확인 후 처리 상태를 변경하여 원활하게 관리할 수 있습니다.

<figure><img src="/files/HIl2yiGW2CnPOgvpcf5w" alt=""><figcaption></figcaption></figure>

**상태 값 설정 기준**

• 신규: 새롭게 발생된 에러\
• 처리: 담당자 원인 파악 후 처리 중\
• 완료: 담당자 처리 완료\
• 마감: 관리자 확인 후 처리 완료 (마감 설정된 에러는 더 이상 노출되지 않습니다.)
