> 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/installation/imqa.md).

# IMQA 시작하기

설치 중 궁금한 사항이 있으시거나, 설치가 잘 되지 않는다면 아래를 통해 언제든지 문의해 주세요!\
필요에 따라 일정을 정한 후, 원격 지원도 진행 가능합니다. 

* 메일: <support@imqa.io>
* 채팅 상담: [imqa.channel.io](http://imqa.channel.io)
* 개발자 포럼: <https://imdev.imqa.io>

{% embed url="<https://youtu.be/FU9YC1kqbeM>" %}

## 1. 회원 가입 <a href="#signup" id="signup"></a>

<http://imqa.io> 홈페이지 상단 메뉴 오른쪽의 \[시작하기]를 클하면 로그인창이 새 탭으로 표시됩니다.

![](/files/bVwbuwGbWQE7ki8jhO31)

1\. 하단의 \[회원가입하기]를 클릭해 주세요.

![](/files/ykTw7Sw16CGT6VnH56ZG)

2\. 이름과 아이디로 사용하실 이메일 주소 및 비밀번호 입력 후 \[회원가입]을 진행해 주세요.

{% hint style="warning" %}
입력하신 이메일 주소로 이메일 인증이 진행됩니다. 로그인 가능한 이메일 주소로 가입해 주세요.
{% endhint %}

![](/files/eQBfyeH8i0BYAEjiU4yH)

3\. 입력하신 이메일 주소로 발송된 인증 메일에서 \[이메일 주소 인증 하기]를 클릭하여 인증하시면 가입이 완료됩니다. \
&#x20;  (간혹 메일이 스팸메일함에 있는 경우가 있습니다. 인증 메일을 못 받으신 경우, 스팸메일함을 확인해 주세요.)

## 2. 로그인 <a href="#login" id="login"></a>

<http://imqa.io> 홈페이지 상단 메뉴 오른쪽의 \[시작하기]를 클릭하면 로그인 페이지가 새 탭으로 표시됩니다. 이메일 주소와 비밀번호를 입력 후 \[로그인]을 클릭합니다.

![](https://lh4.googleusercontent.com/j9mhXtuH7QdEO7Ei6PKMbx9qe1-Jd6nFN5EMuprrGj8Nc7lqv_qkzsHu1kSPLVQLPKZ2GC3b2EcuIQ1-I-ZawQAar07EJO40IQdks17q8rhZyaEhus_jwHM1l85kXlxOrPeMOLR3BFoK2Y0CKPmtrwc)

{% hint style="danger" %}
**비밀번호를 5회 이상 틀릴 경우 계정이 잠깁니다.** 다시 계정을 활성화하려면 ‘비밀번호 찾기’ 절차를 통해 비밀번호를 변경하여 이용해 주세요.
{% endhint %}

## 3. 프로젝트 생성  <a href="#project-standard" id="project-standard"></a>

프로젝트는 IMQA 서비스를 사용하는 기본 단위로 프로젝트 생성을 통해 IMQA와 앱을 연결할 수 있습니다. 앱과 OS를 기준으로 구분되 OS 별로 프로젝트를 생성해야 합니다. 예를 들어 1개의 앱을 안드로이드와 iOS 모두 운영할 경우, 각 OS 별로 총 2개의 프로젝트를 생성하여 관리합니다.

프로젝트 생성 시 MPM을 선택하여 프로젝트를 생성할 경우 Crash와 MPM을 모두 사용하실 수 있습니다.&#x20;

### 생성 및 키 발급 <a href="#issue2" id="issue2"></a>

![](/files/dSYDDmmUNmtuduxJPwME)

프로젝트 리스트 오른쪽 상단의 \[+] 아이콘을 클릭하면 프로젝트를 생성 수 있는 팝업이 표시됩니다.

![](/files/Q2QZAeC05eT5tZFE5I9K)

1\. 원하는 서비스와 팀을 선택하고 프로젝트 이름, 패키지 이름을 입력합니다.

2\. 등록할 앱의 플랫폼을 선택하고 앱 유형을 선택합니다.\
&#x20;  • **서비스**: MPM을 선택할 경우, MPM과 Crash 프로젝트가 모두 생성됩니다. Crash를 선택할 경우 Crash 프로젝트만 생성됩니다.\
&#x20;  • **패키지 이름**: 안드로이드 프로젝트는 ‘Application id’를 의미하며, iOS 프로젝트는 ‘Bundle id’를 의미합니다. Application id, Bundle id 확인 방법은 아래 내용을 참고해 주세요. \
&#x20;   **• 앱 유형**: 네이티브, 리액트 네이티브, 웹/하이브리드 앱으로 앱의 유형을 설정합니다. 리액트 네이티브 앱의 경우, IMQA 서비스 내에서 컴포넌트에 관련된 정보가 표시됩니다. 앱 등록 후 ‘MPM > 관리 > 프로젝트 관리’ 페이지에서 수정할 수 있습니다.

* [안드로이드 프로젝트 패키지 이름(application id) 확인하기](#standard-packageid)
* [iOS 프로젝트 패키지 이름(bundle id) 확인하기](#standard-bundleid)
* [패키지 이름 수정하기](#standard-packageid-edit)

{% hint style="warning" %}
**패키지 이름을 잘못 설정할 경우 누락되는 데이터가 있을 수 있으니 패키지 이름을 확인하여 설정해 주세요.** 프로젝트 생성 시 임시 패키지 이름을 설정하였을 때는 반드시 올바른 패키지 이름으로 수정해 주세요.&#x20;
{% endhint %}

\
&#x20;  • **앱 유형**: 네이티브, 리액트 네이티브, 웹/하이브리드 앱으로 앱의 유형을 설정합니다. 리액트 네이티브 앱의 경우, IMQA 서비스 내에서 컨포넌트에 관련된 정보가 표시되며, 웹/하이브리드 앱의 경우, 웹뷰에 관련된 정보가 표시됩니다. 앱 등록 후 'MPM > 관리 > 프로젝트 관리' 페이지에서 수정할 수 있습니다.

{% hint style="danger" %}
**• 현재 리액트 네이티브 유형으로 프로젝트를 생성했을 경우, 다른 앱 유형으로 수정하실 수 없습니다.** 다른 앱 유형으로 변경하시려면 프로젝트를 삭제하시고 다시 생성해 주세요.
{% endhint %}

3\. 정보 작성이 완료되면 \[프로젝트 생성]을 클릭합니다.

4\. 프로젝트 키가 발급되었습니다. 설치 항목을 참고하여 프로젝트 키를 앱에 삽입합니다.

* [안드로이드 SDK 설치하기](/imqa-guide/installation/android.md)
* [iOS SDK 설치하기 ](/imqa-guide/installation/ios.md)

{% hint style="warning" %}
**프로젝트 키를 앱에 삽입 후** 앱을 실행하고 프로젝트 리스트 페이지를 **새로고침 해주세요.**
{% endhint %}

### **\[AOS] 패키지 이름 확인 (a**pplication id) <a href="#standard-packageid" id="standard-packageid"></a>

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

1\. build.graddle 파일을 열어주세요.

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

2\. build.graddle 파일에서 applicationId를 찾아 패키지 이름을 확인합니다.

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

3\. 프로젝트 생성 시 해당 값을 패키지 이름 항목에 입력합니다.

### **\[iOS] 패키지 이름 확인 (**&#x42;undle id) <a href="#standard-bundleid" id="standard-bundleid"></a>

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

1\. 프로젝트를 선택합니다.

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

2\. 프로젝트 선택 후 나오는 화면에서 Target > General > Identity > Bundle Identifier의 값을 확인합니다.

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

3\. 프로젝트 생성 시 해당 값을 패키지 이름 항목에 입력합니다.

### 패키지 이름 수정 <a href="#standard-packageid-edit" id="standard-packageid-edit"></a>

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

&#x20;1\. 상단 메뉴 ‘관리 > 프로젝트 관리’를 선택합니다.

<figure><img src="/files/6kbMhyPewGNTgBIAPzW4" alt=""><figcaption></figcaption></figure>

2\. 패키지 이름 항목에서 수정할 패키지 명을 입력합니다.

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

3\. \[저장하기] 버튼을 누르시면 수정이 완료됩니다.

### 프로젝트 카드 <a href="#card2" id="card2"></a>

생성된 프로젝트 카드에서는 **프로젝트 정보**와 **요약 지표**를 확인하고, 각 서비스로 이동할 수 있습니다.

![](/files/URw50tkGyULuOce9uqHA)

❶ **플랫폼 아이콘**\
&#x20;  안드로이드와 iOS 정보를 아이콘으로 표시합니다. 리액트 네이티브 앱의 경우, 리액트 프로젝트 전용 아이콘으로 표시됩니다.

❷ **프로젝트 정보**\
&#x20;  프로젝트 이름, 패키지 이름을 표시합니다. 클릭 시 ‘서비스 > 대시보드’로 이동합니다.

❸ **서비스 아이콘**\
&#x20;  MPM Crash 서비스 정보를 아이콘으로 표시합니다. 클릭 시 ‘서비스 > 대시보드’로 이동합니다.

❹ **프로젝트 관리**\
&#x20;  \[…] 아이콘 클릭 시 프로젝트 관리 메뉴를 표시합니다.

❺ **요약 지표 표시/숨김**\
&#x20;  \[∨] 아이콘 클릭 시 요약 지표를 표시합니다. \[∧] 아이콘 클릭 시 요약 지표를 닫습니다.

❻ **MPM 요약 지표** \
&#x20;  우선순위가 가장 높은 앱 버전의 최근 24시간 동안의 요약 지표를 그래프로 표시합니다. 각 성능 지표 별 기준치를 넘는 데이터의 비율을 문제 발생률로 표시합니다. \
&#x20;  • 크래시 지표 예시) 전체 크래시 발생 수: 30개, 전체 앱 실행 수: 100 인 경우 30%로 표시 \
&#x20;  • 그 외 지표 예시) 300ms 넘는 데이터 수: 100개, 전체 데이터 수: 1000 인 경우 10%로 표시

|    성능 지표    |    기준치   |
| :---------: | :------: |
|    **크래**   | 크래시 발생 수 |
| **화면 로딩 시** |   300ms  |
|   **응답시간**  |  3,000ms |
| **CPU 사용량** |    50%   |
| **메모리 사용량** |   100MB  |

* **색상 표시**\
  \- <mark style="color:blue;">**파랑**</mark>: 문제 발생률  60% 미만\
  \- <mark style="color:orange;">**주황**</mark>: 문제 발생률  80% 미만\
  \- <mark style="color:red;">**빨강**</mark>: 문제 발생률  80% 이상

❼ **Crash 요약 지표**\
&#x20;  우선순위가 가장 높은 앱 버전의 최근 24시간 동안의 요약 지표를 그래프로 표시합니다. 6시간 구간으로 크래시 발생 수를 표시합니다.

| 성능 지표 | 산출 구간 |   산출 값   |
| :---: | :---: | :------: |
|   크래  |  6시간  | 크래시 발생 수 |

{% hint style="info" %}
서비스 별 요약 지표를 통해 여러 앱을 관리하는 관리자가 전반적인 성능을 빠르게 파악할 수 있습니다. 앱 버전 우선순위에 대한 자세한 내용은 '[MPM 사용하기 > 프로젝트 리스트 > 전체 프로젝트 관리 > 앱 버전 관리](/imqa-guide/user-guide/crash/project-list.md#app-version)'를 참고하세요.
{% endhint %}