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

Материал из Документация Ключ-АСТРОМ
(Новая страница: «В большинстве сценариев '''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 для автоматически внедренного приложения

  1. Перейти в Веб-приложения.
  2. Выберите приложение, которое вы хотите настроить.
  3. В правом верхнем углу страницы обзора приложения выберите Дополнительно ( … ) > Редактировать.
  4. В настройках приложения выберите Инжектирование.
  5. В раскрывающемся списке Источник кода Real User Monitoring выберите ЕдиныйАгент.
  6. В поле Укажите путь для кода мониторинга 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 вместо ЕдиногоАгента, выполните следующие действия.

  1. Перейти в Веб-приложения.
  2. Выберите приложение, которое вы хотите настроить.
  3. В правом верхнем углу страницы обзора приложения выберите Дополнительно ( … ) > Редактировать.
  4. В настройках приложения выберите Инжектирование.
  5. В раскрывающемся списке Источник кода Real User Monitoring выберите CDN .

Эта конфигурация эффективна как для автоматического добавления, так и для ручной вставки на страницы автоматически добавляемого приложения . При её использовании имена файлов, которые ранее начинались с ruxitagentjs_, будут начинаться с ruxitagent_.

Настройте пользовательский префикс имени файла кода мониторинга

После изменения префикса имени файла кода мониторинга объём собираемых RUM-данных может временно сократиться. Поэтому мы рекомендуем избегать частого изменения этого параметра.

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

Чтобы указать префикс имени файла пользовательского кода мониторинга

  1. Перейдите в Настройки > Веб и мобильный мониторинг > Имя файла кода мониторинга RUM .
  2. В поле Пользовательский префикс имени файла введите нужный пользовательский префикс.