Внедрение Мониторинга реального пользователя JavaScript

Применение Ключ-АСТРОМ / Мониторинг реального пользователя / Установка и конфигурация / Веб приложения / Начальная конфигурация / Внедрение Мониторинга реального пользователя JavaScript

Компонент Ключ-АСТРОМ Пользовательский опыт (RUM) собирает метрики из веб-браузеров ваших клиентов и сопоставляет данные браузера с информацией на стороне сервера, полученной от Единого Агента. Данные веб-браузера собираются RUM JavaScript, который помещается в HTML веб-страниц ваших веб-приложений. Мы называем это размещение RUM JavaScript «инъекцией».

Как работает внедрение RUM JavaScript?

Вы можете инициировать инъекцию одним из двух способов:

• Внедрение JavaScript в ЕдиныйАгент RUM выполняется автоматически для технологий, перечисленных в разделе Технологическая поддержка — Мониторинг реальных пользователей — Веб-серверы и приложения . Все, что вам нужно сделать, чтобы начать внедрение, — это перезапустить процессы вашего веб-сервера после установки Единого Агента. Единый Агент идентифицирует ответы HTML-содержимого и автоматически внедряет RUM JavaScript в раздел заголовка каждой страницы.
• В качестве альтернативы вы можете вставить RUM JavaScript в HTML-код вашего веб-приложения вручную, не устанавливая ЕдиныйАгент. Мы предоставляем вам RUM JavaScript в процессе установки. Вы можете вставить тег на страницы, которые вы собираетесь отслеживать.

Для управления закачкой можно использовать альтернативные форматы закачки .

В зависимости от того, как вы включаете RUM, данные мониторинга отправляются в Ключ-АСТРОМ в различных типах запросов:

• Если у вас установлен ЕдиныйАгент: RUM JavaScript отправляет данные обратно на ваш веб-сервер или сервер приложений. ЕдиныйАгент выполняет некоторый первоначальный мониторинг данных, а затем перенаправляет их в кластер Ключ-АСТРОМ. Данные передаются с помощью запросов XHR POST. По умолчанию конечная точка маяка относится к текущему домену. Также возможно отправлять данные через АктивныйШлюз.
• Если у вас не установлен ЕдиныйАгент: данные отправляются непосредственно в Ключ-АСТРОМ, минуя вашу инфраструктуру.

Куда внедряется RUM JavaScript?

Ключ-АСТРОМ RUM JavaScript работает только с действительным HTML. Грязный код страницы часто является причиной сбоя потока данных мониторинга. Поэтому обратите особое внимание на основные передовые методы работы с HTML, например, убедитесь, что в вашем коде нет незакрытых или отсутствующих тегов.

Наш RUM JavaScript внедряется только в HTML. Мы не изменяем изображения, CSS, службы REST или XML-файлы. ЕдиныйАгент всегда пытается внедрить свой RUM JavaScript в качестве первого скрипта на странице. Это помогает сохранить ваше веб-приложение в целости, но также гарантирует более надежные результаты мониторинга (например, время). Если вы вставляете RUM JavaScript вручную, убедитесь, что это первый исполняемый скрипт на каждой странице.

Как контролировать инъекцию JS?

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

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

Форматы инъекций JS

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

• автоматического инжектирование JS
• Ручная вставка
• получение через REST API

Автоматическая инъекция

Автоматическая инъекция поддерживает все форматы инъекций и обеспечивает бесшовные автоматические обновления, выполняемые ЕдиныйАгент.

Формат инъекции	Описание	Кэширование	Мониторинг обновлений кода	Обновления конфигурации	Когда использовать
Все форматы	Ключ-АСТРОМ ЕдиныйАгент может использовать все форматы инъекций, перечисленные в разделе « Вставка вручную » , для автоматической интеграции RUM в ваше приложение. Единственным исключением является формат тега JavaScript, поскольку тег JavaScript ЕдиныйАгент по сути такой же, с той разницей, что включает конфигурацию , поскольку ЕдиныйАгент может автоматически обновлять ее.				Используйте, когда возможна автоматическая инъекция в ваше веб-приложение. Независимо от выбранного формата внедрения ЕдиныйАгент автоматически обновит вашу конфигурацию и код мониторинга .

Ручная вставка

