Просмотр кода страницы Ограничения брандмауэра для данных с веб-браузеров и мобильных приложений

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

== Запросы ==
Запросы

Для полноценной работы анализа пользовательских данных в Ключ-АСТРОМ должны быть доставлены следующие HTTP-запросы:

* <code>ruxitagentjs_</code> используется для JavaScript при автоматической инъекции — имя тега может содержать дополнительную информацию, такую как активные модули кода и версия тега. Безагентный способ требует использования <code>ruxitagent_</code>.

* <code>/rb_<id></code> и <code>/bf</code> или <code>/bf_<id></code>являются сигналами монитора, которые RUM JavaScript отправляет обратно в Ключ-АСТРОМ.
** Монитор использует параметры запроса. Для предыдущей версии протокола beacon 2 они <code>app</code>, <code>flavor</code>, <code>format</code>, <code>referer</code>, <code>session</code>, <code>svrid</code>, <code>type</code>, <code>visitID</code>, <code>size</code>, <code>zip</code>, <code>va</code>, <code>tt</code>, <code>ns</code>, и даже больше. Для нового протокола beacon версии 3 они <code>type</code>, <code>svrid</code>, <code>rf</code>, <code>sn</code>, <code>app</code>, <code>dbg</code>, <code>flavor</code>, <code>vi</code>, <code>modifiedSince</code>, <code>bp</code>, <code>contentType</code>, <code>crc</code>, <code>v</code>, <code>end</code>.
** <code>POST</code> Тело содержит полезную нагрузку. Полезная нагрузка отправляется с <code>text/plain</code> типом содержимого. Для воспроизведения сеанса <code>application/octet-stream</code> также можно использовать тип содержимого.

== Заголовки ==
RUM использует следующие HTTP-заголовки. Все эти заголовки должны иметь доступ к Ключ-АСТРОМ.

=== Заголовки запросов ===
{| class="wikitable"
|+
!Заголовок
!Цель
|-
|<code>x-astromkey</code>
|Используется для объединения транзакций в заголовках HTTP. Устанавливается Единым Агентом для соединения веб-серверов. Убедитесь, что сетевые компоненты, такие как брандмауэры и маршрутизаторы, не настроены на удаление этих заголовков. Неправильная конфигурация может потенциально привести к повреждению распределенных трассировок. Некоторые сетевые компоненты отключают такие запросы и выдают <code>403</code> ошибку HTTP, поэтому необходимо настроить эти компоненты для приема <code>x-astromkey</code> заголовка.
|-
|<code>x-astromkey-application</code>
|Содержит идентификатор приложения RUM, домен cookie и правило внедрения <code>(noop</code>, <code>auto</code>, <code>before</code>, или <code>after</code>). Также содержит шаблон внедрения, когда <code>injectionRule=after</code> или <code>injectionRule=before</code>.

Используется в случае, если между браузером пользователя и исходным процессом, который доставляет страницу, есть какой-то прокси.
|-
|<code>x-astromkey-origin-url</code>
|Сохраняет исходный URL-адрес запроса в случае перезаписи URL.
|-
|<code>x-astromkey-RequestState</code>
|Отслеживает глубину дерева подпутей, чтобы избежать бесконечных распределенных трассировок.
|-
|<code>x-dtpc</code>
|Определяет надлежащие конечные точки для передачи маяка; включает идентификатор сеанса для корреляции.
|-
|<code>x-dtreferer</code>
|Содержит ссылку на страницу для действия и улучшает результаты корреляции.
|-
|<code>x-dtc</code>
|Содержит информацию для корреляции временных интервалов между источниками.
|-
|<code>Cookie</code>
|Устанавливает <code>dtCookie</code> cookie на случай, если HTTP-запрос их не содержит.
|-
|<code>X-Ruxit-Forwarded-For</code>
|Используется для отслеживания сценариев прокси с помощью модуля кода NGINX.
|-
|<code>X-ruxit-Apache-ServerNamePorts</code>
|Используется модулем Apache code для синхронизации именования служб с модулем PHP code.
|-
|<code>X-ruxit-Disposition</code>
|Используется модулем кода IIS для удаления .Вложенные пути к модулю сетевого кода.
|-
|<code>Accept-Encoding</code>
|Отбрасывается модулем Apache code во время тонкой настройки поведения HTML-инъекции.
|-
|<code>Content-Encoding</code>
|Отбрасывается во время тонкой настройки поведения HTML-инъекции.
|-
|<code>If-None-Match</code>
|Отбрасывается при подавлении кэширования.
|-
|<code>If-Not-Modified-Since</code>
|Отбрасывается при подавлении кэширования.
|-
|<code>If-Match</code>
|Изменяется при подавлении кэширования.
|-
|<code>If-Range</code>
|Изменяется при подавлении кэширования.
|-
|<code>tracecontext</code>
|Используется для маркировки W3C.
|-
|<code>referer</code>
|Содержит адрес предыдущей веб-страницы, с которой была перейдена ссылка на запрашиваемую в данный момент страницу.
|-
|<code>user-agent</code>
|Используется для обнаружения браузера и операционной системы.
|-
|<code>x-host</code>
|Содержит информацию о хосте для доменов, отличных от http.
|}

