A freeze can be a startup freeze or an Application Not Responding (ANR) freeze. When a freeze occurs, the client uploads the freeze information in real time. This information appears in the console after a delay of a few seconds to a few minutes.
Freeze type | Android | iOS |
Startup freeze | The app fails to leave the welcome page and enter the home page within 30 seconds of startup. | The main thread fails to execute a method within 15 seconds (30 seconds for iPhone 6 and earlier models) during app startup. |
ANR freeze | A system ANR freeze. For more information, see ANR on the official Android website. | The main thread fails to execute a method within 10 seconds (20 seconds for iPhone 6 and earlier models) during app runtime. |
Before viewing freeze reports, make sure you have integrated the client SDK and completed instrumentation. For more information, see Integrate an Android client and Integrate an iOS client.
Freeze reports show the total number of freezes, the freeze rate, and the number of affected devices. You can also view detailed information categorized by startup freezes and ANR freezes.
To view freeze reports, perform the following steps:
Log on to the console, click Products & Services > Mobile PaaS, and select an application.
In the navigation pane on the left, click Mobile Analysis > App Performance Analytics > Freeze Report.
Click the Add Filter Condition button in the upper-right corner of the page. Then, select a platform, version, and date range to view the corresponding freeze statistics.
Freeze overview
This section displays per-minute data for startup and ANR freezes in a line chart.
Metric | Startup freeze | ANR freeze |
Freeze count | The number of app startup freezes on the current day. | The number of app ANR freezes on the current day. |
Freeze rate | The number of app startup freezes / The number of app startups. | The number of app ANR freezes / The number of app startups. |
Affected devices | The total number of startup freezes that occurred within the specified time. The count is deduplicated by device ID. | The total number of ANR freezes that occurred within the specified time. The count is deduplicated by device ID. |
Detailed data for startup/ANR freezes
This area displays data for Startup Freeze and ANR Freeze for the selected date, with logs classified by the cause of the freeze.
Freeze Count: The total number of freezes for a specific freeze type, which is the number of freeze logs.
Account Count: The number of unique user IDs for a specific freeze type, based on the userID field in the logs. If the userID field in the log is empty, the value is 1 by default.
Device Count: The number of unique device IDs for a specific freeze type, based on the device ID field in the logs. If the device ID field in the log is empty, the value is 1 by default.
Version: The version number recorded in the freeze log.
Details: The freeze call stack recorded in the freeze log.
For Android devices, you can view the related stack information in the freeze report details. The stack information for startup freezes includes the stack content of all current threads to help developers troubleshoot issues.
For iOS devices, the freeze report details only provide stack information for non-startup freezes.
Details for startup/ANR freeze classifications
In the freeze details list, click the Details link in the Operation column to view the fault details for that freeze type. The details include fault group information and fault samples.
Fault Group:
Freeze Count: The total number of freezes for a specific freeze type, which is the number of freeze logs.
Affected Devices: The number of unique devices that experienced this type of freeze, based on the device ID.
NoteIf the device ID is empty or a hyphen (-), the device is not included in the count.
Device Percentage: The number of devices affected by this freeze type divided by the total number of devices that experienced any freeze.
Model: The percentage of freezes for each device model, sorted in descending order by freeze count.
Fault Sample: Displays device and log details for the current sample. You can switch between samples using the < and > buttons.
Device Details: The Device ID, Platform, User ID, Device Model, and Operating System Version for the current sample.
Log Details: The freeze log for the current sample. You can also export this data. For more information about log details, see Freeze instrumentation.