Используйте ручную вставку, когда автоматическая инъекция невозможна. В этом случае имейте в виду, что выбор правильного формата инъекции важен, потому что в противном случае вы можете потерять информацию, такую ​​как определенные тайминги или действия пользователя, которые доступны только тогда, когда и код мониторинга RUM, и конфигурация полностью загружены. Это особенно верно в тех случаях, когда этот момент времени может быть отложен. Например, при использовании формата фрагмента кода с отложенным режимом или при использовании диспетчера тегов. Независимо от выбранного вами формата внедрения всегда лучше вставить предоставленный RUM JavaScript как можно раньше в код вашего приложения.

Формат инъекции	Описание	Когда использовать
Тег JavaScript ( jsTagComplete)	Предоставляет вам тег JavaScript, чтобы вручную вставить его в код вашего веб-приложения. Файл JavaScript, на который указывает ссылка в теге, содержит код конфигурации и мониторинга , что снижает возможную продолжительность кэширования.	Используйте, если вы не хотите заниматься конфигурацией или отслеживать изменения кода вручную. Часто используется в сочетании с менеджером тегов для интеграции RUM.
Синхронный фрагмент кода ( syncCS)	Предоставляет вам фрагмент кода JavaScript (включая конфигурацию ) с базовыми функциями для ручной вставки его в код вашего веб-приложения. Полная функциональность кода мониторинга загружается синхронно	Используйте, когда обновления конфигурации должны немедленно отражаться на клиентах ваших реальных пользователей и когда вы не хотите вручную обновлять конфигурацию или код мониторинга. Этот тип может приводить к задержкам рендеринга страницы! 1
Фрагмент кода асинхронный ( asyncCS)	Предоставляет вам фрагмент кода JavaScript (включая конфигурацию ) с базовыми функциями для ручной вставки его в код вашего веб-приложения. Полная функциональность кода мониторинга загружается асинхронно (отложенно) .	Используйте, когда обновления конфигурации должны немедленно отражаться на клиентах ваших реальных пользователей, когда вы не хотите вручную обновлять конфигурацию или код мониторинга, и когда вы хотите отложить загрузку Ключ-АСТРОМ RUM. 1
Встроенный код ( jsInlineScript)	Предоставляет вам полный код конфигурации и мониторинга , чтобы вручную встроить их в код вашего веб-приложения.	Используйте, если вы хотите избежать повторного запроса и свести количество веб-запросов к минимуму. В идеале используйте это в сочетании с полностью автоматическим обновлением встроенного кода через API , чтобы гарантировать, что код мониторинга и конфигурация всегда актуальны.
Тег JavaScript ЕдиныйАгент ( jsTag)	Предоставляет вам тег JavaScript (включая конфигурацию ), чтобы вручную вставить его в код вашего веб-приложения. Код мониторинга загружается отдельным файлом из CDN 2	Используйте тот же тег JavaScript, который автоматически вставляется Ключ-АСТРОМ ЕдиныйАгент с включенным автоматическим внедрением. Используйте его только в целях тестирования или в сочетании с полностью автоматическими обновлениями API встроенного кода , чтобы убедиться, что код мониторинга и конфигурация всегда актуальны.

1

Имейте в виду, что это требует регулярных обновлений фрагментов кода, чтобы гарантировать совместимость.

2

используйте собственный CDN.

Для всех форматов внедрения, за исключением отложенного фрагмента кода ( asyncCS) , полная функциональность кода мониторинга загружается синхронно.

Обновления в ручной вставке

Настроено в Ключ-АСТРОМ.	Код мониторинга и конфигурация обновляются в соответствии с продолжительностью кэширования, пока изменения не станут активными. Вы можете настроить продолжительность кэширования при настройке инъекции.
Настроено на ваших серверах	Мы рекомендуем вам регулярно обновлять фрагмент, чтобы новая конфигурация была доступна с самого начала. В противном случае новая конфигурация будет доступна только после первой перезагрузки страницы. Вы должны настроить кэширование в своей среде, используя конфигурацию вашего веб-сервера.

Все указанные длительности кэширования относятся к тому, как долго Ключ-АСТРОМ CDN будет кэшировать ваш код мониторинга и/или конфигурацию. Если вы используете собственную CDN, указанные длительности неприменимы, поскольку они зависят от вашей собственной конфигурации.

