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

Применение АппОптима / Мониторинг реального пользователя / Установка и конфигурация / Веб приложения / Альтернативная установка / Настройка расширения браузера мониторинга реальных пользователей

Расширение браузера 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

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

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

Для АппОптима также необходимо установить 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>.

Для АппОптима : Установить 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>.

Для АппОптима : Установить 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 .