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

= Ограничения брандмауэра для RUM =

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

== Запросы ==
Для полноценной работы '''RUM''' следующие '''HTTP'''-запросы должны проходить через вашу инфраструктуру:

Запросы кода мониторинга '''RUM''':
* В случае безагентного мониторинга эти запросы отправляются на '''CDN''' или АктивныйШлюз кластера, настроенный в соответствии с инструкциями по настройке безагентного мониторинга реального пользователя.
* В случае автоматического внедрения они по умолчанию отправляются на веб-сервер или сервер приложений, на котором размещено приложение, а их '''URL'''-путь содержит строку <code>ruxitagentjs_</code>. Подробнее о стандартном '''URL''' и доступных параметрах конфигурации см. в разделе «Настройка источника кода мониторинга реального пользователя».

Сигналы '''RUM''', сообщающие данные, собранные '''RUM JavaScript''', обратно в Ключ-АСТРОМ:
* В случае безагентного мониторинга сигналы по умолчанию отправляются на конечную точку сигналов, которая является частью Активного Шлюза кластера. Путь '''URL''' — <code>/bf</code> или <code>/bf/</code>.
* В случае автоматического внедрения сигналы по умолчанию отправляются на веб-сервер или сервер приложений, на котором размещено приложение, а путь '''URL''' заканчивается на <code>/rb_</code>.
* '''URL''' сигнала содержит параметры запроса. Убедитесь, что ваш брандмауэр не удаляет никакие параметры запроса.
* Тело '''POST'''-запроса содержит полезную нагрузку. Полезная нагрузка отправляется с типом содержимого <code>text/plain</code>. Для Воспроизведения сессий также может использоваться тип содержимого <code>application/octet-stream</code>. Доступные параметры конфигурации конечной точки сигналов см. в разделе «Настройка конечной точки сигналов для веб-приложений».

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

=== Заголовки запроса ===
{| class="wikitable"
|-
! Заголовок !! Назначение
|-
| <code>x-astromkey</code> || Используется для сшивки транзакций в '''HTTP'''-заголовках. Устанавливается Единым Агентом для связи веб-серверов. Убедитесь, что сетевые компоненты, такие как брандмауэры и маршрутизаторы, никогда не настроены на удаление этих заголовков. Неправильная конфигурация может привести к разрыву распределенных трасс. Некоторые сетевые компоненты отключают такие запросы и выдают ошибку '''HTTP 403''', поэтому необходимо настроить эти компоненты на прием заголовка <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> || Содержит referer страницы для действия и улучшает результаты корреляции.
|-
| <code>x-dtc</code> || Содержит информацию для корреляции кросс-доменных '''XHR'''.
|-
| <code>Cookie</code> || Устанавливает cookie <code>dtCookie</code>, если '''HTTP'''-запрос его не содержит.
|-
| <code>X-Ruxit-Forwarded-For</code> || Используется модулем кода '''NGINX''' для отслеживания сценариев прокси.
|-
| <code>X-ruxit-Apache-ServerNamePorts</code> || Используется модулем кода '''Apache''' для синхронизации именования служб с модулем кода '''PHP'''.
|-
| <code>X-ruxit-Disposition</code> || Используется модулем кода '''IIS''' для упорядочения подпутей модуля кода '''.NET'''.
|-
| <code>Accept-Encoding</code> || Отбрасывается модулем кода '''Apache''' при тонкой настройке поведения внедрения '''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>traceparent</code> || Используется для тегирования '''W3C'''.
|-
| <code>tracestate</code> || Используется для тегирования '''W3C'''.
|-
| <code>referer</code> || Содержит адрес предыдущей веб-страницы, с которой была запрошена текущая страница.
|-
| <code>user-agent</code> ||
|-
| <code>x-host</code> || Содержит информацию о хосте для доменов, не относящихся к '''HTTP(S)'''.
|}

=== Заголовки ответа ===
{| 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> || Устанавливается для ответов на специальные запросы.
|}

== Cookies ==
'''RUM''' использует следующие '''cookies'''. Все они должны иметь возможность достигать Ключ-АСТРОМ. Более подробную информацию о том, как Ключ-АСТРОМ использует '''cookies''', а также объяснение используемых обозначений см. в разделе «Cookies и клиентское хранилище для RUM и Воспроизведения сессий».

{| class="wikitable"
|-
! Cookie !! Максимальный размер !! Назначение
|-
| <code>dtCookie</code> || Нет установленного ограничения, но обычно менее 100 Б || Отслеживает визит на протяжении нескольких запросов.
|-
| <code>dtPC</code> || 58 Б || Идентифицирует правильные конечные точки для передачи сигналов; включает идентификатор сеанса для корреляции.
|-
| <code>dtSa</code> || Максимальная длина '''URL''' || Служит промежуточным хранилищем для действий, охватывающих несколько страниц.
|-
| <code>dtValidationCookie</code> || Длина строки <code>dTValidationCookieValue</code>, составляющая 23 символа || Определяет домен верхнего уровня.
|-
| <code>rxVisitor</code> || 45 Б || Содержит идентификатор посетителя для корреляции сеансов.
|-
| <code>rxvt</code> || 27 Б || Содержит временную метку тайм-аута сеанса.
|-
| <code>dtsrVID</code> || 20 Б || Указывает идентификатор текущей записанной просмотра.
|-
| <code>dtSR</code> || 81 Б || Если включено Воспроизведение сессий, хранит необходимые значения для сохранения непрерывности записи между страницами.
|}
<code>dtsrVID</code> cookie существует в версиях '''RUM JavaScript''' с 1.325+ по 1.333. Дополнительный cookie <code>dtSR</code> доступен, начиная с версии '''RUM JavaScript''' 1.335+.

== Мобильный RUM ==
Для '''RUM Classic''' ЕдиныйАгент для мобильных устройств помечает '''HTTP'''-запросы заголовком <code>x-astromkey</code>. Ключ-АСТРОМ использует этот заголовок для связи мобильной части веб-запроса с сервисной частью, захваченной другим ЕдинымАгентом. Для Нового '''RUM''' ЕдиныйАгент для мобильных устройств помечает '''HTTP'''-запросы с помощью заголовков <code>traceparent</code> и <code>tracestate</code>. Для гибридных приложений cookie <code>dtAdk</code> позволяет объединить сеанс от Единого Агента для мобильных устройств и сеанс от '''RUM JavaScript''' так, чтобы они отображались как один сеанс, а cookie <code>dtAdkSettings</code> используется для синхронизации настроек между ЕдинымАгентом для мобильных устройств и '''RUM JavaScript'''. <code>/mbeacon</code> — это сигнал мониторинга, который ЕдиныйАгент для мобильных устройств отправляет обратно в Ключ-АСТРОМ, если данные передаются через АктивныйШлюз. Если данные отправляются другому ЕдиномуАгенту, сигналом мониторинга является <code>/dtmb</code>.