Получить через REST API

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

Использовать ручную вставку для групп процессов

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

Чтобы подавить автоматическую инъекцию и вручную вставить RUM JavaScript

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

1. В настройках приложения перейдите в Инжектирование .

1. В разделе «Определите собственные правила инжекта» выберите « Добавить пользовательское правило » .
2. Определите оператора и, при необходимости, соответствующий шаблон URL -адреса, чтобы контролировать, на каких страницах вам нужно подавить автоматическую инъекцию.
3. В разделе Правило выберите Не инжектировать .
4. Выберите Добавить , чтобы сохранить пользовательское правило инъекции.
5. Перейдите на вкладку Вставка вручную , выберите нужный формат инъекции и скопируйте предоставленный фрагмент.

Как обеспечить своевременное обновление конфигурации для автоматической инъекции?

🟢Включено по умолчанию

Чтобы обеспечить своевременную доставку изменений конфигурации RUM, ЕдиныйАгент изменяет определенные заголовки кэша. Эта функция называется оптимизацией заголовка управления кешем .

Когда оптимизация заголовка управления кешем включена и конфигурация RUM изменена, запросы, которые в противном случае привели бы к ответу 304 Not Modifiedс помощью 200 OK, дают ЕдиныйАгент возможность внедрить JavaScript RUM в HTML-код вашего приложения. Если конфигурация RUM не была изменена, запросы приводят к 304 Not Modifiedответу.

Измененные заголовки

ЕдиныйАгент изменяет следующие заголовки ответов и запросов:

Заголовки ответа

• ETag
• Last-Modified

Заголовки запроса

• If-None-Match
• If-Modified-Since
• If-Unmodified-Since1
• If-Match1

1

Не изменено для запросов диапазона, которые обычно исключаются из мониторинга RUM.

ЕдиныйАгент не изменяет заголовки Expiresи Cache-Control, которые содержат явное время истечения срока действия ресурсов. Чтобы гарантировать своевременные обновления, мы рекомендуем указывать более короткие сроки действия в этих заголовках.

Вот как ЕдиныйАгент изменяет заголовки управления кешем.

При изменении конфигурации RUM

• Заголовки входящих сообщений If-None-Matchи If-Modified-Sinceзапросов удаляются.
• Изменения, внесенные в заголовки If-Unmodified-Sinceи If-Match, удаляются.
• Когда используются оба ETagи Last-Modifiedзаголовки:
  • ETagК заголовку добавляется суффикс .
  • Одна секунда вычитается из Last-Modifiedзаголовка.
• Когда ETagиспользуется только заголовок:
  • ETagК заголовку добавляется суффикс .
• Когда Last-Modifiedиспользуется только заголовок:
  • Заголовок ETagсоздан.
  • Одна секунда вычитается из Last-Modifiedзаголовка.

Когда конфигурация RUM не изменена

• Прежде чем запрос будет обработан веб-сервером или сервером приложений, изменения, внесенные в заголовки, удаляются, чтобы веб-сервер или сервер приложений не видел изменений.

Если приложение состоит из нескольких инструментированных уровней, изменения заголовков ETagи Last-Modifiedприменяются на каждом уровне.

Оптимизация заголовка кеша для ресурсов, отличных от HTML

Иногда ЕдиныйАгент изменяет заголовки элементов управления кэшем не-HTML-ресурсов. Это происходит потому, что изменение заголовка происходит до того, как становится известен точный тип содержимого. Ключ-АСТРОМ исключает определенные ресурсы из оптимизации заголовка кэша на основе суффикса URI, но невозможно охватить все ресурсы, отличные от HTML.

Чтобы исключить ресурсы, отличные от HTML, из оптимизации заголовка кэша, создайте собственное правило внедрения , чтобы отключить внедрение RUM JavaScript.

Исправление проблем

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

Чтобы отключить оптимизацию заголовка управления кешем

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

1. В настройках приложения перейдите в « Захват » > « расширенная настройка » .

1. В разделе «Настройки cookie и заголовков » отключите параметр «Оптимизировать значение заголовков управления кешем для использования с Ключ-АСТРОМ для мониторинга реальных пользователей» .

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