События пользователя и ошибки

Материал из Документация Ключ-АСТРОМ
Версия от 18:13, 2 марта 2026; IKuznetsov (обсуждение | вклад) (Новая страница: «Помимо обнаружения действий пользователя, Ключ-АСТРОМ также ре...»)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)

Помимо обнаружения действий пользователя, Ключ-АСТРОМ также регистрирует дополнительные события, известные как пользовательские события и события ошибок. Эти события происходят в рамках пользовательской сессии, но не генерируются напрямую в результате взаимодействия пользователя с элементами управления пользовательского интерфейса.

Пользовательские события

События пользователя — это смена страниц, частые клики (rage clicks), частые касания (rage taps) и события маркировки пользователей.

Изменение страницы

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

  • Load: loading of page /payment
  • Page change: /payment

Частые клики

Когда ваше приложение работает медленно или возникают проблемы с пользовательским интерфейсом, пользователи могут многократно щелкать по экрану или элементам управления в раздражении. Ключ-АСТРОМ распознает такое поведение как событие раздражения: щелчок в раздражении для веб-приложения и касание в раздражении для мобильного приложения.

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

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

  • Веб-приложения В настройках приложения выберите Аналитика поведения > Юзабилити-аналитика и отключите параметр Обнаруживать яростные клики.
  • Android См. раздел Обнаружение нажатий в состоянии ярости.
  • iOS Установите ключ конфигурации DTXDetectRageTaps на false.

В Ключ-АСТРОМ вы также можете проверить сессии с событиями, связанными с яростью, чтобы просмотреть подробности таких событий, как клик или касание.

Теги пользователей

Одна из ключевых особенностей мониторинга реальных пользователей — возможность однозначной идентификации отдельных пользователей в разных браузерах, устройствах и пользовательских сессиях. Это достигается путем присвоения пользовательского тега, который может состоять из имени пользователя, псевдонима или адреса электронной почты, пользовательской сессии. Когда пользователь помечается тегом в ​​вашем приложении, Ключ-АСТРОМ сообщает о событии присвоения тега пользователю.

Вы можете помечать пользователей тегами при их входе в систему, а также при использовании или восстановлении уже авторизованной сессии при перезапуске приложения, поскольку тег пользователя не сохраняется при перезапуске приложения.

Для веб-приложений настройку тегирования пользователей можно выполнить либо с помощью JavaScript API RUM, либо с помощью метаданных страниц вашего приложения.

Для мобильных и специализированных приложений Ключ-АСТРОМ предлагает вариант метода «тегирования пользователей».

С помощью пользовательских тегов вы можете анализировать поведение и опыт конкретного пользователя посредством анализа пользовательских сессий. Дополнительную информацию см. в разделах Анализ пользовательских сессий и Подробная информация о пользователе.

События ошибок

К событиям, вызывающим ошибки, относятся сами ошибки и сбои.

Ошибки

Ключ-АСТРОМ сообщает об ошибке всякий раз, когда браузер генерирует исключение JavaScript, веб-запрос приводит к ошибке, пользовательская ошибка отправляется через API, а также по другим причинам.

В зависимости от типа вашего приложения регистрируются следующие типы ошибок.

Тип ошибки Описание Веб-приложение Мобильное приложение Пользовательское приложение
Ошибка запроса Обнаружено браузером и ЕдинымАгентом на ваших серверах. да да да
Сообщение ошибки Сообщения об ошибках поступают вручную через специальный API-интерфейс для отправки отчетов об ошибках. нет да да
Пользовательская ошибка Данные передаются вручную через JavaScript API RUM. да нет нет
Ошибка JavaScript Исключения JavaScript, генерируемые браузером да нет нет

Для сообщения об ошибке, созданной специально для веб-приложения, или об ошибке, созданной для мобильного или пользовательского приложения, используйте специальный метод API.


Ключ-АСТРОМ предлагает множество параметров настройки, связанных с ошибками. Для веб-приложений вы можете точно настроить обнаружение ошибок для каждого типа ошибок, например, настроить правила обработки ошибок запросов, добавить пользовательские правила обработки ошибок или игнорировать ошибки JavaScript. Для мобильных и пользовательских приложений вы можете выбрать вариант игнорирования ошибок веб-запросов.

Обратите внимание, что ошибки влияют как на оценку удобства использования, так и на рейтинг Apdex. Однако вы можете изменить пороговые значения оценки удобства использования, настроить параметры Apdex и исключить ошибки из расчетов Apdex в параметрах приложения.

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

Сбои

Мобильные и пользовательские приложения

Когда ваше приложение аварийно завершает работу, Ключ-АСТРОМ автоматически сообщает о событии сбоя. Ключ-АСТРОМ фиксирует сбои и отправляет отчет о сбое на сервер. Отчет о сбое включает время возникновения и полную трассировку стека исключения.

В случае с пользовательскими приложениями Ключ-АСТРОМ не сообщает о сбоях автоматически. Вам необходимо задать их вручную.

В Ключ-АСТРОМ сбой — это критическая ошибка, приводящая к завершению работы приложения. Некритические ошибки, такие как перехваченные исключения и ошибки, не считаются сбоями (см. выше). Сообщения ANR (Application Not Responding — приложение не отвечает) не отслеживаются Ключ-АСТРОМ.

Некоторые сбои могут не отображаться в отчетах, например, когда пользователь приложения сталкивается с проблемами сети, такими как нестабильное или недоступное интернет-соединение. Это связано с тем, что Ключ-АСТРОМ не отправляет отчеты о сбоях старше 10 минут (поскольку такие отчеты больше не могут быть сопоставлены в кластере Ключ-АСТРОМ).

Отключение сообщений о сбоях

Функция отправки сообщений о сбоях включена по умолчанию, но вы можете ее отключить.

  • Android Подробности см. в описании плагина Ключ-АСТРОМ Android Gradle или SDK ЕдиныйАгент для Android.
  • iOS См. раздел Сообщения о сбоях.
  • Кроссплатформенные фреймворки Отредактируйте конфигурационный файл (astromkey.config.<extension>), добавив строку crashReporting false (Android) или "DTXCrashReportingEnabled": false (iOS). Обратите внимание, что это отключает только мониторинг сбоев нативных приложений.