Анализируйте проблемы Firebase Crashlytics и Android Vitals с помощью App Quality Insights.

В Android Studio вы можете просматривать и обрабатывать данные о сбоях приложений из Firebase Crashlytics и Android Vitals . Эта интеграция переносит данные трассировки стека и статистику сбоев из Crashlytics и Google Play в окно инструментов App Quality Insights в среде разработки Studio, поэтому вам не нужно переключаться между браузером и IDE. Команды разработчиков могут воспользоваться ключевыми возможностями, включая следующие:

  • В вашем коде будут выделены строки, содержащие данные о связанных событиях Crashlytics.
  • Чтобы просмотреть трассировку стека и выявить основные причины сбоев, щелкните по ней, чтобы перейти к соответствующим строкам в вашем коде.
  • См. сводную статистику по наиболее распространенным сбоям и некритическим событиям, например, сгруппированную по производителю устройства и версии Android.
  • Фильтруйте события по таким атрибутам, как уровень серьезности, время и версия приложения.
  • Получите ссылку в браузере, которая откроет страницу панели управления Crashlytics с более подробной информацией о событии.
  • Получите ценные сведения, которые помогут вам легче понять и устранить первопричины определенных проблем.

Отчеты Android Vitals доступны для всех приложений, опубликованных в Google Play. Если вы еще не используете Crashlytics и хотите узнать больше о его возможностях, см. Firebase Crashlytics .

Начать

Чтобы просмотреть данные Crashlytics в Android Studio, необходимо настроить Firebase и Crashlytics в вашем проекте приложения. Вот как это сделать: откройте Firebase Assistant в Android Studio, перейдя в меню Инструменты > Firebase , нажмите Crashlytics , а затем следуйте инструкциям, чтобы добавить Firebase и Crashlytics в ваш проект. Подробнее о работе с Firebase Assistant можно прочитать в руководстве Firebase по началу работы с Android .

Если вы уже добавили Firebase и Crashlytics в свое приложение, войдите в свою учетную запись разработчика в IDE, нажав на значок аватара. После входа в систему откройте окно инструментов «Анализ качества приложений» . Вы должны увидеть, как на панелях появляются отчеты от Crashlytics.

Анализ основных параметров Android

App Quality Insights включает в себя данные о ключевых показателях Android . Это позволяет вам проще получать доступ к основным метрикам, собираемым Google Play, и улучшать пользовательский опыт. Используйте данные о ключевых показателях Android для решения проблем, связанных со стабильностью приложения, чтобы улучшить его качество в Google Play.

Важнейшие данные Android в Android Studio.

В окне инструмента «Аналитика качества приложений» вы можете просматривать критически важные проблемы Android, фильтровать их и переходить от трассировки стека к коду. Для начала выполните следующие шаги:

  1. Войдите в свою учетную запись разработчика в Android Studio, используя значок профиля. в конце панели инструментов.
  2. Откройте App Quality Insights , щелкнув окно инструментов в Android Studio или выбрав View > Tool Windows > App Quality Insights .
  3. В разделе «Аналитика качества приложений» перейдите во вкладку «Основные показатели Android» .
  4. Необязательно: чтобы использовать интеграцию с системой контроля версий для отладочной сборки, добавьте последнюю версию Firebase Crashlytics SDK (или Firebase Android Bill of Materials) в ваше приложение. Затем добавьте следующий код в файл build.gradle.kts или build.gradle на уровне модуля. В релизных (не отладочных) сборках этот флаг включен по умолчанию.

Котлин

android {
  buildTypes {
    getByName("debug") {
      vcsInfo {
        include = true
      }
    }
  }
}

Классный

android {
  buildTypes {
    debug {
      vcsInfo {
        include true
      }
    }
  }
}

В окне инструментов «Аналитика качества приложений» содержится обширная информация, позволяющая понять, с какими событиями сталкиваются пользователи, а также ссылки, помогающие быстро найти источники этих событий.

