Настройка пользовательских ошибок

Ключ-АСТРОМ классифицирует ошибки по следующим типам:

• Ошибки запросов обнаруживаются браузером и OneAgent на ваших серверах.
• Пользовательские ошибки инициируются непосредственно в вашем приложении через RUM JavaScript API .
• Ошибки JavaScript — это обнаруженные исключения JavaScript, выдаваемые браузером.

Чтобы настроить захват ошибок, отредактируйте приложение и разверните раздел « Ошибки ». Выберите требуемый тип ошибки, а затем настройте ошибку для захвата, включения в расчеты Apdex или рассмотрения при обнаружении и анализе проблем ИИ Davis .

Настроить ошибки запроса

По умолчанию Ключ-АСТРОМ считает все коды состояния 4xxи 5xxкоды состояния HTTP ошибками запроса. Нарушения CSP и ошибки с неудачными запросами изображений также регистрируются как ошибки запросов. Кроме того, RUM JavaScript также может использовать пользовательские коды состояния, чтобы информировать вас о проблемах с инфраструктурой.

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

Добавить правило ошибки запроса

Чтобы добавить правило ошибки запроса

1. В меню Ключ-АСТРОМ выберите Web .
2. Выберите приложение, которое вы хотите настроить.
3. В правом верхнем углу страницы обзора приложения выберите Дополнительно ( … ) > Изменить .

1. В настройках приложения выберите Ошибки > Запросить ошибки .
2. Выберите Добавить правило ошибки запроса .
3. Используйте хотя бы один из следующих вариантов:
   • Совпадение по коду ошибки . Укажите либо отдельный код ошибки HTTP, например 404, либо весь диапазон кодов ошибок, например 400-499.
   • Сопоставление по ошибкам, из-за которых не удалось выполнить запрос изображения
   • Сопоставление по ошибкам, имеющим нарушения CSP
4. по желаниюЧтобы применить правило ошибки запроса только к определенным URL-адресам, настройте параметры в разделе Настройки фильтра .
5. Укажите, хотите ли вы зафиксировать эту ошибку . Кроме того, вы можете включить ошибку в расчеты Apdex и включить ошибку в обнаружение и анализ проблем с искусственным интеллектом Дэвиса . Если вы решите включить ошибку в анализ ИИ Дейвиса, Дэвис может сообщить об этой ошибке как о новой открытой проблеме.

Правила обработки ошибок запросов выполняются в порядке их появления в списке ошибок. Выберите Переместить вверх  или Переместить вниз,  чтобы изменить приоритет правила.

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

Управление пользовательскими кодами состояния

Помимо захвата стандартных кодов ошибок HTTP, RUM JavaScript также может использовать пользовательские коды состояния, чтобы сигнализировать об обнаружении проблемы с инфраструктурой.

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

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

В RUM JavaScript используются следующие настраиваемые коды состояния:

Код	Имя	Объяснение
970	Ошибка	Произошла неизвестная ошибка в используемом фреймворке.
971	Отменено	Запрос был отменен.
972	Тайм-аут	В запросе истекло время ожидания.
973	Разобрать	Не удалось обработать ответ. Сообщается модулями XMLHttpRequest, jQuery и MooTools.
974	Настраивать	При настройке запроса произошла ошибка. Сообщается только модулем MooTools.
979	Неизвестный	Произошла неизвестная ошибка платформы. Сообщается только модулями jQuery и MooTools.

Приложения, созданные, начиная с Ключ-АСТРОМ версии 1.238

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

Если вы хотите игнорировать эти настраиваемые коды состояния, удалите или отключите правило ошибки запроса HTTP 970-979 .

Чтобы удалить или отключить правило ошибок запроса HTTP 970-979

1. В меню Ключ-АСТРОМ выберите Web .
2. Выберите приложение, которое вы хотите настроить.
3. В правом верхнем углу страницы обзора приложения выберите Дополнительно ( … ) > Изменить .

1. В настройках приложения выберите Ошибки > Запросить ошибки .
2. Найдите правило ошибок HTTP 970-979 и выполните одно из следующих действий:
   • Выберите Удалить строку  , чтобы полностью удалить это правило ошибки запроса.
   • Разверните правило и отключите параметр Зафиксировать эту ошибку .

Приложения, созданные до версии Ключ-АСТРОМ 1.238

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

• Соответствие по коду ошибки :970-979
• Зафиксируйте эту ошибку :Enabled
• Включить ошибку в расчеты Apdex : Enabledили Disabledисходя из ваших потребностей
• Включите ошибку в обнаружение и анализ проблем ИИ Дейвиса : Enabledили Disabledв зависимости от ваших потребностей

