# 에러 검색

IMQA Crash 에러 검색은 선택한 기간 동안 발생했던 에러들을 다양한 관점에서 검색하고 에러 발생 목록을 확인할 수 있습니다. 통합 에러 목록과 사용자별 에러 목록에서 기간, 에러 유형, 에러명, 등급, 앱 버전, 태그 등 다양한 조회 조건으로 검색할 수 있습니다. 통합 에러 목록의 경우 ‘통합 에러 상세’ 페이지로, 사용자별, 행동분석별 에러 목록의 경우 ‘사용자별 에러 상세’ 페이지로 빠르게 이동할 수 있습니다.

## 1. 통합 에러 목록

통합 에러 목록은 기간 내 발생했던 에러들을 통합적 관점에서 확인할 수 있습니다. 원하는 기간과 조건으로 조회하여, 누적 발생이 많았던 에러에 대한 인사이트를 얻을 수 있습니다. 거시적 관점에서의 상태 확인 및 발생 패턴을 파악할 수 있습니다.

![](https://lh3.googleusercontent.com/vNDDLzechXib_lVFQ0YvTWlnid463-mTPGpBGxL1sJtCYoxxWttEgoqYjSeYXnS8jHt_dFXn8Vad2uz0SD2xkhzc7fq636JjvIMHOSz7QIJjHPWWfx2kX0t3kO5_z_AMFGDQxpMiHhnFuS6ykH0yKg)

IMQA Crash 통합 에러 목록은 다음과 같이 구성됩니다.

**❶ 필터**\
**❷ 에러 테이블**

### **필터** <a href="#filter" id="filter"></a>

에러 유형, 등급, 최근 발생일, 상태, 앱 버전, 태그로 통합 에러 단위를 검색할 수 있습니다.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe1_EZppmiGgLrC27RX-PnBPcraVfFMCrtEC0OufOB66n0hJ-eOh1qjYvaV2C0gHaM6MC0_8YenPr5wdB1TOxSGBfEqfJekXtEUw7V3V32PcrDXLWg_oIwJdDJt2HJQ9_3MyKtkSCFx42ivryXGeR-VfvaG?key=kIOJPAU9cQv0nEn7725tQQ" alt=""><figcaption></figcaption></figure>

❶ **에러 유형**\
기본 ‘전체’로 설정되어 있으며, 안드로이드 프로젝트는  ’크래시’와 ‘ANR’로 검색할 수 있습니다. 웹/하이브리드 앱의 경우 에러를 ‘크래시'와 ‘웹 크래시'로 검색할 수 있습니다. \
SDK에서 Custom Crash 발생 옵션을 통해 사용자 정의 에러를 수집한 경우 ‘Custom’ 으로 에러를 검색할 수 있습니다. Agent에서 Custom Web Crash 발생 옵션을 통해 사용자 정의 에러를 수집한 경우 ‘WCustom’ 으로 에러를 검색할 수 있습니다.&#x20;

{% hint style="info" %}
SDK에서 크래시 외 비즈니스에서 발생하는 다양한 문제를 사용자 정의 에러로 수집할 수 있습니다. 커스텀 크래시에 대한 자세한 내용은 ‘[IMQA Crash 설치 가이드 > Custom Crash 발생](https://docs.imqa.io/imqa-guide/installation/android/crash-sdk-setting#custom-crash)' 을 참고하세요.\
\
Agent에서 웹 페이지에서 발생하는 에러나 비즈니스 로직에서 발생하는 다양한 문제를 사용자 정의 에러로 수집할 수 있습니다. 커스텀 웹 크래시에 대한 자세한 내용은 \
‘[IMQA Crash 설치 가이드 > Custom Web Crash 발생](https://docs.imqa.io/imqa-guide/installation/android/crash-sdk-setting#id-2.-custom-web-crash)' 을 참고하세요.
{% endhint %}

❷ **등급**\
기본 ‘전체’로 설정되어 있으며, SDK에서 사전 정의한 에러의 등급으로 필터링할 수 있습니다.

❸ 최근 발생일\
기본 ‘최근 30일’로 설정되어 있으며, 최근 에러 발생일시가 조회 기간에 포함되는 에러로 필터링할 수 있습니다. 바 위에 마우스 드래그 시 조회 기간 변경이 가능합니다.

❹ **상태**\
기본 ‘전체’로 설정되어 있으며,  ‘에러 상세’ 페이지에서 설정한 상태로 필터링할 수 있습니다.

❺ **앱 버전**\
기본 ‘전체’로 설정되어 있으며,  우선순위가 높은 앱 버전 4개와 그 외로 필터링할 수 있습니다.

❻ **태그**

![](https://lh6.googleusercontent.com/G6kKHH-yQTGgwemWWZO9YjDLipoEX1b-VY36gEdgPK7nCxfVcHwyl2oDYZrdM5j4_2RbAsX-gO90evvLHLrfUyX_9gdPiLd2QdqKusirj6yhs0ovILV0mSK7wrEuF459zCF6HLnjJXToAh8V8KE1bg)

기본 ‘전체’로 설정되어 있으며,  선택 클릭시 ‘통합 에러 상세’ 페이지에서 설정한 전체 태그 목록에서 선택해 검색할 수 있습니다. 원하는 태그를 선택하면 검색 조건으로 추가됩니다. \[X] 아이콘을 클릭해서 삭제할 수 있습니다.

<br>

### 에러 테이블

필터에서 선택한 조건으로 통합 에러를 확인할 수 있습니다. 에러 등급, 에러 명, 태그, 현재 상태와 최근 발생일시를 표시합니다. 이를 통해 발생한 에러를 빠르게 파악할 수 있으며, ‘통합 에러 상세’ 페이지로 이동할 수 있습니다.

![](https://lh4.googleusercontent.com/s47Xieg5T1bvY3vXW_it2TTuOqSk3jbOALWPy0uN9aIGfeZMVyQx-zvDg_71hHG2nXuN60rccO6HP3k3sJ8pRmnfQByCAk-o8QAl161zSV5klYPe06tLBz9RSyLDucNMOBEAXPRnoGhBhi8wBQ-dFw)

❶ **헤더(정렬)**\
기본은 최근 발생일시 순으로 정렬됩니다.

❷ **에러**\
필터에서 선택한 조건으로 에러를 표시합니다. \[에러 항목]클릭 시 ‘통합 에러 상세’ 페이지로 이동합니다.

* **등급**: SDK에서 사전 정의한 에러의 등급을 표시합니다.
* **크래시 명**: 에러 명을 표시합니다.
* **태그**: ‘통합 에러 상세’ 페이지에서 설정한 태그를 표시합니다.
* **상태**: ‘통합 에러 상세’ 페이지에서 설정한 상태를 표시합니다.
* **최근 발생일시**: 해당 에러의 마지막 발생 일시를 표시합니다.

## 2. 사용자별 에러 목록

사용자별 에러 목록은 기간 내 발생했던 에러들을 사용자 관점에서 확인할 수 있습니다. 원하는 기간과 조건으로 조회하여, 특정 사용자에게 발생했던 에러에 대한 인사이트를 얻을 수 있습니다. 미시적 관점에서의 상태 확인 및 발생 패턴을 파악할 수 있습니다.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXerqJVEN9jNzf28cmW0JBcR4z2GZ0q3NZ28n8_lgmyIl2dGiuRp_C3bkcp9vl-0tpjLA21QNyLoAFQWY0wOmiA7Boadc7I-ylSsvWQD3PPLoIzrgXZYlJLZqUOpj6RXKNgDJB2IY-_mrxVq0jMdY_hSJsU?key=kIOJPAU9cQv0nEn7725tQQ" alt=""><figcaption></figcaption></figure>

IMQA Crash 사용자별 에러 목록은 다음과 같이 구성됩니다.

**❶ 조회 기간/조회 조건**\
**❷ 검색 결과**

### 조회 기간/조회 조건

조회하고자 하는 기간과, 조회 조건을 선택할 수 있습니다. 선택한 기간과 기준으로 사용자별 에러 목록을 조회합니다.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXd1xI1k28rPd1G43NiOg2jpEwquHBpdB4dSNjs2S0lN-qr8qyJbVSHZsKYBih-y41hogv261VmShZdhrKvO6uE64-SP6DRH3DJKiuntjRKbyKUfLYQrMLszpYIAEG-uFAcC02w6pWrbDTzoG0VHYbDRlPU2?key=kIOJPAU9cQv0nEn7725tQQ" alt=""><figcaption></figcaption></figure>

① 조회하고자 하는 조회 기간을 \[캘린더] 아이콘을 클릭하여 선택합니다. 시작일시/종료일시는 기본 ‘최근 7일(\~오늘 날짜 현재 시간)’로 설정되어 있으며 ‘1일'을 조회하는 경우에는 같은 날짜로 선택합니다.

② 조회하고자 하는 특정 사용자 ID, 에러명, 화면명이 있을 경우 2글자 이상의 검색어를 입력합니다. 입력하지 않으면 기본 ‘전체'로 조회됩니다.

{% hint style="info" %}
사용자 ID는 별도로 SDK에서 제공하는 API를 통해 데이터를 제공하는 경우에만 조회가 가능합니다.

사용자 ID 설정은 ‘[IMQA Crash 설치 가이드 > Custom User ID 등록](https://docs.imqa.io/imqa-guide/installation/android/crash-sdk-setting#custom-user-id)'을 참고하세요.
{% endhint %}

③ 조회하고자 하는 특정 앱 버전, 에러 유형, 에러 상태가 있을 경우 선택합니다. 기본 ‘전체’로 설정되어 있습니다.

④ \[조회 하기]를 클릭하면 선택한 기간과 기준으로 데이터가 조회됩니다.

{% hint style="info" %}
여러 조회 조건을 설정할 경우, 모든 조건이 일치하는 검색 결과를 표시합니다. (AND 연산)
{% endhint %}

### 검색 결과

조회 기간과 선택한 조건으로 사용자별 에러를 확인할 수 있습니다. 에러 유형, 사용자 ID, 에러명, 에러 발생 화면명, 앱 버전,  현재 상태와 발생일시를 표시합니다. 이를 통해 특정 사용자에게 발생한 에러를 빠르게 파악할 수 있으며, ‘사용자별 에러 상세’ 페이지로 이동할 수 있습니다.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXebMsrYnf0vzaCdQxXy2ZH6aDRPZgz7oqfU-jQtsLk_6RvHr3190s01BHwenh9mj4VUOp9R4zaMvur9qoM0SIlR5ztN-h0izCtoDuaRAr-UC09I7CXdzHO4QpNwNQ4MOnNGO4bn_YDbCRGJ1UlqZi4KO72r?key=kIOJPAU9cQv0nEn7725tQQ" alt=""><figcaption></figcaption></figure>

**❶ 검색결과**\
조회된 검색결과 항목 수를 표시합니다.

**❷ 헤더(정렬)**\
기본은 최근 발생일시 순으로 정렬됩니다.

**❸ 에러**\
선택한 조건으로 특정 사용자의 에러를 표시합니다. \[에러 항목]클릭 시 ‘사용자별 에러 상세’ 페이지로 이동합니다.

* **에러 유형**: 해당 에러의 유형을 표시합니다.&#x20;
* **사용자 ID**: SDK에서 사전 정의한 사용자의 ID 정보가 수집되었을 경우 해당 정보로 표시합니다. 설정한 사용자 정보가 없을 경우 ‘-’ 표시됩니다.&#x20;
* **에러**: 에러 명을 표시합니다.
* **화면명**: 해당 에러가 발생한 화면명을 표시합니다.

{% hint style="warning" %}
현재 웹 크래시 발생 화면명은 네이티브 화면 정보로 표시됩니다.&#x20;
{% endhint %}

* **앱 버전**: 해당 에러가 발생한 앱 버전을 표시합니다.
* **상태**: 해당 에러 상위 통합 에러의 ‘통합 에러 상세’ 페이지에서 설정한 상태를 표시합니다.
* **발생일시**: 해당 에러의 발생 일시를 표시합니다.

## 3. 행동분석별 에러 목록

행동분석별 에러 목록은 특정 사용자의 앱 실행 \~ 앱 종료까지의 행동 흐름에서 발생한 에러를 확인할 수 있습니다. ‘행동분석' 페이지를 통해 특정 크래시가 발생한 화면에서 연계하여 확인할 수 있습니다.

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

행동분석별 에러 목록을 이렇게 활용해보세요.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfXH2jKSSGUerMggKyuBnstvRy0bTa5O5TM1MzYnpsQWKfgP42A4FBKfBUjhtUEjA_CWu3O633BRlgBNGXG0vljI26X4-ghDp40Jc-DPbQF8l2HsNM_OHTzPZsif6UHeanB6mELVBa6-p-qYWAPwt99vfI?key=kIOJPAU9cQv0nEn7725tQQ" alt=""><figcaption></figcaption></figure>

① ‘행동분석' 행동 흐름 목록에서 이슈가 있었던 행동분석 ID 만으로 조회하는 경우, 특정 행동 흐름에서 발생한 에러가 전체 조회됩니다.&#x20;

② ‘행동분석' 행동 흐름 목록에서 이슈가 있었던 행동분석 ID와 화면 ID로 조회하는 경우, 행동 흐름 중 특정 화면에서 발생한 에러가 조회됩니다.&#x20;

{% hint style="info" %}
행동분석별 에러 목록에서의 조회 조건은 행동분석 ID와 화면 ID를 사용합니다.\
행동분석 ID와 화면 ID는 IMQA가 특정 행동 흐름과 특정 화면을 식별하기 위해 부여한 고유 키입니다.
{% endhint %}