Сбои
- Общие фильтры: Период, Версии, Тип, Окружение, Компонент;
- Расширенные фильтры и поиск событий;
- График «Аудитория»;
- Статистика по данным;
- График «Тренды»;
- Настройки графиков;
- Сравнение и AB-эксперименты;
- Отчёты о событиях;
- Крэш-варианты;
- Как поделиться ошибкой;
Раздел Сбои предоставляет сводную информацию о состоянии приложения и устройствах. Здесь можно удобно отслеживать появление новых сбоев, их распределение по версиям и прочим параметрам, а также оценивать влияние сбоев на пользователей в реальном времени.
Общие фильтры: Период, Версии, Тип, Окружение, Компонент
Период
Позволяет указать промежуток времени, за который требуется отобразить сбои приложения. Вы можете как выбрать стандартное значение: 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-, JS- и iOS-приложений. Поддержка «Окружения» для остальных платформ в процессе – ожидайте обновлений!
Компонент
Указывает на компонент вашего приложения, в котором зафиксирован сбой. Сбои, зафиксированные внутри компонента, выделяются в отдельную группу. Версии приложения также будут сгруппированы по компоненту.
Рекомендуем указывать параметр «Ком понент», если ваш проект состоит из множества самостоятельных блоков (например, страница с множеством микро-приложений). Подробнее о применении читайте в документации к Tracer SDK вашей платформы.
Расширенные фильтры и поиск событий
| Фильтр | Описание |
|---|---|
| Статус | Фильтрация по статусам событий: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-free | Показывает процент безошибочных сессий за выбранный период. Рассчитывается по формуле:(1 - (Пользователи со сбоем / Все пользователи)) * 100%Этот график полезен для мониторинга стабильности приложения. |
| Активные устройства | Показывает общее количество активных устройств, использующих приложение, за выбранный период времени. |
Для отображения данных на этом графике необходимо включить опцию мониторинга сессий через Tracer SDK для вашей платформы – crash-free. Подробнее о подключении опции читайте в документации к Tracer SDK для вашей мобильной платформы (глава Crash и ANR).
Статистика по данным
⚠️ На данный момент виджет доступен только для Android-, JS- и iOS-проектов
Виджет предоставляет срез данных по ключевым атрибутам приложения, в котором зафиксированы сбои. Он позволяет быстрее выявлять аномалии, связанные с определенёнными устройствами, ОС и т. д.. В верхней части виджета перечислены активные параметры фильтрации:
| Тип проекта | Фильтры |
|---|---|
| Android | manufacturer, installer, osVersionSDKInt |
| iOS | manufacturer, OS, inBackground |
| JS | Браузер, ОС |
Чтобы отобразить виджет, выберите опцию «Статистика по данным» в дропдауне в левом верхнем углу графика «Аудитория»:
Для каждого значения фильтра вы можете отобразить список подзначений:
По клику на самое значение вы можете автоматически применить его как фильтр для поиска событий.
График «Тренды»
Отображает изменения в общем количестве сбоев за выбранный период. Данные можно сгруппировать и увидеть распределение событий по конкретному признаку – например, по модели устройства. Воспользоваться фичей можно, нажав Группировка в настройках в правом верхнем углу графика и выбрав интересующую категорию – на графике отобразятся 3, 5 или 7 топовых значений (на ваше усмотрение). Подробнее о существующих опциях настроек читайте далее.
Настройки графиков
Вы можете модифицировать отображение графиков, воспользовавшись рядом настроек:
| Опция | Назначение | Графики |
|---|---|---|
| Интервал | Частота или размер шкалы графика. С помощью настройки вы можете отрегулировать количество значений, которое отобразится за выбранный период. | Аудитория, Тренды |
| Автообновление | При выборе опции данные графика будут обновляться в реальном времени каждую минуту. Опция доступа только при выборе стандартных значений периода. | Аудитория, Тренды |
| Исключить muted | При включении опции значение crash-free и данные графика будут расчитаны без учёта muted-крэшей. | Аудитория |
| Группировка | При включении опции вы можете выбрать параметр из существующих свойств (фильтр Данные), по которому будет выполнена группировка значений графика. По умолчанию модифицированный график будет отображаться с накоплением (aka составные), если не выбрано обратное. | Тренды |
| Группировка – топ 3 | Влияет на количество значений параметра группировки, которое будет отображено на графике (для каждого будет отрисована собственная кривая). Значения, не попавшие в топ, объединяются в категорию «Другие» | Тренды |
| Без накопления | Выключает отображение с накоплением для сгруппированных графиков. | Тренды |
| Предыдущий период | Позволяет отобразить на графике значения за равнозначный предыдущий период. Например, при выборе периоде «Последний час» вы увидите значения за текущий и предыдущий час. | Тренды |
Группировка графиков
Сгруппированные графики отображаются как составные – каждая новая линия строится относительно предыдущей, а верхний край графика отражает общее значение. Таким образом можно сравнивать относительный вклад значений в пределах выбранной категории.
Сравнение и AB-эксперименты
Фича «Сравнение» помогает понять, где ухудшается поведение приложения: после выката фичи, в одной из сборок, или в разных конфигур ациях – Tracer покажет наглядную разницу в крэшах, ANR или любых других событиях.
Каждое событие, попавшее в сервис, может содержать набор пользовательских ключей, например, feature_flag, user_bucket и любые другие. Каждый из ключей может иметь несколько значений, например, feature_flag=enabled/disabled.
Сравнение в Tracer устроено в A/B-формате — вы выбираете две группы событий, определяя их через наборы фильтров. Эти фильтры могут быть как значениями одного и того же ключа, так и разными значениями разных ключей. Единственное ограничение: сравниваются все две фиксированные группы – А и Б.
После того, как вы выберете группы для сравнения:
- График «Тренды» отобразит две кривые — по каждой группе, A и B, что позволяет сравнить частоту событий по времени: когда и насколько начали расходиться показатели. Это помогает оперативно заметить рост ошибок или всплески активности.
- Таблица «Отчёты» — еще одна точка анализа: по каждому событию вы увидите разницу в количестве событий и затрон утых устройств (наведите курсор для отображения точных данных по А и Б). Всё ключевое — выделено цветом.
Примеры использования
-
Сравнение по значениям одного ключа – А/В эксперимент по фиче, окружению, модели и т. д.. Например, A/B-тест новых рекомендаций в ленте с целью проверить, не вносит ли новая модель нестабильность. А и В в данном случае указывают на выбранную модель.
-
Сравнение по значениями разных ключей – сравнение между окружением и типами сборок, эксперименту и сегменту аудитории, фиче и региону и т. д.. Например, поведение нового функционала комментариев при старой модели рекомендаций. А и В в данном случае указывает на включенный новый UI комментариев и выбранную модель рекомендаций.
Отчёты о событиях
Внизу раздела отображаются детализированные отчёты о сбоях, сгруппированных по стектрейсу. Каждая запись содержит:
- Краткое описание проблемы: название, сообщение, стектрейс, комментарий и т. д..
- Диапазон версий, в которых наблюдается проблема.
- Тип события (например,
CRASH). - Общее количество сбоев.
- Количество устройств, на которых произошел сбой.
По клику на строку таблицы вы попадёте на страницу описания события. Здесь находится график по событиям группы за выбранный период и сводка о распределении событий по устройствам, ОС и состоянии приложения на момент сбоя:
А также информация о каждом событии из группы:
- Стектрейс события, разделенный по потокам.
- Пользовательские ключи.
- Пользовательские логи.
- Метаинформация о событии (раздел Данные).
Крэш-варианты
По умолчанию все сбои группируются по стектрейсу (подробнее о группировке), однако эта опция позволяет просмотреть варианты одного и того же события, отличающиеся частями стектрейса, влияющими на контекст возникновения сбоя. Например, вызов дополнительных методов в процессе выполнения кода или различие в Application Specific Information.
Группировка по крэш-вариантам выполняется внутри группы сбоев – каждому варианту присваивается собственный id. Список существующих вариантов события можно найти по кнопке «Варианты» на странице отчёта по сбою:
При выборе конкретного варианта вы увидите сбои, относящиеся к этой конкретной группе крэш-вариантов.
Если при обработке события Tracer определил крэш-вариант, в таблице отчётов на странице Сбои появится указание на количество существующих вариантов события:
Как поделиться ошибкой
Шеринг стектрейсов — это функция, которая позволяет делиться найденными ошибками с другими разработчиками или командами. Это удобно, когда нужно быстро обсудить проблему, получить совет или убедиться, что ошибка уже известна другим. Можно делиться стектрейсом публично, чтобы другие тоже могли помочь, или оставить его доступным только для своей команды, если информация конфиденциальная или хочется сохранить эту ошибку на долгое время.
Как это работает?
1 – Откройте ошибку, которой хотите поделиться
В правом верхнем углу рядом с кнопкой «Совет» или «Подписаться» расположена кнопка шеринга:
2 – Нажмите кноп ку «Поделиться»
Вам откроется меню настройки будущей копии этой ошибки – здесь вы можете выбрать, какие данные об ошибке вы хотите дополнительно сохранить, назначить уровень доступа и указать комментарий при необходимости:
3 – Укажите необходимые настройки
| Опция | Описание |
|---|---|
| Логи | Логи из одноименной вкладки отчёта, прикрепленные к этой конкретной ошибке |
| Thread dump | Thread dump текущей ошибки |
| График | Общий график по группе ошибок |
| Ключи | Ключи из одноименной вкладки, прикрепленные к этой конкретной ошибке |
| Source maps | Source maps текущей ошибки |
| Статистика по данным | Общая статистика по группе ошибок |
| Данные | Дополнительные параметры из одноименной вкладки отчёта, прикрепленные к этой конкретной ошибке |
4 – Укажите уровень доступа
| Уровень доступа | Описание |
|---|---|
| Публичный | Ошибку со всеми включенными в неё данными сможет просмотреть любой человек, который получит ссылку. Используйте это, чтобы, например, делиться ошибками с сообществом. |
| Непубличный (Проект) | Ошибку со всеми включенными в неё данными сможет просмотреть только авторизованный пользователь, у которого есть доступ к проекту, к которому принадлежит ошибка. Используйте это, чтобы сохранять конфединцеальные данные или для того, чтобы иметь под рукой копию ошибки, даже если у неё истечет срок хранения в сервисе. |
5 – Добавьте комментарий
В комментарии вы можете указать, например, пояснение, для чего вы сохранили ошибку или для кого она предназначалась. Это необязательный шаг.
6 – Нажмите «Поделиться»
Готово – вы создали копию ошибки и теперь можете поделиться ей с любым другим пользователем.
Где найти сохраненные стектрейсы?
Все сохраненные стектрейсы вы можете в любое время найти во вкладке События в разделе Настройки:
Здесь же вы можете изменить уровень доступа любой из ошибок или удалить её. Редактировние или удаление копий доступно только для пользователей с уро внем доступа администратор и выше.