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

Расширение браузера RUM предоставляет средства для сбора данных Real User Monitoring из сторонних приложений с лицензией SaaS, даже если у вас нет доступа к базовым серверам приложений или источнику HTML-страницы. Примерами таких приложений являются Office 365, Workday, Concur, Google Apps, Zendesk или Confluence.

Когда использовать расширение браузера RUM

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

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

Расширение браузера RUM также может улучшить воспроизведение сеанса , особенно в следующих случаях:

Тип ресурса	Требуется расширение
Картинки	Чтобы загрузить изображения из HTTP-источников
Шрифты	Всегда
Таблицы стилей	Когда захват ресурсов отключен 1 Когда ресурс исключен 1
1 В этих сценариях расширение браузера RUM служит резервным механизмом, гарантирующим, что если ресурс не был захвачен, он будет извлечен из исходного источника.

Добавьте и настройте расширение браузера RUM

Чтобы настроить расширение браузера RUM

1. В меню Ключ-АСТРОМ выберите Развернуть Ключ-АСТРОМ .
2. В разделе Нет доступа к вашему хосту? , выберите Мониторинг через расширение браузера .
3. Прочтите инструкции и выберите Настроить мониторинг .
4. Установите расширение браузера Ключ-АСТРОМ для Google Chrome или Microsoft Edge.
5. Введите имя для своего приложения, а затем определите шаблон внедрения URL .
6. Настройте расширение браузера RUM:
   • Выберите Копировать в веб-интерфейсе Ключ-АСТРОМ, чтобы скопировать URL-адрес конфигурации . Замените {your-token}токеном с доступом к расширению браузера RUM и снова скопируйте URL-адрес конфигурации.
   • Выберите затененный значок Ключ-АСТРОМ на панели инструментов браузера, чтобы открыть расширение браузера RUM.
   • Вставьте скопированный URL-адрес и выберите Подключить приложения . Если расширение успешно получает конфигурацию, вы должны увидеть следующее сообщение: Приложения успешно подключены .
7. Вернитесь к веб-интерфейсу Ключ-АСТРОМ и выберите « Создать приложение » .
8. Снова откройте расширение браузера RUM и выберите Подключить приложения , чтобы убедиться, что вы загрузили последнюю конфигурацию.

Для Ключ-АСТРОМ Managed также необходимо установить Cluster АктивныйШлюз .

Соответствие шаблону URL

Шаблон внедрения URL — это шаблон регулярного выражения, который расширение браузера RUM применяет к текущему URL-адресу. Когда шаблон совпадает, расширение внедряет RUM JavaScript и начинает собирать данные RUM.

Например, если вы откроете Outlook 365 в своем браузере, вы увидите URL-адрес, похожий на https://outlook.office.com/owa/?realm=mycompany.com&exsvurl=1&ll-cc=1033&modurl=0

Если вы определяете outlook\.office\.comшаблон URL-адреса, регулярное выражение совпадает, и расширение собирает данные RUM для этой страницы. Обратите внимание, что этот же шаблон регулярного выражения не соответствует домашней странице Office 365, которая может быть https://www.office.com/?auth=2&home=1.

Существует несколько онлайн-инструментов для проверки ваших регулярных выражений, например, Regex101 .

Вы можете изменить шаблон внедрения URL в любое время через настройки приложения: на странице обзора приложения выберите Обзор ( … ) > Изменить и перейдите в Настройка .

Конечная точка конфигурации

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

Вы можете проверить конечную точку конфигурации через настройки приложения: на странице обзора приложения выберите Обзор ( … ) > Изменить и перейдите в Настройка . URL-адрес конфигурации доступен в URL-адресе, используемом расширением браузера для получения конфигурации .

Проверьте свою конфигурацию

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

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

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

Разверните расширение браузера RUM

После проверки конфигурации вы, вероятно, захотите развернуть расширение для всей компании или для определенной группы пользователей. В этом разделе объясняется, как настроить Google Chrome и Microsoft Edge с помощью записей реестра, и приводятся советы о том, как развернуть их с помощью конфигураций групповой политики в корпоративной среде.

Гугл Хром

Развертывание расширения браузера RUM

• Добавьте расширение в ExtensionInstallForcelistполитику Chrome.
• Установите adminMode = dword:00000000политику расширения. Дополнительные сведения см. в документации по политике Chromium .
• Для Ключ-АСТРОМ SaaS : установите fetchUrl = https://<your-environment-id>.live.Ключ-АСТРОМ.com/api/v1/browserextension/config?Api-Token=<your-token>.

