IMQA 시작하기

IMQA를 처음 사용하시는 분들을 위한 페이지입니다.

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

메일: support@imqa.io
채팅 상담: imqa.channel.io
개발자 포럼: https://imdev.imqa.io

아래 영상을 통해 가입부터 설치까지, 전 과정을 쉽고 빠르게 확인하실 수 있습니다.

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

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

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

입력하신 이메일 주소로 이메일 인증이 진행됩니다. 로그인 가능한 이메일 주소로 가입해 주세요.

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

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

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

3. 프로젝트 생성 (LITE)

프로젝트는 IMQA 서비스를 사용하는 기본 단위로 프로젝트 생성을 통해 IMQA와 앱을 연결할 수 있습니다. 앱과 OS를 기준으로 구분되 OS 별로 프로젝트를 생성해야 합니다.

무료 요금제인 LITE 플랜에서는 1개의 프로젝트 생성이 가능합니다. 별도의 설정 없이 프로젝트를 생성하면 Crash와 MPM 모두 설치가 가능합니다.

생성 및 키 발급

로그인하면 프로젝트 리스트 중앙에 프로젝트를 생성할 수 있는 팝업이 표시됩니다.

1. 프로젝트 이름, 패키지 이름을 입력합니다. • 패키지 이름: 안드로이드 프로젝트는 ‘Application id’를 의미하며, iOS 프로젝트는 ‘Bundle id’를 의미합니다. Application id, Bundle id 확인 방법은 아래 내용을 참고해 주세요.

패키지 이름을 잘못 설정할 경우 누락되는 데이터가 있을 수 있으니 패키지 이름을 확인하여 설정해 주세요. 프로젝트 생성 시 임시 패키지 이름을 설정하였을 때는 반드시 올바른 패키지 이름으로 수정해 주세요.

2. 등록할 앱의 유형을 선택합니다. • 앱 유형: 네이티브, 리액트 네이티브, 웹/하이브리드 앱으로 앱의 유형을 설정합니다. 리액트 네이티브 앱의 경우, IMQA 서비스 내에서 컴포넌트에 관련된 정보가 표시됩니다. 앱 등록 후 ‘MPM > 관리 > 프로젝트 관리’ 페이지에서 수정할 수 있습니다.

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

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

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

프로젝트 키를 앱에 삽입 후 앱을 실행하고 프로젝트 리스트 페이지를 새로고침 해주세요.

[AOS] 패키지 이름 확인 (application id)

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

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

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

[iOS] 패키지 이름 확인 (Bundle id)

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

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

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

패키지 이름 수정

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

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

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

프로젝트 카드

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

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

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

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

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

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

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

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

성능 지표

기준치

크래

크래시 발생 수

화면 로딩 시

300ms

응답시간

3,000ms

CPU 사용량

50%

메모리 사용량

100MB

색상 표시 - 파랑: 문제 발생률 60% 미만 - 주황: 문제 발생률 80% 미만 - 빨강: 문제 발생률 80% 이상

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

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

성능 지표

산출 구간

산출 값

크래

6시간

크래시 발생 수

서비스 별 요약 지표를 통해 여러 앱을 관리하는 관리자가 전반적인 성능을 빠르게 파악할 수 있습니다. 앱 버전 우선순위에 대한 자세한 내용은 'MPM 사용하기 > 프로젝트 리스트 > 전체 프로젝트 관리 > 앱 버전 관리'를 참고하세요.

4. 프로젝트 생성 (Standard 이상)

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

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

생성 및 키 발급

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

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

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

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

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

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

프로젝트 키를 앱에 삽입 후 앱을 실행하고 프로젝트 리스트 페이지를 새로고침 해주세요.

[AOS] 패키지 이름 확인 (application id)

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

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

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

[iOS] 패키지 이름 확인 (Bundle id)

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

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

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

패키지 이름 수정

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

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

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

프로젝트 카드

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

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

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

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

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

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

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