Настройка пользовательских ошибок

Пользовательские ошибки позволяют обнаруживать собственные ошибки. Примером этого является ошибка, возникающая во время проверки поля формы.

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

Чтобы добавить пользовательское правило ошибок

1. В меню Ключ-АСТРОМ выберите Web .
2. Выберите приложение, которое вы хотите настроить.
3. В правом верхнем углу страницы обзора приложения выберите Дополнительно ( … ) > Изменить .

1. В настройках приложения выберите « Ошибки» > « Пользовательские ошибки » .
2. Выберите Добавить пользовательское правило ошибок .
3. Укажите условия, которые Ключ-АСТРОМ должна использовать для идентификации пользовательской ошибки.
   • Используйте ключ соответствия и шаблон ключа для пользовательской ошибки key.
   • Используйте значение соответствия и шаблон значения для пользовательской ошибки value. Пользовательские правила обработки ошибок нечувствительны к регистру. Например, такие значения, как mykeyи MyKeY, обрабатываются одинаково.
4. Укажите, хотите ли вы зафиксировать эту ошибку . Кроме того, вы можете включить ошибку в расчеты Apdex и включить ошибку в обнаружение и анализ проблем с искусственным интеллектом Дэвиса . Если вы решите включить ошибку в анализ ИИ Дейвиса, Дэвис может сообщить об этой ошибке как о новой открытой проблеме.

Пользовательские правила обработки ошибок выполняются в порядке их появления в списке ошибок. Выберите Переместить вверх  или Переместить вниз,  чтобы изменить приоритет правила.

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

После добавления или исключения пользовательской ошибки в Ключ-АСТРОМ вы должны инициировать ошибку в своем приложении с помощью dtrum.reportCustomError()метода RUM JavaScript API .

Например, для ошибки поля формы потребуются следующие параметры метода JavaScript:

Параметр	Объяснение	Пример
key	Имя поля формы.	custom_buying_form_number_of_travelers_field
value	Ошибка проверки, вызванная валидатором.	availability exceeded - e3434
hint	Фактический пользовательский ввод.	1000

Только keyи valueможет использоваться для группировки и анализа пользовательских ошибок; hintявляется дополнительной информацией.

Дополнительные сведения о том, как сообщать о пользовательских ошибках, см. в статье RUM JavaScript API — reportCustomError .

Настройка ошибок JavaScript

Браузеры обнаруживают ошибки JavaScript автоматически, поэтому вам не нужно добавлять эти ошибки. Если вы настроили захват ошибок JavaScript, они автоматически включаются в расчеты Apdex и анализ Дейвиса.

Чтобы игнорировать ошибки JavaScript на отдельном уровне, выберите « Игнорировать эту ошибку JavaScript » на соответствующей странице сведений об ошибке JavaScript.

Чтобы игнорировать все ошибки JavaScript в вычислениях Apdex

1. В меню Ключ-АСТРОМ выберите Web .
2. Выберите приложение, которое вы хотите настроить.
3. В правом верхнем углу страницы обзора приложения выберите Дополнительно ( … ) > Изменить .

1. В настройках приложения выберите Ошибки > Ошибки JavaScript .
2. Включите Игнорировать ошибки JavaScript в вычислениях Apdex .

Создайте дополнительные оповещения об ошибках для Дэвиса

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

Создание дополнительных предупреждений об ошибках

1. В меню Ключ-АСТРОМ перейдите в раздел Интернет и выберите приложение, чтобы отобразить страницу обзора приложения.
2. В инфографике выберите Ошибки .
3. В разделе Ошибки по типу выберите Анализировать по типу .
4. В разделе Детальный анализ для выбранного таймфрейма установите фильтры в поле Фильтровать по… . Доступные фильтры в категории « Ошибки »: Custom error name, Custom error type, Error type, Errors, Request error code, Request error resourceи Request error type.
5. Выберите Создать показатель .
6. В открывшемся наложении настройте параметры метрики и выберите Создать метрику . Дополнительные сведения о создании вычисляемых показателей и отображении их в виде диаграмм см. в разделе Создание вычисляемых показателей .
7. Выберите Создать оповещение .
8. Настройте параметры оповещения. Когда закончите, выберите Создать пользовательское событие для оповещения .
   • Используйте статический порог, 1если вы хотите, чтобы Дэвис всегда поднимал проблему при возникновении определенной ошибки.
   • Используйте автоматическое базовое определение , если вас интересуют только аномалии для этой ошибки.
   • Дополнительные сведения о создании оповещения см. в разделе События показателей для оповещения .