Окно инструментов «Аналитика качества приложений»

  1. Используйте выпадающее меню «Идентификатор приложения», чтобы выбрать идентификатор приложения, которое вы хотите проанализировать. Например, работая над отладочной версией приложения в IDE, вы можете захотеть просмотреть данные о событиях для рабочей версии приложения, которую устанавливают ваши пользователи.
  2. На панели «Проблемы» отображаются наиболее важные события, по которым у Crashlytics есть данные, и они отсортированы по степени значимости ваших сбоев.
  3. Просматривайте события по вариантам , или группам событий со схожими трассировками стека. Анализ событий по вариантам помогает определить первопричины сбоя.
  4. Вкладка «Трассировка стека» отображает подробную информацию о последнем возникновении события, на которое вы нажали на панели «Проблемы» . Вы можете просмотреть трассировку стека события и, щелкнув по ней, перейти к соответствующим строкам в вашем коде. Если ваш код изменился с момента сбоя, нажмите «Показать разницу» рядом с ошибкой в ​​трассировке стека, чтобы увидеть разницу между вашим текущим кодом и версией кода, которая вызвала сбой.

    Возможность отображения различий в трассировке стека AQI.

    Также отображается информация о типе затронутого устройства, его версии Android и времени возникновения события, а также ссылка на событие на панели мониторинга Firebase Crashlytics. Для просмотра информации по нескольким событиям в группе используйте стрелки влево и вправо. Нажмите «Закрыть проблему» , чтобы закрыть проблему непосредственно с панели.

  5. На вкладках «Ключи» и «Журналы» отображаются пользовательские пары ключ-значение и записи в журналах для каждого отчета Crashlytics.
  6. В панели «Подробности» отображается информация о количестве сбоев по типу устройства и версии Android, что позволяет определить, какие группы пользователей пострадали больше всего. Также показано, какие версии приложений вызвали сбой и сколько пользователей было затронуто.
  7. Читайте и добавляйте заметки к задачам, чтобы они были видны в консоли Firebase и вашим коллегам. Чтобы написать заметку к задаче, выберите задачу и откройте панель «Заметки» . Для написания заметок у вас должны быть права на запись в проект Crashlytics. Задачи с заметками отображаются со значком «Заметки». в разделе «Проблемы» .
    Панель «Заметки по анализу качества приложений».
  8. Используйте различные фильтры, чтобы сузить круг поиска до определенных подмножеств событий. Вы можете выбрать или отменить выбор событий, имеющих критический характер. Несмертельный и ANRs а также фильтрация по времени, версии приложения, данным Crashlytics Signal , марке и модели устройства и версии платформы Android. Обратите внимание, что для данных Crashlytics Signal проблема считается регрессированной , если она была закрыта ранее и снова возникла в новой версии приложения.

Помимо возможности перехода от трассировки стека к коду, теперь можно также переходить от кода к трассировке стека: Android Studio теперь помечает строки кода, связанные со сбоями, значком ошибки на боковой панели. Таким образом, вы сможете легко их обнаружить и устранить.

При наведении курсора на значок сбоя появляется всплывающее окно, в котором отображается количество событий, связанных с этой строкой кода, и частота возникновения этих событий.

Сводка событий отображается при наведении курсора на значок сбоя.

Нажмите на значок сбоя, чтобы просмотреть более подробный список событий, включая частоту и количество пользователей, затронутых данным событием. Нажмите на конкретное событие, чтобы перейти к его подробной информации в окне инструментов «Аналитика качества приложений» .

Список событий при нажатии на значок сбоя

Различия в показаниях между Android Vitals и Crashlytics.

Обратите внимание, что Android Vitals и Crashlytics могут сообщать разные значения количества пользователей и событий, связанных с одним и тем же сбоем. Эти расхождения возникают потому, что Play и Crashlytics могут фиксировать сбои в разное время и для разных пользователей. Вот несколько причин, по которым подсчеты в Play и Crashlytics могут отличаться:

  • Play отслеживает сбои, начиная с момента загрузки системы, тогда как Crashlytics отслеживает сбои, происходящие после инициализации SDK Crashlytics.
  • Если пользователь отказывается от отправки отчетов о сбоях при покупке нового телефона, эти сбои не сообщаются в Play Store; однако Crashlytics отслеживает сбои на основе собственной политики конфиденциальности приложения.

Проведение исследования с ограниченными функциями в автономном режиме.

Если вы отправляете новый запрос, например, нажав кнопку «Обновить» , и Android Studio не может связаться с Crashlytics, в окне «Аналитика качества приложений» вы можете перейти в автономный режим .

App Quality Insights предлагает автономный режим.

В этом режиме вы можете продолжать исследовать проблемы и последние события на основе кэшированных данных. Некоторые функции, такие как изменение некоторых параметров фильтра или закрытие проблем, недоступны. Чтобы повторить попытку подключения к Crashlytics и вернуться в онлайн-режим, нажмите «Повторное подключение». .

Разрешения

См. права доступа к сервису .