# 보고서

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

IMQA MPM 보고서는 앱 버전별 측정된 성능 지표에 대한 보고서를 제공합니다. 각 성능 지표별 성능 현황과 병목 현상을 요약하여 일별로 확인할 수 있고 PDF, CSV 형태로 저장하거나 인쇄할 수 있습니다.

![](https://lh5.googleusercontent.com/vMSOI0rSfrLHqkMQr7zQiwVuFvd15eD6v5jOkt5LvBxuP67k8lIeEBwXkqeUekAoFLOla7BbftSPuXu0q8pkriJrdD6n2QtnOJCk3KaIRYfSjGKFVaDrIRFCGu_XEEpdK0hSRK7mbUyB-lBpbujjSI4)

IMQA MPM 보고서는 다음과 같이 구성됩니다.

❶ **조회 날짜/앱 버전**\
❷ **리포트**\
❸ **다운로드/인쇄**

## **2. 조**회 날짜/앱 버전 <a href="#date" id="date"></a>

조회하고자 하는 날짜, 앱 버전을 선택할 수 있습니다. 선택한 기준으로 리포트를 조회합니다.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdzDEoIHX31N2rz4JGwqxO-mpquBMtQIQUQTbQ8F9UNHszv8Te4XLcIla407YmEdkMVBkjUUm5mUWHIfa2t6YFd3n9NEiVMDvbBu50mrOsG51xJZKAfBZQxocXwv-FSIWZRYxogiwyv44n_Z5IzuETbqA_z?key=8C3xMx2Qg8H9O2BlHdriFA" alt=""><figcaption></figcaption></figure>

➀ 조회하고자 하는 조회 날짜를 선택합니다. 기본 ‘오늘 날짜’로 설정되어 있으며 최대 30일 전까지 선택할 수 있습니다.\
➁ 조회하고자 하는 앱 버전을 선택합니다.\
➂ \[적용]을 클릭하면 선택한 기준으로 리포트가 조회됩니다.

## 3. 성능 리포트 <a href="#performance" id="performance"></a>

보고는 성능과 병목 현상 리포트로 구성되어 있습니다. 성능 리포트는 각 성능 지표 구간별 일일 사용자 데이터의 분포를 %로 확인할 수 있습니다. 웹/하이브리드 앱의 경우 ‘웹뷰 화면 로딩시간'이 추가 표시됩니다.

![](https://lh5.googleusercontent.com/mURCMI6-zLxRPyl-y7wcOLoAwe251oqH10v4zrJ2JkZdhfSB2W-nTOhfLN9F-X8CV_-l4NLNRUy9oKW57ydgL_kJ1-8tcQd9l044DuYgMJcCmT65JqkBpQOrY_vMDf_bZ5FWSgGonWxuAf1-BN_6Npk)

❶ **성능 지표**\
성능 지표의 이름과 집계된 데이터 수를 표시합니다.&#x20;

❷ **성능 구간**\
각 성능 지표를 9구간으로 분할하여 표시합니다. 회색으로 표시된 구간은 성능 안정 구간이며, 회색 이외의 구간은 위험한 구간을 의미합니다.

❸ **구간별 비율**\
집계된 데이터의 구간별 비율을 %로 표시합니다.&#x20;

{% hint style="info" %}
성능 지표별 사용자 분포를 통해 몇 %의 사용자가 어느 정도의 성능 문제를 겪는지를 알 수 있습니다. 기준치 구간에 대부분의 사용자가 분포되어 있다면 앱 사용이 원활하다고 판단할 수 있으며, 넓게 분포되어 있다면 앱이 다양한 사용자 환경에 최적화되어 있지 않음을 의미합니다. 앱의 목표 성능을 설정하기 위한 개선 지표로 활용해보세요.
{% endhint %}

## 4. 병목 현상 리포트 <a href="#bottleneck" id="bottleneck"></a>

병목 현상 리포트는 앱 성능 저하 원인을 상세하게 확인할 수 있습니다. 각 성능 지표별 하위 5%의 화면과 사용자 환경, 성능 저하가 있었던 스택 정보를 표시합니다. 웹/하이브리드 앱의 경우 웹뷰 관련 섹션이 추가 표시됩니다.

### 성능 지표별 하위 5% <a href="#bottom5" id="bottom5"></a>

네이티브 화면 로딩시간, CPU 사용량, 메모리 사용량 하위 5%의 화면과 사용자 환경을 확인할 수 있습니다.

![](https://lh4.googleusercontent.com/KJVFim4gm5oR0qTLSzpWEB5IeKtulPEEL1_RhyMf1p-gX3MSYcG4xPtAzfRivqzPzcfZHNF6_i2yczdby306uFIpAWYLh6CJd8LJG2xcHNzUQS33qfHrrSzLqh49WUREnFvUCy7WZRTymVQrGFAL1a0)

❶ **성능 지표**\
성능 지표의 이름과 하위 5% 구간값을 표시합니다.&#x20;

❷ **화면**\
성능 하위 5% 화면 5개와 그 외 비율을 %로 표시합니다.

❸ **OS 버전**\
성능 하위 5% OS 버전 4개와 그 외 비율을 %로 표시합니다.

❹ **디바이스**\
성능 하위 5% 디바이스 4개와 그 외 비율을 %로 표시합니다.

❺ **위치/통신사**<mark style="color:red;">**\***</mark>\
성능 하위 5% 위치/통신사 4개와 그 외 비율을 %로 표시합니다.

{% hint style="warning" %}
최신 iOS 버전의 경우, Apple의 보안정책에 의해 통신사 정보 수집이 불가능합니다. 이 경우 통신사 정보가 표시되지 않거나, ‘Unknown’ 등으로 표시될 수 있습니다.
{% endhint %}

{% hint style="info" %}
성능 지표별 하위 5%를 통해 성능이 저하된 주된 화면, 성능 저하를 경험한 사용자의 환경과 비율을 확인할 수 있습니다. 다양한 환경의 사용자를 위한 파편화 개선 지표로 활용해보세요.
{% endhint %}

### 응답시간 하위 20 URL <a href="#response-time" id="response-time"></a>

일일 사용자 데이터 중 가장 응답시간이 느렸던 URL 20개를 표시합니다. 하위 5% 응답시간 높은 순으로 기본 정렬되며 요청 정보, 하위 5%와 평균값을 확인할 수 있습니다.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXctr07Bgw3P1A46762_27hFqKZCtL9iFVRCHb_TdjM-0jXjnKdmUAiPw9NxBdy3tPWraKzFhmGD8v4fcHvLLTbYpmkPw0ggk5PnE4hWJS6Q2pdqRobq40v3wHBxciZlxoZzv0LZ9UXYqO-rz90tKLxVaXHz?key=8C3xMx2Qg8H9O2BlHdriFA" alt=""><figcaption></figcaption></figure>

❶ **헤더(정렬)**\
기본은 평균 응답시간 높은 순으로 정렬되며 상태, 건 수, 평균, P95(하위 5%)로 정렬할 수 있습니다.

❷ **응답시간 하위 20 URL 항목**\
요청 정보, 하위 5%와 평균값을 표시합니다.

* **메소드**: HTTP 메소드를 표시합니다.
* **호스트**: 호스트 정보를 표시합니다.
* **위치/통신사**<mark style="color:red;">**\***</mark>: 요청을 보낸 사용자 위치/통신사 정보를 표시합니다.

{% hint style="warning" %}
최신 iOS 버전의 경우, Apple의 보안정책에 의해 통신사 정보 수집이 불가능합니다. 이 경우 통신사 정보가 표시되지 않거나, ‘Unknown’ 등으로 표시될 수 있습니다.
{% endhint %}

* **상태:** 응답 코드를 표시합니다.
* **경로**: 요청된 URL을 표시합니다.
* **평균**: 요청된 URL의 전체 응답시간을 평균으로 산출합니다.
* **P95**: 요청된 URL의 하위 5% 응답시간을 평균으로 산출합니다.

{% hint style="info" %}
응답시간 하위 20 URL을 통해 성능이 저하가 있었던 URL, 성능 저하를 경험한 사용자의 환경을 확인할 수 있습니다. 특정 URL 요청의 에러 코드와 응답시간을 확인하고, 성능 개선 지표로 활용해보세요.
{% endhint %}

### 웹뷰 화면 로딩시간 하위 20 <a href="#webview-rendering-time" id="webview-rendering-time"></a>

일일 사용자 데이터 중 가장 화면 로딩시간이 느렸던 웹 페이지 20개를 표시합니다. 하위 5% 화면 로딩시간 높은 순으로 기본 정렬되며 화면 정보, 하위 5%와 평균값을 확인할 수 있습니다.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdkICpLFxU9oRivsc4XqLBGtfiu9j9Zu28THxU50ARvvWHBlNKPBV3-aX8cE8s6A30qTMGobq5GM2A1GZdix3nyU3_XWJab_NPIBAkzu51XbE2iJ37oy2JDMZHFGDvlEs4AMoTfKbU-pZ7RaMLfdezya8u2?key=8C3xMx2Qg8H9O2BlHdriFA" alt=""><figcaption></figcaption></figure>

❶ **헤더(정렬)**\
기본은 평균 화면 로딩시간 높은 순으로 정렬되며 화면, 페이지, 평균, P95(하위 5%)로 정렬할 수 있습니다.

❷ **웹뷰 화면 로딩시간 하위 20 항목**\
페이지 정보, 하위 5%와 평균값을 표시합니다.

* **화면**: 웹 페이지가 속한 네이티브 화면 이름을 표시합니다.
* **페이지**: 웹 페이지  Path를 표시합니다.
* **위치/통신사**<mark style="color:red;">**\***</mark>: 웹 페이지 접속 사용자 위치/통신사 정보를 표시합니다.

{% hint style="warning" %}
최신 iOS 버전의 경우, Apple의 보안정책에 의해 통신사 정보 수집이 불가능합니다. 이 경우 통신사 정보가 표시되지 않거나, ‘Unknown’ 등으로 표시될 수 있습니다.
{% endhint %}

* **건 수**: 해당 데이터의  건 수를 카운트합니다.
* **평균**: 해당 웹 페이지의 전체 화면 로딩시간을 평균으로 산출합니다.
* **P95**: 해당 웹 페이지의 하위 5% 화면 로딩시간을 평균으로 산출합니다.

{% hint style="info" %}
웹뷰 화면 로딩시간 하위 20을 통해 성능이 저하가 있었던 웹 페이지, 성능 저하를 경험한 사용자의 환경을 확인할 수 있습니다. 특정 웹 페이지의 화면 로딩시간을 확인하고, 성능 개선 지표로 활용해보세요.
{% endhint %}

## 5. 다운로드/인쇄 <a href="#download" id="download"></a>

보고서를 PDF, CSV 형태로 저장하거나 인쇄할 수 있습니다.

<img src="https://lh6.googleusercontent.com/rea0HAv-sRy83IQdKtBNSuBPRyJkSEznGDdqCpggjj77OX2BseBsBQ4Y6AA7vXlVSHn3bAJ5kAAMt6ctsi4c0C7HsN5Uz8Ed_5MSJ4_33MhGDTEiCiOunzNzuBfMcIzsG2pbD4arMlBMbYurHoG4c3k" alt="" width="375">

1. \[PDF 다운로드]를 클릭하면 ‘\[IMQA\_REPORT]프로젝트이름\_Ver.앱버전\_조회날짜.pdf’ 파일을 ‘Download’ 폴더에 저장합니다.
2. \[CSV 다운로드]를 클릭하면 ‘\[IMQA\_REPORT]프로젝트이름\_Ver.앱버전\_조회날짜.xlsx’ 파일을 ‘Download’ 폴더에 저장합니다.
3. \[인쇄]를 클릭하면 보고서 양식을 유지하여 ‘인쇄 미리보기 다이얼로그’를 표시합니다.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.imqa.io/imqa-guide/user-guide/mpm/report.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
