Настройка источника кода мониторинга реальных пользователей: различия между версиями
(Новая страница: «В большинстве сценариев '''RUM''' браузер выдает как минимум один дополнительный запрос на...») |
(нет различий)
|
Текущая версия на 23:10, 21 августа 2025
В большинстве сценариев RUM браузер выдает как минимум один дополнительный запрос на код мониторинга:
- Все форматы фрагментов, за исключением встроенного кода, включают код мониторинга как внешний ресурс, который запрашивается браузером отдельно.
- Код мониторинга для воспроизведения сеанса всегда запрашивается отдельно, даже если используемый формат тега — встроенный код.
URL-адрес запрашиваемого кода мониторинга по умолчанию зависит от метода внедрения, используемого для вашего приложения.
- Приложения без агентов: если вы выбрали мониторинг без агентов, код мониторинга запрашивается из Ключ-АСТРОМ CDN. В случае формата тега JavaScript tag имя файла заканчивается на
_complete.jsи содержит идентификатор приложения (например,7cab1abeacdfe1_complete.js). Для всех остальных форматов оно начинается сruxitagent_и содержит информацию об активных модулях кода и версии кода мониторинга (например,ruxitagent_ICA7NQVfqrtux_10307250124095659.js). Имя файла кода мониторинга воспроизведения сеанса начинается сruxitagent_(например,ruxitagent_D_10307250124095659.js) для всех форматов тегов. - Автоматическое внедрение: если RUM JavaScript внедряется автоматически, то как RUM, так и код мониторинга воспроизведения сеанса запрашиваются с вашего веб-сервера или сервера приложений с использованием URL-адреса относительно корня, где имя файла начинается с
ruxitagentjs_и содержит информацию об активных модулях кода и версии кода мониторинга (например,/ruxitagentjs_ICA7NQVfqrtux_10307250124095659.jsили/myapplication/ruxitagentjs_ICA7NQVfqrtux_10307250124095659.js). - Ручная вставка для страниц автоматически внедряемого приложения: если код RUM JavaScript вставляется вручную, даже если ваши группы процессов инструментируются ЕдинымАгентом, код мониторинга, как и при автоматической вставке, запрашивается с вашего веб-сервера или сервера приложений по URL-адресу относительно корня, где имя файла начинается с
ruxitagentjs_. Единственным исключением является формат JavaScript тега , когда код мониторинга RUM запрашивается из CDN, а имя файла заканчивается на_complete.js. Код мониторинга воспроизведения сеанса запрашивается с вашего веб-сервера или сервера приложений и имеет имя файла, начинающееся сruxitagentjs_, для всех форматов тегов.
Обычно это не требуется, но существуют определённые сценарии, в которых может потребоваться альтернативная конфигурация источника кода мониторинга. Например:
- Если ваша инфраструктура блокирует запросы кода мониторинга автоматически внедренного приложения из-за их URL-пути по умолчанию.
- Если вы предпочитаете, чтобы запросы на мониторинг кода не обрабатывались на веб-сервере или сервере приложений, на котором размещено ваше приложение.
- Если вы хотите запретить блокировщикам рекламы блокировать код мониторинга.
В следующих разделах описываются альтернативные конфигурации, позволяющие учитывать эти ограничения.
Автоматически внедренное приложение - Изменить URL-адрес кода мониторинга
В зависимости от вашей инфраструктуры и её конфигурации запросы к коду мониторинга могут не пройти по автоматически выбранному URL-адресу и, следовательно, не быть обработаны ЕдинымАгентом. Чтобы решить эту проблему, можно изменить часть URL-адреса, предшествующую префиксу ruxitagentjs_.
Чтобы изменить URL-путь кода мониторинга RUM для автоматически внедренного приложения
- Перейти в Веб-приложения.
- Выберите приложение, которое вы хотите настроить.
- В правом верхнем углу страницы обзора приложения выберите Дополнительно ( … ) > Редактировать.
- В настройках приложения выберите Инжектирование.
- В раскрывающемся списке Источник кода Real User Monitoring выберите ЕдиныйАгент.
- В поле Укажите путь для кода мониторинга RUM введите относительный путь URL-адреса кода мониторинга.
Например, если код мониторинга для вашего приложения в настоящее время запрашивается из ,/ruxitagentjs_ICA7NQVfqrtux_10307250124095659.jsи вы вводите/custompath, он будет запрошен из/custompath/ruxitagentjs_ICA7NQVfqrtux_10307250124095659.js. Вы не можете удалить частьruxitagentjs_ICA7NQVfqrtux_10307250124095659.js, необходимую для идентификации запроса как запроса кода мониторинга.
Эта конфигурация эффективна не только для автоматического внедрения, но и для ручной вставки на страницы автоматически внедряемых приложений . Единственное исключение _complete.js — запрос формата тега JavaScript, который всё равно будет отправлен в CDN Ключ-АСТРОМ.
Автоматически внедренное приложение - Запрос кода мониторинга из Ключ-АСТРОМ CDN
Обратите внимание, что все подключенные устройства АктивногоШлюза должны быть включены. АктивныйШлюз версии 1.310+ как минимум за 30 дней до того, как эта функция станет доступной.
Если вы хотите, чтобы код мониторинга для автоматически внедренного приложения запрашивался из Ключ-АСТРОМ CDN вместо ЕдиногоАгента, выполните следующие действия.
- Перейти в Веб-приложения.
- Выберите приложение, которое вы хотите настроить.
- В правом верхнем углу страницы обзора приложения выберите Дополнительно ( … ) > Редактировать.
- В настройках приложения выберите Инжектирование.
- В раскрывающемся списке Источник кода Real User Monitoring выберите CDN .
Эта конфигурация эффективна как для автоматического добавления, так и для ручной вставки на страницы автоматически добавляемого приложения . При её использовании имена файлов, которые ранее начинались с ruxitagentjs_, будут начинаться с ruxitagent_.
Настройте пользовательский префикс имени файла кода мониторинга
После изменения префикса имени файла кода мониторинга объём собираемых RUM-данных может временно сократиться. Поэтому мы рекомендуем избегать частого изменения этого параметра.
По умолчанию имя файла кода мониторинга имеет префикс ruxitagent или ruxitagentjs, если не используется тег JavaScript в формате тега. Вы также можете указать пользовательский префикс, который будет использоваться как для приложений без агентов, так и для приложений с автоматическим внедрением, а также для кода мониторинга RUM и воспроизведения сеанса.
Чтобы указать префикс имени файла пользовательского кода мониторинга
- Перейдите в Настройки > Веб и мобильный мониторинг > Имя файла кода мониторинга RUM .
- В поле Пользовательский префикс имени файла введите нужный пользовательский префикс.