Сбои
- Общие фильтры: Период, Версии, Тип;
- График «Аудитория»;
- График «Тренды»;
- Настройки графиков;
- Фильтры и поиск событий;
- Отчёты о событиях;
- Крэш-варианты;
Раздел Сбои предоставляет сводную информацию о состоянии приложения и устройствах. Здесь можно удобно отслеживать появление новых сбоев, их распределение по версиям и прочим параметрам, а также оценивать влияние сбоев на пользователей в реальном времени.
Общие фильтры: Период, Версии, Тип
Период
Позволяет указать промежуток времени, за который требуется отобразить сбои приложения. Вы можете как выбрать стандартное значение: 1 час, 24 часа и т. д., так и указать более специфичный промежуток в календаре – чтобы отметить границы промежутка, достаточно кликнуть на интересующи е даты.
Вы можете регулировать промежуток вплоть до указания конкретного значения времени в полях ввода – календарь поддерживает промежутки до 1 минуты.
ВАЖНО! Tracer хранит значения за последний 90 дней – указать промежуток больше не получится.
Версии
В фильтре отображены все версии вашего приложения, которые генерируют сбои, и количество сбоев по версии. Данные сгруппированны по versionName – по клику на версию в списке вам отобразятся все версии внутри группы с различным versionCode.
Значения списка версий и количество сбоев может отличаться в зависимости от выбранного периода и типа сбоев.
Тип
Указывает на тип зафиксированной ошибки. В Tracer поддержаны следующие типы:
| Тип | Платформа | Значение |
|---|---|---|
CRASH | iOS, Android | Критический сбой в работе приложения. |
ANR | Android | Блокировки основного потока приложения. |
NON_FATAL | iOS, Android | Некритические сбои (asserts) в работе приложения. |
NATIVE | Android | Ошибки, возникшие в нативном коде. |
MEMORY_LEAK | Android | Ошибки памяти. |
METRIC_KIT | iOS | Метрики производительности. |
График «Аудитория»
График отображает изменения в количестве устройств, на которых не было зафиксировано сбоев за выбранный период, и в общем количестве активных устройств с вашим приложением.
| Показатель | Обозначение |
|---|---|
| Crash-free | Показывает процент безошибочных сессий за выбранный период. Рассчитывается по формуле:(1 - (Пользователи со сбоем / Все пользователи)) * 100%Этот график полезен для мониторинга стабильности приложения. |
| Активные устройства | Показывает общее количество активных устройств, использующих приложение, за выбранный период времени. |
Для отображения данных на этом графике необходимо включить опцию мониторинга сессий через Tracer SDK для вашей платформы – crash-free. Подробнее о подключении опции читайте в документации к Tracer SDK для вашей мобильной платформы (глава Crash и ANR).
График «Тренды»
Отображает изменения в общем количестве сбоев за выбранный период. Данные можно сгруппировать и увидеть распределение событий по конкретному признаку – например, по модели устройства. Воспользоваться фичей можно, нажав Группировка в настройках в правом верхнем углу графика и выбрав интересующую категорию – на графике отобразятся 3, 5 или 7 топовых значений (на ваше усмотрение). Подробнее о существующих опциях настроек читайте далее.
Настройки графиков
Вы можете модифицировать отображение графиков, воспользовавшись рядом настроек:
| Опция | Назначение | Графики |
|---|---|---|
| Интервал | Частота или размер шкалы графика. С помощью настройки вы можете отрегулировать количество значений, которое отобразится за выбранный период. | Аудитория, Тренды |
| Автообновление | При выборе опции данные графика будут обновляться в реальном времени каждую минуту. Опция доступа только при выборе стандартных значений периода. | Аудитория, Тренды |
| Группировка | При включении опции вы можете выбрать параметр из существующих свойств (фильтр Данные), по которому будет выполнена группировка значений графика. По умолчанию модифицированный график будет отображаться с накоплением (aka составные), если не выбрано обратное. | Тренды |
| Группировка – топ 3 | Влияет на количество значений параметра группировки, которое будет отображено на графике (для каждого будет отрисована собственная кривая). Значения, не попавшие в топ, о бъединяются в категорию «Другие» | Тренды |
| Без накопления | Выключает отображение с накоплением для сгруппированных графиков. | Тренды |
| Предыдущий период | Позволяет отобразить на графике значения за равнозначный предыдущий период. Например, при выборе периоде «Последний час» вы увидите значения за текущий и предыдущий час. | Тренды |
Группировка графиков
Сгруппированные графики отображаются как составные – каждая новая линия строится относительно предыдущей, а верхний край графика отражает общее значение. Таким образом можно сравнивать относительный вклад значений в пределах выбранной категории.
Фильтры и поиск событий
| Фильтр | Описание |
|---|---|
| Статус | Фильтрация по статусам событий:Fixed – ошибка исправлена в новых версиях.Not Fixed – ошибка не исправлена в новых версиях.Regressed – исправленная ошибка, снова зафиксированная в новых версиях.Not Regressed – ошибки, не отмеченные регрессом. |
| Новые события | Фильтр для отображения событий, которые появились недавно:7d – за последнюю неделю.3d – за последние 3 дня.24h – за последние сутки.6h – за последние 6 часов.1h – за последний час. |
| Устройства | Фильтрация по типу устройства, на котором произошли сбои. Возможно указать как конкретную модель, так конкретного производителя. Например, Google Pixel 7. |
| SDK/OS | Используемая версия ОС устройства. |
| IssueKey | Специальный ключ, используемый для группировки некритических (NON-FATAL) сбоев приложения. Подробнее читайте далее. |
| В фоне | Фильтрация событий, произошедших, когда приложение находилось в фоновом режиме или наоборот. |
| Данные и Ключи | Дополнительные параметры. Определяются в вашем приложении при помощи SDK соответствующими методами. Подробнее читайте в документации к SDK вашей платформы. |
| Сравнение | Фильтр позволяет указать два ключа, по которым будет произведено сравнение событий за выбранный период. Удобно использовать для проведения A/B экспериментов – сравнить, как меняется количество крэшей в зависимости от тестовой группы. |
userId
Tracer SDK также позволяет установить userId – уникальный идентификатор конкретного пользователя вашего приложения в удобном вам формате. Вы можете осуществить поиск событий по этому параметру, чтобы увидеть сбои в приложении конкретного пользователя за выбранный период:
IssueKey
По умолчанию все сбои группируются по общим частям стектрейса, но в случае non-fatal'ов такая группировка является на самой эффективной. Дело в том, что не всегда стектрейс и место, в котором залогировали ошибку, связаны между собой. Чтобы избежать замусоривания сбоев большим количеством non-fatal'ов существует способ повлиять на эту группировку и собрать все non-fatal'ы одного вида ошибки в одну группу при помощи спе циального ключа issueKey. Этот параметр также будет отображаться в названии события.
Преимущество issueKey в том, что не только вы сможете легко найти non-fatal'ы, относящиеся к конкретной проблеме, но и другие разработчики смогут легко найти по ключу точку логирования этой ошибки (и удалить при необходимости) и отследить его в вашем issue-трекере.
Подробнее об использовании issueKey ищите в главе о сбоях или non-fatal'ах в разделе документации SDK к вашей платформе.
Отчёты о событиях
Внизу раздела отображаются детализированные отчёты о сбоях, сгруппированных по стектрейсу. Каждая запись содержит:
- Краткое описание проблемы: название, сообщение, стектрейс, комментарий и т. д..
- Диапазон версий, в которых наблюдается проблема.
- Тип события (например,
CRASH). - Общее количество сбоев.
- Количество устройств, на которых произошел сбой.
По клику на строку таблицы вы попадёте на страницу описания события. Здесь находится график по событиям группы за выбранный период и сводка о распределении событий по устройствам, ОС и состоянии приложения на момент сбоя:
А также информация о каждом событии из группы:
- Стектрейс события, разделенный по потокам.
- Пользовательские ключи.
- Пользовательские логи.
- Метаинформация о событии (раздел Данные).
Крэш-варианты
По умолчанию все сбои группируются по стектрейсу (подробнее о группировке), однако эта опция позволяет просмотреть варианты одного и того же события, отличающиеся частями стектрейса, влияющими на контекст возникновения сбоя. Например, вызов дополнительных методов в процессе выполнения кода или различие в Application Specific Information.
Группировка по крэш-вариантам выполняется внутри группы сбоев – каждому варианту присваивается собственный id. Список существующих вариантов события можно найти по кнопке «Варианты» на странице отчёта по сбою:
При выборе конкретного варианта вы увидите сбои, относящиеся к этой конкретной группе крэш-вариантов.
Если при обработке события Tracer определил крэш-вариант, в таблице отчётов на странице Сбои появится указание на количество существующих вариантов события. Здесь же можно посмотреть и сравнить стектрейсы выявленных вариантов – для этого раскройте строку таблицы по клику на стрелку:
