Настройка конечной точки сигнала для веб-приложений

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

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

  • Приложения с автоматическим внедрением: при автоматическом внедрении RUM-скрипта JavaScript сигналы отправляются обратно на ваш веб-сервер или сервер приложений с использованием URL-адреса относительно корня, где последний сегмент пути содержит префикс rb_ (например, /rb_xxxxxxxxxx или /myapplication/rb_xxxxxxxxxx). Конечная точка сигнала предоставляется ЕдинымАгентом, который перехватывает и пересылает RUM-сигналы.
  • Приложения без агентов: если вы выбрали мониторинг без агентов , данные отправляются на конечную точку сигнала, которая является частью инфраструктуры Ключ-АСТРОМ SaaS.

Обычно вам не нужно менять конечную точку сигнала по умолчанию, но в некоторых сценариях может потребоваться использовать альтернативную конфигурацию конечной точки сигнала. Например:

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

В следующих разделах описываются альтернативные конфигурации конечных точек сигналов, которые позволяют учитывать эти и подобные ограничения.

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

Автоматически внедренное приложение - Изменить URL-адрес конечной точки сигнала

В зависимости от вашей инфраструктуры и её конфигурации сигналы могут не пройти по автоматически выбранному URL-адресу и, следовательно, не быть обработаны ЕдинымАгентом. Чтобы решить эту проблему, можно изменить часть URL-адреса конечной точки сигнала, предшествующую префиксу rb_.

Чтобы изменить URL-адрес конечной точки сигнала для автоматически внедряемого приложения

  1. Перейдите в Веб-приложения.
  2. Выберите приложение, которое вы хотите настроить.
  3. В правом верхнем углу страницы обзора приложения выберите Дополнительно ( … ) > Редактировать.
  4. В настройках приложения выберите Общие настройки > Конечная точка сигнала .
  5. В раскрывающемся списке Тип выберите ЕдиныйАгент .
  6. В поле URL введите относительный URL-адрес конечной точки сигнала.
    Например, если RUM-сигналы вашего приложения в настоящее время отправляются на адрес /rb_abcdefghi, и вы указали URL-адрес /custompath, сигналы будут отправляться на адрес /custompath/rb_abcdefghi. Вы не можете удалить сегмент пути с префиксом rb_, поскольку эта часть URL-адреса необходима для идентификации RUM-сигнала.

Автоматически внедренное приложение - Отправка сигналов в инфраструктуру Ключ-АСТРОМ SaaS

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

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

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

Автоматически внедренное приложение - Отправить сигналы на другой веб-сервер

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

Для отправки сигналов автоматически внедренного приложения на другой инструментированный сервер

  1. В внедренном RUM JavaScript найдите reportUrl и скопируйте последний сегмент пути URL, который начинается с rb_.
  2. Добавьте это значение к URL-адресу инструментированного веб-сервера или сервера приложений.
    Например, если последний сегмент reportUrl — это /rb_abcdefghi, а URL-адрес сервера — http://www.my-server.com, то результирующий URL-адрес конечной точки сигнала — http://www.my-server.com/rb_abcdefghi.
  3. Перейти в Веб-приложение.
  4. Выберите приложение, которое вы хотите настроить.
  5. В правом верхнем углу страницы обзора приложения выберите Дополнительно ( … ) > Редактировать.
  6. В настройках приложения выберите Общие настройки > Конечная точка сигнала.
  7. В раскрывающемся списке Тип выберите ЕдиныйАгент.
  8. В поле URL введите конечную точку сигнала, которую вы определили на шаге 2.
  9. Включите опцию Отправлять данные сигнала через CORS.

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

Приложение без агента - Отправить сигналы на веб-сервер

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

Для отправки сигналов безагентного приложения на инструментированный сервер

  1. Перейти в Веб-приложение.
  2. Выберите любое автоматически внедренное приложение, которое не использует одну из пользовательских конфигураций конечных точек сигнала, описанных на этой странице.
    На этом этапе следует выбрать не настраиваемое приложение без агента, а другое автоматически внедряемое приложение с конфигурацией конечной точки сигнала по умолчанию. Если у вас нет автоматически внедряемого приложения, временно создайте его, как описано в разделе Определение приложений для мониторинга реальных пользователей. Затем это временное приложение можно удалить .
  3. В правом верхнем углу страницы обзора приложения выберите Дополнительно ( … ) > Редактировать.
  4. В настройках приложения выберите Инжектирование.
  5. В теге JavaScript ЕдиныйАгент найдите предоставленный фрагмент reportUrl и скопируйте его значение.
  6. Добавьте значение reportUrl к URL-адресу инструментированного веб-сервера или сервера приложений.
    Например, если значение reportUrl равно /rb_abcdefghi, а URL-адрес сервера — http://www.my-server.com, то результирующий URL-адрес конечной точки сигнала — http://www.my-server.com/rb_abcdefghi.
  7. Перейти в Веб-приложение.
  8. Выберите безагентное приложение, которое вы хотите настроить.
  9. В правом верхнем углу страницы обзора приложения выберите Дополнительно ( … ) > Редактировать.
  10. В настройках приложения выберите Общие настройки > Конечная точка сигнала.
  11. В раскрывающемся списке Тип выберите ЕдиныйАгент.
  12. В поле URL введите конечную точку сигнала, которую вы определили на шаге 6.
  13. Включите опцию Отправлять данные сигнала через CORS.

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