• Для Ключ-АСТРОМ Managed : Установить fetchUrl = https://<your-domain>:9999/e/<your-environment-id>/api/v1/browserextension/config?Api-Token=<your-token>.

Для Windows лучший вариант — использовать групповые политики Windows для установки этих политик.

Пример обязательных записей реестра

[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\ExtensionInstallForcelist]
"1"="fklgmciohehgadlafhljjhgdojfjihhk;https://clients2.google.com/service/update2/crx"

[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\3rdparty\extensions\fklgmciohehgadlafhljjhgdojfjihhk\policy]
"fetchUrl"="https://{your-environment-id}.live.Ключ-АСТРОМ.com/api/v1/browserextension/config?Api-Token={your-token}"
"adminMode"=dword:00000000

Если вы хотите развернуть расширение браузера RUM на Linux или Mac, ознакомьтесь с документацией Chromium для администраторов .

Проверьте свое развертывание

Чтобы убедиться в успешном развертывании и правильной настройке расширения браузера RUM, следуйте приведенным ниже советам.

• Откройте chrome://extensionsстраницу в Google Chrome. На этой странице должно появиться расширение Ключ-АСТРОМ Real User Monitoring . Вы также должны заметить небольшой значок справа, который указывает, что вы установили расширение через ExtensionInstallForcelistполитику.
• Откройте chrome://policyстраницу. Здесь вы должны увидеть две записи для политик adminModeи в расширении Ключ-АСТРОМ Real User Monitoring . Убедитесь, что они установлены на предполагаемые значения.fetchUrl
• Посетите одно из приложений, за которыми вы следите. Значок Ключ-АСТРОМ на панели инструментов вашего браузера должен отображаться в полном цвете.
  • Если значок остается неактивным, проверьте настроенный шаблон URL .
  • Если значок цветной, но вы не видите данных RUM в веб-интерфейсе Ключ-АСТРОМ, обратитесь к нашей странице устранения неполадок RUM .

Microsoft Edge

Используйте эту инструкцию только для Microsoft Edge на основе Chromium; это не будет работать для более старых версий.

Развертывание расширения браузера RUM

• Добавьте расширение браузера RUM в ExtensionInstallForcelistполитику Microsoft Edge. Дополнительные сведения см. в разделе Microsoft Edge — Политики > ExtensionInstallForcelist .
• Установите adminMode = dword:00000000политику расширения.
• Для Ключ-АСТРОМ SaaS : установите fetchUrl = https://<your-environment-id>.live.Ключ-АСТРОМ.com/api/v1/browserextension/config?Api-Token=<your-token>.

• Для Ключ-АСТРОМ Managed : Установить fetchUrl = https://<your-domain>:9999/e/<your-environment-id>/api/v1/browserextension/config?Api-Token=<your-token>.

Для Windows лучший вариант — использовать групповые политики Windows для установки этих политик.

Пример обязательных записей реестра

[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\ExtensionInstallForcelist]
"1"="mpioohaaamocbdblijfoeigkkadcekli;https://edge.microsoft.com/extensionwebstorebase/v1/crx"

[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\3rdparty\extensions\mpioohaaamocbdblijfoeigkkadcekli\policy]
"fetchUrl"="https://{your-environment-id}.live.Ключ-АСТРОМ.com/api/v1/browserextension/config?Api-Token={your-token}"
"adminMode"=dword:00000000

Если вы хотите развернуть расширение на Linux или Mac, ознакомьтесь со статьей Управление расширениями Microsoft Edge на предприятии .

Проверьте свое развертывание

Чтобы убедиться в успешном развертывании и правильной настройке расширения браузера RUM, следуйте приведенным ниже советам.

• Откройте edge://extensionsстраницу в Edge. На этой странице должно появиться расширение Ключ-АСТРОМ Real User Monitoring . Вы также должны заметить небольшой значок справа, который указывает, что вы установили расширение через ExtensionInstallForcelistполитику.
• Посетите одно из приложений, за которыми вы следите. Значок Ключ-АСТРОМ на панели инструментов вашего браузера должен отображаться в полном цвете.
  • Если значок остается неактивным, проверьте настроенный шаблон URL .
  • Если значок цветной, но вы не видите данных RUM в веб-интерфейсе Ключ-АСТРОМ, обратитесь к нашей странице устранения неполадок RUM .