IKuznetsov: Новая страница: «= Проблема = На этой странице объясняется, что делать, если '''Real User Monitoring (RUM)''' не работает...»

2025-08-21T23:59:34Z

Новая страница: «= Проблема = На этой странице объясняется, что делать, если '''Real User Monitoring (RUM)''' не работает...»

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

= Проблема =
На этой странице объясняется, что делать, если '''Real User Monitoring (RUM)''' не работает в вашей среде, в частности, если возникают проблемы с '''bf'''.

[[Файл:Image4011.png|граница]]

Ответы должны иметь статус <code>200 OK</code> , а тело ответа должно начинаться с <code>OK</code>. Если тело ответа начинается с <code>FL</code>, сигнал RUM был отклонен и не передан на сервер. Ответ содержит дополнительную информацию о проблеме.

== RUM JavaScript не внедряется ==
Если вы не видите '''RUM JavaScript''', автоматически внедренный ЕдинымАгентом на ваши веб-страницы, это, вероятно, по одной из следующих причин.

* Ключ-АСТРОМ ЕдиныйАгент не смог определить содержимое как '''HTML''' или отменил попытку внедрения из-за недопустимой структуры '''HTML''' или некорректной кодировки. Убедитесь, что вы используете корректный '''HTML''' с открывающими и закрывающими тегами '''<HTML>''' и '''<HEAD>'''. Подробнее о том, как ЕдиныйАгент внедряет '''RUM JavaScript''' в ваше приложение, см . в статье [[Внедрение Мониторинга реального пользователя JavaScript|Внедрение RUM JavaScript]].
* Запрос соответствует другому приложению, чем ожидалось, из-за неправильной настройки обнаружения приложений. Либо шаблон неверен, либо соответствующие веб-серверы работают за прокси-серверами или другими компонентами, которые перезаписывают '''URL'''-адрес. Подробнее см. в разделе [[Определение приложений для Мониторинга реального пользователя|Что делать, если неинструментированный компонент перезаписывает части URL-адреса?]].
* Приложение, обнаруженное ЕдинымАгентом на первом инструментированном уровне, не распространяется на последующие ЕдиныеАгенты, поскольку заголовок <code>x-astromkey-application</code> удаляется брандмауэром или прокси-сервером.
* Вы определили правила исключения для браузеров, ботов и поисковика.

== RUM JavaScript не загружается ==
Если вы видите, что '''RUM JavaScript''' не загружается, этому может быть несколько причин.

* '''Для безагентного мониторинга'''
** Неверный код '''JavaScript RUM'''. Проверьте настройку, используя документацию по [[Настройка безагентного мониторинга реальных пользователей|настройке мониторинга реальных пользователей без агентов]].
** [https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/CSP Правила политики безопасности контента] запрещают загрузку RUM JavaScript.
** Хост '''RUM JavaScript''' <code><nowiki>https://js-cdn.astromkey.com</nowiki></code> недоступен для клиентских браузеров из-за правил брандмауэра или настроек прокси-сервера. Необходимо разрешить подключения к этому хосту и с него.
* '''Для автоматического внедрения на веб-серверы'''
** Правила брандмауэров, балансировщиков нагрузки и прокси-серверов не разрешают загрузку '''JavaScript в RUM'''. Подробнее см. в разделе [[Ограничения брандмауэра для данных с веб-браузеров и мобильных приложений|Ограничения брандмауэра для RUM]] .
* '''Для автоматического внедрения на серверах приложений Java'''
** Корневое приложение отсутствует. '''JavaScript-код RUM''' обычно загружается из корневого каталога веб-сервера <code>(.../ruxitagentjs_...)</code>.
** Ваш сервер приложений '''Java''' обслуживает статический контент без использования стека сервлетов. В таких случаях загрузка '''RUM'''-кода '''JavaScript''' невозможна.

Чтобы устранить проблему с загрузкой '''JavaScript''', вызванную отсутствием корневого приложения, настройте доступный путь (например, допустимый путь сервлета), как описано в разделе [[Настройка источника кода мониторинга реальных пользователей|Изменение URL-пути кода мониторинга]].

== RUM JavaScript не передает данные на сервер ==
Если вы видите, что '''RUM''' отклоняются и не пересылаются на сервер, этому может быть несколько причин.

* Может потребоваться адаптация правил для брандмауэров, балансировщиков нагрузки или прокси-серверов. Подробнее см. в разделе [[Ограничения брандмауэра для данных с веб-браузеров и мобильных приложений|Ограничения брандмауэра для RUM]].
* Сигналы могут давать сбои, если их автоматически выбранный '''URL-адрес''' заблокирован, но это можно исправить, изменив URL-адрес перед префиксом <code>rb_</code>. Подробнее читайте [[Настройка конечной точки сигнала для веб-приложений|здесь]].
* Ключ-АСТРОМ ограничил скорость захвата вашего приложения.
* Возможно, потребуется изменить [https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/CSP настройки политики безопасности контента].

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

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

Веб-приложения: проблемы с RUM JavaScript - История изменений

IKuznetsov: Новая страница: «= Проблема = На этой странице объясняется, что делать, если '''Real User Monitoring (RUM)''' не работает...»