Сбои
- Общие фильтры: Период, Версии, Тип, Окружение, Компонент;
- График «Аудитория»;
- График «Тренды»;
- Настройки графиков;
- Фильтры и поиск событий;
- Отчёты о событиях;
- Крэш-варианты;
Раздел Сбои предоставляет сводную информацию о состоянии приложения и устройствах. Здесь можно удобно отслеживать появление новых сбоев, их распределение по версиям и прочим параметрам, а также оценивать влияние сбоев на пользователей в реальном времени.
Общие фильтры: Период, Версии, Тип, Окружение, Компонент
Период
Позволяет указать промежуток времени, за который требуется отобразить сбои приложения. Вы можете как выбрать стандартное значение: 1 час, 24 часа и т. д., так и указать более специфичный промежуток в календаре – чтобы отметить границы промежутка, достаточно кликнуть на интересующие даты.
Вы можете регулировать промежуток вплоть до указания конкретного значения времени в полях ввода – календарь поддерживает промежутки до 1 минуты.
ВАЖНО! Tracer хранит значения за последний 90 дней – указать промежуток больше не получится.
Версии
В фильтре отображены все версии вашего приложения, которые генерируют сбои, и количество сбоев по версии. Данные сгрупп ированны по versionName – по клику на версию в списке вам отобразятся все версии внутри группы с различным versionCode.
Значения списка версий и количество сбоев может отличаться в зависимости от выбранного периода и типа сбоев.
ВАЖНО! Если в вашем приложении вы указываете параметр «component», существующие значения версий будут сгруппированы и доступны внутри фильтра Компонент.
Тип
Указывает на тип зафиксированной ошибки и включает в себя как стандартные типы событий, так и кастомные severity, указанные пользователем.
Severity – это уровень логирования (серьезности) ошибки, который используется для классификации ошибок и прочих событий в вашем приложении. Подробнее об использовании читайте в документации к SDK вашей платформы.
Стандартные типы событий:
| Тип | Платформа | Значение |
|---|---|---|
CRASH | iOS, Android, JS, Aurora | Критический сбой, который спровоцировал аварийное завершение работы приложения. |
ANR | Android | Блокировки основного потока приложения. |
NON_FATAL | iOS, Android, JS, Aurora | Некритические сбои (asserts) в работе приложения, зафиксированные SDK или без конкретного severity. |
NATIVE | Android, Aurora | Ошибки, возникшие в нативном коде. |
MEMORY_LEAK | Android | Ошибки памяти. |
METRIC_KIT | iOS | Метрики производительности. |
Существующие уровни Severity:
| Уровень | Описание |
|---|---|
FATAL | Критическая ошибка, которая привела к остановке работы приложения. Учитывается при расчёте crash-free. |
ALERT | Предупреждение о потенциальной проблеме, которая требует вмешательства. |
CRITICAL | Критическая ошибка, которая может привести к серьезным проблемам, но не обязательно к остановке приложения. |
ERROR | Ошибка, которая при вела к неправильной работе приложения, но не остановила его работу. |
WARNING | Предупреждение о потенциальных проблемах или отклонениях от нормальной работы приложения. |
NOTICE | События, которые требуют внимания, но не обязательно указывают на проблему. |
INFO | Общая информация о работе системы. |
DEBUG | Отладочная информация. |
Окружение
Указывает на окружение, на котором был зафиксирован сбой (например, prod/test или release/debug). В дальнейшем этот параметр будет влиять на значение crash-free.
ВАЖНО! На данный момент фильтр доступен только для Android-приложений. Поддержка «Окружения» для остальных платформ в процессе – ожидайте обновлений!
Компонент
Указывает на компонент вашего приложения, в котором зафиксирован сбой. Сбои, зафиксированные внутри компонента, выделяются в отдельную группу. Версии приложения также будут сгруппированы по компоненту.
Рекомендуем указывать параметр «Компонент», если ваш проект состоит из множества самостоятельных блоков (например, страница с множеством микро-приложений). Подробнее о применении читайте в документации к Tracer SDK вашей платформы.
График «Аудитория»
График отображает изменения в количестве устройств, на которых не было зафиксировано сбоев за выбранный период, и в общем количестве активных устройств с вашим приложением.
| Показатель | Обозначение |
|---|---|
| Crash-free | Показывает процент безошибочных сессий за выбранный период. Рассчитывается по формуле:(1 - (Пользователи со сбоем / Все пользователи)) * 100%Этот график полезен для мониторинга стабильности приложения. |
| Активные устройства | Показывает общее количество активных устройств, использующих приложение, за выбранный период времени. |
Для отображения данных на этом графике необходимо включить опцию мониторинга се ссий через Tracer SDK для вашей платформы – crash-free. Подробнее о подключении опции читайте в документации к Tracer SDK для вашей мобильной платформы (глава Crash и ANR).
График «Тренды»
Отображает изменения в общем количестве сбоев за выбранный период. Данные можно сгруппировать и увидеть распределение событий по конкретному признаку – например, по модели устройства. Воспользоваться фичей можно, нажав Группировка в настройках в правом верхнем углу графика и выбрав интересующую категорию – на графике отобразятся 3, 5 или 7 топовых значений (на ваше усмотрение). Подробнее о существующих опциях настроек читайте далее.
Настройки графиков
Вы можете модифицировать отображение графиков, воспользовавшись рядом настроек:
| Опция | Назначение | Графики |
|---|---|---|
| Интервал | Частота или размер шкалы графика. С помощью настройки вы можете отрегулировать количество значений, которое отобразится за выбранный период. | Аудитория, Тренды |
| Автообновление | При выборе опции данные графика будут обновляться в реальном времени каждую минуту. Опция доступа только при выборе стандартных значений периода. | Аудитория, Тренды |
| Исключить muted | При включении опции значение crash-free и данные графика будут расчитаны без учёта muted-крэшей. | Аудитория |
| Группировка | При включении опции вы можете выбрать параметр из существующих свойств (фильтр Данные), по которому будет выполнена группировка значений графика. По умолчанию модифицированный график будет отображаться с накоплением (aka составные), если не выбрано обратное. | Тренды |
| Группировка – топ 3 | Влияет на количество значений параметра группировки, которое будет отображено на графике (для каждого будет отрисована собственная кривая). Значения, не попавшие в топ, объединяются в категорию «Другие» | Тренды |
| Без накопления | Выключает отображение с накоплением для сгруппированных графиков. | Тренды |
| Предыдущий период | Позволяет отобразить на графике значения за равнозначный предыдущий период. Например, при выборе периоде «Последний час» вы увидите значения за текущий и предыдущий час. | Тренды |
Группировка графиков
Сгруппированные графики отображаются как составные – каждая новая линия строится относительно предыдущей, а верхний край графика отражает общее значение. Таким образом можно сравнивать относительный вклад значений в пределах выбранной категории.
Фильтры и поиск событий
| Фильтр | Описание |
|---|---|
| Статус | Фильтрация по статусам событий:Fixed – ошибка исправлена в новых версиях.Not Fixed – ошибка не исправлена в новых версиях.Regressed – исправленная ошибка, снова зафиксированная в новых версиях.Not Regressed – ошибки, не отмеченные регрессом.Muted – ошибки, для которых отключены оповещения.Not Muted – ошибки, для которых не выключены оповещения. |
| Новые события | Фильтр для отображения событий, которые появились недавно: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 определил крэш-вари ант, в таблице отчётов на странице Сбои появится указание на количество существующих вариантов события. Здесь же можно посмотреть и сравнить стектрейсы выявленных вариантов – для этого раскройте строку таблицы по клику на стрелку:
