Настройка мониторинга реальных пользователей с помощью JavaScript API для веб-приложений

Материал из Документация Ключ-АСТРОМ

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

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

Возможности

RUM JavaScript API, который вызывается непосредственно из кода вашего приложения, предлагает множество дополнительных возможностей.

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

Документация

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

Онлайн-руководство по RUM JavaScript API

Чтобы получить доступ к онлайн-руководству, перейдите в документацию JavaScript API.

Руководство по автономному API RUM JavaScript

Чтобы загрузить руководство по RUM JavaScript API из вашей среды

  1. В Dynatrace перейдите в раздел Настройки > Веб и мониторинг мобильных устройств > Расширенные настройки.
  2. В разделе API тега JavaScript выберите Загрузить документацию и примеры.

Разница между RUM JavaScript API

Обратите внимание, что Ключ-АСТРОМ предоставляет два API, связанных с Ключ-АСТРОМ Real User Monitoring.

  • API JavaScript RUM, который рассматривается в этом разделе, предназначен для расширения готовых функций Real User Monitoring для вашего приложения.
  • RUM JavaScript REST API часто используется для получения самой последней версии RUM JavaScript для RUM без агента. Затем необходимо вручную вставить тег или код RUM JavaScript в каждую HTML-страницу вашего приложения. С помощью этого API вы также можете получить список всех вручную добавленных приложений в вашей среде и проверить наличие последней версии RUM JavaScript.