--- metadata: - name: generator content: Diplodoc Platform v5.50.6 alternate: - https://appmetrica.yandex.by/docs/en/mobile-reports/anr.md - https://appmetrica.yandex.by/docs/ru/mobile-reports/anr.md --- > **Documentation Index:** Fetch the complete configuration index at https://appmetrica.yandex.by/docs/ru/llms.txt # ANR ANR (Application Not Responding) — ситуация, при которой на главном потоке задача выполняется длительное время. В это время интерфейс приложения перестает обновляться и реагировать на действия пользователя. В итоге открывается диалоговое окно, предлагающее пользователю подождать или закрыть приложение. С помощью отчета можно определить, в каких случаях ANR случается чаще всего. Используйте эти сведения для подготовки исправлений. Данные в отчете можно отбирать по типу сессии: - только по фоновым сессиям; - без фоновых сессий; - по всем сессиям. Можно сконфигурировать механизм сбора ANR и настроить тайм-ауты: {% list tabs %} - Android 1. [Включите сбор ANR](https://yastatic.net/s3/doc-binary/src/dev/appmetrica/ru/javadoc/io/appmetrica/analytics/AppMetricaConfig.Builder.html#withAnrMonitoring(boolean)). По умолчанию сбор ANR выключен. 1. [Задайте тайм-аут](https://yastatic.net/s3/doc-binary/src/dev/appmetrica/ru/javadoc/io/appmetrica/analytics/AppMetricaConfig.Builder.html#withAnrMonitoringTimeout(int)) — время, которое должен висеть поток, чтобы зафиксировался факт ANR. Значение по умолчанию — 5 секунд, минимальное значение — 5 секунд. {% list tabs group=instructions %} - Java ```java translate=no // Creating an extended library configuration. AppMetricaConfig config = AppMetricaConfig.newConfigBuilder(API_KEY) // Enabling ANR monitoring. Default value is false. .withAnrMonitoring(true) // Override ANR timeout if need. Default value is 5. .withAnrMonitoringTimeout(7) .build(); // Initializing the AppMetrica SDK. AppMetrica.activate(getApplicationContext(), config); ``` - Kotlin ```kotlin translate=no // Creating an extended library configuration. val config = AppMetricaConfig.newConfigBuilder(API_KEY) // Enabling ANR monitoring. Default value is false. .withAnrMonitoring(true) // Override ANR timeout if need. Default value is 5. .withAnrMonitoringTimeout(7) .build() // Initializing the AppMetrica SDK. AppMetrica.activate(applicationContext, config) ``` {% endlist %} - iOS {% list tabs group=instructions %} - Swift ```swift translate=no var configuration = AppMetricaCrashesConfiguration() // Enables detection of situations when the main application thread stops responding (ANR) configuration.applicationNotRespondingDetection = true // Sets the time interval that the watchdog will wait before reporting the ANR status configuration.applicationNotRespondingWatchdogInterval = 4.0 // Sets the frequency with which the watchdog will check the ANR status configuration.applicationNotRespondingPingInterval = 0.1 AppMetricaCrashes.crashes().setConfiguration(configuration) ``` или ```swift translate=no AppMetricaCrashes.crashes().enableANRMonitoring() ``` - Objective-C ```obj-c translate=no AMAAppMetricaCrashesConfiguration *configuration = [[AMAAppMetricaCrashesConfiguration alloc] init]; // Enables detection of situations when the main application thread stops responding (ANR) configuration.applicationNotRespondingDetection = YES; // Sets the time interval that the watchdog will wait before reporting the ANR status configuration.applicationNotRespondingWatchdogInterval = 4.0; // Sets the frequency with which the watchdog will check the ANR status configuration.applicationNotRespondingPingInterval = 0.1; [[AMAAppMetricaCrashes crashes] setConfiguration:configuration]; ``` или ```obj-c translate=no [[AMAAppMetricaCrashes crashes] enableANRMonitoring]; ``` {% endlist %} {% endlist %} ## Период отчета {#period-anr} Отчет можно просмотреть за конкретный день или период времени. Чтобы задать период отчета вручную, используйте кнопку ![с датами](../../_images/button-date.png). Выбранный интервал можно группировать по часам, дням, неделям и месяцам. ## Группировка {#group-anr} Данные для расчета группируются по: - Группе ANR. - Версии приложения. - Устройству. - Версии ОС. - Производителю. ## Показатели {#measure} ![Показатели](../../_images/anr-info-ru.png) Для анализа доступны следующие показатели: - **ANRs** — количество ошибок. - **Устройства** — количество устройств, на которых наблюдалась ошибка хотя бы один раз за выбранный период. - **% от всех устройств** — доля устройств, с которых была отправлена ошибка, от общего числа устройств, запускавших приложение в выбранный период. - **Обнаружен в версии** — версия приложения, в которой ошибка наблюдалась впервые. - **Последнее воспроизведение** — версия приложения, в которой ошибка наблюдалась в последний раз. Чтобы перейти на страницу с информацией о ANR-группе, в правом верхнем углу нажмите на название ANR-группы. ## Символизация ANR {#symbolization-anr} {% note info "" %} Нельзя пересобрать маппинги для предыдущих сборок. Но если есть архивы, сформированные нашим [крэш-плагином](https://appmetrica.yandex.by/docs/ru/sdk/android/analytics/android-crash.md) для предыдущих сборок, то их можно загрузить вручную. {% endnote %} Если mapping или dSYM-файл не был загружен при сборке приложения, в списке групп будет отображаться предупреждение о несимволизированных ANR. ![предупреждение](../../_images/symbolization-anr-ru.png){style="border: solid 1px #cccccc; max-width: 330px;"} Как символизировать ANR: {% list tabs %} - Android ![Android](../../_images/mapping-upload-manual-ru.png){style="border: solid 1px #cccccc; max-width: 800px;"} Чтобы загрузить mapping-файлы: 1. Откройте **Настройки** → **Крэши**. 2. Убедитесь, что загрузка файлов выбрана для ОС Android. 3. Выберите файл для загрузки. Список отсутствующих файлов можно посмотреть на странице **Настройки** → **Крэши** вашего приложения в AppMetrica. - iOS Загрузите [dSYM-файлы на iOS](https://appmetrica.yandex.by/docs/ru/data-collection/upload-dsym.md). Список отсутствующих файлов можно посмотреть на странице **Настройки** → **Крэши** вашего приложения в AppMetrica. {% endlist %} ## Просмотр лога ANR {#show-crash-log-anr} Чтобы просмотреть лог: 1. На странице нажмите на название нужной ANR-группы — откроется отчет по событиям этой группы. Данные будут отображаться по тому же типу сессий, который был выбран в исходном отчете. При желании можно выбрать другой тип сессии. 2. В таблице нажмите кнопку **Посмотреть ANR-лог**. В логе отображается информация об устройстве и ANR. Чтобы посмотреть события, которые предшествовали ANR, из лога можно перейти в карточку профиля. Для этого нажмите кнопку **Посмотреть события сессии**. ## Добавление комментария {#comment-anr} Вы можете оставить комментарий к ANR. Это может быть полезно, если отчет просматривают несколько человек. Например, в комментарии можно указать ссылку на задачу в трекере. Чтобы добавить комментарий, откройте нужную группу и введите текст в поле **Комментарий**. ## Закрытие ANR {#close-anr} Чтобы отфильтровать из отчета исправленные ANR, их можно закрывать. Если после закрытия ANR будет обнаружен в версиях, в которых он ранее не был обнаружен, ANR переоткроется. Чтобы закрыть ANR, откройте нужную группу. В правом верхнем углу в блоке **Статус ANR-группы** установите режим **Закрыт**. ![Статус ANR-группы](../../_images/anr-status-ru.png){style="border: solid 1px #cccccc; max-width: 200px;"} ## Экспорт данных {#export} Описание ANR-лога можно выгрузить в TXT-файл. Для этого откройте нужную ANR-группу, нажмите кнопку **Посмотреть ANR-лог** → **Экспорт**. ## Узнать больше {#learn-more} - [Отладка и исправление ANR на Unity-Android](https://developer.android.com/games/engines/unity/unity-anrs?hl=en) - [Отладка и исправление ANR на Android](https://developer.android.com/topic/performance/anrs/diagnose-and-fix-anrs?hl=en) - [Крэши/ошибки](https://appmetrica.yandex.by/docs/ru/data-collection/about-crashes-and-errors.md) - [Загрузка mapping-файлов и отладочных символов на Android](https://appmetrica.yandex.by/docs/ru/data-collection/upload-mapping.md) - [Загрузка dSYM-файлов на iOS](https://appmetrica.yandex.by/docs/ru/data-collection/upload-dsym.md) Если вы не нашли ответ на свой вопрос, то вы можете задать его через форму обратной связи. Пожалуйста, опишите возникшую проблему как можно подробнее. Если возможно, приложите скриншот. Написать в службу поддержки Предложить улучшение для документации