=== Заголовки ответов ===
{| class="wikitable"
|+
!Заголовок
!Цель
|-
|<code>X-OneAgent-JS-Injection</code>
|Подтверждает, что был введен RUM JavaScript, чтобы избежать дублирования.

Имеет одно из следующих значений:

* <code>true</code>: внедрение завершено.

* <code>block</code>: в это время не следует пытаться выполнить инъекцию.
|-
|<code>X-ruxit-JS-Agent</code>
|Подтверждает, что был введен RUM JavaScript, чтобы избежать дублирования.

Имеет одно из следующих значений:

* <code>true</code>: внедрение завершено.

* <code>block</code>: в это время не следует пытаться выполнить инъекцию.
|-
|<code>x-dtHealthCheck</code>
|Содержит результаты диагностики внедрения RUM JavaScript, необходимой для анализа технической поддержкой.
|-
|<code>x-dtAgentId</code>
|Если проверка работоспособности RUM включена, любой задействованный модуль кода ЕА добавляет сюда свой идентификатор. Устанавливается для ответов на специальные запросы.
|-
|<code>x-dtInjectedServlet</code>
|Содержит полное имя введенного сервлета или фильтра.
|-
|<code>Set-Cookie</code>
|Устанавливает файл cookie состояния сеанса Единого Агента.
|-
|<code>ETag</code>
|Единый агент добавляет пользовательскую строку к исходному <code>ETag</code> заголовку ответа, чтобы отслеживать изменения в конфигурации приложения.
|-
|<code>Last-modified</code>
|Если заголовок <code>ETag</code> ответа обрабатывается, Единый Агент также вычитает 1 секунду из исходного значения этого заголовка. Устанавливается для ответов на специальные запросы.
|-
|<code>Content-Length</code>
|Адаптировано после внедрения HTML. Устанавливается для ответов на специальные запросы.
|-
|<code>Vary</code>
|Адаптировано во время внедрения HTML в сжатые ответы. Устанавливается для ответов на специальные запросы.
|-
|<code>Content-Encoding</code>
|Адаптировано во время внедрения HTML в сжатые ответы.
|-
|<code>Content-Type</code>
|Устанавливается для ответов на специальные запросы.
|-
|<code>Access-Control-Allow-Origin</code>
|Устанавливается для ответов на специальные запросы.
|-
|<code>Cache-Control</code>
|Устанавливается для ответов на специальные запросы.
|-
|<code>Server-Timing</code>
|Используется для передачи информации, которая имеет отношение к корреляции RUM.
|-
|<code>Timing-Allow-Origin</code>
|Позволяет RUM JavaScript получать доступ к информации, которая имеет отношение к корреляции RUM, в случае запросов из разных источников.
|-
|<code>Access-Control-Allow-Headers</code>
|Устанавливается для ответов на специальные запросы.
|-
|<code>Access-Control-Allow-Methods</code>
|Устанавливается для ответов на специальные запросы.
|-
|<code>Access-Control-Max-Age</code>
|Устанавливается для ответов на специальные запросы.
|}

== Файлы cookie ==
RUM использует следующие файлы cookie. Все это должно быть доступно для Ключ-АСТРОМ. 
{| class="wikitable"
|+
!Cookie
!Максимальный размер
!Цель
|-
|<code>dtCookie</code>
|Нет установленного ограничения, но обычно менее 100 B
|Отслеживает посещение по нескольким запросам.
|-
|<code>dtLatC</code>
|5 B
|Измеряет задержку сервера для мониторинга производительности.
|-
|<code>dtPC</code>
|58 B
|Определяет надлежащие конечные точки для передачи маяка; включает идентификатор сеанса для корреляции.
|-
|<code>dtSa</code>
|Максимальная длина URL-адреса
|Служит промежуточным хранилищем для действий, охватывающих страницы.
|-
|<code>dtValidationCookie</code>
|Длина <code>dTValidationCookieValue</code> строки, то есть <code>23</code>
|Определяет домен верхнего уровня.
|-
|<code>dtDisabled</code>
|4 B
|Определяет, следует ли деактивировать RUM JavaScript из-за затрат и контроля трафика или предотвращения перегрузки.
|-
|<code>rxVisitor</code>
|45 B
|Содержит идентификатор посетителя для сопоставления сеансов.
|-
|<code>rxvt</code>
|27 B
|Включает временную метку тайм-аута сеанса.
|}

== Мобильный RUM ==
Единый Агент для мобильных устройств использует <code>x-astromkey</code> заголовок для пометки HTTP-запросов. Ключ-АСТРОМ использует этот заголовок, чтобы связать мобильную часть веб-запроса с сервисной частью, захваченной другим Единым Агентом.

Для гибридных приложений файл <code>dtAdk</code> cookie позволяет присоединяться к сеансу из Единого Агента для мобильных устройств и сеансу из RUM JavaScript, чтобы эти сеансы отображались как один сеанс, в то время <code>dtAdkSettings</code> как файл cookie используется для синхронизации настроек между Единым Агентом для мобильных устройств и RUM JavaScript.

<code>/mbeacon</code> это сигнал монитора, который Единый Агент для мобильных устройств отправляет обратно в Ключ АСТРОМ, если данные передаются через Активный Шлюз. Если данные отправляются другому Единому агенту, сигнал монитора будет<code>/dtmb</code>.