Настройка пользовательских ошибок - История изменений

IKuznetsov в 15:47, 3 января 2025

2025-01-03T15:47:07Z

← Предыдущая версия		Версия от 15:47, 3 января 2025
Строка 1:		Строка 1:
	'''''[[Применение АппОптима]] / [[Мониторинг реального пользователя]] / Установка и конфигурация / Веб приложения / Дополнительная конфигурация / Настройка пользовательских ошибок'''''		'''''[[Применение АппОптима]] / [[Мониторинг реального пользователя]] / [https://docs.expert-apm.ru/index.php/%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5_%D0%90%D0%BF%D0%BF%D0%9E%D0%BF%D1%82%D0%B8%D0%BC%D0%B0#:~:text=%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0%20%D0%B8%20%D0%BA%D0%BE%D0%BD%D1%84%D0%B8%D0%B3%D1%83%D1%80%D0%B0%D1%86%D0%B8%D1%8F Установка и конфигурация] / [https://docs.expert-apm.ru/index.php/%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5_%D0%90%D0%BF%D0%BF%D0%9E%D0%BF%D1%82%D0%B8%D0%BC%D0%B0#:~:text=%D0%9E%D0%BF%D1%80%D0%B5%D0%B4%D0%B5%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5%20%D0%BF%D1%80%D0%B8%D0%BB%D0%BE%D0%B6%D0%B5%D0%BD%D0%B8%D0%B9-,%D0%92%D0%B5%D0%B1%20%D0%BF%D1%80%D0%B8%D0%BB%D0%BE%D0%B6%D0%B5%D0%BD%D0%B8%D1%8F,-%D0%9D%D0%B0%D1%87%D0%B0%D0%BB%D1%8C%D0%BD%D0%B0%D1%8F%20%D0%BA%D0%BE%D0%BD%D1%84%D0%B8%D0%B3%D1%83%D1%80%D0%B0%D1%86%D0%B8%D1%8F Веб приложения] / [https://docs.expert-apm.ru/index.php/%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5_%D0%90%D0%BF%D0%BF%D0%9E%D0%BF%D1%82%D0%B8%D0%BC%D0%B0#:~:text=%D0%BC%D0%BE%D0%BD%D0%B8%D1%82%D0%BE%D1%80%D0%B8%D0%BD%D0%B3%D0%B0%20%D1%80%D0%B5%D0%B0%D0%BB%D1%8C%D0%BD%D1%8B%D1%85%20%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D1%82%D0%B5%D0%BB%D0%B5%D0%B9-,%D0%94%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D0%B0%D1%8F%20%D0%BA%D0%BE%D0%BD%D1%84%D0%B8%D0%B3%D1%83%D1%80%D0%B0%D1%86%D0%B8%D1%8F,-%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0%20%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D0%BE%D0%B2%20%D0%BA%D0%BE%D0%BD%D1%84%D0%B8%D0%B4%D0%B5%D0%BD%D1%86%D0%B8%D0%B0%D0%BB%D1%8C%D0%BD%D0%BE%D1%81%D1%82%D0%B8 Дополнительная конфигурация] / Настройка пользовательских ошибок'''''

	АппОптима классифицирует ошибки по следующим типам:		АппОптима классифицирует ошибки по следующим типам:
Строка 27:		Строка 27:
	#* Сопоставление по ошибкам, из-за которых не удалось выполнить запрос изображения		#* Сопоставление по ошибкам, из-за которых не удалось выполнить запрос изображения
	#* Сопоставление по ошибкам, имеющим нарушения CSP		#* Сопоставление по ошибкам, имеющим нарушения CSP
	# по ~~желаниюЧтобы~~ применить правило ошибки запроса только к определенным URL-адресам, настройте параметры в разделе Настройки фильтра .		# по желанию. Чтобы применить правило ошибки запроса только к определенным URL-адресам, настройте параметры в разделе Настройки фильтра .
	# Укажите, хотите ли вы зафиксировать эту ошибку . Кроме того, вы можете включить ошибку в расчеты Apdex и включить ошибку в обнаружение и анализ проблем с искусственным интеллектом. Если вы решите включить ошибку в анализ ИИ, ИИ может сообщить об этой ошибке как о новой открытой проблеме.		# Укажите, хотите ли вы зафиксировать эту ошибку . Кроме того, вы можете включить ошибку в расчеты Apdex и включить ошибку в обнаружение и анализ проблем с искусственным интеллектом. Если вы решите включить ошибку в анализ ИИ, ИИ может сообщить об этой ошибке как о новой открытой проблеме.

IKuznetsov в 09:55, 25 декабря 2024

2024-12-25T09:55:09Z

Внесённые изменения

ENetrebin в 14:43, 10 сентября 2024

2024-09-10T14:43:43Z

← Предыдущая версия		Версия от 14:43, 10 сентября 2024
Строка 1:		Строка 1:
			'''''[[Применение Ключ-АСТРОМ]] / [[Применение Ключ-АСТРОМ#.D0.9C.D0.BE.D0.BD.D0.B8.D1.82.D0.BE.D1.80.D0.B8.D0.BD.D0.B3%20.D1.80.D0.B5.D0.B0.D0.BB.D1.8C.D0.BD.D0.BE.D0.B3.D0.BE%20.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8F\|Мониторинг реального пользователя]] / Установка и конфигурация / Веб приложения / Дополнительная конфигурация / Настройка пользовательских ошибок'''''

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

ENetrebin в 18:14, 6 июля 2023

2023-07-06T18:14:30Z

← Предыдущая версия		Версия от 18:14, 6 июля 2023
Строка 1:		Строка 1:
	Ключ-АСТРОМ классифицирует ошибки по следующим типам:		Ключ-АСТРОМ классифицирует ошибки по следующим типам:

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

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

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

ENetrebin: Новая страница: «Ключ-АСТРОМ классифицирует ошибки по следующим типам: * Ошибки запросов обнаруживаются...»

2022-11-16T15:11:45Z

Новая страница: «Ключ-АСТРОМ классифицирует ошибки по следующим типам: * Ошибки запросов обнаруживаются...»

Новая страница

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Например, для ошибки поля формы потребуются следующие параметры метода JavaScript:
{| class="wikitable"
!Параметр
!Объяснение
!Пример
|-
|<code>key</code>
|Имя поля формы.
|<code>custom_buying_form_number_of_travelers_field</code>
|-
|<code>value</code>
|Ошибка проверки, вызванная валидатором.
|<code>availability exceeded - e3434</code>
|-
|<code>hint</code>
|Фактический пользовательский ввод.
|<code>1000</code>
|}
Только <code>key</code>и <code>value</code>может использоваться для группировки и анализа пользовательских ошибок; <code>hint</code>является дополнительной информацией.

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

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

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

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

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

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

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

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

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