Документация Ключ-АСТРОМ - Вклад [ru]

Примечания к релизам

2026-09-13T18:22:01Z

IKuznetsov:

Примечания к релизам:

* [[Примечания к релизу 218]]
* [[Примечания к релизу 220]]
* [[Примечания к релизу 222]]
* [[Примечания к выпуску 224|Примечания к релизу 224]]
* [[Примечания к релизу 226]]
*[[Примечания к релизу 228]]
*[[Примечания к релизу 230]]
*[[Примечания к релизу 232]]
*[[Примечания к релизу 234]]
*[[Примечания к релизу 236]]
*[[Примечания к релизу 238]]
*[[Примечания к релизу 240]]
*[[Примечания к релизу 242]]
*[[Примечания к релизу 244]]
*[[Примечания к релизу 246]]
*[[Примечания к релизу 248]]
*[[Примечания к релизу 250]]
*[[Примечания к релизу 252]]
*[[Примечания к релизу 254]]
*[[Примечания к релизу 256]]
*[[Примечания к релизу 258]]
*[[Примечания к релизу 260]]
*[[Примечания к релизу 262]]
*[[Примечания к релизу 264]]
*[[Примечания к релизу 266]]
*[[Примечания к релизу 268]]
*[[Примечания к релизу 270]]
*[[Примечания к релизу 272]]
*[[Примечания к релизу 274]]
*[[Примечания к релизу 276]]
*[[Примечания к релизу 278]]
*[[Примечания к релизу 280]]
*[[Примечания к релизу 282]]
*[[Примечания к релизу 284]]
*[[Примечания к релизу 286]]
*[[Примечания к релизу 288]]
*[[Примечания к релизу 290]]
*[[Примечания к релизу 292]]
*[[Примечания к релизу 294]]
*[[Примечания к релизу 296]]
*[[Примечания к релизу 300]]
*[[Примечания к релизу 304]]
*[[Примечания к релизу 308]]
*[[Примечания к релизу 312]]
*[[Примечания к релизу 316]]
*[[Примечания к релизу 320]]
*[[Примечания к релизу 324]]
*[[Примечания к релизу 328]]
*[[Примечания к релизу 332]]

[[Новости о прекращении поддержки]]

[[Поддержка новых технологий]]

Примечания к релизу 332

2026-09-13T18:21:40Z

IKuznetsov: Новая страница: « == ⚙️ Ключ-АСТРОМ == === Новая функциональность === * '''Мониторинг использования лицензии кластера''': Добавлен дашборд в локальной среде самоконтроля кластера, позволяющий отслеживать использование лицензий на хостовые единицы, единицы данных '''ИИ''' ('''DD...»

== ⚙️ Ключ-АСТРОМ ==

=== Новая функциональность ===

* '''Мониторинг использования лицензии кластера''': Добавлен дашборд в локальной среде самоконтроля кластера, позволяющий отслеживать использование лицензий на хостовые единицы, единицы данных '''ИИ''' ('''DDU''') и единицы '''Digital Experience Monitoring''' ('''DEM''') в рамках классического лицензирования. Также добавлены специальные метрики биллинга для каждого типа лицензии, что позволяет настраивать оповещения о событиях лицензирования (например, при приближении к исчерпанию единиц) с помощью событий метрик.
* '''Настройка и переопределение маскирования ЕдиногоАгента на уровне группы хостов''': Маскирование данных ЕдиногоАгента теперь можно настраивать и переопределять на уровне группы хостов в дополнение к уже существующим уровням окружения, кластера/пространства имен '''Kubernetes''' и группы процессов. Это особенно удобно при управлении сотнями приложений в многокомандных и многодепартаментных средах.
* '''Интуитивная функция масштабирования для графиков в Визуализация данных''': Добавлена возможность масштабирования непосредственно на графиках в '''Визуализация данных'''. Для увеличения выберите начальную точку, удерживайте кнопку мыши и перетащите к конечной точке. После отпускания кнопки появится диалог подтверждения интервала масштабирования. Для возврата к предыдущему временному диапазону используйте кнопку отмены.
* '''Повышение точности мониторинга лимитов измерений для метрик''': Использование пользовательских метрик с постоянным потоком новых значений измерений (например, '''UID''' подов '''Kubernetes''') могло отображать некорректные шаблоны в самоконтроле. Теперь лимиты измерений рассчитываются точно, что обеспечивает более четкое и надежное понимание использования метрик.
* '''Предложения для селекторов сущностей в настройках''': Автоматически применяемые теги, зоны управления и определения '''SLO''' теперь поддерживают предложения селекторов сущностей. Вместо ручного ввода селекторов сущностей можно использовать эту функцию автозаполнения, которая предлагает доступные фильтры, операторы и значения.
* '''Новая конечная точка Metrics API v2 для удаления устаревших метрик''': '''Metrics API v2''' теперь включает новую конечную точку, позволяющую удалять метрики, которые не записывались в течение заданного количества дней. Можно использовать <code>DELETE /api/v2/metrics</code> для удаления принятых метрик, параметр <code>metricSelector</code> для выбора конкретных метрик, подстановочные знаки для удаления метрик с префиксом или всех метрик, указав <code>*</code>, и параметр <code>minUnusedDays</code> для определения количества дней, в течение которых метрика должна оставаться неиспользуемой перед удалением. Пример: удалить все метрики, не записанные за последние 60 дней: <code>DELETE /api/v2/metrics?metricSelector=&minUnusedDays=60</code>.
* '''Проверка совместимости версий ЕдиногоАгента''': '''OneAgent Health''' теперь отображает самую низкую и самую высокую совместимые версии ЕдиногоАгента с данным кластером Ключ-АСТРОМ. Кроме того, выдается предупреждающее сообщение, если версия ЕдиногоАгента слишком низкая или слишком высокая, что позволяет быстро подключить ЕдиногоАгент совместимой версии.
* '''Улучшенный интерфейс конфигурации для мониторинга AWS Lambda''': В рабочий процесс развертывания Lambda внесены улучшения удобства использования и надежности, обеспечивающие согласованное поведение между типами развертывания и предотвращающие распространенные ошибки конфигурации. В частности, добавлен автоматический выбор '''DT_CONNECTION_BASE_URL''' с использованием '''АктивногоШлюза''' для повышения надежности и устранения ошибок конфигурации. Классический мониторинг Lambda для Managed-offline теперь всегда включен, а флажок включения удален из интерфейса.
* '''Улучшенная корреляция сервисов для триггеров сообщений функций AWS Lambda''': Улучшена корреляция сервисов для триггеров сообщений в функциях AWS Lambda, которые отслеживаются слоем ЕдиногоАгента для AWS Lambda.
* '''Новая страница Services включена по умолчанию''': Новая страница сервисов теперь включена по умолчанию во всех окружениях, что позволяет воспользоваться преимуществами нового дизайна и функций анализа.
* '''Поддержка PKCE для OpenID Connect''': Ключ-АСТРОМ теперь поддерживает '''PKCE''' (Proof Key for Code Exchange) для '''OpenID Connect'''. PKCE — это расширение для потока кода авторизации '''OAuth 2.0''', предназначенное для предотвращения атак перехвата кода авторизации. Для включения перейдите в CMC > Аутентификация пользователей > Настройки единого входа, выберите '''OpenID Connect''' и включите '''Use PKCE'''.
* '''Сворачивание панели настроек в Визуализация данных''': Теперь можно свернуть панель настроек в '''Визуализация данных''', чтобы освободить больше места для графиков. Это особенно полезно на небольших экранах.
* '''Новая опция конфигурации для различения похожих отчетов о событиях''': Теперь можно определить тег корреляции для всех источников событий — <code>dt.event.correlation_tag</code>. Используйте этот необязательный тег, чтобы явно создавать отдельные события, даже если отчеты о событиях основаны на похожих данных, таких как заголовок и сущность.
* '''OneAgent Health теперь включает атрибуты ресурсов''': Теперь можно получить доступ к атрибутам ресурсов, собранным кодовыми модулями, в '''OneAgent Health'''. Чтобы просмотреть их, выберите кодовый модуль в таблице данных и разверните раздел сведений. Атрибуты ресурсов могут использоваться в качестве входных данных для правил '''Service detection v2'''.
* '''Мониторинг tmpfs через ЕдиногоАгент доступен как opt-in поведение''': ЕдиноАгент обновлен для мониторинга данных '''tmpfs''' в системах '''Linux'''. Активировать этот мониторинг можно на основе opt-in в разделе «Настройки» > «Сбор и захват» > «Инфраструктура» > «ОС» > «Включить мониторинг дисков tmpfs».

=== Список устранённых проблем ===

* Устранена проблема, при которой модули мониторинга журналов неправильно включались в проверку квоты хостовых единиц, что могло приводить к вводящей в заблуждение информации об использовании квоты. <code>(MGD-8983)</code>
* Исправлены установочные пакеты, которые некорректно синхронизировались между узлами, если в папке установщика сервера Ключ-АСТРОМ присутствовал файл сценария без семантической версии в имени. <code>(MGD-8354)</code>
* Устранена проблема с развертываниями только для приложений, когда несколько кодовых модулей могли перезаписывать версию ЕдиногоАгента друг друга на одном хосте. <code>(MGD-6868)</code>
* Исправлена ошибка в JavaScript-шаге монитора браузера с автоматическим входом, предотвращающая сбои при сбое монитора. <code>(DEM-18430)</code>
* Обеспечена согласованная обработка пробельных конечных точек: спаны '''Service detection v2''' теперь обрабатывают конечные точки, состоящие из всех пробельных символов, так же, как пустые конечные точки, в результате чего <code>endpoint.name</code> не присваивается. <code>(APPOBS-30130)</code>
* Исправлена проблема с модулем проверки работоспособности '''NGINX''', отвечающим за перенаправление трафика между узлами кластера. <code>(MGD-9000)</code>
* Исправлена проблема, при которой повторное открытие глобального селектора временных рамок вызывало дублирование строк часовых поясов. <code>(MGD-9441)</code>
* Обновлена библиотека '''log4j''' для '''CVE-2025-68161''' во избежание ложных срабатываний сканеров безопасности. Сервер Ключ-АСТРОМ не затронут этим уведомлением безопасности. <code>(MGD-9264)</code>
* Ранее фильтр поиска в '''Визуализация данных''' в некоторых сценариях предоставлял пустые предложения. Теперь фильтр поиска всегда показывает соответствующие предложения. <code>(MGD-8961)</code>
* Ранее '''Визуализация данных''' отображала локальные временные рамки для неподдерживаемых типов визуализации или даже когда они были деактивированы. Теперь локальные временные рамки видны только при активации и только для поддерживаемых типов визуализации. <code>(MGD-8770)</code>
* Исправлена визуализация временных рамок для плиток в '''Визуализация данных''' и дашбордах. Периоды времени, выходящие в будущее, теперь ограничены текущим временем. <code>(MGD-7906)</code>
* Ранее уведомления по электронной почте о сущностях синтетического мониторинга отображали затронутые сущности зеленым текстом, хотя должны были отображать красным. Теперь затронутые сущности всегда отображаются красным. <code>(DI-24639)</code>
* Введены дополнительные меры контроля доступа для внутренней конечной точки Hub API, маршрутизируемой через обратный прокси Mission Control. <code>(ASDY-3035)</code>

=== Список запланированных изменений ===

* '''Событийные конечные точки удалены из Extensions Environment API v2''': Следующие устаревшие конечные точки удалены из Environment API v2: <code>/extensions/{extensionName}/environmentConfiguration/events</code> и <code>/extensions/{extensionName}/monitoringConfigurations/{configurationId}/events</code>.
* '''Встроенный чат заменен внешней ссылкой''': Встроенный чат заменен внешней ссылкой на Центр поддержки Ключ-АСТРОМ.
* '''Метрика <code>fileDescriptorsPercentUsed</code> больше не разделяется по PID''': По соображениям производительности измерение '''PID''' было удалено из метрики <code>fileDescriptorsPercentUsed</code>. Ключ метрики: <code>builtin:tech.generic.handles.fileDescriptorsPercentUsed</code>.
* '''Удалена обратная совместимость для АктивныхШлюзов старше версии 1.172''': Начиная с версии '''АктивногоШлюза''' 1.172, все АктивныеШлюзы поддерживают списки приоритетных конечных точек. Для снижения сложности продукта неприоритетные списки конечных точек больше не поддерживаются.
* '''Имя локальной среды самоконтроля больше нельзя изменить''': Имя локальной среды самоконтроля установлено как '''Local Self-Monitoring''' и больше не может быть изменено через Cluster Management Console. Если имя уже было изменено, оно будет сброшено на '''Local-Self-Monitoring'''.
* '''Прекращение поддержки нативных мобильных приложений (iOS и Android)''': Ключ-АСТРОМ прекращает поддержку своих нативных мобильных приложений для '''iOS''' и '''Android'''. Последнее обновление приложения: конец 2025 года. Дата прекращения поддержки: 30 июня 2026 года. Рекомендуется использовать адаптивный веб-интерфейс и настроить предпочитаемые интеграции для уведомлений.

Примечания к релизу 328

2026-09-13T18:13:32Z

IKuznetsov: /* Новая функциональность */

== ⚙️ Ключ-АСТРОМ ==

=== Новая функциональность ===
* '''Изменение базового уровня с учетом праздничных дней''': Из базового уровня сервисов и приложений теперь систематически исключаются такие государственные праздники, как Новый год, Пасха, День благодарения, Черная пятница и Рождество, чтобы свести к минимуму риск ложных оповещений. Настройка включена по умолчанию, отключить её можно в разделе «Настройки» > «Обнаружение аномалий» > «Изменение базового уровня с учетом праздничных дней».
* '''Отслеживание использования лицензии кластера через API''': Теперь можно отслеживать использование лицензий на хостовые единицы, единицы данных '''ИИ''' ('''DDU''') и единицы '''Digital Experience Monitoring''' ('''DEM''') в рамках классического лицензирования через '''Cluster API v2''' – Cluster license.
* '''Добавлена кнопка очистки кэша в базе данных при неудачном бэкапе''': В интерфейс управления кластером добавлена кнопка, позволяющая вручную очистить кэш базы данных в случае, если операция резервного копирования завершилась неудачно. Это позволяет устранить последствия сбоя и восстановить штатную работу системы резервного копирования без полной перезагрузки компонентов кластера.
* '''Внесены исправления в механизмы схемы ConditionalNamingRule''': Схема '''ConditionalNamingRule''' получила ряд исправлений в работе внутренних механизмов. Это повышает корректность применения условных правил именования и снижает вероятность ошибок при обработке конфигураций, использующих данную схему.
* '''Внесены исправления по отображению хостов''': Устранены проблемы, связанные с отображением хостов в интерфейсе. Исправления затрагивают корректность представления списка хостов и связанных с ними данных, что обеспечивает более точное и стабильное отображение информации о monitored-хостах.

=== Список устранённых проблем ===
* Отключен общий доступ на основе политики '''IAM'''. <code>(PAPA-29450)</code>
* Исправлена проблема с модулем проверки работоспособности '''NGINX''', отвечающим за перенаправление трафика между узлами кластера. <code>(MGD-9000)</code>
* '''Cassandra''' обновлена до версии '''4.1.10''', что обеспечивает критические исправления ошибок и безопасности.
* Устранена проблема с проверками ссылочной целостности между настройками, которая мешала сохранению изменений, если значение настройки содержало неизмененные секреты и ссылку на другую настройку. <code>(PS-36658)</code>
* Новый тип события «Предупреждение» теперь можно задать в классическом шаблоне события. <code>(DI-23143)</code>
* Исправлена проблема, из-за которой проблема A связывалась с проблемой B как дубликат, но проблема B не содержала событий из проблемы A, если проблема B достигала лимита доказательств. <code>(DI-23018)</code>
* Исправлена проблема, из-за которой уведомления о проблемах с текстовым форматом (text/html/markdown) отображали время начала/окончания проблемы в '''UTC''' вместо часового пояса, настроенного для сервера Ключ-АСТРОМ. <code>(DI-23006)</code>
* Исправлены проблемы рендеринга '''Воспроизведения сессий''', связанные с обработкой '''CSS''' <code>@import</code>. <code>(DEM-15898)</code>
* Исправлена ошибка в хранилище отслеживаемых сущностей, которая могла приводить к пустым результатам запросов при превышении 2.5 млн встроенных типов во время перестроения индекса атрибутов. <code>(MGD-8002)</code>
* Логика обработки исключений адаптирована таким образом, что <code>PersistenceUnavailableException</code> теперь логируется как <code>INFO</code>. <code>(DI-22667)</code>

=== Список запланированных изменений ===
* '''Автоматическая миграция <code>span:services</code> на SDv2''': Устаревшие сервисы, принимаемые через '''OTLP API''', будут автоматически перенесены на тип '''Unified Services''' с включенным обнаружением аномалий с помощью '''ИИ'''.
* '''Упрощенный поиск в продукте''': Результаты поиска больше не включают документацию и материалы сообщества, вместо этого добавлена статическая ссылка на <code>search.astromkey.com</code>.
* '''Обеспечение согласованности данных в Kubernetes Observability''': Модули '''ЕдиногоАгента''' теперь отклоняются, если версия модуля ОС устарела, что может привести к потере наблюдаемости для затронутых рабочих нагрузок до синхронизации версий.
* '''Добавлена подпись сообщений SAML HTTP-Redirect''': Если в метаданных '''SAML 2.0''' указано <code>wantsAuthnRequestsSigned=true</code>, запросы аутентификации теперь подписываются. Запросы и ответы на выход из системы теперь подписываются по умолчанию.

== 🔍 ЕдиныйАгент ==

=== Новая функциональность ===
* '''Воспроизведение сессий (Session Replay) для мобильных приложений доступно всем клиентам''': Позволяет смотреть, как пользователи взаимодействуют с нативными мобильными приложениями, в режиме видео-подобного воспроизведения, фиксирующего касания, жесты и навигационные потоки.
* '''Игнорирование временных меток в строках, начинающихся с пробелов''': Можно настроить модуль журналов '''ЕдиногоАгента''' на игнорирование временных меток в строках, начинающихся с пробелов. Настройка выполняется в разделе «Настройки» > «Сбор и захват» > «Мониторинг журналов» > «Шаблоны временных меток / разделения».
* '''RUM Web Agent: отправка события Space и игнорирование событий с pointerId -1''': '''RUM Web Agent''' теперь отправляет событие взаимодействия при нажатии клавиши Space и игнорирует надежные синтетические события клика с <code>pointerId</code> -1.
* '''Прекращение отчета метрик хоста в режиме Discovery''': Метрики <code>host.total.swap</code>, <code>disk.used.percentage</code> и <code>process.total.I/O.bytes</code> больше не отображаются в режиме '''Discovery'''.
* '''Дополнительные поддерживаемые метрики для DB2 на z/OS''': Добавлена поддержка метрик: количество взаимоблокировок, количество тайм-аутов взаимоблокировок, время приостановки защелки, количество SELECTS, INSERTS, UPDATES, DELETES, FETCHES, OPENS, CLOSES.
* '''Поддержка MongoDB Reactive Streams''': Обеспечена поддержка '''MongoDB Reactive Streams''' и более новых синхронных версий (5.x).
* '''Поддержка трассировки Kotlin Coroutine''': Добавлена поддержка трассировки '''Kotlin Coroutine''', которая по умолчанию отключена.
* '''Поддержка Go''': Добавлена поддержка '''Go 1.25.3''' и '''1.24.9''', а также '''Go 1.24.8''' и '''1.25.2'''.
* '''Поддержка ARM для модуля кода Go''': Добавлена поддержка мониторинга stripped '''ARM64 binary''' для модуля кода '''Go'''.
* '''Улучшена связь пользовательских действий с распределёнными трассировками''': Улучшена связь для '''Netty RUM''' за счёт использования HTTP-заголовка Server-Timing.
* '''Поддержка z/OS 3.2''': Обеспечена поддержка '''z/OS 3.2'''.

=== Список устранённых проблем ===
* Исправлена проблема, из-за которой отчеты журналов контейнеризованных приложений, записанные в локальном часовом поясе без указания часового пояса в формате временной метки, принимались с неверным значением временной метки. <code>(OA-58490)</code>
* Исправлена проблема, из-за которой метрика доступности хоста в некоторых случаях имела пропуски. <code>(OA-58293)</code>
* Исправлена проблема, из-за которой в некоторых случаях не деактивировались события. <code>(OA-57726)</code>
* Исправлена проблема с Threading Sensor, который инструментировал бесконечный цикл в <code>KafkaMessageListenerContainer$ListenerConsumer</code>. <code>(OA-54736)</code>
* Исправлена утечка памяти в '''OTEL span sensor''', вызванная сохранением thread-local переменных. <code>(OA-54725)</code>
* Исправлена проблема, приводившая к отсутствию данных в трассировке '''ADO'''. <code>(OA-54606)</code>
* Устранена проблема с блокировкой в '''Windows''' при использовании <code>boost::icontains</code>. <code>(OA-54564)</code>
* Исправлены проблемы с потоковой передачей журналов после повторной инициализации '''CICS Agent'''. <code>(OA-54319)</code>
* Удалена устаревшая обработка, при которой HTTP-запросы идентифицировались как запросы '''JavaScript Agent''' на основе <code>jsAgentFilename</code> или <code>jsAgentFilenameDebug</code> из настроек '''UEM''' приложения. <code>(OA-54219)</code>
* Исправлена проблема, из-за которой сервисы '''CICS''' отсутствовали из-за неправильной обработки определенных типов путей. <code>(OA-53529)</code>
* Исправлена возможная ошибка, вызванная модулем кода '''.NET''' в случае дублирования имен пространств имен и классов. <code>(OA-53327)</code>
* Снижено потребление памяти при загрузке установщика агента с тенанта. <code>(OA-52651)</code>
* Исправлена проблема с '''Apache'''/'''NGINX'''/'''IIS''', которая иногда приводила к несоответствию размеров тела ответа заголовку content-length при включенных бизнес-событиях и использовании сжатия. <code>(OA-52314)</code>
* Исправлена проблема в '''CICS''' web client hook disable, которая в редких случаях могла привести к аварийному завершению. <code>(OA-53700)</code>
* Реализованы улучшения для полноты и эффективности логирования. <code>(OA-52864)</code>
* Исправлены некорректные метрики CPU '''DB2''', когда '''DB2''' сообщает -1% в '''SMF'''. <code>(OA-52518)</code>
* Улучшена логика парсинга <code>AndroidManifest.xml</code> при использовании разрывов строк в теге. <code>(DEM-15815)</code>
* Исправлена проблема, из-за которой метрики и журналы расширений баз данных никогда не обновляли информацию об устройстве. Информация об устройстве теперь обновляется раз в час. <code>(DAQ-11256)</code>
* Устранена уязвимость в '''ЕдиногоАгенте''' для '''Windows''', при которой хеши '''NTLM''' могли быть раскрыты во время обнаружения сетевых ресурсов. <code>(OA-51887)</code>
* Исправлена проблема с путями, ограниченными узлами '''IMS''', которая приводила к ошибкам последовательности и дампам протокола в '''zRemote'''. <code>(OA-52874)</code>
* Источник данных '''SNMP''' больше не отправляет дублирующиеся журналы '''SFM''' при тайм-ауте <code>getbulk</code>. <code>(DAQ-13534)</code>
* OS Agent теперь корректно отображает версию '''JVM''', состоящую только из цифр. <code>(OA-52176)</code>
* Исправлена потенциальная ошибка при работе '''NGINX''' с <code>ngx_http_js_module</code>. <code>(OA-53686)</code>
* Исправлено обнаружение инструментария '''Red Hat Go FIPS'''. <code>(OA-53721)</code>
* Метрики доступности сервисов ОС теперь помечаются кластерным временем, а не локальным временем хоста. <code>(OA-52821)</code>
* Исправлена обработка нетабличных сервисов '''Linux''' с символом <code>@</code> в имени. <code>(OA-53573)</code>
* Исправлена проблема с обнаружением и отслеживанием фоновых '''URLSessions''' в '''iOS'''. <code>(DEM-16385)</code>
* Исправлена инструментация тернарного оператора '''SwiftUI'''. <code>(DEM-16142)</code>

=== Список запланированных изменений ===
* '''Парсинг JSON-логов включен по умолчанию''': Модуль журналов '''ЕдиногоАгента''' теперь по умолчанию парсит '''JSON'''-формат для принимаемых журналов, включая определение границ записей, извлечение временных меток и парсинг уровней. Это может изменить способ парсинга существующих журналов.
* '''Понижение функции RUM v2 с opt-in до DevOps-only''': Функция '''Java Real User Monitoring v2''' (ключ: <code>JAVA_UEM_INSTRUMENTATION</code>) переименована в '''Java Real User Monitoring (RUM) Troubleshooting Mode''' и понижена с opt-in до DevOps-only. Теперь она доступна только DevOps-командам для устранения неполадок.
* '''Установка не будет выполнена при наличии недопустимых параметров''': Для '''Windows''' установка '''ЕдиногоАгента''' завершится ошибкой, если переданы недопустимые параметры установки, включая устаревшие, такие как <code>--set-infra-only</code> и <code>INFRA_ONLY</code>.
* '''Прекращение поддержки Jetpack Compose 1.3''': Плагин '''Android Gradle''' будет отменять сборку приложений, использующих эту версию.

== 🌐 АктивныйШлюз ==

=== Новая функциональность ===
* '''Утилита agctl''': Добавлена опция <code>--stdout</code> для команды <code>create-support-archive</code>, позволяющая передавать содержимое архива непосредственно в '''stdout'''.
* '''Kubernetes (производительность)''': Повышена производительность парсинга '''OpenMetrics''' в мониторинге '''Kubernetes'''.
* '''Kubernetes (очистка подключений)''': '''АктивныйШлюз''' теперь по умолчанию освобождает неиспользуемые соединения в фоновом режиме, чтобы избежать сценариев насыщения, которые могут привести к пробелам в мониторинге.

=== Список устранённых проблем ===
* Дополнительные данные маскируются для '''Kubernetes Enhanced Object Visibility''' в '''YAML'''-представлении (<code>k8s.object</code>), включая конфиденциальную информацию, такую как переменные окружения рабочих нагрузок и подов, а также массивы команд и аргументов. <code>(INFOBS-5556)</code>
* Метрики '''Prometheus kube-state-metrics''', принимаемые через мониторинг '''Kubernetes''', теперь обогащаются измерением <code>k8s.cluster.uid</code>. <code>(INFOBS-5445)</code>
* Устранена проблема с приемом данных для '''Kubernetes Enhanced Object Visibility Preview''', затрагивающая только определенные пограничные случаи. <code>(INFOBS-5079)</code>
* Исправлена проблема с '''Kubernetes Enhanced Object Visibility''' в сочетании с '''Kubernetes Security Posture Management'''. <code>(INFOBS-4759)</code>

=== Список запланированных изменений ===
* '''Прекращение поддержки Red Hat/Oracle Linux/Rocky Linux 8''': Поддержка установки '''АктивногоШлюза''' с синтетическим мониторингом на этих ОС прекращена после версии 1.325. Рекомендуется мигрировать на версию 9.
* '''Блокировка версий Chromium ниже 126''': Начиная с синтетической версии 1.325, установки не будут работать с версиями '''Chromium''' ниже 126. Установщик теперь включает проверку совместимости.
* '''Устаревшие атрибуты <code>dt.kubernetes.xxx.name</code>''': Атрибуты <code>dt.kubernetes.workload.name</code>, <code>dt.kubernetes.workload.kind</code>, <code>dt.kubernetes.node.name</code>, <code>dt.kubernetes.cluster.name</code> объявлены устаревшими. Их следует заменить эквивалентными атрибутами из '''Semantic Dictionary''' (<code>k8s.workload.name</code>, <code>k8s.workload.kind</code>, <code>k8s.node.name</code>, <code>k8s.cluster.name</code>).

Навигация 2.0

2026-09-03T19:31:50Z

IKuznetsov:

'''''[[Применение Ключ-АСТРОМ]] / [https://doc.ruscomtech.ru/index.php/Применение_Ключ-АСТРОМ#.D0.9D.D0.B0.D0.B2.D0.B8.D0.B3.D0.B0.D1.86.D0.B8.D1.8F_2.0 Навигация 2.0]'''''

== Начало работы с Ключ-АСТРОМ ==

* [[Что такое Ключ-АСТРОМ|'''Что такое Ключ-АСТРОМ''']]
* '''[[Мониторинг Среды|Мониторинг среды]]'''
* [[Навигация по платформе Ключ-АСТРОМ|'''Навигация по платформе Ключ-АСТРОМ''']]
** [[Страницы ошибок HTTP в среде Ключ-АСТРОМ]]
** [[Обозначение порядка величин]]
** [[Требования к веб-интерфейсу Ключ-АСТРОМ|Требования к веб-интерфейсу]]

* '''[[Проектирование платформ]]'''

== Развертка Ключ-АСТРОМ ==

* [[АктивныйШлюз Ключ-АСТРОМ|'''АктивныйШлюз Ключ-АСТРОМ''']]
** [[Цели АктивногоШлюза]]
*** [[Направление трафика ЕдиногоАгента]]
*** [[Запуск синтетических мониторов из частных локаций]]
*** [[Установка модуля zRemote для мониторинга z/OS]]
** [[Схемы подключения АктивныхШлюзов]]
** [[Установка АктивногоШлюза]]
*** [[Установка АктивногоШлюза на Linux|Linux]]
*** [[Установка АктивногоШлюза на Windows|Windows]]
**** [[Инструкция по установке компонента АктивныйШлюз с синтетикой на платформу РЕД ОС]]
**** [[Инструкция по установке компонента АктивныйШлюз с синтетикой на платформу РЕД ОС без Интернета]]
** [[Конфигурация АктивногоШлюза]]
*** [[Параметры АктивногоШлюза]]
*** [[Настройка прокси АктивногоШлюза]]
*** [[Обратный прокси (балансировщик загрузки) для АктивногоШлюза]]
*** [[Пользовательский SSL-сертификат для АктивногоШлюза]]
*** [[Доверенные корневые сертификаты для АктивногоШлюза]]
*** [[Конфигурация шифра для АктивногоШлюза]]
*** [[Развертывание АктивногоШлюза в нескольких средах]]
*** [[Директории АктивногоШлюза]]
** [[Образ АтивногоШюза в контейнере]]
*** [[Различия АктивныхШлюзов]]
*** [[Конфигурация АктивныхШлюзов]]
*** [[Вместимость АктивныхШлюзов]]
** [[Группы АктивныхШлюзов]]
** [[Диагностика АктивногоШлюза]]
** [[Самостоятельный мониторинг АктивногоШлюза]]
** Операции с АктивнымиШлюзами
*** [[Запуск/остановка/перезапуск АктивногоШлюза]]
*** [[Обновление АктивногоШлюза]]
*** [[Удаление АктивногоШлюза]]
** [[Безопасность АктивногоШлюза]]
*[[ЕдиныйАгент Ключ-АСТРОМ|'''ЕдиныйАгент Ключ-АСТРОМ''']]
** [[ЕдиныйАгент требования к памяти|Требования к памяти для ЕдиногоАгента]]
** [[Установка и эксплуатация ЕдиногоАгента]]
*** [[Установка ЕдиногоАгента на AIX|AIX]]
*** [[Установка ЕдиногоАгента на Linux|Linux]]
*** [[Установка ЕдиногоАгента на Solaris|Solaris]]
*** [[Установка ЕдиногоАгента на Windows|Windows]]
*** z/OS
****[[Установка ЕдиногоАгента на Z/OS|Установка]]
****[[Операции ЕдиногоАгента на Z/OS|Операции]]
****[[Мониторинг ЕдиногоАгента на Z/OS|Мониторинг]]
** [[Возможности ЕдиногоАгента]]
** [[Обзор работоспособности ЕдиногоАгента|Состояние ЕдиногоАгента]]
**[[Безопасность ЕдиногоАгента]]
** [[Обновление ЕдиногоАгента]]
** [[Оркестровка развертывания ЕдиногоАгента|Оркестрация развертывания ЕдиногоАгента]]
*** [[Установка ЕдиногоАгента с помощью Ansible|Ansible]]
** [[ЕдиныйАгент настройка через интерфейс командной строки|Интерфейс командной строки ЕдиногоАгента]]
** Поиск неисправностей ЕдиногоАгента
*** [[Устранение неполадок при установке ЕдиногоАгента|Проблемы с установкой]]
*** [[Устранение неполадок при мониторинге ЕдиногоАгента|Проблемы прерывания мониторинга]]
*** [[Устранение неполадок глубокого мониторинга ЕдиногоАгента|Проблемы глубокого мониторинга]]
*** [[Диагностика ЕдиногоАгента]]
** [[Механизм устаревания файлов ЕдиногоАгента]]
*'''[[Расширение|Расширения]]'''
** [[О расширениях]]
** Расширенная конфигурация
*** [[Специальная конфигурация профиля производительности|Специальный профиль производительности]]
*** [[Настройка данных с помощью расширений|Настройте данные с помощью расширений]]
*** [[Распространение пользовательских дашбордов с расширениями|Распространение пользовательских дашбордов]]
*** [[Пользовательская конфигурация контроллера выполнения расширений]]
*** [[Оповещения о расширениях|Оповещение о расширениях]]
** [[Изучите поддерживаемые расширения]]
*** [[Расширение Apache Kafka]]
*** [[Расширение Microsoft SQL Server]]
*** [[Расширение IBM MQ]]
***[[Расширение UPS Device]]
***[[Расширение Oracle Database]]
***[[Расширение PostgreSQL]]
***[[Расширение Redis]]
***[[Расширение Elasticsearch]]
***[[Расширение Hadoop]]
***[[Расширение NVIDIA]]
*** Источники данных
**** [[Управление расширениями SNMP|SNMP]]
**** [[Управление расширениями WMI|WMI]]
**** [[Расширения SQL|SQL]]
***** [[Управление расширениями базы данных Oracle|Oracle]]
***** [[Управление расширениями Microsoft SQL Server|Microsoft SQL Server]]
***** [[Управление расширениями PostgreSQL|PostgreSQL]]
***** [[Управление расширениями MySQL|MySQL]]
***** [[Управление расширениями базы данных Snowflake|Snowflake]]
***** [[Управление расширениями базы данных SAP Hana|SAP Hana DB]]
***** [[Управление расширениями базы данных IBM|IBM DB2]]
** [[Управление расширениями]]
** [[Ограничения расширений|Ограничения]]
** [[Поиск неисправностей расширений|Поиск неисправностей]]
** [[Разработка собственных расширений]]
*** [[Дополнение для VS Code]]
**** [[Начало работы с VS Code|Начало работы]]
****[[Поддержка разработки для VS Code|Поддержка разработки]]
****[[Справочник команд для VS Code|Справочник команд]]
****[[Настройки для VS Code|Настройки]]
****[[Специализированные представления для VS Code|Специализированные представления]]
****[[Поиск неисправностей VS Code|Поиск неисправностей]]
****Руководства по применению
*****[[Создание расширений Python]]
*****[[Перенос расширений Python]]
*****[[Перенос расширений JMX]]
*** [[Расширения YAML-файла|Расширение файла YAML]]
*** [[Расширения знаков]]
*** [[Создание пользовательских расширений]]
*** Источники данных
**** [[Источник данных SNMP|SNMP]]
***** [[Справка о источнике данных SNMP|Справка]]
***** [[Источник данных SNMP-traps|SNMP-Traps]]
***** Поиск неисправностей
**** [[Источник данных JMX|JMX]]
***** [[Справка о источнике данных JMX|Справка]]
**** [[Источник данных Prometheus|Prometheus]]
***** [[Справка о источнике данных Prometheus|Справка]]
**** [[Источник данных SQL|SQL]]
***** [[Конфигурация IBM DB2|IBM DB2]]
***** [[Конфигурация JDBC|JDBC]]
***** [[Конфигурация Microsoft SQL|Microsoft SQL]]
***** [[Конфигурация MySQL|MySQL]]
***** [[Конфигурация Oracle Database|База данных Oracle]]
***** [[Конфигурация PostgreSQL|PostgreSQL]]
***** [[Конфигурация SAP Hana Database|База данных SAP Hana]]
***** [[Конфигурация Snowflake Database|База данных Snowflake]]
***** [[Справка о источнике данных SQL|Справка]]
**** [[Источник данных WMI|WMI]]
***** [[Пособие по источнику данных WMI]]
***** [[Справка о источнике данных WMI|Справка]]
**** [[Источник данных Python SDK|Python SDK]]
*'''[[OpenTelemetry]]'''
** [[Использование OpenTelemetry с Ключ-АСТРОМ|Начало работы]]
*** [[Экспорт с помощью OTLP]]
*** [[Конфигурация Ключ-АСТРОМ]]
*** Логи
**** [[Прием логов OpenTelemetry|Прием данных]]
*** Метрики
**** [[Настройка приема метрик OpenTelemetry|Настройка]]
**** [[Ограничения метрик OpenTelemetry|Ограничения]]
**** [[Прием метрик OpenTelemetry|Прием данных]]
***** [[Переход с экспорта метрик Ключ-АСТРОМ OpenTelemetry на экспорт метрик OTLP|Переход на экспорт метрик OTLP]]
*** Трассировки
**** [[Прием трассировок OpenTelemetry|Прием данных]]
**** [[Трассировки OpenTelemetry с помощью ЕдиногоАгента]]
** [[Collector Ключ-АСТРОМ|Collector]]
***[[Развертывание Collector|Развертывание]]
***[[Настройка Collector|Настройка]]
***[[Варианты использования Collector|Варианты использования]]
****[[Пакеты запроса OTLP]]
****[[Внедрение FluentD|FluentD]]
****[[Преобразование OTLP gRPC|gRPC в HTTP]]
****[[Вычисление сводки гистограмм|Гистограмма]]
****[[Прием данных от Jaeger|Jaeger]]
****Kubernetes
***** [[Обогащение из Kubernetes|Обогащение]]
***** [[Мониторинг Kubernetes|Мониторинг]]
***** [[Логи приема pod|Логи Pod]]
****[[Получение данных из файла логов|Файлы логов]]
****[[Маскировка конфиденциальных данных|Маскировка данных]]
****[[Применение ограничения памяти|Ограничение памяти]]
****[[Отправка данных на несколько бэкэндов|Несколько бэкэндов]]
****[[Расширение с помощью ЕдиногоАгента]]
****[[Извлечение данных из Prometheus|Prometheus]]
****[[Примеры данных]]
****[[Получение данных из StatsD|StatsD]]
****[[Прием пакетов NetFlow|NetFlow]]
****[[Сбор данных системных логов с помощью OpenTelemetry Collector|Системные логи]]
****[[Преобразование и фильтрация]]
****[[Прием данных из Zipkin|Zipkin]]
***[[Системные требования]]
***[[Самоконтроль OpenTelemetry Collector|Самоконтроль]]
***[[Ссылки Collector|Ссылки]]
***[[Масштабирование Collector|Масштабирование]]
** [[Инструментарий OpenTelemetry|Инструментарий]]
***[[Java OpenTelemetry|Java]]
**** [[Автоматическое внедрение OpenTelemetry в Java-приложение|Автоматическое внедрение]]
**** [[Ручное внедрение OpenTelemetry в Java-приложение|Ручное внедрение]]
*** [[PHP OpenTelemetry|PHP]]
**** [[Автоматическое внедрение OpenTelemetry в PHP-приложение|Автоматическое внедрение]]
**** [[Ручное внедрение OpenTelemetry в PHP-приложение|Ручное внедрение]]
*** [[Python OpenTelemetry|Python]]
**** [[Автоматическое внедрение OpenTelemetry в Python-приложение|Автоматическое внедрение]]
**** [[Ручное внедрение OpenTelemetry в Python-приложение|Ручное внедрение]]
***[[C++ OpenTelemetry|C++]]
***[[.NET OpenTelemetry|.NET]]
***[[Elixir OpenTelemetry|Elixir]]
***[[Erlang OpenTelemetry|Erlang]]
***[[Go OpenTelemetry|Go]]
***[[JavaScript (Node.js) OpenTelemetry|JavaScript (Node.js)]]
***[[Ruby OpenTelemetry|Ruby]]
***[[Rust OpenTelemetry|Rust]]
** Интеграция платформ и технологий
***[[Настройка трассировки OpenTelemetry с помощью Istio|Трассировки с помощью Istio]]
***[[Настройка трассировки OpenTelemetry с помощью Envoy|Трассировки с помощью Envoy]]
** [[Обеспечение успеха с OpenTelemetry|Лучшие практики]]
*[[Настройка Ключ-АСТРОМ в Kubernetes|'''Kubernetes''']]
** [[Быстрый старт Kubernetes|Быстрый старт]]
** [[Развертывание Kubernetes|Развертывание]]
*** [[Начало работы с полной наблюдаемостью Kubernetes (развертывание полного стека в облаке)|Полная наблюдаемость Kubernetes]]
*** [[Начало работы с наблюдаемостью Kubernetes|Наблюдаемость Kubernetes]]
*** [[Начало работы с наблюдаемостью приложений|Наблюдаемость приложения]]
*** [[Токены доступа и разрешения]]
*** [[Поддерживаемые дистрибутивы Kubernetes|Дистрибутивы]]
*** [[Поиск неисправностей Kubernetes|Поиск неисправностей]]
*** Другое
**** [[Начало работы с полной наблюдаемостью (классическое развертывание полного стека) Kubernetes|Классический мониторинг полного стека]]
**** [[Начало мониторинга хоста Kubernetes|Мониторинг хоста]]
**** [[Наблюдаемость приложения с помощью внедрения Pod во время выполнения]]
**** [[Наблюдаемость приложения посредством внедрения во время сборки контейнера]]
**** [[Настройка мониторинга платформы Kubernetes с помощью DaemonSet|Полная наблюдаемость с Daemonset]]
**** [[Развертывание АктивногоШлюза как StatefulSet]]
**** [[Развертывание АктивногоШлюза на виртуальной машине]]
** Как это работает
*** [[Мониторинг платформы Kubernetes]]
*** [[Наблюдаемость приложения]]
*** [[Полная наблюдаемость]]
*** Компоненты
**** [[Ключ-АСТРОМ Operator]]
*** Другие режимы развертывания
**** [[Классический полностековый мониторинг]]
**** [[Мониторинг хоста]]
** Руководства
*** Руководства по переходу
**** [[Руководства по переходу для DynaKube apiVersions]]
**** [[Переход с классического полнофункционального стека на облачный полнофункциональный стек|Переход с классического на полнофункциональный облачный режим]]
**** [[Переход с классического полнофункционального режима на режим мониторинга приложений]]
**** [[Переход из облачного полного стека в режим мониторинга приложений]]
**** [[Перенос Ключ-АСТРОМ Operator в новую среду]]
**** [[Переход с ЕдиныйАгент Operator на Ключ-АСТРОМ Operator|Переход на Ключ-АСТРОМ Operator]]
**** [[Переход из манифестов в Helm для установки Ключ-АСТРОМ Operator|Переход из манифестов в Helm]]
*** Развертывание и настройка
**** [[Развертывание Ключ-АСТРОМ вместе с Istio]]
**** [[Управление развертываниями Ключ-АСТРОМ с помощью GitOps]]
***** [[Настройка извлечения образа узла]]
**** Мониторинг и инструментарий
***** [[Инструментарий ingress-nginx]]
***** [[Мониторинг API Kubernetes]]
***** [[Настройка мониторинга пространств имен и модулей]]
**** Управление ресурсами
***** [[Ограничения ресурсов Ключ-АСТРОМ Operator]]
***** [[Тайм-ауты тестов]]
**** Обновления и обслуживание
***** [[Обновление или удаление Ключ-АСТРОМ Operator]]
***** [[Автоматическое обновление Ключ-АСТРОМ Operator]]
***** [[Настройка автоматического обновления компонентов Ключ-АСТРОМ Operator]]
**** [[Настройка постоянного хранилища для АктивногоШлюза]]
**** [[Установка Operator в режиме FIPS]]
*** Настройки сети и безопасности
**** [[Конфигурации сети]]
***** [[Использование сетевых зон в Kubernetes]]
**** Настройки безопасности
***** [[Включение AppArmor для повышения безопасности|Включение AppArmor]]
***** [[Включение профиля seccomp для контейнеров инициализации Ключ-АСТРОМ|Настройка профиля seccomp для initContainer]]
***** [[Применение стандартов безопасности подов]]
***** [[Дополнительные конфигурации OpenShift]]
***** [[Ротация токенов]]
**** Расширенные конфигурации безопасности
***** [[Импорт сертификатов API Kubernetes]]
*** [[Реестры контейнеров]]
**** [[Использование публичного реестра]]
**** [[Использование частного реестра]]
**** [[Хранение образов Ключ-АСТРОМ в частных реестрах]]
**** [[Проверка подписей образов Ключ-АСТРОМ]]
*** Высокая доступность
**** [[Режим высокой доступности для развертываний Helm]]
**** [[Использование priorityClass для критически важных компонентов Ключ-АСТРОМ]]
**** [[Настройка минимального времени между запросами]]
**** [[Настройка политики отказов]]
*** Метаданные и автоматизация
**** [[Настройка распространения меток сборки]]
**** [[Добавление файла пользовательских свойств]]
**** [[Настройка директории расширений]]
** Интеграции
***[[Включение конечных точек приема телеметрии Ключ-АСТРОМ]]
*'''Другие контейнерные платформы'''
** [[Настройка Ключ-АСТРОМ на Cloud Foundry|Cloud Foundry]]
*** [[Развертывание релиза BOSH для комплексного мониторинга в Cloud Foundry|Развертывание релиза BOSH для комплексного мониторинга]]
*** [[Развертывание ЕдиногоАгента в Cloud Foundry для мониторинга только приложений|Развертывание ЕдиногоАгента в Cloud Foundry]]
*** [[Развертывание ЕдиногоАгента на платформе SAP BTP для мониторинга только приложений|Развертывание ЕдиногоАгента на платформе SAP BTP]]
*** [[Свяжите свои платформы Cloud Foundry с Ключ-АСТРОМ]]
*** [[Установка Ключ-АСТРОМ Service Broker на дашборд Cloud Foundry|Установка Ключ-АСТРОМ Service Broker]]
*** [[Обновление ЕдиногоАгента в Cloud Foundry|Обновление ЕдиногоАгента]]
*** [[Удаление ЕдиногоАгента из Cloud Foundry|Удаление ЕдиногоАгента]]
*** [[Устранение неполадок при развертывании ЕдиногоАгента в Cloud Foundry|Устранение неполадок]]
** [[Настройка Ключ-АСТРОМ на Docker|Docker]]
*** [[Настройка ЕдиногоАгента на контейнерах для мониторинга только приложений]]
*** [[Настройка Ключ-АСТРОМ ЕдиныйАгент как контейнер Docker]]
** [[Настройка Ключ-АСТРОМ на Heroku|Heroku]]
** [[Развертывание ЕдиногоАгента на Mesos/Marathon|Mesos/Marathon]]
** [[Привилегии ЕдиногоАгента для мониторинга контейнеров]]
*'''Другие технологии'''
** [[Расширение возможностей мониторинга метрик|Расширение метрик]]
*** Способы внедрения
**** [[Отправка метрик OpenTelemetry в Ключ-АСТРОМ|OpenTelemetry]]
**** [[Отправка метрик Micrometer в Ключ-АСТРОМ|Micrometer]]
**** [[Prometheus]]
***** [[Управление расширениями Prometheus|Расширения Prometheus]]
**** [[Отправка метрик StatsD в Ключ-АСТРОМ|StatsD]]
**** [[Отправка метрик Telegraf в Ключ-АСТРОМ|Telegraf]]
**** [[Интеграция скриптов метрик|Интеграция скриптов]]
**** [[API метрик ЕдиногоАгента]]
**** [[Расширения JMX]]
***** [[Настройка расширений JMX]]
*** Справка
**** [[Протокол приема метрических данных|Протокол приема]]
**** [[Пользовательские метаданные метрик]]
** [[Расширение возможностей мониторинга событий|Расширение событий]]
** Расширение логов
*** [[API для приема логов ЕдиногоАгента]]
** Расширение трассировок
*** [[ЕдиныйАгент SDK]]
*** [[OpenTracing]]
*** [[Настройки Span]]
** [[Расширение возможностей анализа пользовательского опыта и данных о поведении пользователей|Расширение возможности анализа пользовательского опыта и поведенческих данных]]
*** [[Внедрение инструментов мониторинга в ваше приложение с помощью Ключ-АСТРОМ OpenKit]]
*** [[Библиотеки Ключ-АСТРОМ OpenKit на GitHub]]
*** [[Методы API Ключ-АСТРОМ OpenKit]]
*** [[Ключ-АСТРОМ OpenKit logging]]
** [[Расширение топологии - Пользовательская модель топологии|Расширение топологии]]
*** [[Определение пользовательской топологии]]
*** [[Извлечение и отображение топологии событий]]
*** [[Общая топология сети]]
** [[Расширение данных]]
** Расширение веб-интерфейса Ключ-АСТРОМ
*** [[Единые страницы анализа]]
**** [[Справка о единых страницах анализа|Справка]]
**** [[Туториал по унифицированному анализу|Туториал]]
*** [[Расширение возможностей встроенных унифицированных страниц анализа]]
*'''Ключ-АСТРОМ Managed'''
**API кластера
*** API кластера v2
****АктивныйШлюз
*****Список АктивныхШлюзов кластера
*****Получить сведения об АктивномШлюзе кластера
****Токены кластера
***** [[Получение списка доступных токенов]]
***** [[Получение метаданных токена по запросу]]
***** [[Получение метаданных токена по ID]]
***** [[Создание нового токена]]
***** [[Обновление токена]]
***** [[Удаление токена]]
****Окружение
***** [[Получение списка всех окружений]]
***** [[Получение свойств окружения]]
***** [[Создание нового окружения]]
***** [[Обновление окружения]]
***** [[Удаление окружения]]
***** [[Создание токена владельца среды]]
****Лицензирование
***** [[Экспорт данных лицензии]]
**** Лог мониторинга
***** [[Включение Лога мониторинга]]
***** [[Получение состояния Лога мониторинга]]
***** [[Обновление событий в логах по кластерам]]
**** Удалённый доступ
***** [[Получение списка всех запросов удалённого доступа]]
***** [[Получение запроса удалённого доступа]]
***** [[Выдача удалённого доступа пользователю]]
***** [[Изменение статуса запроса удалённого доступа]]
**** Синтетические локации и ноды
***** [[Получение всех частных синтетических локаций (GET все локации)]]
***** [[Получение свойств указанных локаций (GET локация)]]
***** [[Создание новой частной синтетической локации (POST локация)]]
***** [[Обновление частной синтетической локации (PUT локация)]]
***** [[Удаление частной синтетической локации (DELETE локация)]]
***** [[Получение всех синтетических нод кластера (GET все ноды)]]
***** [[Получение свойств указанных нод кластера (GET нода)]]
**** Менеджмент пользовательских сессий
***** [[Получение конфигурации сессий]]
***** [[Обновление конфигурации сессий]]
***** [[Получение списка сессий]]
***** [[Удаление сессий указанного пользователя]]
*** [[Ротация токена через API]]
**Конфигурация
***[[Настраиваемые свойства Ключ-АСТРОМ Managed]]
***[[Добавление SSL-сертификата в TrustStore кластера Ключ-АСТРОМ Managed]]
***[[Настройка прокси|Могу ли я использовать прокси-сервер для доступа в Интернет?]]
***[[Настройка подключения к SMTP-серверу]]
***[[Конфигурация DNS для Ключ-АСТРОМ Managed]]
***[[Возможности ноды кластера]]
***[[Удалённый доступ к кластеру]]
***[[Настройка и управление сессиями пользователей]]
*** [[Правила сложности пароля]]
*** [[Настройка страницы входа]]
*** Настройка параметров кластера
*** [[Уведомления о работе кластера]]
*** [[Настройка экстренных контактов]]
*** [[Балансировка нагрузки]]
*** [[Настройка повышенных прав доступа]]
*** [[Периоды хранения данных]]
** Служба сведений о домене сбоя
*** [[Развертывание Managed с учетом стойки]]
*** [[Преобразование с использованием репликации с учетом стойки]]
*** [[Преобразование с использованием восстановления с учетом стойки]]
*** [[ВысокаяДоступность для дата-центров]]
*** [[ВысокаяДоступность — репликация нод между дата-центрами]]
*** [[ВысокаяДоступность — переустановка дата-центра]]
*** [[ВысокаяДоступность — восстановление дата-центра через резервную копию]]
*** [[ВысокаяДоступность — восстановление дата-центра через другой дата-центр]]
** Установка
*** [[Требования Managed к оборудованию]]
*** [[Требования Managed к системе]]
*** [[Рекомендации Managed к облачному развёртыванию]]
*** [[Порты ноды кластера]]
*** [[Включение или отключение SELinux]]
*** [[Установка кластера]]
*** [[Добавление новой ноды кластера]]
*** [[Настройка установки для Ключ-АСТРОМ Managed]]
*** [[Установка кластерного АктивногоШлюза]]
*** [[Установка собственного SSL-сертификата для ноды кластера]]
*** [[Настройка SSL-сертификата для кластерного АктивногоШлюза]]
*** Ключ-АСТРОМ офлайн
*** Ключ-АСТРОМ офлайн на защищенных системах
** [[API Контроллера Задач]]
*** [[Создание клиентского SSO]]
*** [[Создание SSO-токена]]
*** [[Получить список доступных пакетов и обновлений]]
*** [[Получить офлайн-пакет]]
*** Отменить регистрацию Контроллера Задач
** Эксплуатация
*** [[Перенос кластера]]
*** [[Управление окружениями мониторинга]]
*** [[Изменение местоположения хранилища]]
*** [[Применение патчей операционной системы к ноде]]
*** [[Обновление Ключ-АСТРОМ Managed]]
*** [[Обновление кластерного АктивногоШлюза]]
*** [[Резервное копирование и восстановление кластера]]
*** [[Примерный размер резервной копии кластера]]
*** [[Удаление ноды кластера]]
*** [[Удаление кластера]]
*** [[Диагностические архивы для установок Ключ-АСТРОМ Managed]]
*** [[Запуск/остановка/перезапуск ноды]]
*** [[Запуск/остановка/перезапуск кластера]]
*** [[Экспорт данных о лицензировании]]
** [[Самомониторинг]]
*** [[Среда локального самомониторинга]]
*** [[Среда удалённого самомониторинга]]
*** [[Среда частного самомониторинга]]

== Наблюдаемость Ключ-АСТРОМ ==

* '''[[Наблюдаемость ИИ и LLM]]'''
** [[Термины и понятия]]
** [[Начало работы с наблюдаемостью ИИ и LLM|Начать]]
*** [[OpenLLMetry]]
*** Примеры использования
**** [[Версионирование моделей ИИ и A/B-тестирование]]
**** [[Мониторинг наблюдаемости RAG‑конвейеров]]
**** [[Сквозная наблюдаемость приложений ИИ в Kubernetes]]
**** [[Наблюдаемость OpenAI]]
** Поставщики моделей и платформы
*** [[OpenAI]]
*** [[NVIDIA NIM]]
*** [[Ollama]]
*** [[Наблюдаемость TensorFlow Keras]]
** Системы оркестровки и оперативного проектирования
*** [[LangChain]]
** Безопасность, управление и организация трафика
*** [[Kong AI Gateway]]
*[[Наблюдаемость приложения|Наблюдаемость приложений]]
**[[Распределенные трассировки]]
*** [[Концепция распределенных трассировок|Концепция]]
*** Анализ
**** [[Начало работы с распределенными трассировками]]
**** [[Исправление диагностических ошибок топологии распределенных трассировок]]
**** [[Настройка трассировки между окружениями]]
*** Варианты использования
**** [[Детализация причин сбоев в работе служб трассировок|Детализация причин сбоев в работе служб]]
**** [[Использование расширения логов для отслеживания ошибок распределенных трассировок]]
**** [[Сегментация запросов для улучшения времени отклика]]
*** [[Адаптивное управление распределенными трассировками]]
**[[Многомерный анализ]]
*** [[Анализ исключений]]
*** [[Топ транзакций баз данных|Основные операторы базы данных]]
*** [[Топ веб-запросов|Самые популярные веб-запросы]]
***
**[[Профилирование и оптимизация]]
*** [[Анализ дампа памяти|Анализ дампов памяти]]
**** [[Настройка АктивногоШлюза (для хранения дампов памяти)|Настройка АктивногоШлюза]]
*** [[Аварийные завершения процессов|Анализ аварий]]
*** [[Непрерывное профилирование ЦП|Профилирование ЦП]]
*** [[Профилирование памяти]]
*** [[Непрерывный анализ потоков]]
**Сервисы
*** [[Анализ служб|Анализ сервисов]]
*** [[Детализация с учетом контекста]]
*** [[Анализ отдельных экземпляров серсиса]]
*** [[Время проведения анализа сервиса]]
*** [[Анализ распределения времени отклика и анализ выбросов|Распределение времени отклика и выбросы]]
*** [[Хотспоты сервиса с высоким временем отклика]]
*** [[Service flow|Поток обслуживания]]
**** [[Service flow метрики|Метрики]]
**** [[Service flow фильтры|Фильтры]]
*** [[Мониторинг ключевых запросов]]
*** [[Обратная трассировка сервиса]]
*Цифровой опыт
** Концепции RUM
*** [[Мониторинг реального пользователя|RUM]]
*** [[Приложения (RUM)|Приложения]]
*** [[Действия пользователя]]
*** [[События пользователя и ошибки]]
*** [[Пользовательские сеансы|Пользовательские сессии]]
*** [[Метрики действий пользователей|Метрики действий пользователя]]
*** [[Определение IP-адресов, геолокации и пользовательских агентов]]
*** [[Оценки и рейтинги Ключ-АСТРОМ]]
**** [[Рейтинг Apdex|Рейтинги Apdex]]
**** [[Оценка пользовательского опыта]]
** Веб-приложения
*** Первоначальная настройка
**** [[Разработка приложений для мониторинга реальных пользователей|Определение приложения]]
**** [[Настройка автоматического внедрения|Настроить автоматическое внедрение]]
**** [[Настройка мониторинга реальных пользователей без использования агентов|Настройка RUM без агентов]]
**** [[Выбор формата фрагмента|Выберите формат фрагмента]]
*** Дополнительная конфигурация
**** [[Управление версией JavaScript Мониторинга реального пользователя|Управление версией JavaScript в RUM]]
**** [[Захват свойств событий и сессий для веб-интерфейсов|Захват свойств событий и сессий]]
**** [[Исключение запросов XHR и Fetch из мониторинга|Исключить запросы XHR и Fetch]]
**** [[Настройка параметров конфиденциальности данных для веб-приложения|Настройка параметров конфиденциальности данных]]
**** [[Настройка атрибутов cookie RUM]]
**** [[Настройка списка разрешенных источников маяков]]
**** [[Настройка связи между фронтендом и бэкендом для веб-интерфейсов|Настройка связи между фронтендом и бэкендом]]
**** [[Настройка захвата взаимодействия пользователя с веб-интерфейсами|Настройка захвата взаимодействия пользователя]]
***** [[Настройка именования элементов пользовательского интерфейса для взаимодействия с пользователем|Настройка именования элементов пользовательского интерфейса]]
***** [[Связывайте взаимодействие пользователя с функциями и компонентами пользовательского интерфейса|Связывайте взаимодействие пользователя с функциями и компонентами пользовательского интерфейса.]]
***** [[Укажите логического предка для взаимодействий с пользователем|Укажите логического предка]]
**** [[Контроль Мониторинга реального пользователя на уровне технологической группы|Контроль RUM на уровне технологической группы]]
**** [[Удаление веб-интерфейса в Мониторинге реальных пользователей|Удалить интерфейс]]
**Мобильные интерфейсы
*** [[Концепции для мобильных интерфейсов|Концепции]]
*** Android
**** [[Первоначальная настройка для Android-интерфейсов|Первоначальная настройка]]
**** [[Поддержка и ограничения]]
**** [[Настройка конфиденциальности и сбора данных]]
**** [[Производительность приложения для Android|Производительность приложения]]
**** [[Мониторинг производительности веб-запросов|Производительность веб-запросов]]
**** [[Сообщения об ошибках и сбоях]]
**** [[Пользовательские события]]
**** [[Управление пользователями и сессиями|Пользователь и сессия]]
**** [[Инструментарий для анализа действий пользователя|Действия пользователя]]
*** iOS
**** [[Первоначальная настройка для iOS-интерфейсов|Первоначальная настройка]]
**** [[Поддержка и ограничения IOS|Поддержка и ограничения]]
**** [[Конфигурация IOS|Конфигурация]]
**** [[Конфиденциальность и сбор данных]]
**** [[Производительность приложения для iOS|Производительность приложения]]
**** [[Мониторинг производительности веб-запросов для iOS|Производительность веб-запросов]]
**** [[Сообщения об ошибках и сбоях на iOS|Сообщения об ошибках и сбоях]]
**** [[Пользовательские события для iOS|Пользовательские события]]
**** [[Управление пользователями и сессиями на iOS|Пользователь и сессия]]
**** [[Инструментарий для анализа действий пользователя для iOS|Действия пользователя]]
*** [[Настройка параметров конфиденциальности данных для мобильных интерфейсов|Конфиденциальность данных]]
*** Дополнительная конфигурация
**** [[Захват свойств событий и сессий для мобильных интерфейсов|Захват свойств событий и сессий]]
**** [[Настройка захвата взаимодействия пользователя с мобильными интерфейсами|Настройка захвата взаимодействия пользователя]]
***** [[Маскировка взаимодействия пользователя с мобильными интерфейсами|Маскировка взаимодействия пользователя]]
**** [[Удаление мобильного интерфейса|Удаление интерфейса]]
*** Анализ и оповещение
**** [[Встроенные метрики RUM|Встроенные метрики]]
**** [[Оповещения о состоянии здоровья для интерфейсов пользователей|Предупреждения о состоянии здоровья]]
**** [[Извлечение метрики из событий пользователя]]
**** [[Извлечение метрик из пользовательских сессий]]
**** [[Анализ поведения пользователей с помощью DQL|Анализ поведения пользователей с помощью DQL.]]
**** [[Отслеживание производительности веб-сайта с помощью DQL|Отслеживайте производительность веб-сайта с помощью DQL.]]
**** [[Анализ производительности от фронтенда до бэкенда]]
**** [[Управление хранилищами для RUM]]
**[[Воспроизведение сеанса|Воспроизведение сессии]]
*** Воспроизведение сессии для веб-интерфейсов
**** [[Активируйте воспроизведение сессий для веб-интерфейсов и настройте управление затратами и трафиком|Активируйте функцию воспроизведения сессий и настройте управление затратами и трафиком]]
**** Настройка воспроизведения сессии
***** [[Настройка режима согласия|Настройте режим согласия]]
***** [[Настройка исключения URL-адресов]]
***** [[Настройка маскирования|Маскирование]]
***** [[Настройка захвата ресурсов]]
**** [[Технические ограничения для воспроизведения сессий на веб-интерфейсах|Технические ограничения]]
**** [[Воспроизведение сеансов в среде со строгими требованиями к конфиденциальности для веб-интерфейсов|Воспроизведение сеанса со строгими требованиями к конфиденциальности]]
*** Воспроизведение сессии для мобильных интерфейсов
**** [[Настройка воспроизведения сеансов для Android]]
**** [[Настройка воспроизведения сеансов для iOS]]
**Синтетический мониторинг
*** [[Приложение Синтетический мониторинг|Синтетическое приложение]]
**** [[HTTP-мониторы: отображение результатов в Ключ-АСТРОМ|HTTP-мониторы, сообщающие о результатах]]
**** [[Создание HTTP-мониторинга|Создание и настройка HTTP-монитора]]
**** [[Результаты работы браузерных мониторов]]
**** [[Создание и настройка браузерного монитора]]
***** [[Запись clickpatch в браузере|Запись ckickpatch в браузере]]
***** [[Типы шагов clickpatch]]
***** [[Настройка времени ожидания между шагами, правил проверки содержимого и пороговых значений производительности|Настройка шагов мониторинга]]
**** [[NAM отслеживает отчётность о результатах]]
**** [[Создание монитора NAM]]
**** [[Выполнение мониторов по запросу]]
**** [[Частные синтетические локации]]
***** [[Требования к частным синтетическим хранилищам]]
***** [[Установка АктивногоШлюза с поддержкой синтетических алгоритмов]]
***** [[Установка и обновление Chromium для Linux]]
***** [[Управление частными локациями]]
***** [[Прокси для частных локаций]]
***** [[Контейнеризированные, автоматически масштабируемые частные синтетические локации в Kubernetes|Частные локации в Kubernetes]]
*** [[Активация браузерных мониторов в последней версии Ключ-АСТРОМ]]
*** [[Контроль доступа к синтетическому мониторингу]]
*** [[Использование сегментов для синтетического мониторинга]]
*** Метрики синтетического мониторинга
**** [[Метрики HTTP-монитора в синтетическом мониторинге]]
**** [[Метрики мониторинга браузера в синтетическом мониторинге]]
**** [[Метрики NAM-мониторов в синтетическом мониторинге]]
*** [[Обзор синтетических оповещений]]
*** [[Синтетические расчеты]]
*** [[Синтетика для Workflows]]
**** [[Обновления атрибутов синтетики]]
*** [[Синтетические мониторы в Smartscape]]
*** [[Архитектура и взаимодействие синтетики]]
**[[Мониторинг цифрового опыта с Business Insights|DEM с аналитическими данными]]
*** [[Business Insights|Аналитика бизнеса]]

== Платформа Ключ-АСТРОМ ==

* '''Искусственный интеллект'''
** Обнаружение аномалий
*** Метрические события
**** Ключевые события метрики
**** События селектора метрик
*** Автоадаптивные пороги
*** Статические пороги
*** Конфигурация обнаружения аномалий
*** Автоматизированное многомерное базовое исследование
*** Регулировка чувствительности обнаружения
**** Приложения
**** Сервисы
**** База данных сервисов
**** Инфраструктура
**** Расширение событий
** Анализ первопричин
*** Концепции
**** Анализ событий и корреляция
***** [[Категории событий]]
****** Мониторинг недоступных событий
****** Доступность событий
****** Пользовательские оповещения
****** События ошибок
****** [[Информационные события]]
****** Ресурсные события
****** События замедления
**** Частые проблемы
** Модели ИИ
*** Причинно-следственный корреляционный анализ
*** Анализ прогноза
*** Сезонная базовая линия
* '''ЕдиныйАгент'''
** Возможности мониторинга
** Как работает ЕдиныйАгент
* '''Smartscape'''

== Решения Ключ-АСТРОМ ==

* '''Наблюдаемость приложения'''
** Сервисы
*** Обнаружение и наименование
**** Типы сервисов
***** Сервисы обмена сообщениями
***** Объединенные сервисы
***** Индивидуальные сервисы
***** Непрозрачные сервисы
***** Унифицированные сервисы
**** Правила обнаружения сервисов
**** Правила именования сервисов
*** Анализ сервисов
**** Анализ сервисов (новая страница)
**** Контекстно-зависимая детализация
**** Анализ отдельных сервисов обслуживания
**** Сроки анализа сервисов
**** Распределение времени отклика и отклонений
**** Время отклика хотспотов
**** Сервисный поток
***** Метрики
***** Фильтрация
**** Мониторинг ключевых запросов
**** Трассировка сервиса
*** Запрос атрибутов
**** Сбор данных по веб-запросу
**** Захват аргументов метода
**** Фильтрация данных мониторинга
*** Настройки
**** Настроить именование запросов
**** Мониторинг сторонних сервисов
**** Пользовательские определения API
**** Отключение мониторинга запросов на обслуживание
**** Настройка обнаружения сбоев в работе сервиса
**** Расчетные метрики для сервисов
** Очереди сообщений
*** Концепции очередей
*** Анализ очередей
*** Конфигурация очередей
**** Трассировка IBM MQ
**** Теги и менеджмент зоны
** Многомерный анализ
*** Анализ исключений
*** Лучшие операторы баз данных
*** Самые популярные веб-запросы
** [[Профилирование и оптимизация]]
*** [[Дампы памяти|Анализ дампа памяти]]
**** [[Настройка АктивногоШлюза (для хранения дампов памяти)]]
*** [[Аварийные завершения процессов]]
*** [[Непрерывное профилирование ЦП]]
*** [[Профилирование памяти]]
*** [[Непрерывный анализ потоков]]
** Базы данных
*** Databases Services Classic
**** Обнаружение и мониторинг
**** Анализ служб базы данных
**** Анализ служб базы данных (новая страница)
**** Улучшение производительности базы данных
**** Переменные SQL
**** Обзор базы данных Oracle
* '''Безопасность приложений'''
** Начните работу с безопасностью приложений
*** Активация безопасности приложений
*** Режимы мониторинга
*** Оценка уязвимости
*** Покрытие хоста
** Анализ уязвимостей во время работы
*** Начало работы с аналитикой уязвимостей во время работы
*** Обзор безопасности приложений
*** Уязвимости третьих лиц
**** Управление уязвимостями третьих лиц
**** Фильтрация или изменение статуса сторонних уязвимостей
**** Расчеты ИИ Security Advisor
**** Расчет индекса безопасности по шкале ИИ
**** Отслеживание исправления
**** Правила мониторинга
*** Уязвимости на уровне кода
**** Управление уязвимостями на уровне кода
**** Правила мониторинга
**** Фильтрация или изменение статуса уязвимостей на уровне кода
*** Уведомления безопасности об уязвимостях
**** Webhook
**** Jira
**** Email
*** Метрики Classic
** Защита приложений во время работы
*** Начало работы с Runtime Application Protection
*** Управление атаками
*** Правила мониторинга
*** Уведомления безопасности об атаках
**** Webhook
**** Jira
**** Email
*** Метрики Classic
** Часто задаваемые вопросы
** Устранение неполадок
* '''Автоматизация'''
** Цели уровня обслуживания
*** Основы целей уровня обслуживания
*** Настройка и мониторинг
*** Примеры конфигураций
*** Управление SLO с разрешениями менеджмент зон
** Автоматизированный мониторинг релизов
*** Мониторинг релизов с помощью Ключ-АСТРОМ
*** Стратегии обнаружения версий
*** Интеграция отслеживания проблем
* '''Цифровой опыт'''
** Концепции RUM
*** RUM
*** Приложения
*** Действия пользователя
*** Пользовательские и ошибочные события
*** Пользовательские сеансы
*** Метрики действий пользователя
*** Обнаружение IP-адресов, геолокаций и пользовательских агентов
*** Оценки и рейтинги Ключ-АСТРОМ
**** Рейтинги Apdex
**** Оценка пользовательского опыта
** Веб-приложения
*** Дополнительная конфигурация
**** Настройка контроля затрат и трафика
**** Настройка параметров конфиденциальности данных
**** Настройка ключевых действий пользователя
**** Захват дополнительных типов взаимодействия
**** Настройка параметров Apdex
**** Изменение пороговых значений оценки пользовательского опыта
**** Создание расчетных показателей
**** Создание пользовательских метрик USQL
**** Определения свойств действия и сеанса
**** Настройка RUM с помощью JavaScript API
**** Настройка обнаружения ошибок
**** Отметка определенных пользователей
**** Настройка определения IP-адреса
**** Сопоставление IP-адреса с местоположениями
**** Настройка обнаружения ресурсов
**** Настройка домена cookie RUM
**** Настройка списка разрешенных источников маяков
**** Настройка конечной точки маяка
**** Исключение IP-адресов, браузеров, ботов и поисковых роботов
**** Настройка своих серверов кэширования
**** Проверка правил обнаружения приложений
**** Настройка XHR для старых версий IE
**** RUM для групп процессов
**** Изменение политики безопасности контента
**** Удаление веб-приложений
*** Поиск неисправностей
** Мобильные приложения
*** Приложения для Android-приложений
**** Быстрое начало
**** Плагин Ключ-АСТРОМ Android Gradle
***** Инструментация своего приложения с помощью плагина
***** Настройка возможностей мониторинга плагинов
***** Настройка плагина для процессов инструментирования
***** Настройка конфигурации ЕдиногоАгента с помощью плагина
***** Изменение конфигурации плагина в зависимости от структуры проекта
***** Поиск неисправностей
**** ЕдиныйАгент SDK для Android
***** Инструментирование через SDK
***** Настройка связи с SDK
***** Инструментация своего приложения вручную с помощью SDK
**** Включение отладочного ведения логов
*** Приложения для iOS-инструментов
*** Гибридные приложения для инструментов
*** Кроссплатформенные фреймворки
**** Cordova
**** Flutter
**** React Native
**** Xamarin
**** .NET MAUI
*** Поиск неисправностей
** Пользовательские приложения
*** Начальная настройка
*** Поиск неисправностей
** Сегментация сеанса
*** Новое: Анализ сеанса пользователя
*** Пользовательские запросы, сегментация и агрегация данных сеанса
*** Данные пользователя
*** Контекстный анализ Apdex
*** Экспорт сеансов пользователей
** Повтор сеанса
*** Включение воспроизведения сеанса для веб-приложений
*** Настройка воспроизведения сеанса для веб-приложений
*** Технические ограничения для воспроизведения сеанса для веб-приложений
*** Настройка воспроизведения сеанса для iOS
*** Настройка воспроизведения сеанса для Android
** [[Синтетический мониторинг]]
*** Общая информация
**** [[Типы синтетических мониторов]]
**** [[Синтетические расчеты]]
**** [[Поддерживаемые методы аутентификации]]
**** [[Выполнение синтетических мониторингов по требованию для CI/CD]]
**** [[Интеграция внешнего хранилища]]
*** Браузерные мониторы
**** [[Создание мониторинга браузера с одним URL-адресом]]
**** [[Clickpath в браузере]]
**** [[Настройка мониторов браузера]]
**** [[События clickpath в браузере]]
**** [[Режим скрипта]]
**** [[Количество действий, выполненных с помощью Clickpath браузера]]
*** HTTP-мониторы
**** [[Создание HTTP-мониторинга]]
**** [[Настройка HTTP-мониторинга]]
**** [[Режим скрипта HTTP-мониторинга]]
**** [[Предварительное и последующее написание скрипта]]
**** [[Метрики HTTP-мониторинга]]
*** Анализ и оповещение
**** Обзор синтетических оповещений
**** Синтетические данные для браузерных мониторингов
**** Многомерный анализ для браузерных мониторингов
**** Waterfall графики
**** [[Синтетические данные для HTTP-мониторинга]]
*** Мониторы доступности сети
**** Мониторинг доступности сети
**** Создание мониторинга NAM
**** Показатели мониторинга NAM
* '''Инфраструктура Наблюдаемость'''
** Мониторинг облачной платформы
*** Веб-сервисы Amazon
*** Microsoft Azure
*** Google Облако
** Мониторинг контейнерной платформы
*** Kubernetes Classic
**** Использование кластера
**** События
**** Рабочие нагрузки
**** Сервисы
**** Метрики Kubernetes
**** Метрики Prometheus
**** Организация развертывания Kubernetes по тегам
**** Мониторинг постоянных требований по объему
**** Оповещение о частых проблемах
**** Мониторинг уязвимостей
**** Мониторинг SLO
**** Метрики прокси Istio/Envoy
**** Глобальные настройки мониторинга по умолчанию
*** Cloud Foundry
**** Метаданные группы процессов для Cloud Foundry
**** Организация развертывания Cloud Foundry по тегам
**** Обзор метрик Cloud Foundry
*** Heroku
*** Группы контейнеров
*** Правила мониторинга контейнеров
*** Варианты использования
**** Оповещение о частых ошибках в конфигурации и обнаружение аномалий
** Сети
*** Контроль сетевых коммуникации
*** Обнаружение сетевых ошибок
*** Расширенный сетевой мониторинг
*** Устранение неполадок сетевого мониторинга
*** F5 BIG-IP LTM-мониторинг
** Хосты
*** Режимы мониторинга инфраструктуры и обнаружения
**** Насколько эффективен мониторинг инфраструктуры сам по себе?
*** Настройки на уровне хоста
**** Группы хостов
**** Пользовательские наименования хостов
**** Теги хоста и метаданные
**** Исключение дисков и сетевого трафика
**** Обнаружение аномалий
*** Мониторинг
**** Мониторинг хоста
***** Доступность хоста
***** Аналитика диска
**** Доступность процесса
**** Мониторинг классических служб Windows
**** Мониторинг служб ОС
** Группы процессов
*** Основные понятия
**** Какие процессы наиболее важны?
**** Какие технологии лежат в основе отдельных процессов?
*** Конфигурация
**** Наименования групп процессов
**** Глубокий мониторинг процесса
**** Обнаружение группы процессов
**** Облачные приложения и обнаружение рабочей нагрузки
**** Метаданные группы процессов
**** Правила обнаружения пользовательских групп процессов (устарело)
*** Мониторинг
**** Обзор всех технологий, работающих в вашей среде
**** Анализ процессов
**** Анализ скорости реагирования процесса
**** Мониторинг и оповещение о доступности групп процессов
**** Мониторинг сетевых подключений, специфичных для процесса
** VMware vSphere
*** Просмотр данных мониторинга виртуализации
*** Измерения работоспособности хоста ESXi
*** Перенос и производительность виртуальных машин
*** Ограничение мониторинга инфраструктуры VMware с помощью разрешений

== Наблюдение и исследование ==

* [[Панели мониторинга (дашборды)|'''Дашборды''']]
** [[Визуализации и плитки]]
*** [[Доступные плитки]]
*** [[Закрепление плиток на панели инструментов|Закрепление плиток на дашборде]]
*** [[Фильтр плиток]]
*** [[Графическая визуализация]]
*** [[Визуализация многоуровневых столбцов]]
*** [[Визуализация многоуровневых областей]]
*** [[Круговая визуализация]]
*** [[Визуализация значений]]
*** [[Визуализация таблиц]]
*** [[Визуализация топ-листа]]
*** [[Визуализация тепловой карты]]
*** [[Визуализация в виде сот]]
** [[Обзор метрик]]
** [[Панели мониторинга (дашборды)|Дашборды]]
*** [[Управление дашбордами|Создание и редактирование дашбордов]]
*** [[Динамические фильтры в дашбордах]]
*** [[Организация дашбордов]]
*** [[Периодичный отчёт по дашбордам]]
*** [[Доступ к дашбордам]]
*** [[Дашборды-шаблоны]]
*** [[Создание дашбордов для нескольких окружений Ключ-АСТРОМ]]
*** [[Таймфреймы и менеджмент-зоны дашбордов]]
*** [[JSON-конфигурация дашбордов]]
*** [[Глобальная настройка дашбордов]]
* [[Визуализация метрик|'''Визуализация метрик''']]
** [[Быстрый старт Визуализации метрик]]
** [[Расширенный режим Визуализации метрик]]
** [[Часто задаваемые вопросы по Визуализации метрик]]
* [[Обновление пользовательских диаграмм|'''Обновление пользовательских диаграмм''']]
* '''Уведомления и оповещения'''
** Уведомления о проблемах
*** Ansible Tower
*** Email
*** Jira
*** Microsoft Teams
*** Opsgenie
*** PagerDuty
*** ServiceNow
*** Slack
*** Trello
*** VictorOps
*** Webhook
*** xMatters
** Окна технического обслуживания
*** Определить окно обслуживания
** Профили оповещения
** Мобильное приложение Ключ-АСТРОМ
* '''Метрики'''
** Метрики самоконтроля
** Встроенные классические метрики
** Фильтрация классических метрик по менеджмент зонам
* '''Мониторинг логов'''
** Конфигурация
*** Поддерживаемый формат данных логов
*** Подключение данных логов к трассировкам
*** Маскировка конфиденциальных данных
*** Поддерживаемые форматы временных меток
*** Конфигурация временной метки логов
** Прием и обработка логов
*** Автообнаружение
*** Модели возвращения логов
*** Пользовательский источник логов
*** Правила приема логов
*** Конфигурация сброса логов (управляемая)
*** Общий прием логов
*** Преобразование содержимого логов
*** Пересылка логов в облаке
*** Потоковая передача логов через Amazon Data Firehose
*** Логи из Kubernetes
*** Логи в Docker
*** Потоковая передача логов с помощью Logstash
*** Потоковая передача логов с помощью Fluentd
*** Потоковая передача системного логов с помощью Fluentd
*** Потоковая передача логов с помощью Fluent Bit
*** Потоковая передача логов Kubernetes с помощью Fluent Bit
*** Системные логи
*** Потоковая передача логов с помощью OpenTelemetry
** [[Анализ данных логов]]
*** [[Программа просмотра логов]]
*** [[Логи событий]]
*** [[Метрики логов]]
*** [[Пользовательские атрибуты логов]]
*** [[Менеджмент зоны]]
** Оповещение о данных логах
** [[Обработка логов]]
*** [[Примеры обработки логов]]
*** [[Команды обработки логов]]
*** [[Типы данных обработки логов]]
*** [[Функции обработки логов]]
** Ограничения мониторинга логов
** Поиск неисправностей
*** Предупреждения о приеме логов
** Методы маскировки конфиденциальных данных
* '''Распределенные трейсы'''
** Концепции
** Адаптивное управление распределёнными трейсами
*** Адаптивное управление распределёнными трейсами
*** Выборка на основе URL-адресов
** Анализ
*** Начать работу с распределенными трассами
*** Обработка диагностических сообщений
*** Настройка кросс-платформенной трассировки
** Варианты использования
*** Выявление причин сбоев в обслуживании
*** Используйте расширение логов трассировок для решения проблем
*** Сегментация запросов для улучшения времени отклика

== Расширения Ключ-АСТРОМ ==

* '''Расширения метрик'''
** Методы интеграций
*** OpenTelemetry
*** Micrometer
*** Prometheus
**** Расширения Prometheus
*** StatsD
*** Telegraf
*** Интеграция сценариев
*** OneAgent metric API
*** SNMP
*** WMI
*** Расширения JMX
**** Настройка расширений JMX
*** SQL
**** Oracle
**** Microsoft SQL Server
**** PostgreSQL
**** MySQL
**** Snowflake
**** SAP Hana DB
**** IBM DB2
** Справка
*** Протокол интеграции
*** Пользовательские метрические метаданные
* '''Расширения событий'''
* '''Расширения логов'''
** API для сбора логов ЕдиногоАгента
* '''Расширения трейсов'''
** OpenTelemetry
** ЕдиныйАгент SDK
** OpenTracing
** Настройка диапазона
* '''Расширения данных о пользовательском опыте и поведении'''
** Инструментируйте свое приложение с помощью Ключ-АСТРОМ OpenKit
** Библиотеки Ключ-АСТРОМ OpenKit на GitHub
** Методы API Ключ-АСТРОМ OpenKit
** Ведение логов Ключ-АСТРОМ OpenKit
** Устранение неполадок в инструментах Ключ-АСТРОМ OpenKit
* '''Расширения топологии'''
** Определение пользовательской топологии
** Извлечение и отображение топологии событий
* '''Расширения данных'''
* '''Расширения веб-интерфейса Ключ-АСТРОМ'''
** Единые страницы анализа
*** Единый справочник по анализу
*** Единый туториал по анализу
** Расширения встроенных единых страниц анализа
** Распространение пользовательских дашбордов
* '''Расширения'''
** [[Концепции расширений 2.0]]
** [[Настройка специализированного профиля производительности]]
** [[Пользовательская конфигурация контроллера выполнения расширений]]
**[[Распространение пользовательских дашбордов с расширениями]]
** [[Настройка данных с помощью расширений]]
** [[Жизненный цикл расширений 2.0]]
** [[Расширения знаков]]
** [[Расширения YAML-файла]]
** Источники данных
*** [[Источник данных SNMP|SNMP]]
**** [[Справка о источнике данных SNMP|Справка]]
**** [[Источник данных SNMP-traps|SNMP-traps]]
**** [[Поиск и устранение неисправностей SNMP|Поиск и устранение неисправностей]]
*** [[Источник данных JMX|JMX]]
**** [[Справка о источнике данных JMX|Справка]]
*** [[Источник данных Prometheus|Prometheus]]
**** [[Справка о источнике данных Prometheus|Справка]]
*** [[Источник данных SQL|SQL]]
**** [[Конфигурация IBM DB2|IBM DB2]]
****[[Конфигурация JDBC|JDBC]]
**** [[Конфигурация Microsoft SQL|Microsoft SQL]]
**** [[Конфигурация MySQL|MySQL]]
**** [[Конфигурация Oracle Database|Oracle Database]]
**** [[Конфигурация PostgreSQL|PostgreSQL]]
**** [[Конфигурация SAP Hana Database|SAP Hana Database]]
**** [[Конфигурация Snowflake Database|Snowflake Database]]
**** [[Справка о источнике данных SQL|Справка]]
*** [[Источник данных WMI|WMI]]
**** [[Пособие по источнику данных WMI]]
**** [[Справка о источнике данных WMI|Справка]]
*** [[Источник данных Python SDK|Python SDK]]
** [[Безопасность расширения]]
* '''Расширения 1.0'''
** Обновление до Python 3.8
** Расширения АктивногоШлюза
*** Введение
*** Возможности
*** Туториал
** Разработка
*** Команды SDK расширения
*** Установить расширение SDK
*** Установить подключаемый модуль АктивныйШлюз
*** Инструкции по расширениям
**** Развернуть расширение
**** Диаграммы
**** Ключевые показатели эффективности
**** Расширения оповещения
**** Групповые показатели
**** Метрики состояния
**** Пользовательская конфигурация модуля плагина АктивныйШлюз
**** Конфигурация расширения
**** Топология
**** Проблемы и события
**** Пользовательские свойства
*** Как использовать внешние пакеты Python
** Расширения ЕдиногоАгента
*** Жизненный цикл
*** Туториал
** Справочник
*** Справка по API расширения Python
**** Обзор процесса
*** Справка по Json
**** Объяснение JSON расширений
**** Справочник JSON расширений
** Поиск неисправностей
*** Производительность модуля плагина АктивныйШлюз
*** Устранение неполадок с расширениями
*** Симулятор расширения
*** Ограничения расширений
*** Часто задаваемые вопросы о расширении АктивногоШлюза
* '''OpenTelemetry'''

== Управление платформой Ключ-АСТРОМ ==

* '''Подписка на платформы Ключ-АСТРОМ'''
** Управление расходами
** Возможности
*** Мониторинг хоста
*** Безопасность приложений
*** Мониторинг цифрового опыта
*** Расширения платформы
* '''Классическое лицензирование Ключ-АСТРОМ'''
** Жизненный цикл лицензии Ключ-АСТРОМ
** Мониторинг приложений и инфраструктуры (хост-устройства)
** Расширения Ключ-АСТРОМ (единицы данных ИИ (DDU))
*** DDU для метрик
**** Автоматическое преобразование пользовательских метрик в DDU
*** DDU для управления логами и аналитики
*** DDU для бессерверных функций
*** DDU для Log Monitoring Classic
*** DDU для деловых мероприятий
*** DDU для пользовательских трассировок (API трассировки)
*** DDU для индивидуальных событий ИИ
** Мониторинг цифрового опыта (DEM-единицы)
** Мониторинг безопасности приложений (ASU)
** Мониторинг облачной автоматизации (CAU)
* '''Центр Ключ-АСТРОМ'''
* '''Управление счетом'''
** Управление подпиской и лицензиями
*** Управление лицензиями
**** История подписки
**** Мониторы затрат
**** Бюджеты
**** Отчеты по выставлению счетов
*** Управление лицензиями
** Настройки
*** Разрешить диапазоны IP-адресов
** Lens
** Управление пользователями, группами и разрешениями
*** Аутентификация в управлении учетными записями с помощью клиентов OAuth
* '''Конфигурация Ключ-АСТРОМ как код'''
** Monaco
*** Установка Monaco CLI
*** Управление конфигурациями
**** Папка проекта
**** Конфигурация
**** Специальные типы конфигурации
**** Конфигурация учетной записи
*** Руководства
**** Расширенные варианты использования шаблонов
**** Создание OAuth-клиента
**** Перенос устаревших типов конфигурации
**** Переход с Monaco 1.x на 2.x
**** Обеспечение порядка конфигураций
*** Справка
**** Команды
**** Требования к оборудованию
**** Ведение логов
**** Типы конфигурации и права доступа
*** Развертка первой конфигурации
** Terraform
*** Установка
*** Простой пример
*** Расширенный пример
*** Справка
**** Утилита для экспорта
**** Перенос
**** Создание OAuth-клиент
*** Примеры логов AWS
*** Ссылки Terraform
* '''Конфиденциальность и безопасность данных'''
** Конфиденциальность данных
*** Защита данных
*** Сроки хранения данных
*** Адаптивное хранение данных
*** Права на конфиденциальность
*** Персональные данные, собранные Ключ-АСТРОМ
*** Уровни защиты данных
*** Файлы cookie
*** Конфиденциальность пользователя для iOS
*** Форма безопасности данных для Android
** Безопасность данных
*** Контроль безопасности данных
*** Безопасный контроль разработки
*** Сообщение о проблеме, связанной с безопасностью
** Конфиденциальность данных и настройка безопасности
*** Настройка параметров конфиденциальности данных
*** Управление логами аудита
* '''Управление идентификацией и доступом'''
** Варианты использования
*** Группы и разрешения по умолчанию
*** Политика Ключ-АСТРОМ по умолчанию
*** Предоставление доступа к Ключ-АСТРОМ
*** Предоставление доступа к настройкам
** Управление пользователями и группами
*** Группы пользователей, разрешения и политика
*** Управление пользователями и группами через LDAP
*** Управление пользователями и группами с помощью SAML в Ключ-АСТРОМ Managed
*** Управление пользователями и группами с помощью OpenID в Ключ-АСТРОМ Managed
*** Управление пользователями
*** Управление группой
*** SAML
**** Концепция
**** Конфигурации SAML
**** Конфигурация для конкретного IdP
***** Подробности AD FS
***** Подробности Azure
***** Подробности о Google Workspaces
***** Подробности Okta
** Управление разрешениями
*** Работа с политикой
**** Управление политикой
**** Групповые разрешения
**** Границы политики
**** Синтаксис утверждения политики
**** Расширенные настройки
***** Глобальные свойства
***** Глобальные атрибуты
***** Перенос ролевых разрешений
***** Шаблонирование
***** Ссылки на политику
*** Разрешения на управление аккаунтом
*** Разрешения на основе ролей
*** Менеджмент зоны
**** Настройка менеджмент зон
**** Правила менеджмент зон
**** Применение и использование менеджмент зон
** API-токены и клиенты OAuth
*** OAuth-клиенты
*** Классические токены доступа
**** Персональный токен доступа
**** Токен арендатора
* '''Сетевые зоны'''
** Основная информация
** Подключение ЕдиногоАгента
** Подключение АктивногоШлюза
** Перенос
*** Анализ
*** План
*** Развертка
*** Проверка
** Новая установка
*** Анализ
*** План
*** Развертка
*** Проверка
** Переименование сетевой зоны
** Удаление сетевой зоны
* '''[[Владение]]'''
** [[Создание и управление владениями]]
** [[Назначение владельцев объектов]]
** [[Приложение для владения]]
** [[Лучшие команды для владения]]
* '''Теги и метаданные'''
** Варианты использования
** Основные понятия
*** Теги в сравнении с метаданными
*** Лучшие команды для тегов
*** [[Масштабирование тегов]]
** Справка
*** Регулярные выражения в Ключ-АСТРОМ
** Настройка
*** Определение и применение тегов
*** Определение тегов на основе переменных среды
* '''Настройки 2.0'''
* '''Системные уведомления'''

== API Ключ-АСТРОМ ==

* '''Основы'''
** Токены и аутентификация
** Коды ответов
** Ограничение доступа
** Предварительные версии и версии с ранним доступом
** Руководства по переносу для устаревших API
*** Токены v1 к токенам доступа
*** События v1 к Событиям v2
*** Проблемы v1 к проблемам v2
*** Профили оповещения в настройках
*** Техническое обслуживание в настройках
*** Частое обнаружение проблем в настройках
*** Топология и Smartscape в контролируемых объектов
*** Учетные записи Cloud Foundry в настройках
*** Учетные записи Kubernetes в настройках
*** События метрики в настройках
* '''API среды'''
** АктивныйШлюз
*** Информация
**** [[GET информацию о всех АктивныхШлюзах]]
**** [[GET информацию о конкретном АктивномШлюзе]]
*** Конфигурация автообновления
**** [[GET глобальную конфигурацию]]
**** [[Редактировать глобальную конфигурацию]]
**** [[GET АктивныйШлюз]]
**** [[Редактировать АктивныйШлюз]]
*** Задания автообновлений
**** [[GET все задания автообновления]]
**** [[GET конкретное задание автообновления]]
**** [[POST задание автообновления]]
**** [[DELETE задание автообновления]]
**** [[GET АктивныхШлюзов с автообновлением заданий]]
** Анонимизация
*** [[PUT задания анонимизации]]
*** [[GET статус анонимизации]]
** Безопасность приложений
*** Проблемы безопасности
**** Получить список проблем безопасности в среде
**** Получить информацию о конкретной проблеме безопасности
**** Скрыть проблему
**** Показать проблему
**** Получить список исправлений
**** Скрыть/показать исправление
**** Получить список уязвимых функций
*** [[Советник по безопасности ИИ]]
** Логи аудита
*** [[GET лога аудита]]
*** [[GET запись лога аудита]]
** Информация о кластере
*** [[GET информацию о кластере]]
** Хранилище учетных данных
** Пользовательские теги
*** [[GET теги]]
*** [[POST-теги]]
*** [[DELETE тегов]]
** Развертывание
***ЕдиныйАгент
****[[Просмотр информации о подключении]]
*** [[GET теги]]
*** [[POST-теги]]
*** [[DELETE тегов]]
** События v1
*** [[GET ленты событий]]
*** [[GET события]]
*** [[POST события]]
*** [[Отправка событий развертывания из Jenkins]]
** События v2
*** [[GET списка событий]]
*** [[GET события v2]]
*** [[POST события v2]]
*** [[GET всех типов событий]]
*** [[GET типа события]]
*** [[GET всех свойств события]]
*** [[GET свойства события]]
** Расширения 2.0
*** Конфигурации среды
**** [[Расширения 2.0 API - GET активация|GET конфигурации среды]]
**** [[PUT конфигурации среды]]
**** [[POST активации конфигурации]]
**** [[DELETE деактивация конфигурации]]
**** [[GET списка событий - Расширения 2.0|GET списка событий]]
*** Расширения
**** [[GET всех расширений - Расширения|GET всех расширений]]
**** [[GET версии расширения]]
**** [[GET расширения]]
**** [[POST файла расширения]]
**** [[DELETE версии расширения]]
**** [[GET схемы расширения]]
*** Конфигурации мониторинга
**** [[GET всех конфигураций мониторинга]]
**** [[GET конфигурации мониторинга]]
**** [[POST конфигурации мониторинга]]
**** [[PUT конфигурации мониторинга]]
**** [[DELETE конфигурации мониторинга]]
**** [[GET списка событий - Конфигурации мониторинга|GET списка событий]]
**** [[GET статуса]]
*** Схемы
**** [[GET всех схем]]
**** [[GET всех файлов]]
**** [[GET файла]]
** Элементы концентратора
** Мониторинг логов
*** [[GET лога поиска]]
*** [[GET лога экспорта]]
*** [[GET сводного лога]]
*** [[POST лога нагрузки]]
** Таймсерии v1
*** [[Пользовательские метрики]]
**** [[PUT пользовательской метрики]]
**** [[DELETE пользовательской метрики - Пользовательские метрики|DELETE пользовательской метрики]]
*** Определение метрик
**** [[GET списка метрик]]
**** [[GET определения метрик]]
*** Чтение точек данных
**** [[GET точек данных]]
**** [[POST точек данных]]
** Метрики v2
*** [[GET метрик]]
*** [[Получение дескриптора метрики]]
*** [[Получение точки данных метрики]]
*** [[Селектор показателей]]
*** [[Выражение метрик]]
*** [[POST введённых точек данных]]
*** [[DELETE пользовательской метрики]]
*** Примеры и варианты использования
**** [[Список всех метрик]]
**** [[Выбор нескольких метрик]]
**** [[Выбор полного поддерева метрик]]
*** [[FAQ]]
** Единицы метрик
*** [[GET всех единиц метрик]]
*** [[GET одной единицы метрик]]
*** [[API метрик - GET - конвертировать единицы|GET - конвертировать единицы]]
** Отслеживаемые объекты v2
*** [[GET список объектов]]
*** [[GET объект]]
*** [[GET все типы объектов]]
*** [[GET тип объектов]]
*** [[POST пользовательское устройство]]
*** [[Селектор объектов]]
** Сетевые зоны
*** [[GET всех сетевых зон]]
*** [[GET одной сетевой зоны]]
*** [[PUT сетевой зоны]]
*** [[DELETE сетевой зоны]]
*** [[GET глобальной конфигурации]]
*** [[PUT глобальной конфигурации]]
** OTLP прием
** [[Топология и Smartscape v1]]
*** [[Приложения]]
**** [[GET все приложения]]
**** [[GET приложение]]
**** [[POST тегов]]
**** [[GET базового уровня]]
*** [[Хосты]]
**** [[GET все хосты]]
**** [[GET хост]]
**** [[POST тэгов]]
**** [[DELETE тэга]]
*** Процессы
**** [[GET все процессы]]
**** [[GET процесс]]
*** Группы процессов
**** [[GET все группы процессов]]
**** [[GET группы процессов]]
**** [[POST тэгов*|POST тэгов]]
*** Сервисы
**** [[GET все сервисы]]
**** [[GET сервис]]
**** [[POST тэгов**|POST тэгов]]
**** [[GET базового уровня*|GET базового уровня]]
*** [[Пользовательские устройства]]
**** [[Создание пользовательского устройства]]
**** [[Отчёт о метрике пользовательского устройства]]
** [[ЕдиныйАгент на хосте]]
** Проблемы v2
*** [[JSON-модели]]
*** Комментарии
**** [[GET все комментарии]]
**** [[GET комментарий]]
**** [[POST комментарий]]
**** [[PUT комментарий]]
**** [[DELETE комментарий]]
*** Проблемы
**** [[GET список*|GET список]]
**** [[GET детали]]
**** [[POST закрытие проблемы]]
** Релизы
*** [[GET релизы]]
** Удаленное управление конфигурацией
*** ЕдиныйАгент
**** [[POST задание конфигурации]]
**** [[POST предпросмотр работы]]
**** [[GET текущая работа]]
**** [[GET готовые работы]]
**** [[GET задание по настройке]]
*** АктивныйШлюз
**** [[POST задание конфигурации*|POST задание конфигурации]]
**** [[POST предпросмотр работы*|POST предпросмотр работы]]
**** [[GET текущая работа*|GET текущая работа]]
**** [[GET готовые работы*|GET готовые работы]]
**** [[GET задание по настройке*|GET задание по настройке]]
** [[Браузерное расширение Real User Monitoring]]
** Мониторинг реального пользователя (RUM)
*** Географические регионы
**** [[GET страны]]
**** [[GET регионы]]
**** [[GET регионы страны]]
**** [[GET города страны]]
**** [[GET города региона]]
*** RUM JavaScript
**** [[GET список инжектированных приложений]]
**** [[GET последняя версия]]
**** [[GET текущая версия]]
**** [[GET тег JavaScript]]
**** [[GET тег JavaScript ЕдиныйАгент]]
**** [[GET фрагмент кода синхронизации]]
**** [[GET фрагмент асинхронного кода]]
**** [[GET встроенный код]]
*** Сеансы пользователей
**** [[GET таблица]]
**** [[GET дерево]]
**** [[Структура сеанса пользователя]]
** Цели уровня обслуживания
*** [[GET все SLO]]
*** [[GET один SLO]]
*** [[POST один SLO]]
*** [[PUT один SLO]]
*** [[DELETE один SLO]]
** Настройки
*** Объекты
**** [[GET объекты]]
**** [[GET объект*|GET объект]]
**** [[POST объект]]
**** [[PUT объект]]
**** [[DELETE объект]]
**** [[GET эффективные значения]]
*** Схемы
**** [[GET все схемы]]
**** [[GET схема]]
** Синтетика v1
*** Синтетические мониторы
**** [[GET все мониторы]]
**** [[GET монитор]]
**** [[POST монитор]]
**** [[PUT монитор]]
**** [[DELETE монитор]]
**** [[JSON модели*|JSON модели]]
*** Синтетические локации
**** [[GET все локации*|GET все локации]]
**** [[GET локация*|GET локация]]
**** [[POST локация*|POST локация]]
**** [[PUT локация*|PUT локация]]
**** [[DELETE локация*|DELETE локация]]
**** [[GET статус локации*|GET статус локации]]
**** [[PUT статус локации*|PUT статус локации]]
**** [[JSON модели**|JSON модели]]
*** Синтетические ноды
**** [[GET все ноды*|GET все ноды]]
**** [[GET нода*|GET нода]]
*** Прочая синтетика
**** [[POST прочие мониторы]]
**** [[POST прочие события]]
**** [[POST изменение состояния прочих мониторов]]
** Синтетика v2
*** Синтетические локации
**** [[GET все локации]]
**** [[GET локация]]
**** [[POST локация]]
**** [[PUT локация]]
**** [[DELETE локация]]
**** [[GET статус локации]]
**** [[PUT статус локации]]
**** [[JSON модели]]
*** Синтетические ноды
**** [[GET все ноды]]
**** [[GET нода]]
*** Отслеживание выполнения
**** [[GET HTTP монитор]]
**** [[GET все выполнения по требованию]]
**** [[GET основная информация о выполнении]]
**** [[GET полная информация о выполнении]]
**** [[POST пакетное выполнение]]
**** [[GET сводка о пакетном выполнении]]
*** Конфигурация
**** [[GET конфигурация]]
**** [[PUT конфигурация]]
** Токены v2
*** Токены доступа
**** [[GET все токены]]
**** [[GET токен]]
**** [[POST поиск токена]]
**** [[POST токен]]
**** [[PUT токен]]
**** [[DELETE токен]]
*** Токены АктивногоШлюза
**** [[GET все токены*|GET все токены]]
**** [[GET токен*|GET токен]]
**** [[POST токен*|POST токен]]
**** [[DELETE токен*|DELETE токен]]
*** Токены владельца
**** [[POST старт ротации]]
**** [[POST окончания ротации]]
**** [[POST отмены ротации]]
* '''API конфигурации'''
** Обнаружение аномалий
*** [[Обнаружение аномалий API - Приложения|Приложение]]
**** [[Обнаружение аномалий приложения API - GET конфигурация|GET конфигурация]]
**** [[Обнаружение аномалий приложения API - PUT конфигурация|PUT конфигурация]]
*** [[Обнаружение аномалий API - AWS|AWS]]
**** [[AWS обнаружение аномалий API - GET конфигурация|GET конфигурация]]
**** [[AWS обнаружение аномалий API - PUT конфигурация|PUT конфигурация]]
*** [[Обнаружение аномалий API - Службы базы данных|Службы базы данных]]
**** [[Обнаружение аномалий базы данных API - GET конфигурация|GET конфигурация]]
**** [[Обнаружение аномалий базы данных API - PUT конфигурация|PUT конфигурация]]
*** [[Обнаружение аномалий API - Дисковые события|Дисковые события]]
**** [[Обнаружение аномалий дисковых событий API - GET все события|GET все события]]
**** [[Обнаружение аномалий дисковых событий API - GET событие|GET событие]]
**** [[Обнаружение аномалий дисковых событий API - POST событие|POST событие]]
**** [[Обнаружение аномалий дисковых событий API - PUT событие|PUT событие]]
**** [[Обнаружение аномалий дисковых событий API - DELETE событие|DELETE событие]]
*** [[Обнаружение аномалий API - Хосты|Хосты]]
**** [[Обнаружение аномалий хоста API - GET конфигурация|GET конфигурация]]
**** [[Обнаружение аномалий хоста API - PUT конфигурация|PUT конфигурация]]
*** [[Обнаружение аномалий API - События метрик|События метрик]]
**** [[Обнаружение аномалий событий метрик API - GET все события|GET все события]]
**** [[Обнаружение аномалий событий метрик API - GET событие|GET событие]]
**** [[Обнаружение аномалий событий метрик API - POST событие|POST событие]]
**** [[Обнаружение аномалий событий метрик API - PUT событие|PUT событие]]
**** [[Обнаружение аномалий событий метрик API - DELETE событие|DELETE событие]]
**** [[Обнаружение аномалий событий метрик API - JSON модель|JSON модель]]
*** [[API обнаружения аномалий - Группы процессов|Группы процессов]]
**** [[API обнаружения аномалий групп процессов - GET конфигурация|GET конфигурация]]
**** [[API обнаружения аномалий групп процессов - PUT конфигурация|PUT конфигурация]]
**** [[API обнаружения аномалий групп процессов - DELETE конфигурация|DELETE конфигурация]]
*** [[API обнаружения аномалий - Службы|Службы]]
**** [[API обнаружения аномалий служб - GET конфигурация|GET конфигурация]]
**** [[API обнаружения аномалий служб - PUT конфигурация|PUT конфигурация]]
*** [[API обнаружения аномалий - VMware|VMware]]
**** [[API обнаружения аномалий VMware - GET конфигурация|GET конфигурация]]
**** [[API обнаружения аномалий VMware - PUT конфигурация|PUT конфигурация]]
** [[API автоматически применяемых тегов|Автоматические теги]]
*** [[API автоматически применяемых тегов - GET все автоматические теги|GET все автоматические теги]]
*** [[API автоматически применяемых тегов - GET автоматический тег|GET автоматический тег]]
*** [[API автоматически определяемых тегов - POST автоматический тег|POST автоматический тег]]
*** [[API автоматически применяемых тегов - PUT автоматический тег|PUT автоматический тег]]
*** [[API автоматически применяемых тегов - DELETE автоматический тег|DELETE автоматический тег]]
*** [[API автоматически применяемых тегов - JSON модели|JSON модели]]
** Учётные данные AWS
*** [[API учётных данных AWS - GET все учётные данные|GET все учётные данные]]
*** [[API учётных данных AWS - POST новые учётные данные|POST новые учётные данные]]
*** [[API учётных данных AWS - GET учётные данные|GET учётные данные]]
*** [[API учётных данных AWS - PUT учётные данные|PUT учётные данные]]
*** [[API учётных данных AWS - DELETE учётные данные|DELETE учётные данные]]
*** [[API учётных данных AWS - GET службы мониторинга|GET службы мониторинга]]
*** [[API учётных данных AWS - PUT службы мониторинга|PUT службы мониторинга]]
** AWS PrivateLink
** Учётные данные Azure
** Расчётные метрики
** Учётные данные Cloud Foundry
** Условное наименование
** Хранилище учётных данных
** Дашборды
*** Получить информацию о всех дашбордах
*** Получить информацию о конкретном дашборде
** [[Конфиденциальность данных]]
** Расширения
** Частота обнаружения проблем
** Учётные данные Kubernetes
** Окна обслуживания
** Зоны управления
** Мобильная символика
** [[Уведомления]]
** Конфигурация ЕдиногоАгента
** Плагины
** [[API Удалённых сред]]
** Отчёты
** RUM
** Сервисы
* '''API управления аккаунтом'''
** Управление окружающей средой
*** GET кластера
*** GET конфигурации IP
*** PUT конфигурации IP
*** GET всех сред
*** GET всех сред v2
** Управление пользователями
*** GET всех пользователей
*** POST нового пользователя
*** DELETE пользователя
*** GET групп пользователей
*** POST групп пользователей
*** PUT групп пользователей
*** DELETE пользователей из групп
** Управление группой
*** GET всех групп
*** POST новой группы
*** GET участников группы
*** PUT группы пользователей
*** DELETE группу пользователей
** Управление разрешениями
*** GET разрешения
*** POST разрешения
*** PUT разрешения
*** DELETE разрешения
** Управление политикой
*** Политика
**** GET всех политик
**** GET собственных политик
**** GET политики
**** POST политики
**** PUT политики
**** DELETE политики
*** Привязки
**** GET привязки групп пользователей
**** PUT привязки групп пользователей
**** GET привязка уровня политики
**** DELETE привязки уровня политики
**** GET привязки политики
**** POST привязки политики
**** DELETE привязки политики
** Подписка на платформу Ключ-АСТРОМ
*** Подписки
**** GET всех подписок
**** GET подписки
*** Использование
**** GET использование
**** GET использование в каждой среде
*** Расходы
**** GET расходов
**** GET расходов за среду
*** Мониторинг затрат
**** GET прогноз
**** GET события
** Справочные данные
*** GET часовые пояса
*** GET географические регионы
*** GET разрешения пользователя

Business Insights

2026-09-03T19:31:04Z

IKuznetsov: Новая страница: « = Business Insights = Business Insights централизует наш сервис и анализ прямо на платформе '''Ключ-АСТРОМ'''. Благодаря встроенным средствам взаимодействия (комментарии и обратная связь), контекстному взаимодействию в рамках всей платформы и централизации всех аналити...»

= Business Insights =
Business Insights централизует наш сервис и анализ прямо на платформе '''Ключ-АСТРОМ'''. Благодаря встроенным средствам взаимодействия (комментарии и обратная связь), контекстному взаимодействию в рамках всей платформы и централизации всех аналитических материалов в одном месте приложение упрощает предоставление Business Insights, помогая клиентам максимально эффективно использовать '''Цифровой опыт''' и '''Бизнес-наблюдаемость''' и лучше понимать свой бизнес.

== Начало работы ==
Уже являетесь клиентом? Или ещё нет, но хотите узнать, как Business Insights может быть адаптирован под ваши нужды? См. раздел «Предварительные требования», чтобы узнать, какие следующие шаги необходимо предпринять в обоих случаях.

== Разрешения ==
Для использования приложения требуется следующее разрешение:
{| class="wikitable"
!Разрешение
!Описание
|-
|<pre>insights:moments:read</pre>
|Необходимо для чтения ценных моментов, оставления комментариев и отправки отзывов
|}

== Установка ==
Чтобы установить приложение:

* Подпишитесь на канал Business Insights, используя токен, предоставленный командой Business Insights.
* После подписки найдите Business Insights в Hub и выберите '''Установить'''.
* При необходимости обратитесь к своей команде Insights за вопросами или помощью в установке.

== Концепции ==

=== Временная шкала: вся история вашего анализа ===
Business Insights централизует все взаимодействия и аналитические материалы в едином представлении временной шкалы, что позволяет легко просматривать всё, что команда Business Insights предоставила для вашей организации, включая анализ ценных моментов, объявления, обучающие материалы, приглашения на живые сессии, такие как Tech Talks и Customer Connects.

Каждый ценный момент снабжён полезными метаданными, включая тип (производительность, операционный, бизнес), имя приложения, а также конкретные страницы или действия для эффективного поиска.

Обучающие моменты помогают быстрее освоить продукт, а объявления гарантируют, что вы всегда в курсе событий в области '''Цифрового опыта''' и '''Бизнес-наблюдаемости''' в контексте того, что важно для вас. Это комплексное представление помогает новым членам команды быстро понять ваш ландшафт цифрового опыта и предыдущие аналитические выводы, ускоряя ввод в курс как сервиса, так и '''Цифрового опыта Ключ-АСТРОМ'''.

=== Карточки ценных моментов ===
Ценные моменты — это небольшие и удобоваримые результаты анализа цифрового опыта, подготовленные нашими аналитиками для операционных, производственных и бизнес-задач, чтобы помочь вам понять, на чём сосредоточиться.

Все карточки ценных моментов можно найти на временной шкале. Карточка содержит всю необходимую информацию для идентификации ценного момента:

* Заголовок
* Цепочка ценности (операционная, производительность, бизнес, другое)
* Компоненты (синтетика, веб-приложение, мобильное приложение)
* Имя приложения/монитора
* Наличие видео
* Количество просмотров данного ценного момента

=== Поиск ===
Если вы хотите найти конкретный ценный момент или ценные моменты, соответствующие определённому критерию, вы можете выполнить поиск по:

* Типу взаимодействия
* Цепочке ценности
* Компоненту продукта
* Заголовку
* Имени приложения/монитора
* Событиям
* Автору
* Избранному

Чтобы добавить ценный момент в избранное, выберите значок на карточке или в деталях ценного момента.

После добавления в избранное он появится на вкладке '''Избранное'''.

=== Детали ценного момента: насыщенный интерактивный контент ===
При выборе ценного момента на временной шкале он открывается в основном представлении со структурированным и удобным для навигации содержимым.

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

Каждый ценный момент также содержит общую глубокую ссылку, что упрощает привлечение других членов команды к обсуждению.

=== Разделы ценного момента ===
Каждый ценный момент может состоять из одного или нескольких разделов. Вы можете использовать боковую панель разделов, чтобы перейти непосредственно к определённому разделу ценного момента. Для этого просто нажмите кнопку '''Раздел'''.

=== Совместная работа и обратная связь в реальном времени ===
Приложение превращает анализ из односторонней доставки в совместную работу. Просто выберите любой контент внутри ценного момента, чтобы оставить комментарий или вопрос, адресованный команде Insights или вашим коллегам. Наша команда получает уведомление и отвечает непосредственно в ветке комментариев, поддерживая общую согласованность и контекст. Вы также будете получать уведомления по электронной почте с прямыми ссылками, когда мы отвечаем.

Чтобы оставить новый комментарий:

* Выделите текст, к которому хотите оставить комментарий, и нажмите кнопку '''Комментарий'''.
* Введите комментарий в появившемся поле.
* Нажмите '''Комментарий''', чтобы сохранить комментарий.

Чтобы просмотреть все комментарии, перейдите на боковую панель комментариев. Если она закрыта, нажмите чтобы открыть её.

Если вы хотите отложить комментарий или ответ на потом, вы также можете выбрать > '''Отметить как непрочитанное'''.

=== Обратная связь ===
Каждый ценный момент также содержит специальный раздел обратной связи, позволяющий быстро указать ценность и направлять наш будущий анализ и приоритеты.

Оставить отзыв можно в двух местах: на правой боковой панели и внизу.

* Нажмите '''Удовлетворен''' или '''Не удовлетворен'''.
* Появится текстовое поле для дополнительного контекста.
* Нажмите '''Отправить''', чтобы отправить отзыв.

=== Связаться с командой Insights ===
Чтобы связаться или узнать больше о команде Business Insights, перейдите на вкладку '''Связаться с командой Insights''', где вы найдёте набор полезных ссылок.

Мониторинг цифрового опыта с Business Insights

2026-09-03T19:29:49Z

IKuznetsov: Новая страница: « = Мониторинг цифрового опыта с Business Insights = Мониторинг цифрового опыта с Business Insights создан, чтобы помочь пользователям '''Мониторинга цифрового опыта''' ускорить получение ценности и внедрение модулей '''Мониторинга цифрового опыта'''. Это предложение прод...»

= Мониторинг цифрового опыта с Business Insights =
Мониторинг цифрового опыта с Business Insights создан, чтобы помочь пользователям '''Мониторинга цифрового опыта''' ускорить получение ценности и внедрение модулей '''Мониторинга цифрового опыта'''.

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

== Предварительные требования ==

* Ещё не являетесь клиентом? Обратитесь к своему аккаунт-менеджеру или менеджеру по успеху клиентов, чтобы узнать, как '''Мониторинг цифрового опыта с Business Insights''' может быть адаптирован под ваши нужды.
* Уже являетесь клиентом? Откройте '''Business Insights''', чтобы получить доступ к вашим анализам и ценностным моментам, или обратитесь напрямую к своей команде Insights за вопросами и помощью. Приложение доступно в рамках сервиса '''Business Insights'''.

== Внедрение продукта и ускорение ==

* Создание дашбордов мониторинга, настройка конфигурации, отметка ключевых действий пользователя, обновление имён действий пользователя и включение целей конверсии.
* Поддержка развертывания и лучшие практики для всех модулей '''Мониторинга цифрового опыта''' и '''Бизнес-аналитики'''.
* Поддержка синтетики (если применимо), включая поддержку скриптов, лучшие практики написания скриптов и полные услуги миграции с устаревших инструментов.

== Расширенная аналитика и дополнительные варианты использования ==
Расширенная аналитика предоставляется различными способами (через дашборды Insights, приложения Insights и другие) в зависимости от вашей модели развертывания и предпочтений. Эта расширенная аналитика может быть развернута для фокуса на множестве вариантов использования, таких как оптимизация производительности, бизнес-аналитика и операционное расследование. Для каждого из этих вариантов использования цель — помочь вам понять, на чём необходимо сосредоточиться для оптимизации пользовательского опыта и бизнес-результатов.

== Оптимизация и рекомендации по устранению корневых причин ==
Команда Insights может предоставлять анализ и подробные рекомендации по улучшениям различными способами, адаптированными к вашим потребностям и рабочему процессу, например, ad hoc анализ или более крупные ежемесячные аналитические отчёты.

Триаж проблем '''Мониторинга цифрового опыта''' (таких как ошибки, всплески производительности, изменения в объёме сессий) также может быть предоставлен, если применимо.

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

Требуется активная подписка на '''Мониторинг цифрового опыта с Business Insights'''. Это предложение не является профессиональными услугами или поддержкой и отличается от '''Бизнес-наблюдаемости с Insights'''. '''Ключ-АСТРОМ''' не гарантирует, что это предложение приведёт к каким-либо конкретным бизнес-результатам, метрикам или улучшениям.

Архитектура и взаимодействие синтетики

2026-09-03T19:28:18Z

IKuznetsov: Новая страница: « = Архитектура и взаимодействие синтетики = Понимание архитектуры синтетики и того, как ваши данные безопасно проходят через неё. Ознакомьтесь с её основными компонентами и тем, как они взаимодействуют для обеспечения бесперебойной работы. Анализируя...»

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

== Компоненты архитектуры ==
В процессе взаимодействия синтетики участвуют следующие компоненты:

* '''Кластер Ключ-АСТРОМ''' — содержит конфигурации синтетических мониторов, планирует выполнение мониторов для частных локаций и при необходимости отправляет конфигурацию мониторов в публичную инфраструктуру.

* '''Частная локация''' — группа синтетических '''АктивныхШлюзов''', назначенных вашему монитору. Кластер Ключ-АСТРОМ планирует выполнение для частной локации.

* '''АктивныйШлюз''' — компонент, используемый синтетическим движком для регистрации и взаимодействия с кластером Ключ-АСТРОМ.

* '''Публичная инфраструктура синтетики''' — инфраструктура, отвечающая за планирование и конфигурацию публичных локаций.

* '''Публичная локация''' — группа синтетических движков, назначенных вашему монитору. Публичная инфраструктура синтетики планирует выполнение для публичной локации.

* '''Синтетический движок''' — движок, отвечающий за выполнение мониторинга.

* '''Пересыльщик маячков''' — пересылает результаты от синтетических движков в кластер Ключ-АСТРОМ.

== Взаимодействие и потоки данных ==
В зависимости от используемой локации поток данных различается. С помощью схемы выше можно увидеть, как происходит взаимодействие для частных и публичных локаций, а также как в этом процессе участвуют токены.

Каждый номер соответствует шагу на схеме.

=== Взаимодействие для частных локаций ===

# '''Кластер Ключ-АСТРОМ → АктивныйШлюз'''

Кластер предоставляет конфигурацию, определения мониторов и планирует выполнение. Данные шифруются с помощью токена АктивногоШлюза.

# '''Синтетический движок → АктивныйШлюз'''

Синтетический движок запрашивает конфигурацию, определения мониторов и выполнение у кластера через АктивныйШлюз. Данные шифруются с помощью синтетического токена, который создаётся при запуске АктивногоШлюза и сохраняется в файле <code>synthetic.token</code> в папке конфигурации. Этот файл токена используется совместно АктивнымШлюзом и синтетическим движком.

# '''Синтетический движок → Пересыльщик маячков'''

Синтетический движок отправляет результаты выполнения. Данные шифруются с помощью токена синтетических мониторов. Кластер Ключ-АСТРОМ генерирует этот токен на уровне арендатора, и он обновляется каждые 24 часа. Раз в день токены старше 48 часов удаляются. Токен передаётся движку вместе с деталями выполнения, а взаимодействие защищается с помощью токена АктивногоШлюза.

# '''Пересыльщик маячков → Кластер Ключ-АСТРОМ'''

Пересыльщик маячков пересылает результаты, отправленные движком, в кластер. Данные шифруются с помощью токена АктивногоШлюза.

=== Взаимодействие для публичных локаций ===

# '''Кластер Ключ-АСТРОМ → Публичная инфраструктура синтетики'''

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

# '''Синтетический движок → Публичная инфраструктура синтетики'''

Синтетический движок запрашивает конфигурацию, определения мониторов и выполнение у публичной инфраструктуры, а также передаёт диагностические данные. Данные защищены на сетевом уровне.

# '''Синтетический движок → Пересыльщик маячков'''

Синтетический движок отправляет результаты выполнения. Данные шифруются с помощью токена синтетических мониторов. Кластер Ключ-АСТРОМ генерирует этот токен на уровне арендатора, и он обновляется каждые 24 часа. Раз в день токены старше 48 часов удаляются. Токен передаётся движку вместе с деталями выполнения, а взаимодействие защищается с помощью токена АктивногоШлюза.

# '''Пересыльщик маячков → Кластер Ключ-АСТРОМ'''

Пересыльщик маячков пересылает результаты, отправленные движком, в кластер. Данные шифруются с помощью токена АктивногоШлюза.

Синтетические мониторы в Smartscape

2026-09-03T19:25:59Z

IKuznetsov: /* Статические и динамические рёбра */

= Синтетические мониторы в Smartscape =
Синтетические мониторы, их шаги и локации, из которых они запускаются, моделируются как ноды первого класса в Smartscape. Они используют тот же граф топологии, семантику и язык запросов, что и остальное окружение — хосты, сервисы, фронтенды и рабочие нагрузки '''Kubernetes'''. На этой странице описана модель — её типы нодов, их атрибуты и связи между ними, а также показано, как запрашивать синтетические мониторы, шаги и локации с помощью '''DQL''' (astromkey Query Language).

Синтетические сущности моделируются как ноды Smartscape, а их отношения — как связи. На этой странице под неуточнённой сущностью или <code>dt.entity.*</code> подразумевается классическая модель.

== Типы нодов ==
Синтетический мониторинг моделируется следующими типами нодов Smartscape:
{| class="wikitable"
!Сущность Smartscape
!Тип ноды
!Идентификатор модели Smartscape
!Классическая модель сущности
|-
|Браузерный монитор
|<pre>BROWSER_MONITOR</pre>
|<pre>dt.smartscape.browser_monitor</pre>
|<pre>dt.entity.synthetic_test</pre>
|-
|Шаг браузерного монитора
|<pre>BROWSER_MONITOR_STEP</pre>
|<pre>dt.smartscape.browser_monitor_step</pre>
|<pre>dt.entity.synthetic_test_step</pre>
|-
|HTTP-монитор
|<pre>HTTP_MONITOR</pre>
|<pre>dt.smartscape.http_monitor</pre>
|<pre>dt.entity.http_check</pre>
|-
|Шаг HTTP-монитора
|<pre>HTTP_MONITOR_STEP</pre>
|<pre>dt.smartscape.http_monitor_step</pre>
|<pre>dt.entity.http_check_step</pre>
|-
|Монитор сетевой доступности
|<pre>NETWORK_AVAILABILITY_MONITOR</pre>
|<pre>dt.smartscape.network_availability_monitor</pre>
|<pre>dt.entity.multiprotocol_monitor</pre>
|-
|Синтетическая локация
|<pre>SYNTHETIC_LOCATION</pre>
|<pre>dt.smartscape.synthetic_location</pre>
|<pre>dt.entity.synthetic_location</pre>
|}
Типы нодов, их атрибуты и отношения определены в группе моделей '''Smartscape — Synthetic''' в '''Семантическом словаре'''.

== Атрибуты ==
Как ноды Smartscape, синтетические мониторы, шаги и локации могут запрашиваться для дашбордов, соглашений об уровне обслуживания ('''SLO''') и навигации по топологии. Каждый тип ноды отвечает на разные вопросы:
{| class="wikitable"
!Тип ноды
!Примеры вопросов
!Ключевые атрибуты
|-
|<pre>HTTP_MONITOR, BROWSER_MONITOR, NETWORK_AVAILABILITY_MONITOR</pre>
|Какие мониторы существуют, кто их владелец, как часто они запускаются, когда они в последний раз завершились успешно или с ошибкой, включены ли они?
|<pre>created_by, creation_timestamp, last_successful_execution_timestamp, last_failed_execution_timestamp, frequency, enabled</pre>
|-
|<pre>HTTP_MONITOR_STEP, BROWSER_MONITOR_STEP</pre>
|Из каких отдельных запросов или действий состоит монитор и в каком порядке?
|<pre>step.sequence_number, step.url, http.request.method, dt.synthetic.step.type</pre>
|-
|<pre>SYNTHETIC_LOCATION</pre>
|Где выполняются мониторы — в каком облаке, регионе и городе, и что может делать каждая локация?
|<pre>cloud.provider, location_type, deployment_type, capabilities, geo.*</pre>
|}
Каждая нода также содержит общие базовые атрибуты: <code>id</code>, <code>id_classic</code>, <code>name</code>, <code>deleted</code> и <code>tags</code>.

<code>deleted</code> — это флаг мягкого удаления. Удалённый монитор, локация или учётные данные не удаляются из Smartscape немедленно — их нода остаётся доступной для запросов в течение периода хранения с <code>deleted == true</code>, так что недавно удалённые элементы всё ещё отображаются. Добавьте <code>| filter deleted == false</code>, чтобы исключить их.

Теги существуют в двух формах. Поле <code>tags</code> содержит обычные теги, агрегированные по всем контекстам; для запроса одного контекста используйте <code>tags:<контекст></code>. Основные теги (primary tags) — это выбранный набор, который '''Ключ-АСТРОМ''' прикрепляет ко всем телеметрическим данным при приёме (например, метки '''Kubernetes''' или облачные теги) — они доступны у мониторов и шагов с префиксом <code>primary_tags.*</code> и являются самым быстрым способом фильтрации или группировки. Правила на основе тегов из классической модели в этой модели отсутствуют.

Географические атрибуты и атрибуты выполнения: синтетические локации содержат полные географические атрибуты (<code>geo.continent.name</code>, <code>geo.country.name</code>, <code>geo.region.name</code>, <code>geo.city.name</code>, <code>geo.location.latitude</code>, <code>geo.location.longitude</code>), поэтому вы можете группировать и фильтровать мониторы по месту выполнения и отображать их на карте. Мониторы предоставляют время последнего успешного и последнего неудачного выполнения как отдельные атрибуты (<code>last_successful_execution_timestamp</code>, <code>last_failed_execution_timestamp</code>), что позволяет находить мониторы как по результату, так и по давности выполнения.

Полный авторитетный список атрибутов, типов и примеров для каждого типа ноды см. в группе моделей '''Smartscape — Synthetic''' в '''Семантическом словаре'''.

== Отношения ==
Синтетические сущности Smartscape связаны следующими отношениями:
{| class="wikitable"
!Источник
!Отношение
!Цель
!Тип
!Описание
|-
|<pre>HTTP_MONITOR</pre>
|<pre>runs_on</pre>
|<pre>SYNTHETIC_LOCATION</pre>
|static
|Локации, из которых выполняется монитор
|-
|<pre>HTTP_MONITOR</pre>
|<pre>contains</pre>
|<pre>HTTP_MONITOR_STEP</pre>
|static
|Отдельные HTTP-запросы, составляющие монитор
|-
|<pre>HTTP_MONITOR</pre>
|<pre>uses</pre>
|<pre>CREDENTIAL_VAULT_ENTRY</pre>
|static
|Записи хранилища учётных данных, которые монитор читает
|-
|<pre>HTTP_MONITOR</pre>
|<pre>updates</pre>
|<pre>CREDENTIAL_VAULT_ENTRY</pre>
|static
|Записи хранилища учётных данных, которые монитор записывает обратно
|-
|<pre>HTTP_MONITOR</pre>
|<pre>monitors</pre>
|<pre>SERVICE</pre>
|dynamic
|Бэкенд-сервис, который монитор проверяет
|-
|<pre>HTTP_MONITOR</pre>
|<pre>is_assigned_to</pre>
|<pre>FRONTEND</pre>
|dynamic
|Фронтенд-приложение, с которым связан монитор
|-
|<pre>HTTP_MONITOR_STEP</pre>
|<pre>belongs_to</pre>
|<pre>HTTP_MONITOR</pre>
|static
|Родительский монитор шага
|-
|<pre>BROWSER_MONITOR</pre>
|<pre>runs_on</pre>
|<pre>SYNTHETIC_LOCATION</pre>
|static
|Локации, из которых выполняется монитор
|-
|<pre>BROWSER_MONITOR</pre>
|<pre>contains</pre>
|<pre>BROWSER_MONITOR_STEP</pre>
|static
|Шаги в скрипте браузерного теста
|-
|<pre>BROWSER_MONITOR</pre>
|<pre>uses</pre>
|<pre>CREDENTIAL_VAULT_ENTRY</pre>
|static
|Записи хранилища учётных данных, которые монитор читает
|-
|<pre>BROWSER_MONITOR</pre>
|<pre>monitors / is_assigned_to</pre>
|<pre>FRONTEND</pre>
|dynamic
|Фронтенд-приложение, которое монитор тестирует
|-
|<pre>BROWSER_MONITOR_STEP</pre>
|<pre>belongs_to</pre>
|<pre>BROWSER_MONITOR</pre>
|static
|Родительский монитор шага
|-
|<pre>NETWORK_AVAILABILITY_MONITOR</pre>
|<pre>runs_on</pre>
|<pre>SYNTHETIC_LOCATION</pre>
|static
|Локации, из которых выполняется монитор
|-
|<pre>NETWORK_AVAILABILITY_MONITOR</pre>
|<pre>monitors</pre>
|<pre>HOST</pre>
|dynamic
|Хост, который монитор проверяет (ping или соединение)
|}

=== Статические и динамические связи ===
Столбец «Тип» в таблице выше отражает, как создаётся каждая связь. Связи бывают двух видов:

* '''Статические''' определяются конфигурацией монитора и стабильны во времени — например, какие шаги содержит монитор, из каких локаций он запускается и какие записи хранилища учётных данных он использует.
* '''Динамические''' выводятся из данных выполнения и могут появляться и исчезать по мере наблюдения трафика — например, бэкенд-сервис, который HTTP-монитор проверяет (<code>monitors</code>), или RUM-фронтенд, с которым связан браузерный монитор (<code>is_assigned_to</code>). Монитор без недавних выполнений может временно не иметь динамических связей.

Связи <code>contains</code> (монитор → шаг) и <code>belongs_to</code> (шаг → монитор) описывают одну и ту же связь с обоих концов, поэтому вы можете перейти от монитора к его шагам или от шага обратно к монитору.

=== Отношения монитор-фронтенд ===
Эти связи позволяют увидеть, с каким RUM-приложением связан монитор — чтобы можно было сопоставить результаты монитора с фронтендом, который фактически используют пользователи. Монитор может быть связан с фронтендом двумя способами, и различие важно:

* <code>is_assigned_to</code>: фронтенд, который вы явно назначили монитору, связывая результаты монитора с этим приложением.
* <code>monitors</code>: цель, которую монитор проверяет во время выполнения: для браузерных мониторов — RUM-фронтенд, для HTTP-мониторов — бэкенд-сервис, для мониторов сетевой доступности — хост.

Обе связи являются динамическими, даже назначенная: связь материализуется на основе выполнения монитора, а не из сохранённой конфигурации. Поэтому связь появляется только после того, как монитор запустился и его целевая сущность была определена; она может меняться или исчезать по мере наблюдения выполнений. Монитор, который не запускался недавно, или чей назначенный фронтенд или обнаруженная цель больше не разрешаются, может не иметь ни одной связи.

=== Хранилище учётных данных: чтение и запись ===
Две связи для учётных данных различают, как монитор взаимодействует с записью хранилища учётных данных:

* <code>uses</code>: монитор читает учётные данные (в предварительном/постскрипте, в '''URL''' или в любом другом месте, где используется секрет).
* <code>updates</code>: монитор записывает учётные данные обратно в хранилище (например, скрипт, который вызывает API <code>save-credential</code> для их ротации).

Это различие позволяет понять, «этот монитор потребляет эти учётные данные» или «этот монитор обслуживает эти учётные данные» — полезно при планировании ротации учётных данных. Браузерные мониторы читают учётные данные, но никогда не записывают их обратно, поэтому <code>BROWSER_MONITOR</code> имеет связи <code>uses</code>, но не <code>updates</code> — это сделано намеренно, а не является пропуском.

== Запросы с помощью DQL ==
Используйте команду <code>smartscapeNodes</code> для запроса синтетических нод. Все запросы выполняются к таблице <code>smartscape.nodes</code>.

=== Вывести все мониторы заданного типа ===
<pre>
smartscapeNodes HTTP_MONITOR
| fields id, name, enabled, frequency,
creation_timestamp, last_successful_execution_timestamp
| sort name asc
</pre>Замените <code>HTTP_MONITOR</code> на <code>BROWSER_MONITOR</code> или <code>NETWORK_AVAILABILITY_MONITOR</code> для других типов мониторов.

=== Показать читаемые имена и атрибуты вместо сырых идентификаторов ===
При навигации по связям или работе со ссылочными идентификаторами часто есть <code>SmartscapeId</code> ноды, но нужно получить его имя или атрибут. Функции <code>getNodeName()</code> и <code>getNodeField()</code> являются аналогами классических <code>entityName()</code> / <code>entityAttr()</code> и разрешают значение непосредственно по идентификатору — без соединения или дополнительного запроса.<pre>
smartscapeEdges is_assigned_to
| filter source_type == "HTTP_MONITOR"
| fields monitorName = getNodeName(source_id),
frontendName = getNodeName(target_id),
monitorEnabled = getNodeField(source_id, "enabled")
</pre><code>getNodeName(id)</code> возвращает имя ноды; <code>getNodeField(id, "<атрибут>")</code> возвращает любой атрибут (например, <code>"enabled"</code>, <code>"cloud.provider"</code>, <code>"geo.country.name"</code>). Классическая функция <code>entityName()</code> недоступна для нод Smartscape.

=== Найти мониторы, которые не выполнялись успешно в последнее время ===
Мониторы, у которых <code>last_successful_execution_timestamp</code> старше 24 часов, могут указывать на постоянный сбой или неправильно настроенное расписание.<pre>
smartscapeNodes HTTP_MONITOR
| filter enabled == true
| filter isNull(last_successful_execution_timestamp)
OR last_successful_execution_timestamp < now() - 24h
| fields id, name, last_successful_execution_timestamp, last_failed_execution_timestamp
| sort last_successful_execution_timestamp asc
</pre><code>last_successful_execution_timestamp</code> отражает успешные выполнения, зафиксированные в модели Smartscape, поэтому монитор без зафиксированных успехов показывает <code>null</code> — в том числе если он только когда-либо завершался ошибкой. Для полной исторической картины используйте метрики доступности; если ваш диапазон может охватывать период до данных Smartscape, см. раздел «Запрос доступности во время перехода от классической модели к Smartscape».

=== Найти все отключённые мониторы ===
<pre>
smartscapeNodes HTTP_MONITOR
| filter enabled == false
| fields id, name, last_modification_timestamp, last_modified_by
| sort last_modification_timestamp desc
</pre>

=== Сравнить частоту выполнения по всем типам мониторов ===
Синтетические ноды запрашиваются командой <code>smartscapeNodes</code> — нет объекта данных <code>fetch smartscape.nodes</code>. Один вызов <code>smartscapeNodes</code> принимает несколько типов нод (через запятую) и предоставляет поле <code>type</code>, поэтому можно перечислить все типы мониторов сразу без объединения:<pre>
smartscapeNodes HTTP_MONITOR, BROWSER_MONITOR, NETWORK_AVAILABILITY_MONITOR
| fields name, type, frequencyMinutes = frequency
| sort frequencyMinutes asc
</pre>

=== Показать распределение мониторов по локациям ===
Отношения обходятся с помощью <code>traverse</code>, а не расширением поля. Начиная с мониторов и проходя по связи <code>runs_on</code>, каждая строка попадает на целевую ноду <code>SYNTHETIC_LOCATION</code>, атрибуты которой затем можно группировать. <code>count()</code> по локации даёт количество мониторов, выполняющихся там.<pre>
smartscapeNodes HTTP_MONITOR
| traverse edgeTypes: {runs_on}, targetTypes: {SYNTHETIC_LOCATION}
| summarize monitorCount = count(),
by: {locationId = id, locationName = name,
country = geo.country.name, city = geo.city.name, cloud = cloud.provider,
longitude = geo.location.longitude, latitude = geo.location.latitude}
| sort monitorCount desc
</pre>Поля <code>longitude</code> и <code>latitude</code> позволяют отобразить результат непосредственно на карте в дашборде или ноутбуке.

=== Найти все мониторы, использующие конкретную запись хранилища учётных данных ===
Этот запрос полезен перед ротацией или удалением записи хранилища учётных данных, чтобы оценить зону влияния изменения. Тип связи определяет роль (<code>uses</code> = чтение, <code>updates</code> = запись), а <code>getNodeName</code> разрешает имена учётных данных и мониторов непосредственно — без обхода или соединения. Запрос выводит каждую связь монитор-учётные данные; раскомментируйте второй фильтр и укажите имя учётных данных, чтобы сузить до одной записи.<pre>
smartscapeEdges uses, updates
| filter target_type == "CREDENTIAL_VAULT_ENTRY"
// | filter getNodeName(target_id) == "my-credential-name"
| fieldsAdd credentialName = getNodeName(target_id),
monitorName = getNodeName(source_id),
role = if(type == "updates", "writes", else: "reads")
| fields credentialName, monitorName, monitorType = source_type, role
| sort credentialName asc
</pre>Поле <code>source_type</code> различает HTTP- и браузерные мониторы. Монитор, который одновременно читает и записывает одни и те же учётные данные, появляется дважды — один раз как чтение, один раз как запись.

=== Найти, с какими фронтенд-приложениями связаны мониторы ===
Мониторы связываются с RUM-фронтендом через связь <code>is_assigned_to</code>. Запросите связи и разрешите имена нод с помощью <code>getNodeName</code> — по одной строке на связь монитор-фронтенд:<pre>
smartscapeEdges is_assigned_to
| filter source_type == "HTTP_MONITOR"
| fields monitorName = getNodeName(source_id), frontendName = getNodeName(target_id)
| sort monitorName asc
</pre>Используйте <code>BROWSER_MONITOR</code> для браузерных мониторов. Чтобы получить одну строку на монитор с массивом фронтендов, добавьте <code>| summarize frontends = collectArray(frontendName), by: {monitorName}</code>.

Обе связи динамические: они появляются только после выполнения монитора и разрешения целевой сущности. Связь <code>is_assigned_to</code> связывает монитор с назначенным фронтендом; связь <code>monitors</code> связывает его с целевой сущностью во время выполнения (HTTP-монитор → нода <code>SERVICE</code>, браузерный монитор → нода <code>FRONTEND</code>, монитор сетевой доступности → нода <code>HOST</code>). Любая из связей может отсутствовать, если монитор не запускался недавно. Прежде чем полагаться на них, проверьте, что существует:<pre>
smartscapeEdges "*" | filter type == "is_assigned_to" or type == "monitors" | summarize count(), by: {type, source_type, target_type}
</pre>

=== Вывести шаги монитора по порядку ===
Шаги — это запрашиваемые ноды, поэтому вы можете перечислить действия или запросы, составляющие монитор, и отсортировать их по порядку. Пройдите по связи <code>contains</code> от монитора к его шагам. Чтобы ограничить запрос одним монитором, раскомментируйте фильтр и укажите его идентификатор (строка идентификатора должна быть обёрнута в <code>toSmartscapeId</code>).<pre>
smartscapeNodes BROWSER_MONITOR
// | filter id == toSmartscapeId("BROWSER_MONITOR-0000000000000000")
| traverse edgeTypes: {contains}, targetTypes: {BROWSER_MONITOR_STEP}
| fields stepId = id, name, sequence = step.sequence_number,
stepType = dt.synthetic.step.type
| sort sequence asc
</pre>Для HTTP-мониторов используйте <code>HTTP_MONITOR / HTTP_MONITOR_STEP</code> и замените <code>stepType</code> на специфичные для HTTP поля <code>url = step.url</code> и <code>method = http.request.method</code>.

<code>traverse</code> возвращает только шаги, которые существуют как материализованные ноды. Ноды шагов HTTP-монитора (<code>HTTP_MONITOR_STEP</code>) материализуются не всегда — связи <code>contains</code> могут присутствовать, а ноды шагов отсутствовать — поэтому вариант для HTTP может не возвращать строк в некоторых окружениях, даже если у монитора есть шаги. Шаги браузерного монитора материализуются надёжно.

== Запрос доступности ==
Метрики доступности синтетики содержат идентификатор ноды Smartscape в качестве размерности. Каждый тип монитора имеет свой ключ метрики и размерность:
{| class="wikitable"
!Тип монитора
!Метрика доступности
!Размерность Smartscape
|-
|HTTP
|<pre>dt.synthetic.http.availability</pre>
|<pre>dt.smartscape.http_monitor</pre>
|-
|Браузерный
|<pre>dt.synthetic.browser.availability</pre>
|<pre>dt.smartscape.browser_monitor</pre>
|-
|Сетевая доступность
|<pre>dt.synthetic.multi_protocol.availability</pre>
|<pre>dt.smartscape.network_availability_monitor</pre>
|}
Используйте средневзвешенное по количеству выполнений. Доступность монитора за временной интервал и по локации основана на разном количестве выполнений, поэтому усреднение средних значений по интервалам (<code>avg</code> от <code>avg</code>) приводит к завышению или занижению значений для разреженных интервалов. Вместо этого разделите сумму доступности на количество точек данных: <code>sum(availability) / sum(availability, rollup: count)</code>. Это даёт равный вес каждому выполнению и показывает истинный процент доступности.

Примеры ниже используют HTTP-мониторы. Для браузерных или мониторов сетевой доступности замените <code>dt.synthetic.http.availability</code> на <code>dt.synthetic.browser.availability</code> или <code>dt.synthetic.multi_protocol.availability</code> соответственно.

=== Доступность по монитору ===
Этот запрос возвращает средневзвешенную доступность за последние 24 часа для каждого монитора, с именем и состоянием включения, разрешёнными непосредственно. Чтобы ограничить одним монитором, раскомментируйте фильтр и укажите свой идентификатор — размерность <code>dt.smartscape.*</code> является <code>SmartscapeId</code>, поэтому литерал должен быть обёрнут в <code>toSmartscapeId(...)</code>.<pre>
timeseries {
sumAv = sum(dt.synthetic.http.availability),
dataPoints = sum(dt.synthetic.http.availability, rollup: count)
}, by: {monitorId = dt.smartscape.http_monitor}, from: now()-24h
// | filter monitorId == toSmartscapeId("HTTP_MONITOR-0000000000000000")
| fieldsAdd availability = arraySum(sumAv) / arraySum(dataPoints),
name = getNodeName(monitorId),
enabled = getNodeField(monitorId, "enabled")
| fields monitorId, name, enabled, availability
| sort availability asc
</pre>Чтобы сохранить значение как временной ряд по интервалам (для графика) вместо одного числа, замените <code>fieldsAdd</code> на <code>| fieldsAdd availability = sumAv[] / dataPoints[]</code>.

=== Доступность отслеживаемого приложения ===
Метрики выполнения синтетики также содержат сущности, которые проверяет каждый монитор, в поле <code>dt.synthetic.monitored_entity_ids</code>, поэтому можно вычислить доступность с точки зрения отслеживаемого приложения (например, вместе с его метриками опыта). Сгруппируйте по этой размерности, разверните её и отфильтруйте по приложению:<pre>
timeseries avgAv = avg(dt.synthetic.browser.availability),
by: {dt.synthetic.monitored_entity_ids},
from: now()-24h
| expand dt.synthetic.monitored_entity_ids
// | filter dt.synthetic.monitored_entity_ids == "APPLICATION-0000000000000000"
| summarize chartData = avg(avgAv[]), by: {timeframe, interval, dt.synthetic.monitored_entity_ids}
</pre>

== Обратная совместимость ==
Существующие запросы DQL, которые используют классические размерности сущностей (<code>dt.entity.http_check</code>, <code>dt.entity.synthetic_test</code>, <code>dt.entity.multiprotocol_monitor</code>, <code>dt.entity.synthetic_location</code>), продолжат работать без изменений. Телеметрия синтетики обогащается как идентификатором ноды Smartscape, так и классическим идентификатором сущности, поэтому запросы к классическим сущностям остаются действительными и будут возвращать данные.

Запросы к классическим синтетическим сущностям в DQL объявлены устаревшими. Они остаются поддерживаемыми до тех пор, пока поддерживается '''Ключ-АСТРОМ Classic''', так что вы можете переходить на новую модель в своём темпе. Новые функции, атрибуты и отношения добавляются только в модель Smartscape.

== Запрос доступности во время перехода от классической модели к Smartscape ==
Этот раздел является временным пособием для периода миграции. Пропустите его, если вы запрашиваете доступность за временные диапазоны, которые не выходят за пределы миграции вашего окружения на Smartscape — для недавних данных приведённых выше запросов достаточно. Как только запрашиваемые диапазоны больше не будут пересекать границу миграции, этот раздел можно удалить без влияния на остальную часть страницы.

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

=== Модель с двумя идентификаторами ===
Метрики доступности синтетики публикуются с двумя семействами размерностей:

* Размерности Smartscape (<code>dt.smartscape.http_monitor</code>, <code>dt.smartscape.browser_monitor</code>, <code>dt.smartscape.network_availability_monitor</code>) — заполняются для выполнений после миграции на Smartscape.
* Классические размерности сущностей (<code>dt.entity.http_check</code>, <code>dt.entity.synthetic_test</code>, <code>dt.entity.multiprotocol_monitor</code>) — заполняются для всех выполнений, включая выполненные до миграции.

В переходный период оба семейства размерностей заполняются для одного и того же выполнения. Запрос, сгруппированный только по <code>dt.smartscape.http_monitor</code>, пропустит выполнения до миграции, а сгруппированный только по <code>dt.entity.http_check</code> вернёт всю историю, но в классическом формате идентификатора. Чтобы охватить диапазон, охватывающий миграцию, объедините их в один нормализованный идентификатор с помощью <code>coalesce</code>.

Каждая нода Smartscape предоставляет соответствующий классический идентификатор сущности через поле <code>id_classic</code>. Числовой суффикс одинаков в обоих форматах:
{| class="wikitable"
!Идентификатор Smartscape
!Классический идентификатор сущности
|-
|<pre>HTTP_MONITOR-1A2B3C4D</pre>
|<pre>HTTP_CHECK-1A2B3C4D</pre>
|-
|<pre>HTTP_MONITOR_STEP-1A2B3C4D</pre>
|<pre>HTTP_CHECK_STEP-1A2B3C4D</pre>
|-
|<pre>BROWSER_MONITOR-1A2B3C4D</pre>
|<pre>SYNTHETIC_TEST-1A2B3C4D</pre>
|-
|<pre>BROWSER_MONITOR_STEP-1A2B3C4D</pre>
|<pre>SYNTHETIC_TEST_STEP-1A2B3C4D</pre>
|-
|<pre>NETWORK_AVAILABILITY_MONITOR-1A2B3C4D</pre>
|<pre>MULTIPROTOCOL_MONITOR-1A2B3C4D</pre>
|}

=== Правила для объединяющих запросов ===
При написании объединяющих запросов соблюдайте четыре правила:

1. Помещайте <code>coalesce</code> в <code>fieldsAdd</code>, а не в предложение <code>timeseries by:</code>. Предложение <code>by:</code> принимает только простые размерности; выражение там вызовет ошибку <code>MANDATORY_PARAMETER_HAS_TO_BE_FIELD_BUT_WAS_EXPRESSION</code>. Сначала группируйте по обеим сырым размерностям, а затем получайте объединённый идентификатор. 2. Объединённый идентификатор имеет тип <code>SmartscapeId</code>, поэтому фильтруйте его с помощью <code>toSmartscapeId(...)</code>, а не как простую строку — сравнение строк без преобразования не вернёт результатов. Сырая размерность <code>dt.smartscape.*</code> также является <code>SmartscapeId</code>, а классическая <code>dt.entity.*</code> — простая строка. 3. Суммы и счётчики завышены из-за двойного подсчёта; отношения не страдают. В переходный период оба семейства размерностей заполняются для одного выполнения, поэтому простое суммирование или подсчёт (например, общее количество выполнений) завышено. Средневзвешенное по выполнению <code>sum(availability) / sum(count)</code> не страдает, потому что дублирование масштабирует числитель и знаменатель одинаково. Если нужны точные общие количества выполнений, сначала дедуплицируйте — подробнее см. «Синтетические расчёты». 4. Не каждая нода шага материализована. В частности, ноды шагов HTTP-монитора могут отсутствовать, даже если связи <code>contains</code> существуют — см. раздел «Вывести шаги монитора по порядку».

=== Доступность за диапазон, включающий данные до миграции ===
Сгруппируйте как по размерности Smartscape, так и по классической, объедините их в единый <code>monitorId</code> с помощью <code>coalesce</code> и вычислите средневзвешенное по выполнению, чтобы результат был корректным, даже если оба семейства перекрываются. Функции <code>toSmartscapeId</code> и <code>replaceString</code> преобразуют классический идентификатор сущности в его эквивалент Smartscape. Запрос охватывает все HTTP-мониторы за 90 дней; раскомментируйте фильтр и укажите свой идентификатор, чтобы ограничить одним монитором.<pre>
timeseries {
sumAv = sum(dt.synthetic.http.availability),
dataPoints = sum(dt.synthetic.http.availability, rollup: count)
}, by: {dt.smartscape.http_monitor, dt.entity.http_check}, from: now()-90d
| fieldsAdd monitorId = coalesce(dt.smartscape.http_monitor,
toSmartscapeId(replaceString(toString(dt.entity.http_check), "HTTP_CHECK", "HTTP_MONITOR")))
// | filter monitorId == toSmartscapeId("HTTP_MONITOR-0000000000000000")
| summarize sumAv = sum(sumAv[]), dataPoints = sum(dataPoints[]), by: {timeframe, interval, monitorId}
| fieldsAdd av = sumAv[] / dataPoints[], avg = arraySum(sumAv) / arraySum(dataPoints)
| fieldsRemove sumAv, dataPoints
</pre>Для браузерных мониторов и мониторов сетевой доступности замените ключ метрики и размерность Smartscape из справочника метрик доступности, а также классическую размерность и пару префиксов для <code>replaceString</code> из таблицы «Модель с двумя идентификаторами». Например, для браузерных мониторов используйте <code>sum(dt.synthetic.browser.availability)</code>, группировку по <code>{dt.smartscape.browser_monitor, dt.entity.synthetic_test}</code> и <code>replaceString(toString(dt.entity.synthetic_test), "SYNTHETIC_TEST", "BROWSER_MONITOR")</code>.

=== Долгосрочный отчёт по доступности для всего парка ===
Этот запрос вычисляет средневзвешенную доступность за 30 дней для каждого HTTP-монитора, обрабатывая как данные Smartscape, так и классические в одном запросе. <code>getNodeName</code> / <code>getNodeField</code> добавляют имя и состояние включения из объединённого <code>monitorId</code> непосредственно.<pre>
timeseries {
sumAv = sum(dt.synthetic.http.availability),
dataPoints = sum(dt.synthetic.http.availability, rollup: count)
}, by: {dt.smartscape.http_monitor, dt.entity.http_check}, from: now()-30d
| fieldsAdd monitorId = coalesce(dt.smartscape.http_monitor,
toSmartscapeId(replaceString(toString(dt.entity.http_check), "HTTP_CHECK", "HTTP_MONITOR")))
| summarize sumAv = sum(sumAv[]), dataPoints = sum(dataPoints[]), by: {monitorId}
| fieldsAdd availability = arraySum(sumAv) / arraySum(dataPoints),
name = getNodeName(monitorId), enabled = getNodeField(monitorId, "enabled")
| sort availability asc
| fields name, enabled, availability, monitorId
</pre>Мониторы, которые выполнялись только до миграции и больше не существуют как ноды Smartscape, всё равно отображаются (их доступность учтена), но <code>getNodeName</code> вернёт <code>null</code> — текущей ноды для разрешения нет.

=== Найти классический идентификатор монитора по его идентификатору Smartscape ===
Запрос выводит классический идентификатор для каждого монитора. Чтобы найти один, раскомментируйте фильтр и укажите его идентификатор Smartscape:<pre>
smartscapeNodes HTTP_MONITOR
// | filter id == toSmartscapeId("HTTP_MONITOR-0000000000000000")
| fields id, classicId = id_classic
</pre>Поле <code>id</code> имеет тип <code>SmartscapeId</code>, поэтому литерал фильтра должен быть обёрнут в <code>toSmartscapeId(...)</code>. Поле <code>id_classic</code>, напротив, является простой строкой и фильтруется напрямую (см. следующий запрос).

=== Найти идентификатор Smartscape монитора по его классическому идентификатору ===
Запрос выводит идентификатор Smartscape для каждого монитора. Чтобы найти один, раскомментируйте фильтр и укажите его классический идентификатор (простая строка — <code>toSmartscapeId</code> не требуется):<pre>
smartscapeNodes HTTP_MONITOR
// | filter id_classic == "HTTP_CHECK-0000000000000000"
| fields id, id_classic, name
</pre>

Синтетические мониторы в Smartscape

2026-09-03T19:18:51Z

IKuznetsov: Новая страница: « = Синтетические мониторы в Smartscape = Синтетические мониторы, их шаги и локации, из которых они запускаются, моделируются как узлы первого класса в '''Smartscape''' на '''Grail'''. Они используют тот же граф топологии, семантику и язык запросов, что и остальное окружени...»

= Синтетические мониторы в Smartscape =
Синтетические мониторы, их шаги и локации, из которых они запускаются, моделируются как узлы первого класса в '''Smartscape''' на '''Grail'''. Они используют тот же граф топологии, семантику и язык запросов, что и остальное окружение — хосты, сервисы, фронтенды и рабочие нагрузки '''Kubernetes'''. На этой странице описана модель — её типы узлов, их атрибуты и связи между ними, а также показано, как запрашивать синтетические мониторы, шаги и локации с помощью '''DQL''' (astromkey Query Language).

Синтетические сущности моделируются как узлы Smartscape, а их отношения — как рёбра. Подробнее см. «Smartscape на Grail». На этой странице под неуточнённой сущностью или <code>dt.entity.*</code> подразумевается классическая модель.

== Типы узлов ==
Синтетический мониторинг моделируется следующими типами узлов Smartscape:
{| class="wikitable"
!Сущность Smartscape
!Тип узла
!Идентификатор модели Smartscape
!Классическая модель сущности
|-
|Браузерный монитор
|<pre>BROWSER_MONITOR</pre>
|<pre>dt.smartscape.browser_monitor</pre>
|<pre>dt.entity.synthetic_test</pre>
|-
|Шаг браузерного монитора
|<pre>BROWSER_MONITOR_STEP</pre>
|<pre>dt.smartscape.browser_monitor_step</pre>
|<pre>dt.entity.synthetic_test_step</pre>
|-
|HTTP-монитор
|<pre>HTTP_MONITOR</pre>
|<pre>dt.smartscape.http_monitor</pre>
|<pre>dt.entity.http_check</pre>
|-
|Шаг HTTP-монитора
|<pre>HTTP_MONITOR_STEP</pre>
|<pre>dt.smartscape.http_monitor_step</pre>
|<pre>dt.entity.http_check_step</pre>
|-
|Монитор сетевой доступности
|<pre>NETWORK_AVAILABILITY_MONITOR</pre>
|<pre>dt.smartscape.network_availability_monitor</pre>
|<pre>dt.entity.multiprotocol_monitor</pre>
|-
|Синтетическая локация
|<pre>SYNTHETIC_LOCATION</pre>
|<pre>dt.smartscape.synthetic_location</pre>
|<pre>dt.entity.synthetic_location</pre>
|}
Типы узлов, их атрибуты и отношения определены в группе моделей '''Smartscape — Synthetic''' в '''Семантическом словаре'''.

== Атрибуты ==
Как узлы Smartscape, синтетические мониторы, шаги и локации могут запрашиваться для дашбордов, соглашений об уровне обслуживания ('''SLO''') и навигации по топологии. Каждый тип узла отвечает на разные вопросы:
{| class="wikitable"
!Тип узла
!Примеры вопросов
!Ключевые атрибуты
|-
|<pre>HTTP_MONITOR, BROWSER_MONITOR, NETWORK_AVAILABILITY_MONITOR</pre>
|Какие мониторы существуют, кто их владелец, как часто они запускаются, когда они в последний раз завершились успешно или с ошибкой, включены ли они?
|<pre>created_by, creation_timestamp, last_successful_execution_timestamp, last_failed_execution_timestamp, frequency, enabled</pre>
|-
|<pre>HTTP_MONITOR_STEP, BROWSER_MONITOR_STEP</pre>
|Из каких отдельных запросов или действий состоит монитор и в каком порядке?
|<pre>step.sequence_number, step.url, http.request.method, dt.synthetic.step.type</pre>
|-
|<pre>SYNTHETIC_LOCATION</pre>
|Где выполняются мониторы — в каком облаке, регионе и городе, и что может делать каждая локация?
|<pre>cloud.provider, location_type, deployment_type, capabilities, geo.*</pre>
|}
Каждый узел также содержит общие базовые атрибуты: <code>id</code>, <code>id_classic</code>, <code>name</code>, <code>deleted</code> и <code>tags</code>.

<code>deleted</code> — это флаг мягкого удаления. Удалённый монитор, локация или учётные данные не удаляются из Smartscape немедленно — их узел остаётся доступным для запросов в течение периода хранения с <code>deleted == true</code>, так что недавно удалённые элементы всё ещё отображаются. Добавьте <code>| filter deleted == false</code>, чтобы исключить их.

Теги существуют в двух формах. Поле <code>tags</code> содержит обычные теги, агрегированные по всем контекстам; для запроса одного контекста используйте <code>tags:<контекст></code>. Основные теги (primary tags) — это выбранный набор, который '''Ключ-АСТРОМ''' прикрепляет ко всем телеметрическим данным при приёме (например, метки '''Kubernetes''' или облачные теги) — они доступны у мониторов и шагов с префиксом <code>primary_tags.*</code> и являются самым быстрым способом фильтрации или группировки. Правила на основе тегов из классической модели в этой модели отсутствуют.

Географические атрибуты и атрибуты выполнения: синтетические локации содержат полные географические атрибуты (<code>geo.continent.name</code>, <code>geo.country.name</code>, <code>geo.region.name</code>, <code>geo.city.name</code>, <code>geo.location.latitude</code>, <code>geo.location.longitude</code>), поэтому вы можете группировать и фильтровать мониторы по месту выполнения и отображать их на карте. Мониторы предоставляют время последнего успешного и последнего неудачного выполнения как отдельные атрибуты (<code>last_successful_execution_timestamp</code>, <code>last_failed_execution_timestamp</code>), что позволяет находить мониторы как по результату, так и по давности выполнения.

Полный авторитетный список атрибутов, типов и примеров для каждого типа узла см. в группе моделей '''Smartscape — Synthetic''' в '''Семантическом словаре'''.

== Отношения ==
Синтетические сущности Smartscape связаны следующими отношениями:
{| class="wikitable"
!Источник
!Отношение
!Цель
!Тип
!Описание
|-
|<pre>HTTP_MONITOR</pre>
|<pre>runs_on</pre>
|<pre>SYNTHETIC_LOCATION</pre>
|static
|Локации, из которых выполняется монитор
|-
|<pre>HTTP_MONITOR</pre>
|<pre>contains</pre>
|<pre>HTTP_MONITOR_STEP</pre>
|static
|Отдельные HTTP-запросы, составляющие монитор
|-
|<pre>HTTP_MONITOR</pre>
|<pre>uses</pre>
|<pre>CREDENTIAL_VAULT_ENTRY</pre>
|static
|Записи хранилища учётных данных, которые монитор читает
|-
|<pre>HTTP_MONITOR</pre>
|<pre>updates</pre>
|<pre>CREDENTIAL_VAULT_ENTRY</pre>
|static
|Записи хранилища учётных данных, которые монитор записывает обратно
|-
|<pre>HTTP_MONITOR</pre>
|<pre>monitors</pre>
|<pre>SERVICE</pre>
|dynamic
|Бэкенд-сервис, который монитор проверяет
|-
|<pre>HTTP_MONITOR</pre>
|<pre>is_assigned_to</pre>
|<pre>FRONTEND</pre>
|dynamic
|Фронтенд-приложение, с которым связан монитор
|-
|<pre>HTTP_MONITOR_STEP</pre>
|<pre>belongs_to</pre>
|<pre>HTTP_MONITOR</pre>
|static
|Родительский монитор шага
|-
|<pre>BROWSER_MONITOR</pre>
|<pre>runs_on</pre>
|<pre>SYNTHETIC_LOCATION</pre>
|static
|Локации, из которых выполняется монитор
|-
|<pre>BROWSER_MONITOR</pre>
|<pre>contains</pre>
|<pre>BROWSER_MONITOR_STEP</pre>
|static
|Шаги в скрипте браузерного теста
|-
|<pre>BROWSER_MONITOR</pre>
|<pre>uses</pre>
|<pre>CREDENTIAL_VAULT_ENTRY</pre>
|static
|Записи хранилища учётных данных, которые монитор читает
|-
|<pre>BROWSER_MONITOR</pre>
|<pre>monitors / is_assigned_to</pre>
|<pre>FRONTEND</pre>
|dynamic
|Фронтенд-приложение, которое монитор тестирует
|-
|<pre>BROWSER_MONITOR_STEP</pre>
|<pre>belongs_to</pre>
|<pre>BROWSER_MONITOR</pre>
|static
|Родительский монитор шага
|-
|<pre>NETWORK_AVAILABILITY_MONITOR</pre>
|<pre>runs_on</pre>
|<pre>SYNTHETIC_LOCATION</pre>
|static
|Локации, из которых выполняется монитор
|-
|<pre>NETWORK_AVAILABILITY_MONITOR</pre>
|<pre>monitors</pre>
|<pre>HOST</pre>
|dynamic
|Хост, который монитор проверяет (ping или соединение)
|}

=== Статические и динамические рёбра ===
Столбец «Тип» в таблице выше отражает, как создаётся каждое ребро. Рёбра бывают двух видов:

* '''Статические''' определяются конфигурацией монитора и стабильны во времени — например, какие шаги содержит монитор, из каких локаций он запускается и какие записи хранилища учётных данных он использует.
* '''Динамические''' выводятся из данных выполнения и могут появляться и исчезать по мере наблюдения трафика — например, бэкенд-сервис, который HTTP-монитор проверяет (<code>monitors</code>), или RUM-фронтенд, с которым связан браузерный монитор (<code>is_assigned_to</code>). Монитор без недавних выполнений может временно не иметь динамических рёбер.

Рёбра <code>contains</code> (монитор → шаг) и <code>belongs_to</code> (шаг → монитор) описывают одну и ту же связь с обоих концов, поэтому вы можете перейти от монитора к его шагам или от шага обратно к монитору.

=== Отношения монитор-фронтенд ===
Эти рёбра позволяют увидеть, с каким RUM-приложением связан монитор — чтобы можно было сопоставить результаты монитора с фронтендом, который фактически используют пользователи. Монитор может быть связан с фронтендом двумя способами, и различие важно:

* <code>is_assigned_to</code>: фронтенд, который вы явно назначили монитору, связывая результаты монитора с этим приложением.
* <code>monitors</code>: цель, которую монитор проверяет во время выполнения: для браузерных мониторов — RUM-фронтенд, для HTTP-мониторов — бэкенд-сервис, для мониторов сетевой доступности — хост.

Оба являются динамическими, даже назначенный: ребро материализуется на основе выполнения монитора, а не из сохранённой конфигурации. Поэтому связь появляется только после того, как монитор запустился и его целевая сущность была определена; она может меняться или исчезать по мере наблюдения выполнений. Монитор, который не запускался недавно, или чей назначенный фронтенд или обнаруженная цель больше не разрешаются, может не иметь ни одного ребра.

=== Хранилище учётных данных: чтение и запись ===
Два ребра для учётных данных различают, как монитор взаимодействует с записью хранилища учётных данных:

* <code>uses</code>: монитор читает учётные данные (в предварительном/постскрипте, в '''URL''' или в любом другом месте, где используется секрет).
* <code>updates</code>: монитор записывает учётные данные обратно в хранилище (например, скрипт, который вызывает API <code>save-credential</code> для их ротации).

Это различие позволяет понять, «этот монитор потребляет эти учётные данные» или «этот монитор обслуживает эти учётные данные» — полезно при планировании ротации учётных данных. Браузерные мониторы читают учётные данные, но никогда не записывают их обратно, поэтому <code>BROWSER_MONITOR</code> имеет рёбра <code>uses</code>, но не <code>updates</code> — это сделано намеренно, а не является пропуском.

== Запросы с помощью DQL ==
Используйте команду <code>smartscapeNodes</code> для запроса синтетических узлов. Все запросы выполняются к таблице <code>smartscape.nodes</code>.

=== Вывести все мониторы заданного типа ===
<pre>
smartscapeNodes HTTP_MONITOR
| fields id, name, enabled, frequency,
creation_timestamp, last_successful_execution_timestamp
| sort name asc
</pre>Замените <code>HTTP_MONITOR</code> на <code>BROWSER_MONITOR</code> или <code>NETWORK_AVAILABILITY_MONITOR</code> для других типов мониторов.

=== Показать читаемые имена и атрибуты вместо сырых идентификаторов ===
При навигации по рёбрам или работе со ссылочными идентификаторами часто есть <code>SmartscapeId</code> узла, но нужно получить его имя или атрибут. Функции <code>getNodeName()</code> и <code>getNodeField()</code> являются аналогами классических <code>entityName()</code> / <code>entityAttr()</code> и разрешают значение непосредственно по идентификатору — без соединения или дополнительного запроса.<pre>
smartscapeEdges is_assigned_to
| filter source_type == "HTTP_MONITOR"
| fields monitorName = getNodeName(source_id),
frontendName = getNodeName(target_id),
monitorEnabled = getNodeField(source_id, "enabled")
</pre><code>getNodeName(id)</code> возвращает имя узла; <code>getNodeField(id, "<атрибут>")</code> возвращает любой атрибут (например, <code>"enabled"</code>, <code>"cloud.provider"</code>, <code>"geo.country.name"</code>). Классическая функция <code>entityName()</code> недоступна для узлов Smartscape.

=== Найти мониторы, которые не выполнялись успешно в последнее время ===
Мониторы, у которых <code>last_successful_execution_timestamp</code> старше 24 часов, могут указывать на постоянный сбой или неправильно настроенное расписание.<pre>
smartscapeNodes HTTP_MONITOR
| filter enabled == true
| filter isNull(last_successful_execution_timestamp)
OR last_successful_execution_timestamp < now() - 24h
| fields id, name, last_successful_execution_timestamp, last_failed_execution_timestamp
| sort last_successful_execution_timestamp asc
</pre><code>last_successful_execution_timestamp</code> отражает успешные выполнения, зафиксированные в модели Smartscape, поэтому монитор без зафиксированных успехов показывает <code>null</code> — в том числе если он только когда-либо завершался ошибкой. Для полной исторической картины используйте метрики доступности; если ваш диапазон может охватывать период до данных Smartscape, см. раздел «Запрос доступности во время перехода от классической модели к Smartscape».

=== Найти все отключённые мониторы ===
<pre>
smartscapeNodes HTTP_MONITOR
| filter enabled == false
| fields id, name, last_modification_timestamp, last_modified_by
| sort last_modification_timestamp desc
</pre>

=== Сравнить частоту выполнения по всем типам мониторов ===
Синтетические узлы запрашиваются командой <code>smartscapeNodes</code> — нет объекта данных <code>fetch smartscape.nodes</code>. Один вызов <code>smartscapeNodes</code> принимает несколько типов узлов (через запятую) и предоставляет поле <code>type</code>, поэтому можно перечислить все типы мониторов сразу без объединения:<pre>
smartscapeNodes HTTP_MONITOR, BROWSER_MONITOR, NETWORK_AVAILABILITY_MONITOR
| fields name, type, frequencyMinutes = frequency
| sort frequencyMinutes asc
</pre>

=== Показать распределение мониторов по локациям ===
Отношения обходятся с помощью <code>traverse</code>, а не расширением поля. Начиная с мониторов и проходя по ребру <code>runs_on</code>, каждая строка попадает на целевой узел <code>SYNTHETIC_LOCATION</code>, атрибуты которого затем можно группировать. <code>count()</code> по локации даёт количество мониторов, выполняющихся там.<pre>
smartscapeNodes HTTP_MONITOR
| traverse edgeTypes: {runs_on}, targetTypes: {SYNTHETIC_LOCATION}
| summarize monitorCount = count(),
by: {locationId = id, locationName = name,
country = geo.country.name, city = geo.city.name, cloud = cloud.provider,
longitude = geo.location.longitude, latitude = geo.location.latitude}
| sort monitorCount desc
</pre>Поля <code>longitude</code> и <code>latitude</code> позволяют отобразить результат непосредственно на карте в дашборде или ноутбуке.

=== Найти все мониторы, использующие конкретную запись хранилища учётных данных ===
Этот запрос полезен перед ротацией или удалением записи хранилища учётных данных, чтобы оценить зону влияния изменения. Тип ребра определяет роль (<code>uses</code> = чтение, <code>updates</code> = запись), а <code>getNodeName</code> разрешает имена учётных данных и мониторов непосредственно — без обхода или соединения. Запрос выводит каждое отношение монитор-учётные данные; раскомментируйте второй фильтр и укажите имя учётных данных, чтобы сузить до одной записи.<pre>
smartscapeEdges uses, updates
| filter target_type == "CREDENTIAL_VAULT_ENTRY"
// | filter getNodeName(target_id) == "my-credential-name"
| fieldsAdd credentialName = getNodeName(target_id),
monitorName = getNodeName(source_id),
role = if(type == "updates", "writes", else: "reads")
| fields credentialName, monitorName, monitorType = source_type, role
| sort credentialName asc
</pre>Поле <code>source_type</code> различает HTTP- и браузерные мониторы. Монитор, который одновременно читает и записывает одни и те же учётные данные, появляется дважды — один раз как чтение, один раз как запись.

=== Найти, с какими фронтенд-приложениями связаны мониторы ===
Мониторы связываются с RUM-фронтендом через ребро <code>is_assigned_to</code>. Запросите рёбра и разрешите имена узлов с помощью <code>getNodeName</code> — по одной строке на связь монитор-фронтенд:<pre>
smartscapeEdges is_assigned_to
| filter source_type == "HTTP_MONITOR"
| fields monitorName = getNodeName(source_id), frontendName = getNodeName(target_id)
| sort monitorName asc
</pre>Используйте <code>BROWSER_MONITOR</code> для браузерных мониторов. Чтобы получить одну строку на монитор с массивом фронтендов, добавьте <code>| summarize frontends = collectArray(frontendName), by: {monitorName}</code>.

Оба ребра динамические: они появляются только после выполнения монитора и разрешения целевой сущности. Ребро <code>is_assigned_to</code> связывает монитор с назначенным фронтендом; ребро <code>monitors</code> связывает его с целевой сущностью во время выполнения (HTTP-монитор → узел <code>SERVICE</code>, браузерный монитор → узел <code>FRONTEND</code>, монитор сетевой доступности → узел <code>HOST</code>). Любое из рёбер может отсутствовать, если монитор не запускался недавно. Прежде чем полагаться на них, проверьте, что существует:<pre>
smartscapeEdges "*" | filter type == "is_assigned_to" or type == "monitors" | summarize count(), by: {type, source_type, target_type}
</pre>

=== Вывести шаги монитора по порядку ===
Шаги — это запрашиваемые узлы, поэтому вы можете перечислить действия или запросы, составляющие монитор, и отсортировать их по порядку. Пройдите по ребру <code>contains</code> от монитора к его шагам. Чтобы ограничить запрос одним монитором, раскомментируйте фильтр и укажите его идентификатор (строка идентификатора должна быть обёрнута в <code>toSmartscapeId</code>).<pre>
smartscapeNodes BROWSER_MONITOR
// | filter id == toSmartscapeId("BROWSER_MONITOR-0000000000000000")
| traverse edgeTypes: {contains}, targetTypes: {BROWSER_MONITOR_STEP}
| fields stepId = id, name, sequence = step.sequence_number,
stepType = dt.synthetic.step.type
| sort sequence asc
</pre>Для HTTP-мониторов используйте <code>HTTP_MONITOR / HTTP_MONITOR_STEP</code> и замените <code>stepType</code> на специфичные для HTTP поля <code>url = step.url</code> и <code>method = http.request.method</code>.

<code>traverse</code> возвращает только шаги, которые существуют как материализованные узлы. Узлы шагов HTTP-монитора (<code>HTTP_MONITOR_STEP</code>) материализуются не всегда — рёбра <code>contains</code> могут присутствовать, а узлы шагов отсутствовать — поэтому вариант для HTTP может не возвращать строк в некоторых окружениях, даже если у монитора есть шаги. Шаги браузерного монитора материализуются надёжно.

== Запрос доступности ==
Метрики доступности синтетики содержат идентификатор узла Smartscape в качестве размерности. Каждый тип монитора имеет свой ключ метрики и размерность:
{| class="wikitable"
!Тип монитора
!Метрика доступности
!Размерность Smartscape
|-
|HTTP
|<pre>dt.synthetic.http.availability</pre>
|<pre>dt.smartscape.http_monitor</pre>
|-
|Браузерный
|<pre>dt.synthetic.browser.availability</pre>
|<pre>dt.smartscape.browser_monitor</pre>
|-
|Сетевая доступность
|<pre>dt.synthetic.multi_protocol.availability</pre>
|<pre>dt.smartscape.network_availability_monitor</pre>
|}
Используйте средневзвешенное по количеству выполнений. Доступность монитора за временной интервал и по локации основана на разном количестве выполнений, поэтому усреднение средних значений по интервалам (<code>avg</code> от <code>avg</code>) приводит к завышению или занижению значений для разреженных интервалов. Вместо этого разделите сумму доступности на количество точек данных: <code>sum(availability) / sum(availability, rollup: count)</code>. Это даёт равный вес каждому выполнению и показывает истинный процент доступности.

Примеры ниже используют HTTP-мониторы. Для браузерных или мониторов сетевой доступности замените <code>dt.synthetic.http.availability</code> на <code>dt.synthetic.browser.availability</code> или <code>dt.synthetic.multi_protocol.availability</code> соответственно.

=== Доступность по монитору ===
Этот запрос возвращает средневзвешенную доступность за последние 24 часа для каждого монитора, с именем и состоянием включения, разрешёнными непосредственно. Чтобы ограничить одним монитором, раскомментируйте фильтр и укажите свой идентификатор — размерность <code>dt.smartscape.*</code> является <code>SmartscapeId</code>, поэтому литерал должен быть обёрнут в <code>toSmartscapeId(...)</code>.<pre>
timeseries {
sumAv = sum(dt.synthetic.http.availability),
dataPoints = sum(dt.synthetic.http.availability, rollup: count)
}, by: {monitorId = dt.smartscape.http_monitor}, from: now()-24h
// | filter monitorId == toSmartscapeId("HTTP_MONITOR-0000000000000000")
| fieldsAdd availability = arraySum(sumAv) / arraySum(dataPoints),
name = getNodeName(monitorId),
enabled = getNodeField(monitorId, "enabled")
| fields monitorId, name, enabled, availability
| sort availability asc
</pre>Чтобы сохранить значение как временной ряд по интервалам (для графика) вместо одного числа, замените <code>fieldsAdd</code> на <code>| fieldsAdd availability = sumAv[] / dataPoints[]</code>.

=== Доступность отслеживаемого приложения ===
Метрики выполнения синтетики также содержат сущности, которые проверяет каждый монитор, в поле <code>dt.synthetic.monitored_entity_ids</code>, поэтому можно вычислить доступность с точки зрения отслеживаемого приложения (например, вместе с его метриками опыта). Сгруппируйте по этой размерности, разверните её и отфильтруйте по приложению:<pre>
timeseries avgAv = avg(dt.synthetic.browser.availability),
by: {dt.synthetic.monitored_entity_ids},
from: now()-24h
| expand dt.synthetic.monitored_entity_ids
// | filter dt.synthetic.monitored_entity_ids == "APPLICATION-0000000000000000"
| summarize chartData = avg(avgAv[]), by: {timeframe, interval, dt.synthetic.monitored_entity_ids}
</pre>

== Обратная совместимость ==
Существующие запросы DQL, которые используют классические размерности сущностей (<code>dt.entity.http_check</code>, <code>dt.entity.synthetic_test</code>, <code>dt.entity.multiprotocol_monitor</code>, <code>dt.entity.synthetic_location</code>), продолжат работать без изменений. Телеметрия синтетики обогащается как идентификатором узла Smartscape, так и классическим идентификатором сущности, поэтому запросы к классическим сущностям остаются действительными и будут возвращать данные.

Запросы к классическим синтетическим сущностям в DQL объявлены устаревшими. Они остаются поддерживаемыми до тех пор, пока поддерживается '''Ключ-АСТРОМ Classic''', так что вы можете переходить на новую модель в своём темпе. Новые функции, атрибуты и отношения добавляются только в модель Smartscape.

== Запрос доступности во время перехода от классической модели к Smartscape ==
Этот раздел является временным пособием для периода миграции. Пропустите его, если вы запрашиваете доступность за временные диапазоны, которые не выходят за пределы миграции вашего окружения на Smartscape — для недавних данных приведённых выше запросов достаточно. Как только запрашиваемые диапазоны больше не будут пересекать границу миграции, этот раздел можно удалить без влияния на остальную часть страницы.

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

=== Модель с двумя идентификаторами ===
Метрики доступности синтетики публикуются с двумя семействами размерностей:

* Размерности Smartscape (<code>dt.smartscape.http_monitor</code>, <code>dt.smartscape.browser_monitor</code>, <code>dt.smartscape.network_availability_monitor</code>) — заполняются для выполнений после миграции на Smartscape.
* Классические размерности сущностей (<code>dt.entity.http_check</code>, <code>dt.entity.synthetic_test</code>, <code>dt.entity.multiprotocol_monitor</code>) — заполняются для всех выполнений, включая выполненные до миграции.

В переходный период оба семейства размерностей заполняются для одного и того же выполнения. Запрос, сгруппированный только по <code>dt.smartscape.http_monitor</code>, пропустит выполнения до миграции, а сгруппированный только по <code>dt.entity.http_check</code> вернёт всю историю, но в классическом формате идентификатора. Чтобы охватить диапазон, охватывающий миграцию, объедините их в один нормализованный идентификатор с помощью <code>coalesce</code>.

Каждый узел Smartscape предоставляет соответствующий классический идентификатор сущности через поле <code>id_classic</code>. Числовой суффикс одинаков в обоих форматах:
{| class="wikitable"
!Идентификатор Smartscape
!Классический идентификатор сущности
|-
|<pre>HTTP_MONITOR-1A2B3C4D</pre>
|<pre>HTTP_CHECK-1A2B3C4D</pre>
|-
|<pre>HTTP_MONITOR_STEP-1A2B3C4D</pre>
|<pre>HTTP_CHECK_STEP-1A2B3C4D</pre>
|-
|<pre>BROWSER_MONITOR-1A2B3C4D</pre>
|<pre>SYNTHETIC_TEST-1A2B3C4D</pre>
|-
|<pre>BROWSER_MONITOR_STEP-1A2B3C4D</pre>
|<pre>SYNTHETIC_TEST_STEP-1A2B3C4D</pre>
|-
|<pre>NETWORK_AVAILABILITY_MONITOR-1A2B3C4D</pre>
|<pre>MULTIPROTOCOL_MONITOR-1A2B3C4D</pre>
|}

=== Правила для объединяющих запросов ===
При написании объединяющих запросов соблюдайте четыре правила:

1. Помещайте <code>coalesce</code> в <code>fieldsAdd</code>, а не в предложение <code>timeseries by:</code>. Предложение <code>by:</code> принимает только простые размерности; выражение там вызовет ошибку <code>MANDATORY_PARAMETER_HAS_TO_BE_FIELD_BUT_WAS_EXPRESSION</code>. Сначала группируйте по обеим сырым размерностям, а затем получайте объединённый идентификатор. 2. Объединённый идентификатор имеет тип <code>SmartscapeId</code>, поэтому фильтруйте его с помощью <code>toSmartscapeId(...)</code>, а не как простую строку — сравнение строк без преобразования не вернёт результатов. Сырая размерность <code>dt.smartscape.*</code> также является <code>SmartscapeId</code>, а классическая <code>dt.entity.*</code> — простая строка. 3. Суммы и счётчики завышены из-за двойного подсчёта; отношения не страдают. В переходный период оба семейства размерностей заполняются для одного выполнения, поэтому простое суммирование или подсчёт (например, общее количество выполнений) завышено. Средневзвешенное по выполнению <code>sum(availability) / sum(count)</code> не страдает, потому что дублирование масштабирует числитель и знаменатель одинаково. Если нужны точные общие количества выполнений, сначала дедуплицируйте — подробнее см. «Синтетические расчёты». 4. Не каждый узел шага материализован. В частности, узлы шагов HTTP-монитора могут отсутствовать, даже если рёбра <code>contains</code> существуют — см. раздел «Вывести шаги монитора по порядку».

=== Доступность за диапазон, включающий данные до миграции ===
Сгруппируйте как по размерности Smartscape, так и по классической, объедините их в единый <code>monitorId</code> с помощью <code>coalesce</code> и вычислите средневзвешенное по выполнению, чтобы результат был корректным, даже если оба семейства перекрываются. Функции <code>toSmartscapeId</code> и <code>replaceString</code> преобразуют классический идентификатор сущности в его эквивалент Smartscape. Запрос охватывает все HTTP-мониторы за 90 дней; раскомментируйте фильтр и укажите свой идентификатор, чтобы ограничить одним монитором.<pre>
timeseries {
sumAv = sum(dt.synthetic.http.availability),
dataPoints = sum(dt.synthetic.http.availability, rollup: count)
}, by: {dt.smartscape.http_monitor, dt.entity.http_check}, from: now()-90d
| fieldsAdd monitorId = coalesce(dt.smartscape.http_monitor,
toSmartscapeId(replaceString(toString(dt.entity.http_check), "HTTP_CHECK", "HTTP_MONITOR")))
// | filter monitorId == toSmartscapeId("HTTP_MONITOR-0000000000000000")
| summarize sumAv = sum(sumAv[]), dataPoints = sum(dataPoints[]), by: {timeframe, interval, monitorId}
| fieldsAdd av = sumAv[] / dataPoints[], avg = arraySum(sumAv) / arraySum(dataPoints)
| fieldsRemove sumAv, dataPoints
</pre>Для браузерных мониторов и мониторов сетевой доступности замените ключ метрики и размерность Smartscape из справочника метрик доступности, а также классическую размерность и пару префиксов для <code>replaceString</code> из таблицы «Модель с двумя идентификаторами». Например, для браузерных мониторов используйте <code>sum(dt.synthetic.browser.availability)</code>, группировку по <code>{dt.smartscape.browser_monitor, dt.entity.synthetic_test}</code> и <code>replaceString(toString(dt.entity.synthetic_test), "SYNTHETIC_TEST", "BROWSER_MONITOR")</code>.

=== Долгосрочный отчёт по доступности для всего парка ===
Этот запрос вычисляет средневзвешенную доступность за 30 дней для каждого HTTP-монитора, обрабатывая как данные Smartscape, так и классические в одном запросе. <code>getNodeName</code> / <code>getNodeField</code> добавляют имя и состояние включения из объединённого <code>monitorId</code> непосредственно.<pre>
timeseries {
sumAv = sum(dt.synthetic.http.availability),
dataPoints = sum(dt.synthetic.http.availability, rollup: count)
}, by: {dt.smartscape.http_monitor, dt.entity.http_check}, from: now()-30d
| fieldsAdd monitorId = coalesce(dt.smartscape.http_monitor,
toSmartscapeId(replaceString(toString(dt.entity.http_check), "HTTP_CHECK", "HTTP_MONITOR")))
| summarize sumAv = sum(sumAv[]), dataPoints = sum(dataPoints[]), by: {monitorId}
| fieldsAdd availability = arraySum(sumAv) / arraySum(dataPoints),
name = getNodeName(monitorId), enabled = getNodeField(monitorId, "enabled")
| sort availability asc
| fields name, enabled, availability, monitorId
</pre>Мониторы, которые выполнялись только до миграции и больше не существуют как узлы Smartscape, всё равно отображаются (их доступность учтена), но <code>getNodeName</code> вернёт <code>null</code> — текущего узла для разрешения нет.

=== Найти классический идентификатор монитора по его идентификатору Smartscape ===
Запрос выводит классический идентификатор для каждого монитора. Чтобы найти один, раскомментируйте фильтр и укажите его идентификатор Smartscape:<pre>
smartscapeNodes HTTP_MONITOR
// | filter id == toSmartscapeId("HTTP_MONITOR-0000000000000000")
| fields id, classicId = id_classic
</pre>Поле <code>id</code> имеет тип <code>SmartscapeId</code>, поэтому литерал фильтра должен быть обёрнут в <code>toSmartscapeId(...)</code>. Поле <code>id_classic</code>, напротив, является простой строкой и фильтруется напрямую (см. следующий запрос).

=== Найти идентификатор Smartscape монитора по его классическому идентификатору ===
Запрос выводит идентификатор Smartscape для каждого монитора. Чтобы найти один, раскомментируйте фильтр и укажите его классический идентификатор (простая строка — <code>toSmartscapeId</code> не требуется):<pre>
smartscapeNodes HTTP_MONITOR
// | filter id_classic == "HTTP_CHECK-0000000000000000"
| fields id, id_classic, name
</pre>

Обновления атрибутов синтетики

2026-09-03T19:17:04Z

IKuznetsov: Новая страница: « = Обновления атрибутов синтетики = '''Актуально только для лицензирования DPS''' Это изменение затрагивает только арендаторов '''DPS''', для которых синтетический мониторинг генерирует события '''Grail'''. В январе 2025 года мы переименовали некоторые атрибуты си...»

= Обновления атрибутов синтетики =
'''Актуально только для лицензирования DPS''' Это изменение затрагивает только арендаторов '''DPS''', для которых синтетический мониторинг генерирует события '''Grail'''.

В январе 2025 года мы переименовали некоторые атрибуты синтетических событий, чтобы привести их в соответствие с последними соглашениями об именовании в '''Ключ-АСТРОМ'''. Это касается событий <code>batch_status</code>, создаваемых, например, '''Синтетикой для Workflows'''.

Если ваши рабочие процессы используют выходные данные '''Синтетики для Workflows''', проверьте их и обновите все экземпляры старых имён атрибутов.

У вас есть до 31 мая 2025 года, чтобы внести эти обновления:

* До 31 мая 2025 года '''Синтетика для Workflows''' возвращает атрибуты как в старом, так и в новом формате именования.
* После 31 мая 2025 года '''Синтетика для Workflows''' будет возвращать атрибуты только в новом формате именования.

Сравнение всех старых и новых имён приведено в таблице ниже.

== Как обновить имена атрибутов ==
Поскольку выходные данные '''Синтетики для Workflows''' могут использоваться множеством способов в различных действиях рабочих процессов, автоматическое обновление имён атрибутов невозможно. Поэтому вам потребуется найти и обновить все затронутые имена атрибутов вручную.

Чтобы найти затронутые имена атрибутов, откройте каждый рабочий процесс и найдите все экземпляры старых имён атрибутов в действиях рабочего процесса.

* Проверьте все задачи рабочего процесса, которые следуют за действием '''Синтетики для Workflows''' (то есть задачи, которые могут использовать результаты этого действия).
* Имена синтетических атрибутов можно найти на панели конфигурации действия, на вкладках '''Входные данные''' и '''Условия'''.
* Однако для уверенности просмотрите все возможные параметры конфигурации каждого рабочего процесса. Обновите имя атрибута в соответствии с таблицей ниже и сохраните рабочий процесс. Проделайте это для всех рабочих процессов.

== Сравнение старых и новых имён ==
В этой таблице приведены все затронутые атрибуты событий <code>batch_status</code> со старыми и соответствующими новыми именами.

Дополнительная информация о событиях Synthetic batch_status (атрибуты, тип, описание и примеры) доступна в разделе Synthetic batch status.

<code>__key__</code> и <code>__index__</code> являются заполнителями; точные значения зависят от конкретного действия '''Синтетики для Workflows'''.
{| class="wikitable"
!Старое имя атрибута
!Новое имя атрибута
|-
|<pre>dt.synthetic.batch.status</pre>
|<pre>batch.status</pre>
|-
|<pre>dt.synthetic.result.duration</pre>
|<pre>batch_result.duration</pre>
|-
|<pre>dt.synthetic.result.executed_count</pre>
|<pre>batch_result.executed_count</pre>
|-
|<pre>dt.synthetic.result.failed_count</pre>
|<pre>batch_result.failed_count</pre>
|-
|<pre>dt.synthetic.result.failed_to_execute_count</pre>
|<pre>batch_result.failed_to_execute_count</pre>
|-
|<pre>dt.synthetic.result.total_duration</pre>
|<pre>batch_result.total_duration</pre>
|-
|<pre>dt.synthetic.result.triggered_count</pre>
|<pre>batch_result.triggered_count</pre>
|-
|<pre>dt.synthetic.result.triggering_problems_count</pre>
|<pre>batch_result.triggering_problems_count</pre>
|-
|<pre>dt.synthetic.configuration.fail_on_performance_issue</pre>
|<pre>configuration.fail_on_performance_issue</pre>
|-
|<pre>dt.synthetic.configuration.fail_on_ssl_warning</pre>
|<pre>configuration.fail_on_ssl_warning</pre>
|-
|<pre>dt.synthetic.configuration.processing_mode</pre>
|<pre>configuration.processing_mode</pre>
|-
|<pre>dt.synthetic.configuration.take_screenshot_on_success</pre>
|<pre>configuration.take_screenshot_on_success</pre>
|-
|<pre>dt.synthetic.metadata.__key__</pre>
|<pre>metadata.__key__</pre>
|-
|<pre>dt.synthetic.triggered_executions</pre>
|<pre>triggered_executions</pre>
|-
|<pre>dt.synthetic.failed_executions.__index__.location.id</pre>
|<pre>failed_executions.__index__.dt.entity.synthetic_location</pre>
|-
|<pre>dt.synthetic.failed_executions.__index__.monitor.id</pre>
|<pre>failed_executions.__index__.dt.synthetic.monitor.id</pre>
|-
|<pre>dt.synthetic.failed_executions.__index__.execution.end_timestamp</pre>
|<pre>failed_executions.__index__.execution.end_timestamp</pre>
|-
|<pre>dt.synthetic.failed_executions.__index__.execution.id</pre>
|<pre>failed_executions.__index__.execution.id</pre>
|-
|<pre>dt.synthetic.failed_executions.__index__.execution.stage</pre>
|<pre>failed_executions.__index__.execution.stage</pre>
|-
|<pre>dt.synthetic.failed_executions.__index__.status.code</pre>
|<pre>failed_executions.__index__.result.status.code</pre>
|-
|<pre>dt.synthetic.failed_executions.__index__.status.details</pre>
|<pre>failed_executions.__index__.result.status.details</pre>
|-
|<pre>dt.synthetic.failed_executions.__index__.status.message</pre>
|<pre>failed_executions.__index__.result.status.message</pre>
|-
|<pre>dt.synthetic.failed_executions.__index__.status.on_demand.message</pre>
|<pre>failed_executions.__index__.result.status.on_demand.message</pre>
|-
|<pre>dt.synthetic.failed_to_execute.__index__.location.id</pre>
|<pre>failed_to_execute.__index__.dt.entity.synthetic_location</pre>
|-
|<pre>dt.synthetic.failed_to_execute.__index__.monitor.id</pre>
|<pre>failed_to_execute.__index__.dt.synthetic.monitor.id</pre>
|-
|<pre>dt.synthetic.failed_to_execute.__index__.execution.end_timestamp</pre>
|<pre>failed_to_execute.__index__.execution.end_timestamp</pre>
|-
|<pre>dt.synthetic.failed_to_execute.__index__.execution.id</pre>
|<pre>failed_to_execute.__index__.execution.id</pre>
|-
|<pre>dt.synthetic.failed_to_execute.__index__.execution.stage</pre>
|<pre>failed_to_execute.__index__.execution.stage</pre>
|-
|<pre>dt.synthetic.triggering_problems.__index__.location.id</pre>
|<pre>triggering_problems.__index__.dt.entity.synthetic_location</pre>
|-
|<pre>dt.synthetic.triggering_problems.__index__.entity.id</pre>
|<pre>triggering_problems.__index__.triggering_problem.entity.id</pre>
|-
|<pre>dt.synthetic.triggering_problems.__index__.cause</pre>
|<pre>triggering_problems.__index__.triggering_problem.cause</pre>
|-
|<pre>dt.synthetic.triggering_problems.__index__.details</pre>
|<pre>triggering_problems.__index__.triggering_problem.details</pre>
|}

Синтетика для Workflows

2026-09-03T19:14:41Z

IKuznetsov: Новая страница: « = Синтетика для Workflows = '''Синтетика для Workflows''' позволяет выполнять синтетические мониторы по требованию на выбранных локациях в рамках ваших рабочих процессов. '''Ключ-АСТРОМ''' может реагировать на любое событие и выполнять синтетические мониторы в раб...»

= Синтетика для Workflows =
'''Синтетика для Workflows''' позволяет выполнять синтетические мониторы по требованию на выбранных локациях в рамках ваших рабочих процессов. '''Ключ-АСТРОМ''' может реагировать на любое событие и выполнять синтетические мониторы в рабочих процессах для оценки их влияния на пользовательский опыт. В зависимости от результата рабочие процессы могут уведомить команду, создав тикет в '''Jira''', отправив сообщение в '''Slack''' или запустив процесс восстановления.

С помощью '''Синтетики для Workflows''' вы можете выбрать, какие мониторы выполнять:

* список всех доступных мониторов;
* мониторы, помеченные определёнными тегами;
* мониторы, назначенные конкретным фронтенд-приложениям.

Также можно использовать выражения рабочих процессов для извлечения списка мониторов и локаций из входящих событий, что позволяет создавать повторно используемые рабочие процессы.

== Шаг 1. Установка Synthetic for Workflows ==
Чтобы использовать действия Synthetic for Workflows, сначала необходимо установить Synthetic for Workflows из '''Ключ-АСТРОМ Hub'''.

* В '''Ключ-АСТРОМ Hub''' найдите '''Synthetic for Workflows'''.
* Выберите '''Synthetic for Workflows''' и нажмите '''Установить'''.
* После установки действия <code>synthetic_for_workflows</code> автоматически появляются в разделе '''Выбор действия''' рабочих процессов.

Перед началом убедитесь, что ваши мониторы правильно определены. Чтобы создать новый монитор, найдите '''Синтетический''' в '''Ключ-АСТРОМ Hub'''.

== Шаг 2. Назначение разрешений для рабочих процессов ==
Необходимые разрешения перечислены в рабочих процессах. Кроме того, для выполнения Synthetic for Workflows требуются следующие разрешения:

* <code>environment:roles:manage-settings</code>
* <code>storage:buckets:read</code>
* <code>storage:events:read</code>

Пример политики:<pre>
ALLOW
app-engine:apps:run,
automation:workflows:read,
app-engine:functions:run,
automation:workflows:run,
automation:workflows:write,
environment:roles:manage-settings,
storage:buckets:read,
storage:events:read;
</pre>

== Использование действия synthetic_for_workflows ==

=== Выбор синтетических мониторов ===
Чтобы выбрать мониторы из списка для Synthetic for Workflows, необходимо указать синтетические мониторы, которые должны выполняться при запуске рабочего процесса. Вы можете выбрать монитор из '''Визуального''' или '''Из события'''. Найти наиболее релевантные мониторы можно, отфильтровав список по различным критериям, таким как тип, имя, приложения и теги.

Вы также можете:

* Выбрать '''С определёнными тегами''', чтобы просмотреть мониторы с определённым тегом.
* Выбрать '''Назначенные фронтенд-приложениям''', чтобы выбрать мониторы, назначенные конкретным приложениям. Доступные приложения можно найти в списке '''Выбор фронтенд-приложений'''.

=== Выбор синтетической локации ===
В разделе '''Выбор синтетической локации''':

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

Если вы не выберете ни одной локации, монитор будет выполнен в локации, указанной в его конфигурации.

=== Добавление метаданных ===
Раздел '''Добавление метаданных''' позволяет обогатить результат синтетического монитора контекстом выполнения, например, именем приложения, версией, этапом разработки и версией сборки.

Чтобы добавить метаданные:

* Нажмите '''Добавить метаданные'''.
* Заполните поля '''Ключ''' и '''Значение'''. В этих полях можно использовать выражения рабочих процессов.
* Метаданные сохраняются автоматически.

=== Настройка выполнения монитора ===
Вы можете настроить параметры выполнения, которые будут применяться ко всем выполнениям в рабочих процессах.

Для этого включите или отключите любые из следующих параметров:

* '''Останавливать при проблеме'''
* '''Завершать с ошибкой при проблеме производительности'''
* '''Завершать с ошибкой при предупреждении SSL'''
* '''Делать скриншоты при успехе'''

=== Настройка выполнения рабочего процесса ===
Вы можете настроить поведение рабочего процесса в случае сбоя пакетного выполнения синтетических мониторов. Это делается с помощью переключателя '''Завершать задачу рабочего процесса при сбое пакетного выполнения'''.

Вы можете включить или отключить его:

* '''Включено''': если выполнение монитора завершается ошибкой, задача завершается ошибкой. Это можно комбинировать с другими параметрами конфигурации, такими как переключатель '''Повтор при ошибке''', чтобы управлять поведением рабочего процесса в соответствии с задачей, завершившейся ошибкой.

* '''Отключено''': если выполнение монитора завершается ошибкой, задача завершается успешно. Действие Synthetic for Workflows генерирует результаты, которые могут быть использованы следующей задачей, например, '''Site Reliability Guardian'''.

По умолчанию этот переключатель выключен.

== Результаты синтетических мониторов в Grail ==
Обратите внимание, что синтетический мониторинг не генерирует события Grail для арендаторов, не использующих '''DPS'''. Вся обработка будет основываться исключительно на данных API. Чтобы узнать больше о лицензировании DPS, см. раздел «Лицензия Ключ-АСТРОМ».

Результаты синтетических мониторов, выполненных по требованию, сохраняются как события в '''Grail'''.

Существует три типа событий:

* <code>batch_status</code> — содержит сводный результат всех выполнений мониторов в пакете;
* <code>browser_monitor_execution</code> — содержит подробную информацию об одном выполнении браузерного монитора;
* <code>http_monitor_execution</code> — содержит подробную информацию об одном выполнении HTTP-монитора.

== Интеграция Synthetic for Workflows с Site Reliability Guardian ==
Если вы хотите оценивать цели на основе результатов синтетических мониторов, вы можете интегрировать '''Site Reliability Guardian''' (SRG) как следующее действие в вашем рабочем процессе.

Для этого:

* Нажмите на задаче <code>synthetic_for_workflows</code> и выберите '''Site Reliability Guardian''' в разделе '''Выбор действия'''. Это запустит задачу <code>site_reliability_guardian_1</code>.
* Выберите задачу <code>site_reliability_guardian_1</code>. В разделе '''Переменные''' укажите параметр <code>batchId</code> из результата синтетического монитора и значение <code><nowiki>{{ result("synthetic_for_workflows_1")["event.id"] }}</nowiki></code>. Вы можете заменить <code>synthetic_for_workflows_1</code> на любое другое имя задачи.
* В '''Ключ-АСТРОМ Hub''' найдите '''Site Reliability Guardian'''.
* Нажмите кнопку '''+ Guardian'''.
* В вашем Guardian выберите '''Переменные'''.
* Нажмите '''Добавить переменную'''.
* В поле '''Имя''' введите <code>batchId</code>. В поле '''Значение''' укажите значение по умолчанию. Нажмите кнопку '''Добавить''', чтобы сохранить изменения.
* Справа заполните '''Имя Guardian'''.
* Нажмите '''Добавить новую цель''' и укажите один из следующих запросов '''DQL'''.

Обратите внимание, что запросы для синтетических событий из приложений, отличных от '''Синтетический''', например из '''Notebooks''', '''Дашбордов''' и '''SRG''', не тарифицируются.

Используйте следующий запрос, чтобы получить общую продолжительность всего пакета:<pre>
fetch dt.synthetic.events
| filter event.id == $batchId
| fields batch_result.duration
</pre>Используйте следующий запрос, чтобы проверить, успешно ли завершился пакет:<pre>
fetch dt.synthetic.events
| filter event.id == $batchId
| filter batch.status == "Success"
| summarize count = count()
</pre>

Обзор синтетических оповещений

2026-09-03T16:52:12Z

IKuznetsov: Новая страница: «= Обзор синтетического оповещения = Синтетический монитор создаёт проблему, когда выполняется одно из следующих условий: * Отслеживаемая система недоступна. В этом случае монитор сообщает о проблеме доступности. Проблема создаётся после указанного к...»

= Обзор синтетического оповещения =

Синтетический монитор создаёт проблему, когда выполняется одно из следующих условий:

* Отслеживаемая система недоступна. В этом случае монитор сообщает о проблеме доступности. Проблема создаётся после указанного количества последовательных сбоев выполнения.

Система считается недоступной, если:

* система не отвечает;
* возникли проблемы с сертификатами (для браузерных и '''HTTP'''-мониторов);
* нарушены ограничения (для всех типов мониторов). Ограничения можно задать при настройке или редактировании мониторов.

* Нарушен указанный порог производительности, что означает, что отслеживаемая система доступна, но работает медленно. В этом случае монитор сообщает о проблеме производительности.

== Обработка отказов и пороги производительности ==

Чтобы настроить обработку отказов и указать пороги производительности, перейдите в раздел '''Синтетический''' → '''Синтетический''', выберите свой монитор, а затем нажмите '''Редактировать'''.

Не забудьте '''Сохранить''' настройки монитора.

=== Обработка отказов ===

В разделе '''Обработка отказов''' на вкладке '''Отказы и производительность''' можно задать условия для создания проблемы. Доступны два варианта:

* Создавать проблему и отправлять оповещение, когда монитор недоступен во всех настроенных локациях (глобальный сбой). Вы можете указать, сколько последовательных выполнений должно завершиться сбоем, чтобы проблема была создана.

* Создавать проблему и отправлять оповещение, когда монитор недоступен в одном или нескольких последовательных запусках в любой локации (локальный сбой). Вы можете указать:

** минимальное количество локаций, которые должны быть затронуты, чтобы проблема была создана;
** сколько последовательных выполнений должно завершиться сбоем, чтобы проблема была создана.

Этот вариант доступен только при назначении как минимум двух локаций.

Для браузерных мониторов можно дополнительно выбрать '''Автоматический повтор при ошибке''' — это настраивает монитор на предотвращение ложных срабатываний путём выполнения ещё одного запуска после первого сбоя. Ошибка возникает только после того, как второй запуск также завершится сбоем.

=== Порог производительности для всего монитора ===

В разделе '''Пороги производительности''' на вкладке '''Отказы и производительность''' можно задать порог производительности для всего монитора. Монитор создаёт проблему, когда сумма длительностей всех шагов превышает этот порог.

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

=== Пороги производительности для отдельных шагов ===

На вкладке '''Шаги''' можно задать пороги производительности для отдельных шагов. Монитор создаёт проблему, когда хотя бы один шаг с указанным порогом нарушает этот порог.

== Проблемы ==

Вы можете отслеживать проблемы в разделе '''Проблемы''' (новые проблемы) или в разделе '''Синтетический''' → '''Синтетический'''. Мониторы с проблемами имеют красный значок в колонке '''Проблемы''', который также отображает количество проблем для монитора. В списке мониторов выберите интересующий монитор, чтобы открыть панель предварительного просмотра справа. Оттуда вы можете, например, выбрать '''Просмотреть сведения > Анализировать выполнения''' и исследовать выполнения, в которых были обнаружены проблемы.

Метрики NAM-мониторов в синтетическом мониторинге

2026-09-03T16:48:05Z

IKuznetsov: Новая страница: « = Метрики NAM-мониторов в синтетическом мониторинге = == Метрики и параметры == === Размеры (для всех мониторов сетевой доступности) === {| class="wikitable" !Название !Тип !Описание !Пример значения |- |<pre>dt.entity.host</pre> |string |Если доступен, идентификатор сущности монитори...»

= Метрики NAM-мониторов в синтетическом мониторинге =

== Метрики и параметры ==

=== Размеры (для всех мониторов сетевой доступности) ===
{| class="wikitable"
!Название
!Тип
!Описание
!Пример значения
|-
|<pre>dt.entity.host</pre>
|string
|Если доступен, идентификатор сущности мониторинга для целевого хоста.
|<pre>HOST-024C103F7F86A290</pre>
|-
|<pre>dt.entity.multiprotocol_monitor</pre>
|string
|Идентификатор монитора (идентификатор сущности мониторинга).
|<pre>MULTIPROTOCOL_MONITOR-3F6C9D500287BBAF</pre>
|-
|<pre>dt.entity.synthetic_location</pre>
|string
|Идентификатор синтетической локации (идентификатор сущности мониторинга).
|<pre>SYNTHETIC_LOCATION-A4F834D72840EFC1</pre>
|-
|<pre>dt.maintenance_window_ids</pre>
|array
|UUID окон обслуживания.
|<pre>c715d677-eb1b-3e1b-8dbc-db06cad5b8eb</pre>
|-
|<pre>dt.security_context</pre>
|string
|Контекст безопасности используется в разрешениях доступа для ограничения видимости.
|<pre>mySecurityContext</pre>
|-
|<pre>dt.synthetic.monitor.id</pre>
|string
|Идентификатор синтетического монитора.
|<pre>SYNTHETIC_TEST-1234567890ABCDEF</pre>
|-
|<pre>dt.synthetic.monitored_entity_ids</pre>
|array
|Идентификаторы отслеживаемых сущностей.
|<pre>APPLICATION-EA7C4B59F27D43EB</pre>
|-
|<pre>dt.synthetic.step.id</pre>
|string
|Идентификатор шага.
|<pre>SYNTHETIC_TEST_STEP-1234567890ABCDEF</pre>
|-
|<pre>interpolated</pre>
|boolean
|Информация о том, была ли доступность монитора интерполирована.
|<pre>false</pre>
|-
|<pre>monitor.name</pre>
|string
|Название монитора.
|<pre>My NAM monitor</pre>
|-
|<pre>primary_tags.__key__</pre>
|string
|Определяемые пользователем основные теги '''Grail'''.
|<pre>tag-value</pre>
|-
|<pre>request.id</pre>
|numeric
|Порядковый идентификатор запроса.
|<pre>2</pre>
|-
|<pre>request.target_address</pre>
|string
|Адрес целевой сущности.
|<pre>54.171.216.19</pre>
|-
|<pre>request.type</pre>
|string
|Тип запроса.
|<pre>icmp, tcp</pre>
|-
|<pre>result.state</pre>
|string
|Состояние результата выполнения монитора.
|<pre>SUCCESS, FAIL</pre>
|-
|<pre>result.status.code</pre>
|numeric
|Числовое представление статуса выполнения.
|<pre>0, 1401</pre>
|-
|<pre>result.status.message</pre>
|string
|Статус выполнения.
|<pre>HEALTHY, CONSTRAINT_VIOLATED</pre>
|-
|<pre>step.id</pre>
|numeric
|Порядковый идентификатор шага.
|<pre>1</pre>
|-
|<pre>step.name</pre>
|string
|Название шага.
|<pre>My step</pre>
|-
|<pre>step.sequence_number</pre>
|numeric
|Номер последовательности шага (начиная с 0).
|<pre>0</pre>
|}

=== Метрики монитора (для всех мониторов сетевой доступности) ===
{| class="wikitable"
!Название
!Тип
!Размеры
!Описание
|-
|<pre>dt.synthetic.multi_protocol.availability</pre>(последняя версия '''Ключ-АСТРОМ''')
<pre>builtin:synthetic.multiProtocol.availability</pre>(предыдущая версия '''Ключ-АСТРОМ''')
|numeric
|<pre>dt.synthetic.monitor.id, dt.entity.multiprotocol_monitor, monitor.name, dt.synthetic.step.id, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context, interpolated</pre>
|Доступность, рассчитанная на основе статуса выполнения визитов: 100 % для кода 0: HEALTHY, SCRIPT_FINISH, SKIPPED; 0 % для кодов ошибок, таких как 1401 — CONSTRAINT_VIOLATED.
|-
|<pre>dt.synthetic.multi_protocol.execution_time</pre>(последняя версия '''Ключ-АСТРОМ''')
<pre>builtin:synthetic.multiProtocol.executionTime</pre>(предыдущая версия '''Ключ-АСТРОМ''')
|numeric
|<pre>dt.synthetic.monitor.id, dt.entity.multiprotocol_monitor, monitor.name, dt.synthetic.step.id, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context</pre>
|Продолжительность между началом и окончанием выполнения визита (в миллисекундах). Метрика доступна только если выполнение визита состоялось; необходимо наличие как времени начала, так и времени окончания.
|-
|<pre>dt.synthetic.multi_protocol.executions</pre>(последняя версия '''Ключ-АСТРОМ''')
<pre>builtin:synthetic.multiProtocol.executions</pre>(предыдущая версия '''Ключ-АСТРОМ''')
|numeric
|<pre>dt.synthetic.monitor.id, dt.entity.multiprotocol_monitor, monitor.name, dt.synthetic.step.id, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context, dt.maintenance_window_ids, result.state, result.status.code, result.status.message</pre>
|Количество выполнений монитора за время.
|-
|<pre>dt.synthetic.multi_protocol.success_rate</pre>(последняя версия '''Ключ-АСТРОМ''')
<pre>builtin:synthetic.multiProtocol.successRate</pre>(предыдущая версия '''Ключ-АСТРОМ''')
|numeric
|<pre>dt.synthetic.monitor.id, dt.entity.multiprotocol_monitor, monitor.name, dt.synthetic.step.id, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context</pre>
|Отношение выполненных шагов без ошибок (успешных и пропущенных) ко всем выполненным шагам. Учитываются только шаги, которые были фактически выполнены, а не запланированные. Например, при 2 успешных шагах, 1 ошибочном и 8 не запущенных отношение составляет 2/3, или 66,67 %.
|}

=== Метрики шагов (для всех мониторов сетевой доступности) ===
{| class="wikitable"
!Название
!Тип
!Размеры
!Описание
|-
|<pre>dt.synthetic.multi_protocol.step.availability</pre>(последняя версия '''Ключ-АСТРОМ''')
<pre>builtin:synthetic.multiProtocol.step.availability</pre>(предыдущая версия '''Ключ-АСТРОМ''')
|numeric
|<pre>dt.synthetic.monitor.id, dt.entity.multiprotocol_monitor, monitor.name, dt.synthetic.step.id, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context, step.id, request.type</pre>
|Доступность, рассчитанная на основе статуса выполнения шагов: 100 % для кода 0: HEALTHY, SCRIPT_FINISH, SKIPPED; 0 % для кодов ошибок, таких как 1401 — CONSTRAINT_VIOLATED.
|-
|<pre>dt.synthetic.multi_protocol.step.execution_time</pre>(последняя версия '''Ключ-АСТРОМ''')
<pre>builtin:synthetic.multiProtocol.step.executionTime</pre>(предыдущая версия '''Ключ-АСТРОМ''')
|numeric
|<pre>dt.synthetic.monitor.id, dt.entity.multiprotocol_monitor, monitor.name, dt.synthetic.step.id, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context, step.id, request.type</pre>
|Продолжительность между началом и окончанием выполнения шага (в миллисекундах). Метрика доступна только если выполнение шага состоялось и имеет определённое время окончания; поэтому недоступна для пропущенных шагов.
|-
|<pre>dt.synthetic.multi_protocol.step.executions</pre>(последняя версия '''Ключ-АСТРОМ''')
<pre>builtin:synthetic.multiProtocol.step.executions</pre>(предыдущая версия '''Ключ-АСТРОМ''')
|numeric
|<pre>dt.synthetic.monitor.id, dt.entity.multiprotocol_monitor, monitor.name, dt.synthetic.step.id, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context, step.id, request.type, result.state, result.status.code, result.status.message</pre>
|Количество выполнений шагов за время.
|-
|<pre>dt.synthetic.multi_protocol.step.success_rate</pre>(последняя версия '''Ключ-АСТРОМ''')
<pre>builtin:synthetic.multiProtocol.step.successRate</pre>(предыдущая версия '''Ключ-АСТРОМ''')
|numeric
|<pre>dt.synthetic.monitor.id, dt.entity.multiprotocol_monitor, monitor.name, dt.synthetic.step.id, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context, step.id, request.type</pre>
|Отношение выполненных запросов без ошибок ко всем выполненным запросам. Если у шага нет выполненных запросов (поскольку ни один не соответствует его определению в конфигурации монитора), возвращается значение 100 %. Например, при 2 успешных запросах и 1 ошибочном отношение составляет 2/3, или 66,67 %.
|}

=== Метрики запросов (для всех мониторов сетевой доступности) ===
{| class="wikitable"
!Название
!Тип
!Размеры
!Описание
|-
|<pre>dt.synthetic.multi_protocol.request.availability</pre>(последняя версия '''Ключ-АСТРОМ''')
<pre>builtin:synthetic.multiProtocol.request.availability</pre>(предыдущая версия '''Ключ-АСТРОМ''')
|numeric
|<pre>dt.synthetic.monitor.id, dt.entity.multiprotocol_monitor, monitor.name, dt.synthetic.step.id, step.name, step.sequence_number, dt.entity.synthetic_location, dt.entity.host (only for monitors with filter defined), dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context, step.id, request.id, request.target.address, request.type</pre>
|Доступность, рассчитанная на основе статуса выполнения запросов: 100 % для кода 0: HEALTHY, SCRIPT_FINISH, SKIPPED; 0 % для кодов ошибок, таких как 1401 — CONSTRAINT_VIOLATED.
|-
|<pre>dt.synthetic.multi_protocol.request.executions</pre>(последняя версия '''Ключ-АСТРОМ''')
<pre>builtin:synthetic.multiProtocol.request.executions</pre>(предыдущая версия '''Ключ-АСТРОМ''')
|numeric
|<pre>dt.synthetic.monitor.id, dt.entity.multiprotocol_monitor, monitor.name, dt.synthetic.step.id, step.name, step.sequence_number, dt.entity.synthetic_location, dt.entity.host (only for monitors with filter defined), dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context, step.id, request.id, request.target.address, request.type, result.state, result.status.code, result.status.message</pre>
|Количество выполнений запросов за время.
|}

=== Метрики ICMP-мониторов ===
{| class="wikitable"
!Название
!Тип
!Размеры
!Описание
|-
|<pre>dt.synthetic.multi_protocol.icmp.packets_received</pre>(последняя версия '''Ключ-АСТРОМ''')
<pre>builtin:synthetic.multiProtocol.icmp.packetsReceived</pre>(предыдущая версия '''Ключ-АСТРОМ''')
|numeric
|<pre>dt.synthetic.monitor.id, dt.entity.multiprotocol_monitor, monitor.name, dt.synthetic.step.id, step.name, step.sequence_number, dt.entity.synthetic_location, dt.entity.host (only for monitors with filter defined), dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context, step.id, request.id, request.target.address, request.type</pre>
|Количество пакетов, успешно возвращённых.
|-
|<pre>dt.synthetic.multi_protocol.icmp.packets_sent</pre>(последняя версия '''Ключ-АСТРОМ''')
<pre>builtin:synthetic.multiProtocol.icmp.packetsSent</pre>(предыдущая версия '''Ключ-АСТРОМ''')
|numeric
|<pre>dt.synthetic.monitor.id, dt.entity.multiprotocol_monitor, monitor.name, dt.synthetic.step.id, step.name, step.sequence_number, dt.entity.synthetic_location, dt.entity.host (only for monitors with filter defined), dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context, step.id, request.id, request.target.address, request.type</pre>
|Общее количество отправленных пакетов.
|-
|<pre>dt.synthetic.multi_protocol.icmp.request_execution_time</pre>(последняя версия '''Ключ-АСТРОМ''')
<pre>builtin:synthetic.multiProtocol.icmp.requestExecutionTime</pre>(предыдущая версия '''Ключ-АСТРОМ''')
|numeric
|<pre>dt.synthetic.monitor.id, dt.entity.multiprotocol_monitor, monitor.name, dt.synthetic.step.id, step.name, step.sequence_number, dt.entity.synthetic_location, dt.entity.host (only for monitors with filter defined), dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context, step.id, request.id, request.target.address, request.type</pre>
|Продолжительность между началом и окончанием обработки запроса (в миллисекундах). Эта метрика предоставляется всегда, даже если фактическое выполнение запроса не состоялось (например, из-за исключений или тайм-аутов). Диагностическая метрика — позволяет проверить время выполнения внешнего процесса ping.
|-
|<pre>dt.synthetic.multi_protocol.icmp.round_trip_time</pre>(последняя версия '''Ключ-АСТРОМ''')
<pre>builtin:synthetic.multiProtocol.icmp.roundTripTime</pre>(предыдущая версия '''Ключ-АСТРОМ''')
|numeric
|<pre>dt.synthetic.monitor.id, dt.entity.multiprotocol_monitor, monitor.name, dt.synthetic.step.id, step.name, step.sequence_number, dt.entity.synthetic_location, dt.entity.host (only for monitors with filter defined), dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context, step.id, request.id, request.target.address, request.type</pre>
|Время кругового пути (Round-Trip Time) для полученных пакетов.
|-
|<pre>dt.synthetic.multi_protocol.icmp.success_rate</pre>(последняя версия '''Ключ-АСТРОМ''')
<pre>builtin:synthetic.multiProtocol.icmp.successRate</pre>(предыдущая версия '''Ключ-АСТРОМ''')
|numeric
|<pre>dt.synthetic.monitor.id, dt.entity.multiprotocol_monitor, monitor.name, dt.synthetic.step.id, step.name, step.sequence_number, dt.entity.synthetic_location, dt.entity.host (only for monitors with filter defined), dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context, step.id, request.id, request.target.address, request.type</pre>
|Отношение полученных пакетов к отправленным. Не учитывает настроенное количество пакетов для отправки. Например, из 10 пакетов для отправки, если 5 было отправлено и 4 получено, отношение составляет 4/5, или 80,00 %.
|}

=== Размеры TCP-мониторов ===
{| class="wikitable"
!Название
!Тип
!Описание
!Пример значения
|-
|<pre>request.tcp_port_number</pre>
|string
|Номер порта TCP-запроса, указанный в конфигурации монитора.
|<pre>665</pre>
|}

=== Метрики TCP-мониторов ===
{| class="wikitable"
!Название
!Тип
!Размеры
!Описание
|-
|<pre>dt.synthetic.multi_protocol.tcp.connection_time</pre>(последняя версия '''Ключ-АСТРОМ''')
<pre>builtin:synthetic.multiProtocol.tcp.connectionTime</pre>(предыдущая версия '''Ключ-АСТРОМ''')
|numeric
|<pre>dt.synthetic.monitor.id, dt.entity.multiprotocol_monitor, monitor.name, dt.synthetic.step.id, step.name, step.sequence_number, dt.entity.synthetic_location, dt.entity.host (only for monitors with filter defined), dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context, step.id, request.id, request.target.address, request.type, request.tcp_port_number</pre>
|Продолжительность между временем начала (создание сокета и соединение) и временем окончания (когда соединение успешно установлено) в миллисекундах. Метрика доступна только если выполнение запроса завершилось без исключений или тайм-аутов и имеет определённое время окончания.
|}

=== Размеры DNS-мониторов ===
{| class="wikitable"
!Название
!Тип
!Описание
!Пример значения
|-
|<pre>request.dns_record_type</pre>
|string
|Тип DNS-записи, запрашиваемой запросом, указанный в конфигурации.
|<pre>A, AAAA, CNAME</pre>
|}

=== Метрики DNS-мониторов ===
{| class="wikitable"
!Название
!Тип
!Размеры
!Описание
|-
|<pre>dt.synthetic.multi_protocol.dns.resolution_time</pre>(последняя версия '''Ключ-АСТРОМ''')
<pre>builtin:synthetic.multiProtocol.dns.resolutionTime</pre>(предыдущая версия '''Ключ-АСТРОМ''')
|numeric
|<pre>dt.synthetic.monitor.id, dt.entity.multiprotocol_monitor, monitor.name, dt.synthetic.step.id, step.name, step.sequence_number, dt.entity.synthetic_location, dt.entity.host (only for monitors with filter defined), dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context, step.id, request.id, request.target.address, request.type, request.dns_record_type</pre>
|Продолжительность между началом и окончанием запроса к DNS-серверу в миллисекундах. Метрика доступна только если выполнение запроса состоялось (без исключений или тайм-аутов) и имеет определённое время окончания.
|}

== Запросы DQL для извлечения данных ==
Используйте запросы '''DQL''' для извлечения данных с метриками и размерностями.

Следующие примеры используют '''Notebooks''' для демонстрации работы с результатами мониторов сетевой доступности. В них метрики результатов используются как отправная точка для изучения возможностей извлечения и интерпретации данных с помощью '''DQL'''.

=== Статус сущности хоста для ICMP-запросов ===
Монитор <code>MULTIPROTOCOL_MONITOR-5C2F92334DF71A90</code> выполняет ICMP-запросы и фильтрует отслеживаемые хосты с помощью <code>"targetFilter": "hostGroup == e2e-synthetic-private-location"</code> (что разрешается примерно в 26 хостов).

Используя метрику <code>dt.synthetic.multi_protocol.request.executions</code> и разбивая её по размерностям <code>dt.entity.host</code> и <code>result.status.message</code>, мы можем отобразить статус подключения к конкретной отслеживаемой сущности хоста в этой группе хостов. Некоторые хосты не соответствуют ожидаемому уровню успешности; вместо HEALTHY их запросы помечаются как CONSTRAINT_VIOLATED.<pre>
timeseries status = avg(dt.synthetic.multi_protocol.request.executions),
by:{dt.entity.host, result.status.message},
filter: dt.entity.multiprotocol_monitor == "MULTIPROTOCOL_MONITOR-5C2F92334DF71A90"
</pre>

=== Количество отправленных и полученных ICMP-пакетов ===
Монитор <code>MULTIPROTOCOL_MONITOR-548C3CD54183CED9</code> выполняет ICMP-запросы к хостам с явно определёнными IP-адресами: 18.x.x.x, 10.x.x.x и 34.x.x.x. Каждый из этих IP-адресов сопоставлен с отдельным хостом.

Мы используем сумму метрик <code>dt.synthetic.multi_protocol.icmp.packets_sent</code> и <code>dt.synthetic.multi_protocol.icmp.packets_received</code>, чтобы получить представление о том, сколько пакетов было отправлено и получено.

Разбиваем результаты по размерности <code>request.target_address</code> и фильтруем данные только для 18.x.x.x и 10.x.x.x.

Для 18.x.x.x получено столько же пакетов, сколько было отправлено, но для 10.x.x.x все пакеты потеряны и ни один не получен.<pre>
timeseries {
packets_sent = sum(dt.synthetic.multi_protocol.icmp.packets_sent),
packets_received = sum(dt.synthetic.multi_protocol.icmp.packets_received)
},
by:{request.target_address},
filter: dt.entity.multiprotocol_monitor == "MULTIPROTOCOL_MONITOR-548C3CD54183CED9"
AND (
request.target_address == "18.x.x.x"
OR request.target_address == "10.x.x.x"
)
</pre>

=== Статус цели для TCP-запросов ===
Монитор <code>MULTIPROTOCOL_MONITOR-74E68F22FF5E9227</code> выполняет TCP-запросы к хостам из группы хостов, которая разрешается в IP-адреса 18.x.x.x, 34.x.x.x и 44.x.x.x.

Чтобы отобразить статус TCP-подключения для пары IP-порт, мы используем метрику <code>dt.synthetic.multi_protocol.request.executions</code> и разбиваем её по следующим размерностям:

* <code>request.target_address</code>
* <code>request.tcp_port_number</code>
* <code>result.status.message</code>

В следующем примере:

* На каждом хосте открыты порты 22 (SSH) и 8080 (HTTP-сервер), и каждое подключение к хостам на этих портах завершается успешно со статусом HEALTHY.
* Ни один сервис не использует стандартный HTTP-порт 80. Поэтому подключения ко всем хостам на этом порте завершаются ошибкой со статусом ошибки TCP-сокета.

Обратите внимание, что результаты этого запроса можно ограничить только успешными запросами с помощью фильтра по размерности <code>result.status.code</code> (code == 0).<pre>
timeseries status = sum(dt.synthetic.multi_protocol.request.executions),
by: {request.target_address, request.tcp_port_number, result.status.message},
filter: dt.entity.multiprotocol_monitor == "MULTIPROTOCOL_MONITOR-74E68F22FF5E9227"
// and result.status.code == 0
</pre>

=== Время TCP-подключения к целевому порту ===
Монитор <code>MULTIPROTOCOL_MONITOR-74E68F22FF5E9227</code> выполняет TCP-запросы к хостам из группы хостов, которая разрешается в IP-адреса 18.x.x.x, 34.x.x.x и 44.x.x.x.

В следующем примере мы разбиваем результаты по идентификаторам отслеживаемых сущностей хостов.

Чтобы проверить типичное время, затрачиваемое на успешное подключение к целевому порту для хоста, мы используем среднее значение метрики <code>dt.synthetic.multi_protocol.tcp.connection_time</code> с разбивкой по размерностям:

* <code>dt.entity.host</code>
* <code>request.target_address</code>
* <code>request.tcp_port_number</code>

Открыты только порты 22 (SSH) и 8080 (HTTP-сервер), и только для этих портов доступна метрика <code>dt.synthetic.multi_protocol.tcp.connection_time</code>. Хосты фактически находятся в разных географических локациях (Огайо, Орегон и Северная Вирджиния в США), поэтому разница во времени подключения ожидаема.<pre>
timeseries duration = avg(dt.synthetic.multi_protocol.tcp.connection_time),
by:{dt.entity.host, request.target_address, request.tcp_port_number},
filter: dt.entity.multiprotocol_monitor == "MULTIPROTOCOL_MONITOR-74E68F22FF5E9227"
</pre>

== Статусы выполнения ==

=== Все мониторы сетевой доступности ===
{| class="wikitable"
!Код / Сообщение
!Пример
!Описание
|-
|<pre>0 HEALTHY</pre>
|
|Всё в порядке.
|-
|<pre>-1 UNEXPECTED_ERROR</pre>
|Resource saturation
|Неожиданная проблема, обычно связанная с компонентами выполнения монитора.
|-
|<pre>1401 CONSTRAINT_VIOLATED</pre>
|
|Условия ограничений, определённые в конфигурации монитора, не были выполнены.
|-
|<pre>1604 VALIDATION_ERROR</pre>
|
|Обнаружена некорректная конфигурация монитора.
|-
|<pre>12013 UNKNOWN_HOST</pre>
|Error in the hostname
|Не удаётся определить IP-адрес хоста. Возможные причины: неверное имя хоста, недоступность DNS-сервера, проблемы с кешем DNS, вмешательство брандмауэра или прокси.
|-
|<pre>12033 Execution timeout</pre>
|Server operates slowly
|Тайм-аут выполнения запроса. Возможные причины: проблемы с сетью, медленный или не отвечающий сервер или сервис, блокировка подключения правилами брандмауэра, слишком маленький тайм-аут.
|}

=== Статусы выполнения TCP-мониторов ===
{| class="wikitable"
!Код / Сообщение
!Пример
!Описание
|-
|<pre>22000 TCP socket connection error</pre>
|Service is not listening on a specified port.
|Этот статус означает, что хост был идентифицирован и доступен, но TCP-соединение не может быть установлено или было неожиданно закрыто. Предоставляется дополнительное объяснение точного исключения. Статус используется, если во время попытки подключения возвращается <code>java.net.SocketException</code>. Возможные причины: сервис не прослушивает указанный порт, сервис достиг предела ресурсов или подключений, сервис стал недоступен во время процесса установки сокетного соединения.
|}

Метрики мониторинга браузера в синтетическом мониторинге

2026-09-03T16:45:56Z

IKuznetsov:

= Метрики мониторинга браузера в синтетическом мониторинге =

== Метрики и параметры ==
=== Монитор ===
{| class="wikitable"
!Ключ метрики
!Название метрики
!Описание метрики
!Единица
!Размеры
|-
|<pre>dt.synthetic.browser.availability</pre>
|Уровень доступности (по местоположению) [Монитор браузера]
|Коэффициент доступности браузерных мониторов.
| %
|<pre>dt.synthetic.monitor.id, dt.entity.synthetic_test, monitor.name, dt.synthetic.step.id, dt.entity.synthetic_test_step, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context, interpolated</pre>
|-
|<pre>dt.synthetic.browser.executions</pre>
|Количество выполнений (по статусу) [Монитор браузера]
|Количество выполнений монитора.
|count
|<pre>dt.synthetic.monitor.id, dt.entity.synthetic_test, monitor.name, dt.synthetic.step.id, dt.entity.synthetic_test_step, step.name, step.sequence_number, dt.entity.synthetic_location, dt.maintenance_window_ids, dt.synthetic.monitored_entity_ids, primary_tags.__key__, result.state, result.status.code, result.status.message, dt.security_context</pre>
|-
|<pre>dt.synthetic.browser.duration</pre>
|Продолжительность [Монитор браузера]
|Продолжительность работы браузера, рассчитанная как сумма длительностей всех шагов.
|ms
|<pre>dt.synthetic.monitor.id, dt.entity.synthetic_test, monitor.name, dt.synthetic.step.id, dt.entity.synthetic_test_step, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context</pre>
|-
|<pre>dt.synthetic.browser.classic.total_duration</pre>
|Общая продолжительность (классическая) [Монитор браузера]
|Общая продолжительность работы браузера, измеряемая как сумма общей продолжительности всех шагов. Источник метрики — классический '''JavaScript'''-код '''RUM'''.
|ms
|<pre>dt.synthetic.monitor.id, dt.entity.synthetic_test, monitor.name, dt.synthetic.step.id, dt.entity.synthetic_test_step, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context</pre>
|-
|<pre>dt.synthetic.browser.user_events.duration</pre>
|Длительность событий пользователя [Монитор браузера]
|Продолжительность мониторинга браузера, рассчитываемая как сумма длительностей всех событий пользователя на уровне шагов. Источник метрики — новый '''JavaScript'''-код '''RUM'''.
|ms
|<pre>dt.synthetic.monitor.id, dt.entity.synthetic_test, monitor.name, dt.synthetic.step.id, dt.entity.synthetic_test_step, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context</pre>
|-
|<pre>dt.synthetic.browser.user_events.total_duration</pre>
|Общая продолжительность событий пользователя [Монитор браузера]
|Общая продолжительность мониторинга браузера, измеренная как сумма всех значений метрики User events total duration на уровне шагов. Источник метрики — новый '''JavaScript'''-код '''RUM'''.
|ms
|<pre>dt.synthetic.monitor.id, dt.entity.synthetic_test, monitor.name, dt.synthetic.step.id, dt.entity.synthetic_test_step, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context</pre>
|-
|<pre>dt.synthetic.browser.user_actions.duration</pre>
|Длительность действий пользователя [Монитор браузера]
|Продолжительность мониторинга браузера, рассчитываемая как сумма продолжительности всех действий пользователя на уровне шагов. Источник метрики — новый '''JavaScript'''-код '''RUM'''.
|ms
|<pre>dt.synthetic.monitor.id, dt.entity.synthetic_test, monitor.name, dt.synthetic.step.id, dt.entity.synthetic_test_step, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context</pre>
|-
|<pre>dt.synthetic.browser.user_actions.total_duration</pre>
|Общая продолжительность действий пользователя [Монитор браузера]
|Общая продолжительность мониторинга браузера, измеренная как сумма всех значений метрики User actions total duration на уровне шагов. Источник метрики — новый '''JavaScript'''-код '''RUM'''.
|ms
|<pre>dt.synthetic.monitor.id, dt.entity.synthetic_test, monitor.name, dt.synthetic.step.id, dt.entity.synthetic_test_step, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context</pre>
|}

=== Шаги ===
{| class="wikitable"
!Ключ метрики
!Название метрики
!Описание метрики
!Единица
!Размеры
|-
|<pre>dt.synthetic.browser.step.executions</pre>
|Количество выполнений (шаг) (по статусу) [Монитор браузера]
|Количество выполнений шагов.
|count
|<pre>dt.synthetic.monitor.id, dt.entity.synthetic_test, monitor.name, dt.synthetic.step.id, dt.entity.synthetic_test_step, step.name, step.sequence_number, dt.entity.synthetic_location, dt.maintenance_window_ids, dt.synthetic.monitored_entity_ids, primary_tags.__key__, result.state, result.status.code, result.status.message, dt.security_context</pre>
|-
|<pre>dt.synthetic.browser.step.duration</pre>
|Длительность (шаг) [Монитор браузера]
|Длительность отдельного шага мониторинга браузера, измеряемая как сумма длительностей событий действий пользователя на этом шаге.
|ms
|<pre>dt.synthetic.monitor.id, dt.entity.synthetic_test, monitor.name, dt.synthetic.step.id, dt.entity.synthetic_test_step, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context</pre>
|-
|<pre>dt.synthetic.browser.step.classic.total_duration</pre>
|Общая продолжительность (классическая) (шаг) [Монитор браузера]
|Общая продолжительность каждого шага мониторинга браузера, измеряемая как сумма всех действий пользователя на этом шаге. Источником метрики является классический '''JavaScript'''-код '''RUM'''.
|ms
|<pre>dt.synthetic.monitor.id, dt.entity.synthetic_test, monitor.name, dt.synthetic.step.id, dt.entity.synthetic_test_step, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context</pre>
|-
|<pre>dt.synthetic.browser.step.user_events.duration</pre>
|Длительность событий пользователя (шаг) [Монитор браузера]
|Продолжительность отдельного шага мониторинга браузера, измеряемая от начала первого пользовательского события этого шага до конца последнего пользовательского события. Источником метрики является новый '''JavaScript'''-код '''RUM'''.
|ms
|<pre>dt.synthetic.monitor.id, dt.entity.synthetic_test, monitor.name, dt.synthetic.step.id, dt.entity.synthetic_test_step, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context</pre>
|-
|<pre>dt.synthetic.browser.step.user_events.total_duration</pre>
|Общая продолжительность событий пользователя (шаг) [Монитор браузера]
|Общая продолжительность каждого шага мониторинга браузера, измеряемая как сумма длительностей всех пользовательских событий на этом шаге. Источником метрики является новый '''JavaScript'''-код '''RUM'''.
|ms
|<pre>dt.synthetic.monitor.id, dt.entity.synthetic_test, monitor.name, dt.synthetic.step.id, dt.entity.synthetic_test_step, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context</pre>
|-
|<pre>dt.synthetic.browser.step.user_actions.duration</pre>
|Длительность действий пользователя (шаг) [Монитор браузера]
|Продолжительность отдельного шага мониторинга браузера, измеряемая от начала первого действия пользователя на этом шаге до конца последнего действия пользователя на этом шаге. Источником метрики является новый '''JavaScript'''-код '''RUM'''.
|ms
|<pre>dt.synthetic.monitor.id, dt.entity.synthetic_test, monitor.name, dt.synthetic.step.id, dt.entity.synthetic_test_step, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context</pre>
|-
|<pre>dt.synthetic.browser.step.user_actions.total_duration</pre>
|Общая продолжительность действий пользователя (шаг) [Монитор браузера]
|Общая продолжительность каждого шага мониторинга браузера, измеряемая как сумма длительностей всех действий пользователя на этом шаге. Источником метрики является новый '''JavaScript'''-код '''RUM'''.
|ms
|<pre>dt.synthetic.monitor.id, dt.entity.synthetic_test, monitor.name, dt.synthetic.step.id, dt.entity.synthetic_test_step, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context</pre>
|}

== Варианты использования ==
Следующие примеры использования демонстрируют, как можно применять метрики в запросах '''DQL'''.

=== Доступность монитора отслеживания ===
Предположим, вам нужно выявить мониторы, у которых возникли проблемы с доступностью.

Следующий запрос использует метрику <code>dt.synthetic.browser.availability</code> и измерение <code>dt.entity.synthetic_test</code> для возврата мониторов, отсортированных по их доступности, при этом наименее доступные мониторы отображаются первыми.<pre>
timeseries {
availability_series = avg(dt.synthetic.browser.availability)
}, by: { dt.entity.synthetic_test }
| fieldsAdd monitor_name = entityName(dt.entity.synthetic_test)
| summarize { monitor_name = takeFirst(monitor_name),
availability = avg(arrayAvg(availability_series)) },
by: {dt.entity.synthetic_test}
| sort availability asc
</pre>Исходный ответ выглядит следующим образом:<pre>
{
"records": [
{
"dt.entity.synthetic_test": "SYNTHETIC_TEST-06AFE815FF214729",
"monitor_name": "Browser monitor1",
"availability": 31.746031746031743
},
{
"dt.entity.synthetic_test": "SYNTHETIC_TEST-094D2E6AA99D2252",
"monitor_name": "Browser monitor2",
"availability": 46.03174603174603
},
{
"dt.entity.synthetic_test": "SYNTHETIC_TEST-0C362AEC36824874",
"monitor_name": "Browser monitor3",
"availability": 100
}
]
}
</pre>

=== Анализ сбоев, вызванных взаимодействием серверов ===
Предположим, вам необходимо проанализировать сбои в работе браузерных мониторов, вызванные взаимодействием с сервером.

В следующем запросе используются метрика <code>dt.synthetic.browser.step.executions</code> и измерения <code>dt.entity.synthetic_test</code>, <code>result.status.message</code> и <code>result.status.code</code>.<pre>
timeseries {
execution_series = sum(dt.synthetic.browser.step.executions)
}, by: { result.status.message,
result.status.code,
dt.entity.synthetic_test},
interval: 15m
| filter result.status.code != 0
| filter (result.status.code < 1000 and result.status.code >= 400) or in(result.status.code, array(10054, 12014, 12183))
| summarize { dt.synthetic.monitor_ids = collectArray(dt.entity.synthetic_test),
execution_number = sum(arraySum(execution_series)),
executions = sum(execution_series[]) },
by: {timeframe, interval, result.status.message, result.status.code}
</pre>

=== Оцените доступность и производительность фронтенда ===
Предположим, вам необходимо оценить доступность и производительность фронтенда.

В следующем запросе используются метрики <code>dt.synthetic.browser.availability</code>, <code>dt.synthetic.browser.step.duration</code> и <code>dt.synthetic.browser.executions</code> вместе с измерением <code>dt.synthetic.monitored_entity_ids</code>.<pre>
timeseries {
availability_series = avg(dt.synthetic.browser.availability),
performance_series = avg(dt.synthetic.browser.step.duration)
},
by: { dt.synthetic.monitored_entity_ids }
| expand entity = dt.synthetic.monitored_entity_ids
| filter isNotNull(entity)
| fieldsAdd entity_name = entityName(entity, type: "dt.entity.application")
| fieldsAdd frontend_name = coalesce(entity_name, entity)
| summarize { frontend_name = takeLast(frontend_name),
availability = avg(arrayAvg(availability_series)),
performance = avg(arrayAvg(performance_series))
}, by: {dt.entity.application = entity}
| sort availability asc, performance desc
| limit 10
| fieldsRename `Frontend` = frontend_name,
`Доступность` = availability,
`Средняя продолжительность события` = performance
</pre>

Метрики мониторинга браузера в синтетическом мониторинге

2026-09-03T16:41:43Z

IKuznetsov: Новая страница: « = Метрики мониторинга браузера в синтетическом мониторинге = == Метрики и параметры == === Монитор === {| class="wikitable" !Ключ метрики !Название метрики !Описание метрики !Единица !Размеры |- |<pre>dt.synthetic.browser.availability</pre> |Уровень доступности (по местоположению) [Монито...»

= Метрики мониторинга браузера в синтетическом мониторинге =

== Метрики и параметры ==

=== Монитор ===
{| class="wikitable"
!Ключ метрики
!Название метрики
!Описание метрики
!Единица
!Размеры
|-
|<pre>dt.synthetic.browser.availability</pre>
|Уровень доступности (по местоположению) [Монитор браузера]
|Коэффициент доступности браузерных мониторов.
| %
|<pre>dt.synthetic.monitor.id, dt.entity.synthetic_test, monitor.name, dt.synthetic.step.id, dt.entity.synthetic_test_step, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context, interpolated</pre>
|-
|<pre>dt.synthetic.browser.executions</pre>
|Количество выполнений (по статусу) [Монитор браузера]
|Количество выполнений монитора.
|считать
|<pre>dt.synthetic.monitor.id, dt.entity.synthetic_test, monitor.name, dt.synthetic.step.id, dt.entity.synthetic_test_step, step.name, step.sequence_number, dt.entity.synthetic_location, dt.maintenance_window_ids, dt.synthetic.monitored_entity_ids, primary_tags.__key__, result.state, result.status.code, result.status.message, dt.security_context</pre>
|-
|<pre>dt.synthetic.browser.duration</pre>
|Продолжительность [Монитор браузера]
|Продолжительность работы браузера, рассчитанная как сумма длительностей всех шагов.
|РС
|<pre>dt.synthetic.monitor.id, dt.entity.synthetic_test, monitor.name, dt.synthetic.step.id, dt.entity.synthetic_test_step, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context</pre>
|-
|<pre>dt.synthetic.browser.classic.total_duration</pre>
|Общая продолжительность (классическая) [Монитор браузера]
|Общая продолжительность работы браузера, измеряемая как сумма общей продолжительности всех шагов. Источник метрики — классический '''JavaScript'''-код '''RUM'''.
|РС
|<pre>dt.synthetic.monitor.id, dt.entity.synthetic_test, monitor.name, dt.synthetic.step.id, dt.entity.synthetic_test_step, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context</pre>
|-
|<pre>dt.synthetic.browser.user_events.duration</pre>
|Длительность событий пользователя [Монитор браузера]
|Продолжительность мониторинга браузера, рассчитываемая как сумма длительностей всех событий пользователя на уровне шагов. Источник метрики — новый '''JavaScript'''-код '''RUM'''.
|РС
|<pre>dt.synthetic.monitor.id, dt.entity.synthetic_test, monitor.name, dt.synthetic.step.id, dt.entity.synthetic_test_step, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context</pre>
|-
|<pre>dt.synthetic.browser.user_events.total_duration</pre>
|Общая продолжительность событий пользователя [Монитор браузера]
|Общая продолжительность мониторинга браузера, измеренная как сумма всех значений метрики User events total duration на уровне шагов. Источник метрики — новый '''JavaScript'''-код '''RUM'''.
|РС
|<pre>dt.synthetic.monitor.id, dt.entity.synthetic_test, monitor.name, dt.synthetic.step.id, dt.entity.synthetic_test_step, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context</pre>
|-
|<pre>dt.synthetic.browser.user_actions.duration</pre>
|Длительность действий пользователя [Монитор браузера]
|Продолжительность мониторинга браузера, рассчитываемая как сумма продолжительности всех действий пользователя на уровне шагов. Источник метрики — новый '''JavaScript'''-код '''RUM'''.
|РС
|<pre>dt.synthetic.monitor.id, dt.entity.synthetic_test, monitor.name, dt.synthetic.step.id, dt.entity.synthetic_test_step, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context</pre>
|-
|<pre>dt.synthetic.browser.user_actions.total_duration</pre>
|Общая продолжительность действий пользователя [Монитор браузера]
|Общая продолжительность мониторинга браузера, измеренная как сумма всех значений метрики User actions total duration на уровне шагов. Источник метрики — новый '''JavaScript'''-код '''RUM'''.
|РС
|<pre>dt.synthetic.monitor.id, dt.entity.synthetic_test, monitor.name, dt.synthetic.step.id, dt.entity.synthetic_test_step, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context</pre>
|}

=== Шаги ===
{| class="wikitable"
!Ключ метрики
!Название метрики
!Описание метрики
!Единица
!Размеры
|-
|<pre>dt.synthetic.browser.step.executions</pre>
|Количество выполнений (шаг) (по статусу) [Монитор браузера]
|Количество выполнений шагов.
|считать
|<pre>dt.synthetic.monitor.id, dt.entity.synthetic_test, monitor.name, dt.synthetic.step.id, dt.entity.synthetic_test_step, step.name, step.sequence_number, dt.entity.synthetic_location, dt.maintenance_window_ids, dt.synthetic.monitored_entity_ids, primary_tags.__key__, result.state, result.status.code, result.status.message, dt.security_context</pre>
|-
|<pre>dt.synthetic.browser.step.duration</pre>
|Длительность (шаг) [Монитор браузера]
|Длительность отдельного шага мониторинга браузера, измеряемая как сумма длительностей событий действий пользователя на этом шаге.
|РС
|<pre>dt.synthetic.monitor.id, dt.entity.synthetic_test, monitor.name, dt.synthetic.step.id, dt.entity.synthetic_test_step, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context</pre>
|-
|<pre>dt.synthetic.browser.step.classic.total_duration</pre>
|Общая продолжительность (классическая) (шаг) [Монитор браузера]
|Общая продолжительность каждого шага мониторинга браузера, измеряемая как сумма всех действий пользователя на этом шаге. Источником метрики является классический '''JavaScript'''-код '''RUM'''.
|РС
|<pre>dt.synthetic.monitor.id, dt.entity.synthetic_test, monitor.name, dt.synthetic.step.id, dt.entity.synthetic_test_step, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context</pre>
|-
|<pre>dt.synthetic.browser.step.user_events.duration</pre>
|Длительность событий пользователя (шаг) [Монитор браузера]
|Продолжительность отдельного шага мониторинга браузера, измеряемая от начала первого пользовательского события этого шага до конца последнего пользовательского события. Источником метрики является новый '''JavaScript'''-код '''RUM'''.
|РС
|<pre>dt.synthetic.monitor.id, dt.entity.synthetic_test, monitor.name, dt.synthetic.step.id, dt.entity.synthetic_test_step, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context</pre>
|-
|<pre>dt.synthetic.browser.step.user_events.total_duration</pre>
|Общая продолжительность событий пользователя (шаг) [Монитор браузера]
|Общая продолжительность каждого шага мониторинга браузера, измеряемая как сумма длительностей всех пользовательских событий на этом шаге. Источником метрики является новый '''JavaScript'''-код '''RUM'''.
|РС
|<pre>dt.synthetic.monitor.id, dt.entity.synthetic_test, monitor.name, dt.synthetic.step.id, dt.entity.synthetic_test_step, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context</pre>
|-
|<pre>dt.synthetic.browser.step.user_actions.duration</pre>
|Длительность действий пользователя (шаг) [Монитор браузера]
|Продолжительность отдельного шага мониторинга браузера, измеряемая от начала первого действия пользователя на этом шаге до конца последнего действия пользователя на этом шаге. Источником метрики является новый '''JavaScript'''-код '''RUM'''.
|РС
|<pre>dt.synthetic.monitor.id, dt.entity.synthetic_test, monitor.name, dt.synthetic.step.id, dt.entity.synthetic_test_step, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context</pre>
|-
|<pre>dt.synthetic.browser.step.user_actions.total_duration</pre>
|Общая продолжительность действий пользователя (шаг) [Монитор браузера]
|Общая продолжительность каждого шага мониторинга браузера, измеряемая как сумма длительностей всех действий пользователя на этом шаге. Источником метрики является новый '''JavaScript'''-код '''RUM'''.
|РС
|<pre>dt.synthetic.monitor.id, dt.entity.synthetic_test, monitor.name, dt.synthetic.step.id, dt.entity.synthetic_test_step, step.name, step.sequence_number, dt.entity.synthetic_location, dt.synthetic.monitored_entity_ids, primary_tags.__key__, dt.security_context</pre>
|}

== Варианты использования ==
Следующие примеры использования демонстрируют, как можно применять метрики в запросах '''DQL'''.

=== Доступность монитора отслеживания ===
Предположим, вам нужно выявить мониторы, у которых возникли проблемы с доступностью.

Следующий запрос использует метрику <code>dt.synthetic.browser.availability</code> и измерение <code>dt.entity.synthetic_test</code> для возврата мониторов, отсортированных по их доступности, при этом наименее доступные мониторы отображаются первыми.<pre>
timeseries {
availability_series = avg(dt.synthetic.browser.availability)
}, by: { dt.entity.synthetic_test }
| fieldsAdd monitor_name = entityName(dt.entity.synthetic_test)
| summarize { monitor_name = takeFirst(monitor_name),
availability = avg(arrayAvg(availability_series)) },
by: {dt.entity.synthetic_test}
| sort availability asc
</pre>Исходный ответ выглядит следующим образом:<pre>
{
"records": [
{
"dt.entity.synthetic_test": "SYNTHETIC_TEST-06AFE815FF214729",
"monitor_name": "Browser monitor1",
"availability": 31.746031746031743
},
{
"dt.entity.synthetic_test": "SYNTHETIC_TEST-094D2E6AA99D2252",
"monitor_name": "Browser monitor2",
"availability": 46.03174603174603
},
{
"dt.entity.synthetic_test": "SYNTHETIC_TEST-0C362AEC36824874",
"monitor_name": "Browser monitor3",
"availability": 100
}
]
}
</pre>

=== Анализ сбоев, вызванных взаимодействием серверов ===
Предположим, вам необходимо проанализировать сбои в работе браузерных мониторов, вызванные взаимодействием с сервером.

В следующем запросе используются метрика <code>dt.synthetic.browser.step.executions</code> и измерения <code>dt.entity.synthetic_test</code>, <code>result.status.message</code> и <code>result.status.code</code>.<pre>
timeseries {
execution_series = sum(dt.synthetic.browser.step.executions)
}, by: { result.status.message,
result.status.code,
dt.entity.synthetic_test},
interval: 15 min
| filter result.status.code != 0
| filter (result.status.code < 1000 and result.status.code >= 400 ) or in(result.status.code, array( 10054 , 12014 , 12183 ))
| summarize { dt.synthetic.monitor_ids = collectArray(dt.entity.synthetic_test),
execution_number = sum(arraySum(execution_series)),
executions = sum(execution_series[]) },
by: {timeframe, interval, result.status.message, result.status.code}
</pre>

=== Оцените доступность и производительность фронтенда ===
Предположим, вам необходимо оценить доступность и производительность фронтенда.

В следующем запросе используются метрики <code>dt.synthetic.browser.availability</code>, <code>dt.synthetic.browser.step.duration</code> и <code>dt.synthetic.browser.executions</code> вместе с измерением <code>dt.synthetic.monitored_entity_ids</code>.<pre>
timeseries {
availability_series = avg(dt.synthetic.browser.availability),
performance_series = avg(dt.synthetic.browser.step.duration)
},
by: { dt.synthetic.monitored_entity_ids }
| expand entity = dt.synthetic.monitored_entity_ids
| filter isNotNull(entity)
| fieldsAdd entity_name = entityName(entity, type: "dt.entity.application" )
| fieldsAdd frontend_name = coalesce(entity_name, entity)
| summarize { frontend_name = takeLast(frontend_name),
availability = avg(arrayAvg(availability_series)),
performance = avg(arrayAvg(performance_series))
}, by: {dt.entity.application = entity}
| sort availability asc, performance desc
| limit 10
| fieldsRename `Frontend` = frontend_name,
`Доступность` = availability,
`Средняя продолжительность события` = performance
</pre>

Метрики HTTP-монитора в синтетическом мониторинге

2026-09-03T16:33:19Z

IKuznetsov: Новая страница: « = Метрики HTTP-монитора в синтетическом мониторинге = == Метрики и параметры == === Монитор === {| class="wikitable" !Ключ метрики !Название метрики !Описание метрики !Единица !Размеры |- |<code>dt.synthetic.http.availability</code> |Уровень доступности (по локации) [HTTP-монитор] |Коэффициент...»

= Метрики HTTP-монитора в синтетическом мониторинге =

== Метрики и параметры ==

=== Монитор ===
{| class="wikitable"
!Ключ метрики
!Название метрики
!Описание метрики
!Единица
!Размеры
|-
|<code>dt.synthetic.http.availability</code>
|Уровень доступности (по локации) [HTTP-монитор]
|Коэффициент доступности HTTP-мониторов.
| %
|<code>dt.synthetic.monitor.id</code>
<code>dt.entity.http_check</code>
<code>monitor.name</code>
<code>dt.synthetic.step.id</code>
<code>dt.entity.http_check_step</code>
<code>step.name</code>
<code>step.sequence_number</code>
<code>dt.entity.synthetic_location</code>
<code>dt.synthetic.monitored_entity_ids</code>
<code>primary_tags.__key__</code>
<code>dt.security_context</code>
<code>interpolated</code>
|-
|<code>dt.synthetic.http.dns</code>
|Время поиска DNS (по локации) [HTTP-монитор]
|Время, затраченное на разрешение имени хоста для целевого URL-адреса, суммированное по всем запросам.
|мс
|(аналогично предыдущему)
|-
|<code>dt.synthetic.http.download_time</code>
|Время загрузки (по локации) [HTTP-монитор]
|Время, затраченное на загрузку HTTP-ответа для всех этапов. Этот показатель не основан на показателе из Синтетического мониторинга Классического.
|мс
|(аналогично)
|-
|<code>dt.synthetic.http.duration</code>
|Продолжительность (по локации) [HTTP-монитор]
|Длительность, равная сумме всех запросов.
|мс
|(аналогично)
|-
|<code>dt.synthetic.http.duration_threshold</code>
|Пороговое значение длительности [HTTP-монитор]
|Пороговое значение производительности для суммы всех запросов.
|мс
|(аналогично)
|-
|<code>dt.synthetic.http.executions</code>
|Количество выполнений (по статусу) [HTTP-монитор]
|Количество выполнений монитора. Параметр <code>maintenance_window</code> доступен только в Синтетическом мониторинге Классическом.
|шт.
|<code>dt.synthetic.monitor.id</code>
<code>dt.entity.http_check</code>
<code>monitor.name</code>
<code>dt.synthetic.step.id</code>
<code>dt.entity.http_check_step</code>
<code>step.name</code>
<code>step.sequence_number</code>
<code>dt.entity.synthetic_location</code>
<code>result.status.message</code>
<code>result.status.code</code>
<code>result.state</code>
<code>result.http_status.code</code>
<code>dt.maintenance_window_ids</code>
<code>dt.synthetic.monitored_entity_ids</code>
<code>primary_tags.__key__</code>
<code>dt.security_context</code>
<code>maintenance_window</code>
|-
|<code>dt.synthetic.http.response_size</code>
|Размер ответа (по локации) [HTTP-монитор]
|Размер ответа, равный сумме всех запросов.
|КБ
|(аналогично duration)
|-
|<code>dt.synthetic.http.tcp_connect_time</code>
|Время установления TCP-соединения (по локации) [HTTP-монитор]
|Время, затраченное на установление TCP-соединения с сервером (включая SSL) для суммы всех запросов.
|мс
|(аналогично)
|-
|<code>dt.synthetic.http.time_to_first_byte</code>
|Время до первого байта (по локации) [HTTP-монитор]
|Время, необходимое для получения первого байта ответа от сервера, соответствующих кэшей приложений или локального ресурса. Рассчитывается как сумма всех шагов.
|мс
|(аналогично)
|-
|<code>dt.synthetic.http.tls_handshake_time</code>
|Время установления TLS-соединения (по локации) [HTTP-монитор]
|Время, затраченное на завершение TLS-рукопожатия для суммы всех запросов.
|мс
|(аналогично)
|-
|<code>dt.synthetic.http.redirects_count</code>
|Количество перенаправлений (по локации) [HTTP-монитор]
|Количество перенаправлений для суммы всех запросов.
|шт.
|(аналогично)
|-
|<code>dt.synthetic.http.redirects_time</code>
|Время переадресации (по локации) [HTTP-монитор]
|Время, затраченное на выполнение перенаправлений для суммы всех запросов.
|мс
|(аналогично)
|-
|<code>dt.synthetic.http.waiting_time</code>
|Время ожидания (по локации) [HTTP-монитор]
|Время, необходимое серверу для ответа первым байтом за все шаги. Этот показатель не основан на показателе из Синтетического мониторинга Классического.
|мс
|(аналогично)
|}

=== Шаги ===
{| class="wikitable"
!Ключ метрики
!Название метрики
!Описание метрики
!Единица
!Размеры
|-
|<code>dt.synthetic.http.request.dns</code>
|Время выполнения DNS-запроса (по запросу, локации) [HTTP-монитор]
|Время, необходимое для определения имени хоста целевого URL-адреса для отдельных HTTP-запросов.
|мс
|(аналогично монитору)
|-
|<code>dt.synthetic.http.request.download_time</code>
|Время загрузки (по шагам, локации) [HTTP-монитор]
|Время, затраченное на разрешение имени хоста для целевого URL-адреса на отдельных этапах HTTP-запроса. Этот показатель не основан на показателе из Синтетического мониторинга Классического.
|мс
|(аналогично)
|-
|<code>dt.synthetic.http.request.duration</code>
|Продолжительность (по запросу, локации) [HTTP-монитор]
|Длительность отдельных HTTP-запросов.
|мс
|(аналогично)
|-
|<code>dt.synthetic.http.request.executions</code>
|Количество выполненных запросов [HTTP-монитор]
|Количество выполненных запросов.
|шт.
|(аналогично executions у монитора)
|-
|<code>dt.synthetic.http.request.response_size</code>
|Размер ответа (по запросу, локации) [HTTP-монитор]
|Размер ответа отдельных HTTP-запросов.
|КБ
|(аналогично)
|-
|<code>dt.synthetic.http.request.tcp_connect_time</code>
|Время установления TCP-соединения (по запросу, локации) [HTTP-монитор]
|Время, необходимое для установления TCP-соединения с сервером (включая SSL) для отдельных HTTP-запросов.
|мс
|(аналогично)
|-
|<code>dt.synthetic.http.request.time_to_first_byte</code>
|Время до первого байта (по запросу, локации) [HTTP-монитор]
|Время, необходимое для получения первого байта ответа от сервера, соответствующих кэшей приложений или локального ресурса. Рассчитывается для отдельных HTTP-запросов.
|мс
|(аналогично)
|-
|<code>dt.synthetic.http.request.tls_handshake_time</code>
|Время установления TLS-соединения (по запросу, локации) [HTTP-монитор]
|Время, необходимое для завершения TLS-рукопожатия для отдельных HTTP-запросов.
|мс
|(аналогично)
|-
|<code>dt.synthetic.http.request.redirects_count</code>
|Количество перенаправлений (запросов) [HTTP-монитор]
|Количество перенаправлений.
|шт.
|(аналогично)
|-
|<code>dt.synthetic.http.request.redirects_time</code>
|Время перенаправления (запрос) [HTTP-монитор]
|Время, затраченное на выполнение перенаправлений.
|мс
|(аналогично)
|-
|<code>dt.synthetic.http.request.waiting_time</code>
|Время ожидания (шаг) (по локации) [HTTP-монитор]
|Время, необходимое серверу для ответа первым байтом. Этот показатель не основан на показателе из Синтетического мониторинга Классического.
|мс
|(аналогично)
|}

=== Устаревший ===
{| class="wikitable"
!Ключ метрики
!Название метрики
!Описание метрики
!Единица
!Размеры
|-
|<code>dt.synthetic.http.availability.excluding_maintenance_windows</code>
|Коэффициент доступности без учета периодов технического обслуживания (по локации) [HTTP-монитор]
|Показатель доступности HTTP-мониторов без учета периодов технического обслуживания. Этот показатель отсутствует в последней версии Ключ-АСТРОМ.
| %
|<code>dt.entity.http_check</code>
<code>dt.entity.synthetic_location</code>
|}

== Варианты использования ==
Следующие примеры демонстрируют, как можно применять метрики в запросах '''DQL'''.

=== Доступность монитора отслеживания ===
Предположим, вам нужно выявить мониторы, у которых возникли проблемы с доступностью.

Следующий запрос использует метрику <code>dt.synthetic.http.availability</code> и измерение <code>dt.entity.http_check</code> для возврата мониторов, отсортированных по их доступности, при этом наименее доступные мониторы отображаются первыми.<pre>
timeseries {
availability_series = avg(dt.synthetic.http.availability) },
by: { dt.entity.http_check }
| fieldsAdd monitor_name = entityName(dt.entity.http_check)
| summarize { monitor_name = takeFirst(monitor_name),
availability = avg(arrayAvg(availability_series)) },
by: {dt.entity.http_check}
| sort availability asc
</pre>Исходный ответ выглядит следующим образом:<pre>
{
"records": [
{
"dt.entity.http_check": "HTTP_CHECK-D1DF6416D98DF200",
"monitor_name": "HTTP monitor",
"availability": 0
},
{
"dt.entity.http_check": "HTTP_CHECK-DD85DA9C14659614",
"monitor_name": "HTTP monitor2",
"availability": 31.746031746031743
},
{
"dt.entity.http_check": "HTTP_CHECK-ADA43EC2FFF9115D",
"monitor_name": "HTTP monitor3",
"availability": 46.03174603174603
},
{
"dt.entity.http_check": "HTTP_CHECK-0135CB5835BEAEA8",
"monitor_name": "HTTP monitor4",
"availability": 100
},
...
]
}
</pre>

=== Определите наиболее проблемные локации ===
Предположим, вам нужно определить локации с наименьшей доступностью и самым медленным средним временем ответа на HTTP-запросы.

В следующем запросе используются метрики <code>dt.synthetic.http.availability</code> и <code>dt.synthetic.http.request.duration</code>, а также измерение <code>dt.entity.synthetic_location</code>.<pre>
timeseries {
availability_series = avg(dt.synthetic.http.availability),
performance_series = avg(dt.synthetic.http.request.duration) },
by: { dt.entity.synthetic_location }
| fieldsAdd location_name = entityName(dt.entity.synthetic_location)
| summarize { location_name = takeFirst(location_name),
availability = avg(arrayAvg(availability_series)),
request_duration = avg(arrayAvg(performance_series))},
by: {dt.entity.synthetic_location}
| sort availability asc, request_duration desc
</pre>Исходный ответ выглядит следующим образом:<pre>
{
"records": [
{
"dt.entity.synthetic_location": "SYNTHETIC_LOCATION-00000000000003B3",
"location_name": "Лас-Вегас",
"availability": 23.809523809523807,
"request_duration": 2662.3457875457875
},
{
"dt.entity.synthetic_location": "SYNTHETIC_LOCATION-0000000000000004",
"location_name": "Amazon US East (N. Virginia)",
"availability": 60.714285714285715,
"request_duration": 1297.4880952380952
},
{
"dt.entity.synthetic_location": "SYNTHETIC_LOCATION-2D4A33F9E13D70E7",
"location_name": "Осло",
"availability": 66.66666666666667,
"request_duration": 1114.1904761904761
},
{
"dt.entity.synthetic_location": "SYNTHETIC_LOCATION-0000000000000064",
"location_name": "Гданьск",
"availability": 70,
"request_duration": 294.2772881374772
},
{
"dt.entity.synthetic_location": "SYNTHETIC_LOCATION-9FFF47C604374908",
"location_name": "Дублин",
"availability": 72.06349206349208,
"request_duration": 1146.2952380952381
},
...
]
}
</pre>

=== Идентификация кодов состояния, полученных в ходе выполнения тестов ===
Предположим, вам необходимо определить коды состояния ошибок (>= 400), полученные во время выполнения тестов.

В следующем запросе используются метрика <code>dt.synthetic.http.executions</code> и измерение <code>result.http_status.code</code>.<pre>
timeseries {
execution_series = sum(dt.synthetic.http.executions)
}, by: { result.http_status.code }
| filter result.http_status.code >= 400
| summarize { executions = sum(execution_series[]),
status.code = toString(takeFirst(result.http_status.code)) },
by: { timeframe, interval, result.http_status.code}
</pre>Визуализированный ответ выглядит следующим образом:

Использование сегментов для синтетического мониторинга

2026-09-03T16:30:33Z

IKuznetsov: Новая страница: « = Использование сегментов для синтетического мониторинга = При анализе синтетических данных вы можете использовать сегменты в качестве удобных фильтров. Например, вы можете отфильтровать мониторы, доступность и производительность которых вы хотите...»

= Использование сегментов для синтетического мониторинга =
При анализе синтетических данных вы можете использовать сегменты в качестве удобных фильтров. Например, вы можете отфильтровать мониторы, доступность и производительность которых вы хотите просмотреть в '''Синтетическом мониторинге''', '''Дашбордах''' или '''Блокнотах'''.

== Предварительные требования ==

* Убедитесь, что у вас есть права доступа <code>storage:filter-segments:write</code> и <code>storage:filter-segments:read</code>. Чтобы узнать, как настроить права доступа, см. раздел «Права доступа в Хранилище данных».
* Если вы используете частные синтетические локации, вам необходимо установить АктивныйШлюз версии 1.331+.
* Подробнее о сегментах см. в разделе «Сегменты».

== Создайте сегмент для фильтрации синтетических данных ==

# Перейдите в '''Настройки''' > '''Сегментация среды''' > '''Сегменты'''.
# Выберите '''Сегмент'''.
# Введите название сегмента.
# Укажите '''Видимость'''. Подробнее см. раздел «Видимость сегментов».
# (Необязательно) Добавьте переменную, выбрав '''Новая переменная {$}''' и введя '''DQL'''-запрос. Подробнее см. раздел «Переменные в сегментах».
# Отфильтруйте мониторы по одному из следующих критериев:
#* '''Название монитора''': В разделе '''Данные (все типы)''' выберите '''Дополнительно''' и выберите '''Сущности по типу'''. Затем выполните следующие действия:
#** В поле фильтра раздела '''Данные (все типы)''' укажите имя монитора, используя условие фильтра <code>monitor.name</code>, как показано в следующем примере.
<pre>
monitor.name = "Example Monitor"
</pre>

#** В поле фильтра раздела '''Сущности''' укажите то же имя монитора, используя условие фильтра <code>entity.name</code>, как в следующем примере.
<pre>
entity.name = "Example Monitor"
</pre>

#* '''Локации, к которым привязаны мониторы''': В поле фильтра раздела '''Данные (все типы)''' укажите идентификаторы локаций, используя условия фильтра <code>assignedLocations</code> и <code>dt.entity.synthetic_location</code>, как в примере ниже.
<pre>
assignedLocations = "SYNTHETIC_LOCATION-9FFF47C604374908" OR dt.entity.synthetic_location = "SYNTHETIC_LOCATION-9FFF47C604374908"
</pre>

#* '''Контекст безопасности''': В поле фильтра раздела '''Данные (все типы)''' укажите контекст безопасности, используя условие фильтра <code>dt.security_context</code>, как показано в следующем примере.
<pre>
dt.security_context = "Synthetic"
</pre>

#** Для сред, созданных до января 2026 года, значение контекста безопасности, предоставляемое синтетической телеметрией, формируется на основе имён менеджмент зон, к которым принадлежат данные мониторы.
#* '''Идентификатор монитора''': В разделе '''Данные (все типы)''' выберите '''Дополнительно''' и затем '''Сущности по типу'''. После этого выполните следующие действия:
#** В поле фильтра раздела '''Данные (все типы)''' укажите идентификаторы мониторов, как показано в примере ниже.
<pre>
dt.entity.http_check = HTTP_CHECK-89A9309667898FB1 OR dt.entity.synthetic_test = SYNTHETIC_TEST-EC7EA74353431688 OR dt.entity.multiprotocol_monitor = MULTIPROTOCOL_MONITOR-F21AC791C60EC214
</pre>

#*** Используйте условие фильтра <code>dt.entity.synthetic_test</code> для фильтрации браузерных мониторов.
#*** Используйте условие фильтра <code>dt.entity.http_check</code> для фильтрации '''HTTP'''-мониторов.
#*** Используйте условие фильтра <code>dt.entity.multiprotocol_monitor</code> для фильтрации мониторов '''NAM'''.
#** В поле фильтра раздела '''Сущности''' укажите те же идентификаторы мониторов, используя условие фильтра <code>id</code>, как в следующем примере.
<pre>
id = HTTP_CHECK-89A9309667898FB1 OR id = SYNTHETIC_TEST-EC7EA74353431688 OR id = MULTIPROTOCOL_MONITOR-F21AC791C60EC214
</pre>

# Выберите '''Сохранить'''.

== Используйте сегмент для фильтрации данных ==

=== Чтобы применить сегмент в Синтетическом мониторинге ===

# Перейдите в раздел '''Синтетический мониторинг'''.
# В верхнем левом углу страницы выберите нужный сегмент.
# Теперь вы можете видеть только отфильтрованные мониторы.

=== Чтобы применить сегмент на дашбордах или в блокнотах ===

# Перейдите в раздел '''Дашборды''' или '''Блокноты'''.
# Выберите ранее созданный дашборд или блокнот, или создайте новый.
#* Например, вы можете выбрать одну из следующих готовых дашбордов:
#* '''Synthetic web availability and performance''' — предоставляет подробную информацию о доступности и производительности браузерных и '''HTTP'''-мониторов.
#* '''Synthetic network availability monitoring''' — предоставляет подробную информацию о результатах мониторинга, полученных с помощью мониторов '''NAM'''.
# Выберите '''Готовые дашборды''', найдите нужный дашборд (например, '''Synthetic web availability and performance''') в поле '''Поиск документов''', а затем выберите её.
# Выберите сегмент.
# Теперь вы можете просматривать данные только для отфильтрованных мониторов.
# После выбора вы также можете перейти к разделу '''Сегменты''', выбрав '''Управление сегментами''' в списке сегментов.

== Связанные темы ==

* Сегменты
* Метрики синтетического мониторинга

Контроль доступа к синтетическому мониторингу

2026-09-03T16:29:30Z

IKuznetsov: Новая страница: « = Контроль доступа к синтетическому мониторингу = Ключ-АСТРОМ '''Синтетический мониторинг''' полностью интегрирован в последнюю версию платформы Ключ-АСТРОМ. На этой странице объясняется, как получить доступ к конфигурации, сущностям и данным '''Синтети...»

= Контроль доступа к синтетическому мониторингу =
Ключ-АСТРОМ '''Синтетический мониторинг''' полностью интегрирован в последнюю версию платформы Ключ-АСТРОМ. На этой странице объясняется, как получить доступ к конфигурации, сущностям и данным '''Синтетического мониторинга''' через все точки входа платформы — '''Синтетический мониторинг''', '''Блокноты''', '''Дашборды''' и '''API''' — а также необходимые разрешения, контексты безопасности и то, как классические разрешения применяются в последней версии Ключ-АСТРОМ.

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

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

= Обзор =
В последней версии Ключ-АСТРОМ доступ к синтетическому мониторингу охватывает три категории:

* '''Настройка''': Определение мониторов и локаций, включая создание, редактирование, удаление и чтение параметров мониторов.
* '''Сущности''': Отслеживаемые объекты-сущности, представляющие собой синтетические мониторы и локации для фильтрации, корреляции и представления данных на уровне сущностей в рамках всей платформы.
* '''Данные''': Результаты выполнения, метрики и события, хранящиеся в Хранилище данных, такие как показатели доступности, время отклика, данные каскадной модели и события оповещения.

Все три категории доступны с нескольких точек входа на платформу. После установки соответствующих разрешений одна и та же конфигурация, сущности и данные будут доступны независимо от места вашей работы.
{| class="wikitable"
!Точка входа
!Конфигурация
!Сущности
!Данные
|-
|'''Синтетический мониторинг'''
|Создавайте, редактируйте и удаляйте мониторы и локации.
|Отслеживание объектов через пользовательский интерфейс.
|Результаты, доступность, производительность
|-
|'''Дашборды'''
|Неприменимо
|Запросы к сущностям через '''DQL'''
|Показатели и тенденции
|-
|'''Блокноты'''
|Неприменимо
|Запросы к сущностям через '''DQL'''
|Запросы на языке запросов Ключ-АСТРОМ ('''DQL''') по событиям и метрикам.
|-
|'''API''' Ключ-АСТРОМ
|Полное создание, чтение, обновление и удаление ('''CRUD''') через '''API''' платформы.
|Запрос через '''API''' '''DQL'''-запросов платформы
|Запрос через '''API''' хранилища платформы
|-
|'''Рабочие процессы'''
|Запуск выполнения по требованию
|Неприменимо
|Употребить результаты
|}
Все точки входа используют одни и те же базовые разрешения '''IAM''', описанные в следующем разделе.

= Разрешения =
Доступ к синтетическим данным на всех точках входа платформы контролируется политиками '''IAM'''. Назначайте политики '''IAM''' пользователям или группам в разделе '''Управление учетными записями''' > '''Управление идентификацией и доступом''' > '''Политики'''.

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

== Настройка монитора и локации ==
Эти разрешения определяют, кто может просматривать, создавать, изменять и запускать мониторы и локации '''Синтетического мониторинга'''. Ключ-АСТРОМ проверяет их при использовании '''Синтетического мониторинга''' или вызове '''API''' '''Синтетического мониторинга'''.
{| class="wikitable"
!Разрешение
!Доступ предоставлен
|-
|<code>synthetic:monitors:read</code>
|Просмотр определений и настроек монитора
|-
|<code>synthetic:monitors:write</code>
|Создавайте, редактируйте и удаляйте мониторы.
|-
|<code>synthetic:monitors:execute</code>
|Запускать выполнение мониторов по запросу
|-
|<code>synthetic:locations:read</code>
|Просмотреть общедоступные и частные синтетические локации
|-
|<code>synthetic:locations:write</code>
|Создание и настройка частных локаций
|-
|<code>geolocation:locations:lookup</code>
|Разрешение географических данных для настройки частной локации
|-
|<code>synthetic:environment-configuration:read</code>
|Просмотр конфигурации '''Синтетического мониторинга''' для всего арендатора
|-
|<code>synthetic:environment-configuration:write</code>
|Обновить синтетическую конфигурацию для всего клиента.
|}

== Реквизиты для входа ==
Эти разрешения регулируют доступ к записям хранилища учетных данных, используемым в аутентификации синтетического монитора.
{| class="wikitable"
!Разрешение
!Доступ предоставлен
|-
|<code>credential-vault:entries:read</code>
|Просмотреть сохраненные учетные данные
|-
|<code>credential-vault:entries:write</code>
|Создание и управление сохраненными учетными данными
|-
|<code>credential-vault:entries:admin</code>
|Перезаписать сохраненные учетные данные
|}

== Синтетические данные (метрики и события) ==
Эти разрешения контролируют доступ к результатам синтетического тестирования, хранящимся в Хранилище данных, включая метрики доступности, время ответа, события выполнения и данные каскадной модели. Помимо просмотра результатов синтетического тестирования, они необходимы для '''Дашбордов''', '''Блокнотов''', '''DQL'''-запросов и метрик '''API'''.
{| class="wikitable"
!Разрешение
!Доступ предоставлен
|-
|<code>storage:buckets:read</code>
|Общий доступ к Хранилищу данных для чтения; базовые права доступа для указанных ниже разрешений на хранение данных.
|-
|<code>storage:metrics:read</code>
|Запрос синтетических метрик, таких как доступность, длительность, количество выполнений и длительность шага.
|-
|<code>storage:events:read</code>
|События синтетического выполнения запросов и события оповещения
|-
|<code>storage:user.events:read</code>
|Запрос синтетических событий на уровне пользователя.
|-
|<code>storage:files:read</code>
|Запросы к вложенным файлам и двоичным данным, хранящимся в Хранилище данных.
|-
|<code>storage:system:read</code>
|Запрос событий использования платежных услуг, хранящихся в Хранилище данных.
|}
'''Синтетический мониторинг''' Для корректной работы '''Синтетического мониторинга''' требуются дополнительные разрешения. Полный список см. в разделе '''Разрешения Синтетического мониторинга'''.

== Сущности ==
Это разрешение контролирует доступ к отслеживаемым записям сущностей — синтетическому монитору и объектам локации, как они отображаются в модели сущностей (используется для фильтрации, корреляции и представлений, ориентированных на сущности).
{| class="wikitable"
!Разрешение
!Доступ предоставлен
|-
|<code>storage:entities:read</code>
|Запрос синтетических объектов мониторинга и локации из Хранилища данных
|-
|<code>storage:smartscape:read</code>
|Запрос узлов '''Smartscape'''
|}
Для доступа к вкладке '''Частные локации''' в '''Синтетическом мониторинге''' требуются разрешения <code>storage:smartscape:read</code> и <code>storage:metrics:read</code>, предоставленные без условия контекста безопасности, а также соответствующие разрешения на настройку локаций (<code>synthetic:locations:read</code> для просмотра локаций, <code>synthetic:locations:write</code> для управления ими). Эти разрешения должны быть применены ко всему арендатору, чтобы вкладка была доступна.

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

Следующие политики по умолчанию включают разрешения, относящиеся к синтетическим процессам:
{| class="wikitable"
!Политика по умолчанию
!Включен синтетический доступ
|-
|Администратор
|Полный доступ к API платформы: <code>synthetic:monitors:read/write/execute</code>, <code>synthetic:locations:read/write</code>, <code>synthetic:environment-configuration:read/write</code>, <code>credential-vault:entries:read/write</code>. Также включает классический <code>environment:roles:manage-settings</code>.
|-
|Пользователь Pro
|<code>synthetic:monitors:read/write/execute</code>, <code>synthetic:locations:read/write</code>, <code>synthetic:environment-configuration:read</code>, <code>credential-vault:entries:read/write</code>. Также включает классический <code>environment:roles:viewer</code>.
|-
|Стандартный пользователь
|Доступ к API платформы только для чтения: <code>synthetic:monitors:read</code>, <code>synthetic:locations:read</code>. Также включает классический <code>environment:roles:viewer</code>.
|}
Политики доступа Ключ-АСТРОМ, такие как «Администратор», «Профессиональный пользователь» и «Стандартный пользователь», отделены от политик доступа к данным, которые контролируют доступ к данным, хранящимся в Хранилище данных. Политики доступа Ключ-АСТРОМ по умолчанию не включают разрешения на чтение данных. Чтобы разрешить пользователям просматривать результаты выполнения, метрики и события в '''Синтетическом мониторинге''', '''Дашбордах''' или '''Блокнотах''', назначьте политику доступа к данным, например, «Чтение метрик + Чтение событий + Чтение сущностей» для доступа к определенным типам данных (метрики, события, сущности), «Чтение по умолчанию для мониторинга хранилища» для большинства данных '''Синтетического мониторинга''' или «Полный доступ к чтению данных Хранилища данных» для полного доступа к Хранилищу данных, включая события пользователей.

Политики по умолчанию могут быть назначены группам пользователей на уровне учетной записи (где они применяются ко всем средам) или на уровне среды. Их можно найти в обзоре политик в разделе '''Управление учетными записями'''.

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

== Только для просмотра ==
Права доступа Ключ-АСТРОМ:

* <code>synthetic:monitors:read</code>
* <code>synthetic:locations:read</code>
* <code>synthetic:environment-configuration:read</code>

Политика доступа к данным: '''Мониторинг по умолчанию для хранилища (чтение)''', которая охватывает синтетические метрики, события и сущности.

== Просмотреть и выполнить ==
Права доступа Ключ-АСТРОМ включают все перечисленные выше, а также:

* <code>synthetic:monitors:read</code>
* <code>synthetic:locations:read</code>
* <code>synthetic:environment-configuration:read</code>
* <code>synthetic:monitors:execute</code>

Политика доступа к данным: '''Мониторинг хранилища по умолчанию (чтение)'''.

== Полное управление монитором ==
Права доступа Ключ-АСТРОМ включают все перечисленные выше, а также:

* <code>synthetic:monitors:read</code>
* <code>synthetic:locations:read</code>
* <code>synthetic:environment-configuration:read</code>
* <code>synthetic:monitors:write</code>
* <code>synthetic:monitors:execute</code>
* <code>synthetic:locations:write</code>
* <code>geolocation:locations:lookup</code>
* <code>synthetic:environment-configuration:write</code>

Политика доступа к данным: '''Мониторинг хранилища по умолчанию (чтение)'''.

= Контекст безопасности =
Контексты безопасности — это значения, устанавливаемые на отдельных синтетических мониторах, которые позволяют осуществлять детальный контроль доступа. Если вы знакомы с Ключ-АСТРОМ Classic, вы можете рассматривать контексты безопасности как функцию, аналогичную зонам управления. Вместо группировки объектов в зоны, вы устанавливаете значения контекстов безопасности на мониторах и соответствующим образом определяете область действия политик '''IAM'''.

Если вы используете частные синтетические локации, установите АктивныйШлюз версии 1.331+. Более ранние версии не обогащают метрики и события, создаваемые при выполнении синтетического монитора, значением контекста безопасности монитора. Без этого обогащения политики '''IAM''', ограниченные контекстами безопасности, не могут предоставлять доступ к данным выполнения.

== Как работает контекст безопасности ==
Монитор может иметь одно или несколько значений контекста безопасности. Предоставить разрешения платформе можно двумя способами:

* '''В масштабах всего арендатора''': разрешение распространяется на все синтетические мониторы в среде. Политика не имеет границ контекста безопасности.
* '''Ограничение по контекстам безопасности''': разрешение применяется только к мониторам, имеющим хотя бы один из указанных контекстов безопасности, которые выражены в качестве условия в границах политики '''IAM'''.

Это означает, что у двух пользователей может быть <code>synthetic:monitors:read</code>: один доступ ко всем мониторам, а другой — только к тем, контекст безопасности которых соответствует значениям, разрешенным их политикой.

Ограничения контекста безопасности применяются только к пользователям с новыми разрешениями синтетической платформы. Пользователи, имеющие только классические разрешения, всегда имеют доступ ко всему арендатору, и контексты безопасности не ограничивают их видимость.

== Правила создания мониторов с контекстом безопасности ==

* Пользователь, которому ограничен доступ к определенным контекстам безопасности, должен указать как минимум один контекст безопасности, к которому у него есть доступ, при создании монитора. Если пользователь не предоставит доступный контекст безопасности, создание монитора будет отклонено.
* Пользователь с правами доступа, действующими в масштабе всего арендатора, может создавать мониторы с контекстом безопасности или без него.
* Контексты безопасности могут быть определены только пользователями с правами доступа к '''API''' платформы. Поскольку контексты безопасности — это концепция последней версии Ключ-АСТРОМ, не имеющая аналога в классической модели разрешений, для установки или изменения назначений контекстов безопасности требуется последняя версия Ключ-АСТРОМ '''IAM'''.
* Монитор поддерживает максимум 10 значений контекста безопасности.

== Настройка границ контекста безопасности в политиках IAM ==
Чтобы ограничить доступ определенными контекстами безопасности, добавьте условие в оператор политики.<pre>
ALLOW synthetic:monitors:read
WHERE synthetic:dt.security_context IN ("team-a", "platform-ops");
</pre>Пользователь с такой политикой имеет доступ к '''API''' платформы только к мониторам с контекстом безопасности <code>team-a</code> или <code>platform-ops</code>.

Для обеспечения ограниченного доступа к объектам в '''Синтетическом мониторинге''', '''Дашбордах''' и '''Блокнотах''' объедините разрешения '''Синтетического мониторинга''' с ограничением доступа <code>storage:smartscape:read</code> и <code>storage:dt.security_context</code>.<pre>
ALLOW storage:smartscape:read
WHERE storage:dt.security_context IN ("team-a", "platform-ops");
</pre>Контексты безопасности выполняют ту же функцию, что и зоны управления в Ключ-АСТРОМ Classic — определяют, кто может видеть и управлять какими мониторами.

== Разделение мониторов между командами в рамках общего клиента ==
Нескольким командам, использующим один и тот же клиент Ключ-АСТРОМ, часто требуется изолированная видимость — каждая команда должна видеть и управлять только своими мониторами, не имея доступа к мониторам, принадлежащим другим командам.

Присвойте каждому монитору команды отдельное значение контекста безопасности (например, <code>team-a</code> и <code>team-b</code>), затем создайте отдельную политику '''IAM''' для каждой команды, которая будет обусловливать все разрешения для синтетических приложений этим значением:<pre>
ALLOW synthetic:monitors:read, synthetic:monitors:write, synthetic:monitors:execute
WHERE synthetic:dt.security_context IN ("team-a");

ALLOW storage:metrics:read, storage:events:read, storage:user.events:read, storage:smartscape:read
WHERE storage:dt.security_context IN ("team-a");
</pre>Пользователи в группе <code>team-a</code> могут создавать и управлять мониторами, запускать их выполнение и просматривать результаты — но только для мониторов, которые содержат контекст безопасности <code>team-a</code>. Мониторы, принадлежащие группе <code>team-b</code>, им не видны, и наоборот.

== Раздельный доступ к синтетическим и RUM-данным ==
Организациям часто необходимо предоставлять определенным пользователям доступ только к синтетическим данным, не раскрывая при этом данные реального мониторинга пользователей. Это распространенное требование для команд, которые управляют синтетическими мониторами, но не несут ответственности за мониторинг реальных пользователей.

Проблема заключается в том, что разрешение <code>storage:user.events:read</code>, необходимое '''Синтетическому мониторингу''' для отображения событий выполнения, также распространяется на пользовательские события '''Мониторинга реального пользователя'''. Предоставление разрешения без каких-либо условий обеспечивает доступ как к данным '''Синтетического мониторинга''', так и к данным '''Мониторинга реального пользователя'''.

Контексты безопасности решают эту проблему, поскольку пользовательские события, генерируемые синтетическими мониторами, обогащаются значениями контекста безопасности, установленными на этих мониторах. Это означает, что условие <code>storage:dt.security_context</code> работает так же, как и <code>synthetic:dt.security_context</code> для разрешений <code>synthetic:monitors:*</code>.

Следующая политика предоставляет доступ к синтетическим мониторам и событиям их выполнения в рамках определенного контекста безопасности, не раскрывая при этом никаких данных '''Мониторинга реального пользователя''':<pre>
ALLOW synthetic:monitors:read, synthetic:monitors:execute
WHERE synthetic:dt.security_context IN ("synthetic-only");

ALLOW storage:metrics:read, storage:events:read, storage:user.events:read
WHERE storage:dt.security_context IN ("synthetic-only");
</pre>Пользователь с такой политикой может открыть '''Синтетический мониторинг''', просмотреть мониторы, помеченные тегом <code>synthetic-only</code>, и увидеть результаты их выполнения, но события пользователя из сессий '''Мониторинга реального пользователя''', которые не несут контекста безопасности '''Синтетического мониторинга''', остаются вне сферы действия его разрешений.

= Синхронизация зоны управления =
С внедрением Ключ-АСТРОМ версии 1.343 Ключ-АСТРОМ выполняет однократную синхронизацию для сред, созданных до января 2026 года. Во время этой синхронизации зоны управления, к которым принадлежит каждый синтетический монитор, сопоставляются со значениями контекста безопасности с идентичными именами на этом мониторе. Это сохраняет существующую структуру группировки без необходимости ручного переназначения.

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

Эта одноразовая синхронизация не активирует управление доступом на основе контекста безопасности. Чтобы использовать контексты безопасности в качестве основы для ограниченных разрешений, вам по-прежнему необходимо назначить разрешения синтетической платформы, описанные на этой странице.

= Доступ к API =

== Аутентификация ==
API синтетической платформы аутентифицирует запросы, используя токен носителя в заголовке <code>Authorization</code>.<pre>
Authorization: Bearer <токен>
</pre>Ключ-АСТРОМ поддерживает следующие механизмы аутентификации:

* '''Токены платформы''' (<code>dt0s16.*</code>): Создаются через '''Управление учетной записью''' > '''Мои токены платформы''' и ограничиваются правами доступа '''IAM''' создавшего их пользователя. Рекомендуется для личного использования и автоматизации в контексте пользователя.
* '''Клиенты OAuth''': клиенты '''OAuth 2.0''', использующие предоставление учетных данных клиента и не привязанные к конкретной учетной записи пользователя. Рекомендуется для автоматизации взаимодействия между сервисами.

== API синтетической платформы ==
API синтетической платформы — это выделенный интерфейс API для синтетического моделирования в последней версии Ключ-АСТРОМ. Он отделен от классического API среды.

Базовый URL:<pre>
https://<environment-id>.apps.astromkey.com/platform/synthetic/v1
</pre>Спецификация '''OpenAPI''' доступна по адресу <code>/platform/synthetic/v1/openapi.yaml</code>. Вы можете ознакомиться с ней в '''API''' Ключ-АСТРОМ.

Все конечные точки API синтетической платформы в настоящее время находятся на стадии раннего внедрения. Они могут изменяться несовместимым образом, хотя этого стараются избегать по возможности. Новые константы перечислений могут быть добавлены без повышения версии, поэтому клиенты должны корректно обрабатывать неизвестные значения перечислений.

= Синтетическое приложение =
'''Синтетический мониторинг''' работает как с моделью разрешений '''IAM''', описанной в этом документе, так и с классическими разрешениями на основе ролей. Если пользователю не назначены никакие разрешения платформы, приложение переключается на классические разрешения, если это применимо.

== Список мониторов ==
При использовании разрешений платформы '''Синтетический мониторинг''' отображает список мониторов с помощью узлов '''Smartscape'''. Необходимое разрешение <code>storage:smartscape:read</code> включено во все политики доступа Ключ-АСТРОМ по умолчанию, включая политику для стандартных пользователей.

Одно лишь <code>storage:smartscape:read</code> дает приложению отправную точку для отображения мониторов. Для просмотра данных о конфигурации и выполнении мониторов требуются дополнительные разрешения:
{| class="wikitable"
!Что вы хотите увидеть
!Необходимые разрешения
|-
|Определения и настройки монитора
|<code>synthetic:monitors:read</code>
|-
|Результаты выполнения, доступность и производительность
|<code>storage:metrics:read</code>, <code>storage:events:read</code>
|}
Полный список разрешений, необходимых для работы приложения '''Синтетический мониторинг''', см. в разделе '''Разрешения приложения Синтетический мониторинг'''.

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

= Настройка прав доступа =
В этом разделе объясняется, как настроить синтетические разрешения в последней версии Ключ-АСТРОМ и как сопоставить классические разрешения на основе ролей с моделью '''IAM'''.

== Для администраторов ==

=== Новые среды ===
Для сред, созданных в последней версии Ключ-АСТРОМ, классические разрешения для миграции отсутствуют. Назначайте политики '''IAM''' непосредственно группам пользователей в разделе '''Управление учетными записями''' > '''Управление идентификацией и доступом''' > '''Политики'''. Используйте справочник разрешений и примеры шаблонов доступа на этой странице для создания политик, соответствующих обязанностям каждой группы.

=== Среды с существующими классическими правами доступа ===
Классические ролевые разрешения продолжат работать во время перехода, но Ключ-АСТРОМ рекомендует перейти на политики '''IAM'''. В таблице ниже приведено сопоставление соответствующих классических разрешений с их последними эквивалентами в Ключ-АСТРОМ.
{| class="wikitable"
!Классическая концепция
!Эквивалент IAM в последней версии Ключ-АСТРОМ
|-
|Просмотр окружающей среды (в масштабах всей среды)
|<code>synthetic:monitors:read</code> + <code>storage:*</code> права на чтение, без ограничения контекста безопасности
|-
|Просмотр окружающей среды (зона управления)
|Те же права доступа с <code>WHERE synthetic:dt.security_context IN (...)</code> ограничением доступа.
|-
|Управление настройками мониторинга (в масштабах всей среды)
|Все права на чтение + <code>synthetic:monitors:write</code>, <code>synthetic:monitors:execute</code>, <code>synthetic:locations:write</code>, <code>geolocation:locations:lookup</code>, без ограничений
|-
|Управление настройками мониторинга (зона управления)
|Те же права доступа с <code>WHERE synthetic:dt.security_context IN (...)</code> ограничением доступа.
|-
|Зона управления
|Контекст безопасности — назначьте соответствующие контексты безопасности мониторам и определите область действия политик IAM с помощью <code>synthetic:dt.security_context</code> границ.
|}
Перейдите в раздел '''Управление учетными записями''' > '''Управление идентификацией и доступом''' > '''Политики''', создайте или обновите политики с необходимыми разрешениями и назначьте их соответствующим группам пользователей. Полную процедуру см. в разделе '''Преобразование разрешений на основе ролей в политики IAM'''.

Используйте границы политик '''IAM''' для установки максимальных лимитов разрешений и предотвращения повышения привилегий.

Замените классические токены доступа, используемые для автоматизации API, на клиенты '''OAuth'''.

== Для пользователей ==
Доступ к синтетическим задачам в последней версии Ключ-АСТРОМ контролируется разрешениями политики '''IAM''', назначенными вашей группе пользователей администратором. Используйте следующую таблицу, чтобы определить разрешения, необходимые для выполнения распространенных задач синтетического анализа.
{| class="wikitable"
!Что вы хотите сделать
!Необходимые разрешения
|-
|Откройте Синтетический мониторинг и просмотрите мониторы.
|<code>synthetic:monitors:read</code>, <code>storage:buckets:read</code>, и <code>storage:smartscape:read</code>
|-
|Просматривайте результаты выполнения, доступность и производительность.
|<code>storage:metrics:read</code>, <code>storage:events:read</code>, и <code>storage:user.events:read</code>
|-
|Просмотр синтетических данных в дашбордах и блокнотах.
|<code>storage:*</code> Права доступа на чтение такие же, как указано выше.
|-
|Создание или редактирование мониторов
|<code>synthetic:monitors:write</code>
|-
|Запуск выполнения по требованию
|<code>synthetic:monitors:execute</code>
|-
|Управление частными локациями
|<code>synthetic:locations:read</code>, <code>storage:smartscape:read</code>, <code>storage:metrics:read</code>, <code>synthetic:locations:write</code>, и <code>geolocation:locations:lookup</code>
|}
Если у вас нет доступа к '''Синтетическому мониторингу''' или вы видите отсутствующие данные, обратитесь к администратору Ключ-АСТРОМ, чтобы убедиться, что вашей группе назначены необходимые разрешения политики '''IAM''' для целевой среды.

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

К синтетическим объектам применяются следующие классические разрешения:

* '''Окружение просмотра''': Доступ только для чтения к синтетическим мониторам и их результатам по всему клиенту.
* '''Управление настройками мониторинга''': полный доступ к созданию, редактированию и удалению синтетических мониторов во всем клиенте.

Доступ, предоставляемый классическими разрешениями, нельзя ограничить с помощью контекста безопасности.

Классические токены доступа обеспечивают эквивалентный доступ на уровне API и управляются в разделе '''Настройки''' > '''Интеграция''' > '''API''' Ключ-АСТРОМ.

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

Если вам необходимо предоставить пользователям доступ только к определенным мониторам, перейдите на новейшие политики '''IAM''' Ключ-АСТРОМ и используйте контексты безопасности для определения точных границ доступа. Это обеспечит вам детальный контроль доступа на основе атрибутов ('''ABAC''') для синтетических мониторов, '''Дашбордов''', '''Блокнотов''' и '''API''' без необходимости предоставления прав администратора на уровне всего арендатора.

= Связанные темы =

* Синтетическое приложение
* Синтетический мониторинг
* Токены платформы
* Клиенты OAuth
* Управление политиками IAM
* API синтетических мониторов v2

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

2026-09-03T16:26:53Z

IKuznetsov: Новая страница: «= Активация браузерных мониторов в последней версии Ключ-АСТРОМ = Чтобы использовать браузерные мониторы в последней версии Ключ-АСТРОМ при запуске браузерных мониторов из частных локаций, требуется АктивныйШлюз версии 1.331+. Функция мониторинга брау...»

= Активация браузерных мониторов в последней версии Ключ-АСТРОМ =

Чтобы использовать браузерные мониторы в последней версии Ключ-АСТРОМ при запуске браузерных мониторов из частных локаций, требуется АктивныйШлюз версии 1.331+.

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

* Использовать возможности '''Синтетического мониторинга''' в полной мере, включая улучшенную диаграмму потока запросов.
* Применять полученные данные на практике в блокнотах и визуализировать тенденции на дашбордах.
* Исследовать синтетические события с помощью языка запросов Ключ-АСТРОМ ('''DQL''').
* Выявлять узкие места и проблемы взаимодействия с помощью комплексных, улучшенных метрик продолжительности.
* Объединять синтетические сигналы и сигналы '''Мониторинга реального пользователя''', чтобы связать результаты имитационного тестирования с реальными результатами использования в '''Ключевых показателях опыта'''.
* Находить подробную информацию обо всех запусках браузерных мониторов, включая те, которые повторялись из-за включенной функции автоматической повторной попытки при ошибке.

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

* Продолжительность (рекомендуется как наиболее точное отражение пользовательского опыта).
* Длительность событий пользователя.
* Общая продолжительность событий пользователя.

Эти метрики доступны как для всего монитора браузера, так и для отдельных шагов монитора. Активация этой функции не останавливает выполнение классического '''JavaScript RUM''', и метрика «Общая продолжительность» (классическая) остается доступной.

= Включение или отключение браузерных мониторов в последней версии Ключ-АСТРОМ =

Не применимо к новым средам Ключ-АСТРОМ, созданным после 26 января 2026 года.

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

* '''Среда''': Эта функция применяется ко всем мониторам в среде, которые настроены на наследование ее на уровне среды.
* '''Монитор''': Эта функция применяется к отдельному монитору.

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

Активация этой функции открывает новую диаграмму '''Водопад запросов'''. Вы будете перенаправлены на эту диаграмму при выборе пункта '''Анализ выполнений''' на странице отчётов монитора браузера. Если функция еще не активирована, вы будете перенаправлены на страницу многомерного анализа в '''Синтетическом мониторинге Классическом'''.

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

== Активация или деактивация браузерных мониторов в последней версии Ключ-АСТРОМ на уровне среды ==

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

# Перейдите в '''Настройки''' > '''Сбор и захват данных''' > '''Синтетический мониторинг''' > '''Новый интерфейс мониторинга браузера'''.
# Включите или выключите функцию '''Включить новый мониторинг браузера'''. Изменения сохраняются автоматически и подтверждаются уведомлением внизу страницы.

После активации или деактивации функции на уровне среды она применяется ко всем браузерным мониторам в вашей среде, которые настроены на наследование этой функции на уровне среды.

Чтобы активировать или деактивировать эту функцию для отдельных мониторов независимо от настроек на уровне среды, см.:

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

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

== Активация или деактивация браузерных мониторов в последней версии Ключ-АСТРОМ для нового монитора ==

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

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

# Выберите '''Переопределить''', если монитор настроен на наследование этой функции на уровне среды.
#* По умолчанию монитор настроен на наследование параметров функции на уровне среды. Например, если функция активирована на уровне среды, она также активирована для монитора. Однако вы можете запретить монитору наследовать параметры, заданные на уровне среды, выбрав '''Переопределить'''. Затем вы можете активировать или деактивировать функцию для монитора независимо от параметров, заданных на уровне среды. Чтобы монитор снова начал наследовать параметры с уровня среды, выберите '''Удалить переопределение'''.
# Вы можете перейти к уровню окружения, выбрав '''Окружение'''.
# Включите или выключите функцию '''Включить новый мониторинг браузера'''.
# Прокрутите вниз и выберите '''Сохранить'''. Вы увидите уведомление, подтверждающее сохранение изменений.

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

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

# Перейдите в раздел '''Синтетический мониторинг'''.
# (Необязательно) Чтобы отфильтровать таблицу по мониторам браузеров, выберите '''Браузер''' в разделе '''Параметры фильтра''' слева.
# Из списка мониторов браузера выберите тот монитор, для которого вы хотите активировать или деактивировать эту функцию.
# Выберите '''Редактировать''' в правом верхнем углу панели обзора монитора.
# Выполните шаги 1–3 процедуры активации или деактивации браузерных мониторов в последней версии Ключ-АСТРОМ для нового монитора.

Контейнеризированные, автоматически масштабируемые частные синтетические локации в Kubernetes

2026-09-03T16:24:29Z

IKuznetsov: Новая страница: « = Контейнеризированные, автоматически масштабируемые частные синтетические локации в Kubernetes = Ключ-АСТРОМ версия 1.264+ Контейнеризированные, автоматически масштабируемые частные синтетические среды в '''Kubernetes''' и его коммерческом дистрибутиве '''OpenShift''...»

= Контейнеризированные, автоматически масштабируемые частные синтетические локации в Kubernetes =
Ключ-АСТРОМ версия 1.264+

Контейнеризированные, автоматически масштабируемые частные синтетические среды в '''Kubernetes''' и его коммерческом дистрибутиве '''OpenShift''' являются альтернативой развертыванию АктивногоШлюза с поддержкой синтетических тестов на отдельных хостах или виртуальных машинах и последующему назначению их частным средам для выполнения синтетических мониторов.

В отличие от отдельных АктивныхШлюзов с поддержкой синтетического моделирования, которые развертываются и назначаются частным локациям (а затем отслеживаются с помощью метрик использования), контейнеризированные локации развертываются как единое целое, при этом минимальное и максимальное количество АктивныхШлюзов являются необходимыми входными параметрами.

'''Kubernetes''' и '''OpenShift''' — это не просто дополнительные поддерживаемые платформы АктивногоШлюза наряду с '''Windows''' и '''Linux'''; благодаря этому предложению, контейнеризированные частные синтетические среды:

* Масштабируются автоматически (на основе показателей использования и указанного максимального/минимального количества АктивныхШлюзов).
* Просты в управлении и обслуживании.
* Обеспечивают поддержку синтетического мониторинга облачных решений, требующих разработки приложений на основе контейнеров.
* Возможно ускоренное развертывание с минимальным временем простоя.
* Автоматически отслеживается использование ресурсов в рамках операций автоматического масштабирования.

Вы можете управлять расположениями '''Kubernetes'''/'''OpenShift''' через веб-интерфейс Ключ-АСТРОМ и существующий '''API Synthetic - Locations, nodes, and configuration API v2'''. Дополнительные конечные точки раннего доступа в этом '''API''' упрощают развертывание расположений '''Kubernetes'''; новые конечные точки помогают генерировать команды, которые необходимо выполнить в кластере '''Kubernetes'''.

В контейнеризированных средах можно запускать как запланированные, так и запускаемые по запросу сценарии всех типов синтетических мониторов.

= Архитектура =
Контейнеризированные частные синтетические ячейки развертываются как единое целое.

В каждой локации настроено несколько АктивныхШлюзов с поддержкой синтетических вычислений, представленных в виде подов. Минимальное и максимальное количество АктивныхШлюзов указывается при настройке локации.

Объект '''StatefulSet''' рассматривается как локация.

В каждом пространстве имен может быть одна или несколько локаций. См. раздел «Требования, рекомендации и оговорки» ниже.

В каждом кластере '''Kubernetes''' может быть одна или несколько автоматически масштабируемых локаций.

Масштабирование локаций осуществляется автоматически путем регулирования количества АктивныхШлюзов на каждую локацию с помощью следующих дополнительных элементов контейнеризированной архитектуры локаций.

'''Адаптер синтетических метрик''' запрашивает и получает метрики использования контейнеризированных АктивныхШлюзов от кластера Ключ-АСТРОМ.

* В каждом кластере '''Kubernetes''' используется один адаптер синтетических метрик.
* Метрический адаптер настроен для связи с одной средой Ключ-АСТРОМ.
* Для установки адаптера синтетических метрик в '''Kubernetes''' требуются роли суперпользователя — см. раздел «Установка контейнеризированной локации» ниже.

'''Горизонтальный автоматический масштабировщик подов''' масштабирует локацию, регулируя количество АктивныхШлюзов на основе данных об использовании, получаемых от адаптера синтетических метрик.

На каждом объекте установлен один горизонтальный автоматический масштабировщик подов.

= Требования =
Контейнерные частные синтетические локации поддерживаются с помощью Ключ-АСТРОМ версии 1.264+ на '''Kubernetes''' 1.22-1.25 с постоянным уровнем громкости и поддержкой <code>kubectl</code>.

* Дополнительная поддержка для '''Kubernetes''' 1.26+ доступна в процессе установки.
* Поддерживаются все виды реализаций '''Kubernetes''', как облачные, так и локальные (например, облачные сервисы '''Kubernetes''' или '''Minikube''').
* Поддерживаются версии '''OpenShift''', совместимые с поддерживаемыми версиями '''Kubernetes'''.
* Для доступа к общедоступным репозиториям, где доступны образы '''Docker''' для АктивногоШлюза с поддержкой синтетических метрик и адаптера синтетических метрик, требуется подключение к Интернету. Ссылки на эти образы указаны в соответствующих файлах шаблонов — см. разделы «Установка контейнеризированной локации» и «Обновление контейнеризированной локации» ниже.

= Таблица размеров =
Ниже приведены требования к оборудованию АктивногоШлюза, сгруппированные по размерам.

* Запросы на использование ЦП и ОЗУ относятся к ресурсам, резервируемым подами при их создании.
* Ограничения по ЦП и ОЗУ указывают на максимальное потребление ресурсов на один под.
* Если локация контролируется ЕдинымАгентом или другим решением для глубокого мониторинга, требования к оперативной памяти ('''RAM''') возрастут.
* В режиме '''FIPS''' для бесбраузерного пода предъявляются те же требования, что и для обычного бесбраузерного пода.

{| class="wikitable"
!Компонент
!XS
!S
!M
!Браузерный под
!Бесбраузерный под
!Браузерный под с FIPS
!Браузерный под с FIPS и корпоративным прокси
|-
|АктивныйШлюз
|✓
|✓
|✓
|✓
|✓
|✓
|✓
|-
|Синтетический движок
|✓
|✓
|✓
|✓
|✓
|✓
|✓
|-
|Рабочий браузер
|✓
|✓
|✓
|✓
|–
|✓
|✓
|-
|FIPS-прокси
|–
|–
|–
|–
|–
|✓
|✓
|-
|FIPS-партнер
|–
|–
|–
|–
|–
|–
|✓
|-
|Контейнеры
|14
|2
|15
|16
|1
|12
|12
|-
|Запросы ЦП
|7.15 vCPU
|1.15 vCPU
|7.65 vCPU
|7.8 vCPU
|0.3 vCPU
|1 vCPU
|12 × 0.5 vCPU
|-
|Ограничения ЦП
|20.3 vCPU
|2.3 vCPU
|21.8 vCPU
|22.1 vCPU
|0.3 vCPU
|2 vCPU
|12 × 1.5 vCPU
|-
|Запросы на ОЗУ
|14.25 ГиБ
|2.25 ГиБ
|14.5 ГиБ
|14.75 ГиБ
|0.25 ГиБ
|2 ГиБ
|12 × 1 ГиБ
|-
|Ограничения ОЗУ
|29 ГиБ
|5 ГиБ
|29.5 ГиБ
|30 ГиБ
|1 ГиБ
|4 ГиБ
|12 × 2 ГиБ
|-
|Временное хранение
|2.5 ГиБ
|1.3 ГиБ
|2.6 ГиБ
|2.7 ГиБ
|1.2 ГиБ
|0.1 ГиБ
|12 × 0.1 ГиБ
|-
|Постоянное хранение
|12 ГиБ
|12 ГиБ
|12 ГиБ
|12 ГиБ
|–
|–
|–
|-
|ОЗУ-диск
|4 ГиБ
|–
|4 ГиБ
|4 ГиБ
|–
|–
|–
|}

= Рекомендации и предостережения =

== АктивныеШлюзы ==

* Мы рекомендуем использовать АктивныйШлюз размера '''S''' и как минимум два АктивныхШлюза на одну локацию.
* При выборе размера нода учитывайте возможные ограничения, специфичные для используемой вами службы '''Kubernetes'''.
* Все АктивныеШлюзы в пределах одной территории всегда имеют одинаковый размер.
* После указания размера АктивногоШлюза для локации изменить его невозможно, поскольку размер постоянного хранилища изменить нельзя.
* В отношении локаций '''Kubernetes''' действуют те же правила, что и в отношении других локаций: АктивныйШлюз нельзя добавить одновременно в несколько локаций.
* Нельзя объединять АктивныйШлюз в контейнере и без контейнера в одной и той же локации.
* Образ для АктивногоШлюза с поддержкой синтетического моделирования находится в общедоступном реестре; на это местоположение образа ссылается файл шаблона.

== Локации ==

* Мы рекомендуем устанавливать каждую локацию в отдельном пространстве имен.
* При развертывании более одной локации в рамках одного пространства имен используйте разные имена для соответствующих ресурсов АктивногоШлюза — см. раздел «Установка контейнеризированной локации» ниже.
* Для обеспечения автоматического масштабирования локация, использующая одно и то же пространство имен '''Kubernetes''', должна быть подключена к той же среде Ключ-АСТРОМ, что и адаптер синтетических метрик. Например, предположим, что локация A и адаптер метрик настроены для среды X. Однако локация A использует то же пространство имен, что и локация B, настроенная для среды Y. В таком случае локация A масштабируется автоматически; локация B — нет.
* Если вы хотите установить компонент в том же пространстве имен, что и другие ресурсы Ключ-АСТРОМ, такие как Оператор Ключ-АСТРОМ, имейте в виду, что для контейнеризированных АктивныхШлюзов с поддержкой Synthetic требуются более высокие аппаратные и системные ресурсы.

== Синтетический метрический адаптер ==

* Наилучшей практикой является развертывание адаптера синтетических метрик в собственном пространстве имен для каждого кластера '''Kubernetes'''. Адаптер синтетических метрик может использовать то же пространство имен, что и локация. Однако развертывание адаптера метрик в собственном пространстве имен гарантирует, что он не будет удален при отключении локации.
* Метрический адаптер может взаимодействовать только с одной средой Ключ-АСТРОМ, поэтому автоматическое масштабирование по локации работает только для этой среды.
* Образ адаптера синтетической метрики находится в общедоступном реестре; на это местоположение образа ссылается файл шаблона.

== Особенности автоматического масштабирования ==
Для целей автоматического масштабирования адаптеру синтетических метрик необходим доступ к '''API''' '''Kubernetes''' и его расширение за счет указания новой службы '''API''' — <code>v1beta1.external.metrics.k8s.io</code>.

Данная служба '''API''' определена в шаблоне адаптера синтетических метрик — см. раздел «Установка и развертывание контейнеризированной локации» ниже.

'''Определение API-сервиса в шаблоне адаптера метрик'''<pre>
apiVersion: apiregistration.k8s.io/v1
kind: APIService
metadata:
name: v1beta1.external.metrics.k8s.io
spec:
service:
name: astromkey-metrics-apiserver
namespace: {{ adapterNamespace }}
group: external.metrics.k8s.io
version: v1beta1
insecureSkipTLSVerify: true
groupPriorityMinimum: 100
versionPriority: 100
</pre>Адаптер синтетических метрик также изменяет существующий ресурс в своем шаблоне — объект <code>horizontal-pod-autoscaler</code> '''ServiceAccount''' в пространстве имен <code>kube-system</code>.

'''Изменение существующих ресурсов в шаблоне адаптера метрик'''<pre>
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
name: hpa-controller-astromkey-metrics
roleRef:
apiGroup: rbac.authorization.k8s.io
kind: ClusterRole
name: astromkey-metrics-server-resources
subjects:
- kind: ServiceAccount
name: horizontal-pod-autoscaler
namespace: kube-system
</pre>

== Ограничения ==
Обратите внимание, что в кластере '''Kubernetes''' разрешен только один внешний сервер метрик. Поэтому другие компоненты, выполняющие функцию сервера метрик (например, надстройка '''KEDA''' или адаптер '''Prometheus'''), не могут использоваться вместе с адаптером синтетических метрик.

= Установите контейнерную локацию =

== 1. Первоначальная настройка для размещения Kubernetes/OpenShift ==

# Перейдите в раздел '''Синтетический мониторинг''' > '''Частные локации''' > '''Новые частные локации''' > '''Kubernetes''' или '''OpenShift'''.
# Укажите название локации на ваш выбор.
# Выберите географическую локацию, например, '''San Francisco, California, United States'''. (Обратите внимание, что вы не сможете сохранить изменения, пока не укажете название и локацию.)
# В разделе '''АктивныеШлюзы''':
#* Укажите минимальное и максимальное количество АктивныхШлюзов для вашей локации. Эти параметры используются для автоматического масштабирования горизонтального пода.
#* Выберите размер нода АктивногоШлюза ('''XS''', '''S''', или '''M'''). См. также разделы «Требования» и «Рекомендации и предостережения».
#* При необходимости включите режим '''FIPS'''. Вы можете выбрать между режимом '''FIPS''' без привязки к серверу и режимом '''FIPS''' с корпоративным прокси. В качестве альтернативы вы можете включить режим '''FIPS''' через '''API'''.
# Только '''Kubernetes''': Если ваша реализация '''Kubernetes''' основана на более поздней версии, чем 1.21–1.25, включите параметр '''Использовать Kubernetes версии 1.26+'''.
#* Если вы измените этот параметр после загрузки шаблона локации, вам потребуется повторить процедуру развертывания.
# (Необязательно) Вы можете включить тип запроса '''ICMP''' для выполнения мониторов доступности сети.
# (Необязательно) Вы можете отключить поддержку браузерных мониторов. В этом случае нод АктивногоШлюза будет рассматриваться как не использующий браузер.
# (Необязательно) Включите оповещение о состоянии в частной локации. Это позволит сгенерировать сообщение о проблеме и отправить оповещение, когда все АктивныеШлюзы в частной локации отключатся.
# Выберите '''Далее'''.

== 2. Разверните локацию ==

# Укажите имя АктивногоШлюза или используйте имя по умолчанию. Это имя используется в качестве префикса для АктивныхШлюзов, развернутых в рамках указанной локации. Первый АктивныйШлюз называется <code><prefix>-0</code>, второй — <code><prefix>-1</code>, и так далее. Это имя также используется в качестве имени '''StatefulSet'''.
# Укажите имя пространства имен '''Location''' или используйте имя по умолчанию.
# Выберите '''Скачать synthetic.yaml'''. Это файл шаблона для указания локации. Вы можете переименовать файл в соответствии с вашей локацией для удобства идентификации.
# Скопируйте загруженный шаблон локации в свой кластер '''Kubernetes'''.
# Сгенерируйте команды развертывания.
# Выполните следующие команды в терминале:
#* Команда для создания пространства имен и секретов для реестра '''Docker''' и АктивногоШлюза.
#* Команда для развертывания АктивногоШлюза.
# Выберите '''Готово''' или продолжите развертывание адаптера метрик.

== 3. Разверните адаптер синтетических метрик ==
Эта процедура генерирует отдельный шаблон для адаптера синтетических метрик. Затем вы выполняете сгенерированные команды в своем кластере '''Kubernetes''' для развертывания адаптера метрик.

* Адаптер синтетических метрик необходимо развернуть всего один раз для каждого кластера '''Kubernetes'''.
* Для установки адаптера синтетических метрик требуется роль суперпользователя '''Kubernetes''' для создания ролей '''ClusterRoles''' и '''ClusterRoleBindings'''.

# Разверните адаптер развертывания метрик.
# Укажите имя пространства имен адаптера метрик или используйте имя по умолчанию.
# Выберите '''Скачать synthetic-adapter.yaml'''. Это файл-шаблон для адаптера синтетических метрик.
# Скопируйте загруженный шаблон адаптера метрик в свой кластер '''Kubernetes'''.
# Сгенерируйте команды развертывания.
# Выполните следующие команды в терминале:
#* Команда для создания пространства имен и секретов для реестра '''Docker''' и АктивногоШлюза.
#* Команда для развертывания АктивногоШлюза.
# Выберите '''Завершить'''.

= Установка контейнеризированной локации, поддерживающей стандарт FIPS, через API =
Установите режим '''FIPS''' для данной локации.

Установите свойство <code>fipsMode</code> в '''JSON'''-запросе, используя '''REST API'''.

* Для создания новой локации используйте '''POST'''-запрос.
* Для обновления существующей локации используйте вызов '''PUT''' location.

Выполните дополнительную настройку в зависимости от режима:

=== Поддерживается браузерами ===
Предоставьте сертификат для повторной подписи '''HTTPS'''-запросов:<pre>
kubectl -n $NAMESPACE create secret tls synthetic-fips-proxy-cert --cert=squid.crt --key=squid.key
</pre>

=== Поддержка браузеров с использованием корпоративного прокси ===
Предоставьте сертификат для повторной подписи '''HTTPS'''-запросов:<pre>
kubectl -n $NAMESPACE create secret tls synthetic-fips-proxy-cert --cert=squid.crt --key=squid.key
</pre>Предоставьте '''Squid''' конфигурацию корпоративного прокси:<pre>
kubectl -n $NAMESPACE create secret generic synthetic-fips-proxy-peer --from-literal='peer.conf=cache_peer proxy.example.com parent 443 0 default no-digest proxy-only login=proxyuser:proxypass tls tls-min-version=1.2 tls-options=NO_SSLv3'
</pre>Укажите конфигурацию корпоративного прокси-сервера для АктивногоШлюза. Подробности см. в разделе «Конфигурация прокси-сервера».

=== Без браузера ===
Дополнительная настройка не требуется.

Продолжите загрузку и развертывание шаблона '''YAML''', как описано в разделе «Установка».

= Обновление локации контейнера или его АктивныхШлюзов =
Для внесения любых изменений в локацию необходимо повторно загрузить файл шаблона локации и применить изменения с помощью команды <code>kubectl</code>.

# Перейдите в раздел '''Синтетический мониторинг''' > '''Частные локации'''.
# Выберите свою локацию в разделе '''Частные синтетические локации'''.
# Перейдите на вкладку развертывания в частной локации.
# Повторно введите имя АктивногоШлюза и пространство имен '''Location''', которые вы указали при развертывании локации.
# Выберите '''Загрузить synthetic.yml''', чтобы загрузить новый файл шаблона локации.
# Переименуйте файл в соответствии с вашей локацией для удобства идентификации.
# Скопируйте файл шаблона в свой кластер '''Kubernetes'''.
# Выполните следующую команду, чтобы применить изменения в вашем кластере '''Kubernetes'''. Убедитесь, что вы используете имя файла шаблона, расположенного в вашем регионе, вместо synthetic.yaml. Выполните эту команду из того же места, где находится файл шаблона.
<pre>
kubectl apply --server-side --force-conflicts -f ./synthetic.yaml
</pre>

* <code>--server-side</code>: Используется серверное применение (server-side apply), которое отслеживает права собственности на поля на сервере '''API''' '''Kubernetes'''. Это рекомендуемый подход для сложных определений ресурсов, таких как шаблон локации, и позволяет избежать ограничений по размеру, присущих клиентскому применению.
* <code>--force-conflicts</code>: Этот флаг гарантирует применение обновления даже при наличии конфликтов владения полями — например, если поле ранее управлялось другим менеджером полей, таким как предыдущий <code>kubectl apply</code> запуск или контроллер '''Kubernetes'''. Без этого флага вам потребуется разрешить конфликты вручную, прежде чем обновление сможет продолжиться.

Если ваша конфигурация включает поля, права собственности на которые необходимо целенаправленно передать контроллеру — например, <code>replicas</code> '''HorizontalPodAutoscaler''' — см. раздел «Передача прав собственности» в документации '''Kubernetes''', чтобы узнать, как безопасно скоординировать этот переход.

Любое обновление переразвертывает АктивныеШлюзы в обратном порядке по сравнению с их предыдущим развертыванием. Например, если в вашей локации находятся АктивныеШлюзы <code>activegate-name-0</code> и <code>activegate-name-1</code>, <code>activegate-name-1</code> сначала останавливается и переразвертывается.

Переразвернутый модуль АктивногоШлюза использует тот же постоянный том, который был развернут для обеспечения непрерывности ведения логов.

= Удаление адаптера локации или метрик в Kubernetes =
Фрагменты кода для удаления адаптера локации и метрики можно найти на соответствующих вкладках ('''Развертывание частной локации''' или '''Развертывание адаптера метрики''') в сведениях о локации. Вы можете скопировать и сохранить эти команды для дальнейшего использования.

В любой момент вы можете повторно сгенерировать команды для соответствующих пространств имен.

* Если вы переименовали файл шаблона, используйте новое имя файла в командах.
* Приведенные ниже команды очистки не удаляют соответствующие пространства имен.

== Удалить локацию ==

# Перейдите в раздел '''Синтетический мониторинг''' > '''Частные локации'''.
# Выберите свою локацию в разделе '''Частные синтетические локации'''.
# Перейдите на вкладку развертывания в частной локации.
# Разверните команду '''Удалить''' (необязательно), затем скопируйте и выполните предоставленную команду удаления.

Данная процедура удаляет только частную локацию '''Synthetic''', но не удаляет ее пространство имен.

== Удалить адаптер синтетической метрики ==

# Перейдите в раздел '''Синтетический мониторинг''' > '''Частные локации'''.
# Выберите свою локацию в разделе '''Частные синтетические локации'''.
# Перейдите на вкладку развертывания адаптера метрик.
# Разверните команду '''Удалить''' (необязательно), затем скопируйте и выполните предоставленную команду удаления.

Данная процедура удаляет только метрический адаптер, но не удаляет его пространство имен.

= Многозональный доступ к PVC в облачных кластерах =
Использование кластера с несколькими зонами доступности (multi-AZ) и развертываниями, использующими '''PVC''', может привести к тому, что поды будут зависать в состоянии ожидания после пересоздания. Это происходит потому, что тома хранения не реплицируются между зонами.

'''PVC''' используется совместно только нодами, расположенными в одной зоне доступности. При использовании кластера с несколькими зонами доступности, если нод пытается получить доступ к '''PVC''' из другой зоны доступности, он застрянет в состоянии ожидания и отобразит сообщение об ошибке.

В настоящее время существует два возможных решения для развертывания '''Kubernetes''' в нескольких зонах доступности:

* Используйте параметр «Привязка нодов», чтобы ограничить размещение подов в определенной зоне.
* Используйте системы общего хранения данных.

== Используйте параметр «Привязка нодов», чтобы ограничить размещение подов в определенной зоне ==
Вы можете настроить привязку нодов таким образом, чтобы для развертывания использовались только определенные зоны.

Для установки привязки нода:

# Используйте следующую команду, чтобы узнать, в какой зоне развернут каждый нод:
<pre>
kubectl get nodes --show-labels
</pre>

# Найдите метку <code>failure-domain.beta.kubernetes.io/zone</code>, например, <code>failure-domain.beta.kubernetes.io/zone=us-east-1a</code>.
# Используйте команду <code>kubectl label</code>, чтобы установить пользовательскую метку для нода:
<pre>
kubectl label nodes node name label=value
</pre>Пример:<pre>
kubectl label nodes ip-10-179-202-73.ec2.internal zone=us-east-1a
</pre>

# Добавьте пользовательскую метку нода в <code>nodeSelector</code> раздел шаблона синтетического развертывания. Например:
<pre>
spec:
nodeSelector:
zone: us-east-1a
</pre>

# Сохраните изменения.
# Примените шаблон.

Ноды с одинаковой меткой зоны будут развернуты в одной зоне доступности, и вы сможете совместно использовать '''PVC''' между ними без возникновения ошибок.

== Используйте системы общего хранения данных ==
Каждый облачный сервис предоставляет свои собственные варианты систем общего хранения данных. Для примера использования общей файловой системы ('''EFS'''):

Предполагается, что у вас уже есть настроенная общая файловая система. Если нет, обратитесь к документации вашего облачного провайдера по настройке '''EFS'''.

Для использования класса хранения с '''EFS''':

# Заполните шаблон синтетического развертывания аналогично приведенному ниже примеру:
<pre>
kind: StorageClass
apiVersion: storage.k8s.io/v1
metadata:
name: efs-test
provisioner: efs.csi.aws.com
parameters:
fileSystemId: fs-0c155dcd8425aa39d
provisioningMode: efs-ap
directoryPerms: "700"
basePath: "/"
</pre>

# Измените раздел <code>volumeClaimTemplates</code> шаблона аналогично приведенному ниже примеру:
<pre>
volumeClaimTemplates:
- metadata:
name: persistent-storage
spec:
storageClassName: efs-test
accessModes:
- ReadWriteMany
resources:
requests:
storage: 3Gi
</pre>

# Сохраните изменения.
# Примените шаблон.

Теперь, если под будет переразвёрнут на ноде в другой зоне, '''PVC''' должен автоматически привязаться к новой зоне развертывания.

= Мониторы NAM на контейнерных локациях =
Мониторы доступности сети поддерживаются в контейнеризированных развертываниях АктивногоШлюза с поддержкой синтетических тестов, но для тестов '''ICMP''' требуются дополнительные разрешения.

Чтобы включить тип запроса '''ICMP''' для выполнения '''NAM''':

# В Расширениях найдите раздел '''Настройки'''.
# В настройках найдите раздел '''Частные синтетические локации''' и выберите его.
# Выберите '''Добавить локацию Kubernetes'''.
# Укажите вашу локацию и обязательно включите параметр '''Включить тип запроса ICMP для выполнения мониторов доступности сети'''.

Мониторы '''ICMP''' используют исполняемый файл <code>ping</code>, для работы которого требуется набор прав <code>CAP_NET_RAW</code>, установленных для контейнера, выполняющего запросы (<code>synthetic-vuc</code>).

Для этого контейнера необходимо установить свойство <code>allowPrivilegeEscalation</code> в значение <code>true</code>, поскольку процесс, запускающий исполняемый файл <code>ping</code>, по умолчанию не обладает необходимыми привилегиями.

Полный код <code>securityContext</code> для контейнера <code>synthetic-vuc</code> с включенными мониторами доступности сети должен выглядеть следующим образом.<pre>
securityContext:
readOnlyRootFilesystem: true
privileged: false
allowPrivilegeEscalation: true
runAsNonRoot: true
capabilities:
drop: ["all"]
add: ["NET_RAW"]
</pre>

= OpenShift =
'''OpenShift''' использует '''Security Context Constraint (SCC)''' для ограничения возможностей, используемых подами. По умолчанию развернутые поды будут использовать <code>restricted-v2</code> '''SCC''', который не допускает никаких дополнительных возможностей. Рекомендуемое решение — подготовить собственный '''Security Context Constraint'''.

== Создайте выделенный сервисный аккаунт (необязательно) ==
Если пользовательский '''SCC''' используется только при синтетическом развертывании, рекомендуется создать отдельную учетную запись службы.<pre>
oc -n $NAMESPACE create sa sa-astromkey-synthetic
oc -n $NAMESPACE adm policy add-role-to-user edit system:serviceaccount:$NAMESPACE:sa-astromkey-synthetic
</pre>

== Создайте пользовательское ограничение контекста безопасности ==
Файл <code>scc-astromkey-synthetic.yaml</code>:<pre>
apiVersion: security.openshift.io/v1
kind: SecurityContextConstraints
metadata:
name: scc-astromkey-synthetic
allowPrivilegedContainer: false
allowHostDirVolumePlugin: false
allowHostIPC: false
allowHostNetwork: false
allowHostPID: false
allowHostPorts: false
runAsUser:
type: MustRunAsRange
seccompProfiles:
- runtime/default
seLinuxContext:
type: MustRunAs
fsGroup:
type: MustRunAs
supplementalGroups:
type: MustRunAs
volumes:
- configMap
- downwardAPI
- emptyDir
- persistentVolumeClaim
- projected
- secret
users: []
groups: []
priority: null
readOnlyRootFilesystem: true
requiredDropCapabilities:
- ALL
defaultAddCapabilities: null
allowedCapabilities:
- NET_RAW
allowPrivilegeEscalation: true
</pre><code>priority</code> может быть установлено на любое число от 1 до 9. Если два или более '''SCC''' удовлетворяют требованиям, выбирается тот, который имеет более высокий приоритет.<pre>
oc create -f scc-astromkey-synthetic.yaml
</pre>

== Добавьте новый SCC в учетную запись службы ==
<pre>
oc -n $NAMESPACE adm policy add-scc-to-user scc-astromkey-synthetic system:serviceaccount:$NAMESPACE:default
</pre>Если был создан сервисный аккаунт <code>sa-astromkey-synthetic</code>, замените им <code>default</code>:<pre>
oc -n $NAMESPACE adm policy add-scc-to-user scc-astromkey-synthetic system:serviceaccount:$NAMESPACE:sa-astromkey-synthetic
</pre>

== Red Hat OpenShift (ARO) ==
Если кластер '''OpenShift''' развернут как ресурс '''Red Hat OpenShift (ARO)''', то по умолчанию группа сетевой безопасности не разрешит трафик '''ICMP''' за пределы кластера. Группа сетевой безопасности '''ARO''' не подлежит изменению, но пользовательскую группу сетевой безопасности можно создать и импортировать во время создания кластера '''ARO'''. Запуск кластера с настройками по умолчанию позволит использовать мониторы '''ICMP NAM''' только для ресурсов внутри кластера '''OpenShift'''. Любые запросы, исходящие за пределы кластера, будут завершаться ошибкой.

= Конфигурация прокси =
Добавьте следующий код в начало файла шаблона локации, чтобы вставить ресурс '''ConfigMap''', содержащий информацию о вашем прокси-сервере.

В приведенном ниже примере кода:

* Прокси-сервер используется для подключения к кластеру Ключ-АСТРОМ и тестируемым ресурсам.
* Пространство имен (<code>namespace: astromkey</code>) должно совпадать с пространством имен локации.
<pre>
kind: ConfigMap
apiVersion: v1
data:
custom.properties: |-
[http.client]
proxy-server = 10.102.43.210
proxy-port = 3128
proxy-user = proxyuser
proxy-password = proxypass
metadata:
name: ag-custom-configmap
namespace: astromkey
---
</pre>Добавьте следующий код в <code>spec.template.spec.volumes:</code>.<pre>
- name: ag-custom-volume
configMap:
name: ag-custom-configmap
items:
- key: custom.properties
path: custom.properties
</pre>Добавьте следующий код в конфигурацию контейнера АктивногоШлюза в разделе <code>volumeMounts:</code>.<pre>
- name: ag-custom-volume
mountPath: /var/lib/astromkey/gateway/config_template/custom.properties
subPath: custom.properties
</pre>

= Совместимость с Оператором Ключ-АСТРОМ =
Если вы развертываете Оператор Ключ-АСТРОМ в том же кластере '''Kubernetes''', что и контейнеризированная синтетическая локация, сгенерированный шаблон '''StatefulSet''' должен включать аннотацию пода <code>astromkey.com/split-mounts: "true"</code>. Эта аннотация предотвращает конфликты, возникающие, когда внедрение Оператора сталкивается с образом АктивногоШлюза, который уже содержит каталог <code>/var/lib/astromkey</code>.

Начиная с Ключ-АСТРОМ версии 1.335 в шаблоне локации, сгенерированном Ключ-АСТРОМ, содержится эта аннотация. Если вы управляете манифестом '''StatefulSet''' вручную или используете более раннюю версию, убедитесь, что аннотация присутствует в разделе <code>spec.template.metadata.annotations</code>.

= Открытые частные синтетические локации без браузера =
В целом, мы рекомендуем развертывание полностью синтетических частных локаций для поддержки выполнения всех типов синтетических мониторов ('''HTTP''', браузерный, '''NAM''').

Если вам не требуется запускать браузерные мониторы, рассмотрите возможность развертывания вашей локации в режиме без браузера. В этом режиме локация (или принадлежащий ей АктивныйШлюз) развертывается без браузера, что снижает требования к оборудованию. Однако браузерные мониторы не могут работать в локации без браузера.

Рассмотрите возможность использования локаций без браузера в качестве альтернативы синтетическим приватным локациям с поддержкой мониторинга браузера, если вы сосредоточены исключительно на:

* Примерах использования сети и инфраструктуры (с помощью мониторов '''NAM''')
* Мониторинге '''API''' (с использованием '''HTTP'''-мониторов)

По сравнению со стандартным шаблоном внесены следующие изменения:

* Значение <code>browser</code> устанавливается для переменной среды <code>DT_SYNTHETIC_UNSUPPORTED_MONITORING_MODULES</code> в контейнере <code>synthetic-vuc</code> в разделе <code>env</code>:
<pre>
- name: DT_SYNTHETIC_UNSUPPORTED_MONITORING_MODULES
value: "browser"
</pre>

* Контейнеры <code>synthetic-vuc-worker</code> не включены.
* Том <code>chromium-cache</code> не указан и не установлен.

= Конфигурация аутентификации Kerberos =
Добавьте следующий код в начало файла шаблона локации, чтобы вставить ресурс '''ConfigMap''', содержащий информацию о вашем сервере '''Kerberos'''.

В приведенном ниже примере кода:

* Область <code>EXAMPLE.COM</code> используется в аутентификации '''Kerberos'''.
* Домен <code>example.com</code> используется в аутентификации '''Kerberos'''.
* Имя хоста центра распространения ключей: <code>kerberos.example.com</code>.
* Пространство имен (<code>namespace: astromkey</code>) должно совпадать с пространством имен локации.
<pre>
kind: ConfigMap
apiVersion: v1
data:
krb5.conf: |-
[libdefaults]
dns_lookup_realm = false
ticket_lifetime = 24h
renew_lifetime = 7d
forwardable = true
rdns = false
pkinit_anchors = FILE:/etc/pki/tls/certs/ca-bundle.crt
spake_preauth_groups = edwards25519
dns_canonicalize_hostname = fallback
qualify_shortname = ""
default_realm = EXAMPLE.COM
default_ccache_name = /tmp/krb5cc_%{uid}
[realms]
EXAMPLE.COM = {
kdc = kerberos.example.com
admin_server = kerberos.example.com
}
[domain_realm]
.example.com = EXAMPLE.COM
example.com = EXAMPLE.COM
metadata:
name: krb-map
namespace: astromkey
---
</pre>Добавьте следующий код в <code>spec.template.spec.volumes:</code>.<pre>
- name: krb5-conf
configMap:
name: krb-map
items:
- key: krb5.conf
path: krb5.conf
</pre>Добавьте следующий код в конфигурацию каждого контейнера <code>synthetic-vuc-worker</code> в разделе <code>volumeMounts:</code>.<pre>
- name: krb5-conf
mountPath: /etc/krb5.conf
subPath: krb5.conf
</pre>

= Синтетический метрический адаптер: дополнительные настройки =

== Отключить проверку доменного сертификата ==
Добавьте следующий код в шаблон адаптера синтетической метрики в разделе <code>env</code>:<pre>
- name: TLS_SECURE
value: "false"
</pre>Это отключает проверку сертификатов для подключения адаптера синтетических метрик к кластеру Ключ-АСТРОМ (по умолчанию она включена).

== Конфигурация прокси ==
Добавьте следующий код в шаблон адаптера синтетической метрики в разделе <code>env</code>:<pre>
- name: HTTPS_PROXY
value: "http://proxyuser:proxypass@10.102.43.210:3128"
- name: NO_PROXY
value: "172.20.0.0/16" # не перенаправлять внутренние вызовы в кластер Kubernetes
</pre>Более подробную информацию об этих переменных среды см. в документации пакета '''Go httpproxy'''.

Способ получения '''CIDR'''-адреса сервиса зависит от дистрибутива '''Kubernetes'''; например, для облачного '''Kubernetes''' можно использовать следующую команду:<pre>
aws eks describe-cluster --name my-cluster --query 'cluster.kubernetesNetworkConfig'
</pre>

= Перенос синтетического адаптера на API запросов Хранилища данных =
Этот раздел актуален для клиентов, использующих метрики Хранилища данных, включая среды Ключ-АСТРОМ, созданные после января 2026 года.

Начиная с Ключ-АСТРОМ версии 1.338+ Адаптер Synthetic Adapter поддерживает API запросов Хранилища данных для синтетических метрик. Для миграции требуется перегенерировать токен <code>dynametric</code> адаптера Synthetic Adapter.

Новый токен <code>dynametric</code> должен быть платформенным токеном, созданным в разделе '''Управление учетной записью'''. Он должен обладать следующими областями действия: <code>storage:buckets:read</code>, <code>storage:metrics:read</code>.

Существует два способа обновления до нового API:

* Обновите всю развернутую систему до более новой версии (АктивныйШлюз версии 1.337+).
* Обновите API самостоятельно, не обновляя всю систему целиком.

== Миграция при обновлении развертывания на АктивныйШлюз версии 1.337+ ==

# Загрузите новый шаблон адаптера и все шаблоны синтетических локаций, использующие этот адаптер.
# Удалите предыдущий секрет <code>dynametric</code>:
<pre>
kubectl -n $adapterNamespace delete secret dynametric
</pre>

# Создайте новый секрет <code>dynametric</code>:
<pre>
kubectl -n $adapterNamespace create secret generic dynametric --from-literal=apiToken=xxx.yyy.zzz
</pre>

# Примените новый шаблон адаптера:
<pre>
kubectl apply --server-side --force-conflicts -f synthetic_metric_adapter.yaml
</pre>

# Примените новый шаблон локации:
<pre>
kubectl apply --server-side --force-conflicts -f $locationTemplateFile
</pre>

# Убедитесь, что '''HPA''' в данной локации получает новые метрики. Они должны стать доступны примерно через пять минут после развертывания.
<pre>
kubectl get hpa -n $locationNamespace
</pre>Если в поле <code>TARGETS</code> отображается какое-либо значение (кроме «Неизвестно»), значит, адаптер получает метрики.

== Миграция без изменения развернутой версии АктивногоШлюза ==

# Удалите предыдущий секрет <code>dynametric</code>:
<pre>
kubectl -n $adapterNamespace delete secret dynametric
</pre>

# Создайте новый секрет <code>dynametric</code>:
<pre>
kubectl -n $adapterNamespace create secret generic dynametric --from-literal=apiToken=xxx.yyy.zzz
</pre>

# Измените параметры развертывания адаптера. Установите переменную среды <code>METRIC_3RD_GEN_ENABLED</code> в значение <code>"true"</code>:
<pre>
env:
- name: METRIC_3RD_GEN_ENABLED
value: "true"
</pre>

# Установите переменную среды <code>BASE_URL</code> в соответствии с URL-адресом последней версии Ключ-АСТРОМ:
<pre>
env:
- name: BASE_URL
value: "https://mySampleEnv.apps.astromkey.com"
</pre>

# Измените параметры развертывания синтетических локаций — измените целевую метрику в определении '''Horizontal Pod Autoscaler''':
<pre>
metrics:
- type: External
external:
metric:
name: "dt.sfm.synthetic.engine_utilization:dt.entity.synthetic_location==SYNTHETIC_LOCATION-A1183B9FB2353097"
</pre>

# После применения изменений проверьте, получает ли '''HPA''' в данной локации новые метрики. Они должны стать доступны примерно через пять минут после развертывания.
<pre>
kubectl get hpa -n $locationNamespace
</pre>Если в поле <code>TARGETS</code> отображается любое значение, кроме пустого или <code>Unknown</code>, адаптер получает метрики.

= Немасштабируемые контейнерные локации =
Объекты, масштабируемые автоматически, перестают масштабироваться по любой из следующих причин:

* Если в '''StatefulSet''' достигнуто максимальное количество подов, а коэффициент использования локации превысит пороговое значение в 80%, новые поды АктивногоШлюза не будут создаваться до тех пор, пока максимальное количество АктивныхШлюзов не будет увеличено.
* Адаптер синтетических метрик перестаёт работать, и автомасштабировщики горизонтальных подов не получают метрики, необходимые для автоматического масштабирования.

Для проверки состояния автомасштабирования пода можно выполнить следующую команду. В приведенном ниже примере <code>astromkey</code> — это пространство имен локации.<pre>
kubectl describe hpa -n astromkey
</pre>Если в выходных данных <code>ScalingActive</code> установлено значение <code>false</code>, автомасштабировщик не получает данные метрик.

= API: Синтетический — API для определения локаций, нодов и конфигурации, версия 2 =
Вы можете автоматизировать развертывание и управление контейнеризированными локациями с помощью существующего '''API Synthetic - Locations, nodes, and configuration API v2'''. В этот '''API''' добавлены конечные точки раннего доступа для упрощения развертывания локаций '''Kubernetes'''. Новые конечные точки помогают генерировать команды, необходимые для выполнения в кластере '''Kubernetes'''.

Новые конечные точки для развертывания '''Kubernetes''' в зависимости от локации:

* Конечная точка '''GET location YAML''' (<code>/synthetic/locations/{LocationId}/yaml</code>) получает файл шаблона локации на основе идентификатора локации, которое вы изначально настроили для развертывания в контейнере.
* Конечная точка '''GET apply commands''' (<code>synthetic/locations/commands/apply</code>) получает список команд для развертывания локации в '''Kubernetes'''/'''OpenShift'''.
* Конечная точка '''GET delete commands''' (<code>synthetic/locations/{LocationId}/commands/delete</code>) получает команды для удаления локации в контейнере.

Прокси для частных локаций

2026-09-03T16:20:08Z

IKuznetsov: Новая страница: « = Прокси для частных локаций = В развертывание Ключ-АСТРОМ можно включать прокси-серверы, балансировщики нагрузки и обратные прокси-серверы. В частности, конфигурация АктивногоШлюза позволяет определить один или несколько прокси-серверов для исходящ...»

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

Для настройки прокси-сервера для связи с тестируемым ресурсом отредактируйте файл <code>custom.properties</code> и задайте свойства в соответствующем разделе <code>[synthetic]</code>.

Чтобы настроить прокси-сервер только для внутренней связи с кластером Ключ-АСТРОМ, см. раздел «Настройки для связи только с кластером Ключ-АСТРОМ».

Чтобы настроить один и тот же прокси-сервер как для тестируемого ресурса, так и для кластера Ключ-АСТРОМ, задайте свойства в соответствующем разделе <code>[http.client]</code>.

== Свойства конфигурации прокси ==
При настройке прокси для АктивногоШлюза с поддержкой синтетических алгоритмов можно использовать следующие свойства:
{| class="wikitable"
!Свойство
!Описание
|-
|<code>proxy-server</code>
|Адрес сервера (имя хоста или IP-адрес)
|-
|<code>proxy-port</code>
|Порт (необязательный). Если оставить поле пустым, будет использоваться порт по умолчанию <code>8080</code>.
|-
|<code>proxy-scheme</code>
|Схема (необязательный). Если поле оставить пустым, используется схема по умолчанию <code>http</code>. Применяется наиболее распространённая конфигурация, при которой соединение с прокси-сервером инициируется с использованием '''HTTP''' и автоматически преобразуется в защищённое. Вся дальнейшая связь АктивногоШлюза через прокси-сервер защищена протоколом '''SSL'''/'''TLS'''. Этот параметр необходимо установить в <code>https</code> для прокси-серверов, которые вообще не поддерживают '''HTTP'''.
|-
|<code>proxy-user</code>
|Имя пользователя (необязательный)
|-
|<code>proxy-domain</code>
|Домен пользователя в случае аутентификации '''NTLM'''
|-
|<code>proxy-password</code>
|Пароль (необязательный). После перезапуска АктивногоШлюза пароль, указанный в свойстве <code>proxy-password</code>, шифруется, и зашифрованный пароль сохраняется в свойстве <code>proxy-password-encr</code>. Если запятая (<code>,</code>) является частью значения, перед ней необходимо добавить экранирующую обратную косую черту (<code>\</code>). Например, <code>proxy-password = foo\,bar</code>.
|-
|<code>proxy-off</code>
|Если установить это значение <code>true</code>, прокси-сервер будет отключён для данного типа связи.
|-
|<code>proxy-non-proxy-hosts</code>
|. В качестве символа-заменителя можно также использовать звёздочку (<code>*</code>). Допускается только один символ-заменитель, либо в начале, либо в конце имени хоста. Например, <code><nowiki>proxy-non-proxy-hosts=*.foo.com|localhost</nowiki></code> означает, что доступ ко всем хостам в домене <code>foo.com</code> и <code>localhost</code> должен осуществляться напрямую, даже если указан прокси-сервер. Полное описание допустимого синтаксиса см. в разделе «Свойства сети» <code>http.nonProxyHosts</code> для соответствующего параметра.
|-
|<code>proxy-authentication-schemes</code>
|АктивныйШлюз версии 1.271+. Список схем аутентификации через прокси-сервер (необязательный). Это приоритетный список схем аутентификации через прокси-сервер, которые АктивныйШлюз должен использовать при аутентификации с прокси-сервером. Начиная с первой схемы в списке, АктивныйШлюз попытается выполнить аутентификацию и, в случае неудачи, перейдёт к следующей схеме в списке. Если это свойство не определено, АктивныйШлюз попытается выполнить аутентификацию, используя все доступные схемы. Поддерживаемые значения: <code>NTLM</code>, <code>BASIC</code>.
|}

== Сценарии подключения через прокси-сервер ==
Это возможные сценарии для вашей конфигурации прокси. Доступ к тестируемому ресурсу через прокси поддерживается только для браузерных мониторов и '''HTTP'''-мониторов.

=== Подключитесь к кластеру Ключ-АСТРОМ ===
<pre>
[http.client]
proxy-server=<proxy>
proxy-port=8080
proxy-user=username
proxy-password=password

[synthetic]
proxy-off=true
</pre>

=== Подключитесь одновременно к кластеру Ключ-АСТРОМ и к тестируемому ресурсу ===
<pre>
[http.client]
proxy-server=<proxy>
proxy-port=8080
proxy-user=username
proxy-password=password
</pre>

=== Подключитесь к кластеру Ключ-АСТРОМ и протестированным ресурсам через различные прокси-серверы ===
Подключитесь к кластеру Ключ-АСТРОМ:<pre>
[http.client]
proxy-server=<proxy>
proxy-port=8080
proxy-user=username
proxy-password=password
</pre>Подключитесь к проверяемому ресурсу:<pre>
[synthetic]
proxy-server=<прокси между AG и проверяемым ресурсом>
proxy-port=9090
proxy-user=username_two
proxy-password=password_two
</pre>

=== Подключитесь к проверяемому ресурсу и/или Amazon S3 ===
Для работы АктивногоШлюза с поддержкой синтетического анализа требуется доступ к сервису '''Amazon S3''' для загрузки и просмотра снимков экрана браузера в закрытых помещениях.<pre>
[synthetic]
proxy-server=<прокси между AG и проверяемым ресурсом>
proxy-port=8080
proxy-user=username
proxy-password=password
</pre>Для получения дополнительной информации см. файлы автоматической настройки прокси-сервера ('''PAC''').

=== Настройте синтетический мониторинг с прямым подключением к другим ресурсам ===
<pre>
[synthetic]
proxy-server=<прокси между AG и проверяемым ресурсом>
proxy-port=8080
proxy-user=username
proxy-password=password
proxy-non-proxy-hosts=my.corp.org|*.gdansk.astromkey.com
</pre>

== Файлы автоматической настройки прокси-сервера (PAC) ==
Для настройки сложных параметров прокси-сервера для мониторинга браузера в приватном режиме можно использовать файлы автоматической настройки прокси ('''PAC''').

=== Что такое PAC-файл? ===
Файл автоматической настройки прокси ('''PAC''') — это функция '''JavaScript''', которая определяет, будут ли запросы веб-браузера ('''HTTP''', '''HTTPS''' и '''FTP''') направляться непосредственно к месту назначения или перенаправляться на веб-прокси-сервер (подробнее см. файл автоматической настройки прокси ('''PAC''') на '''developer.mozilla.org''').

=== Предоставьте PAC-файл мониторам вашего браузера ===

# Перейдите в раздел '''Синтетический мониторинг'''.
# (Необязательно) Чтобы отфильтровать таблицу по мониторам браузеров, выберите '''Браузер''' в разделе '''Параметры фильтра''' слева.
# Из списка мониторов браузера выберите тот монитор, для которого вы хотите предоставить '''PAC'''-файл. После этого справа отобразится панель предварительного просмотра.
# В правом верхнем углу панели предварительного просмотра выберите '''Редактировать'''.
# С этого момента вы будете перенаправлены на предыдущую страницу Ключ-АСТРОМ, где сможете указать '''URL'''-адрес '''PAC'''-файла.
# Переключитесь в режим сценария.
#* Для создания clickpatch выберите '''Записанный clickpatch''' > '''Скрипт'''.
#* Для мониторинга по одному '''URL'''-адресу выберите '''Скрипт монитора'''.
# Добавьте следующее в объект <code>configuration</code> '''JSON'''-файла:
<pre>
"proxy": {
"pacUrl": "https://www.example.com/test.pac"
}
</pre>

# <code>pacUrl</code> указывает на ваш размещённый '''PAC'''-файл.

=== Совместимость конфигурации файла PAC ===

* Конфигурация '''PAC'''-файла применяется только к частным синтетическим локациям, а не к общедоступным.
* Конфигурация '''PAC'''-файла применяется только к настроенному вами монитору — для каждого отдельного монитора '''PAC'''-файл должен быть настроен в его скрипте; нет глобальной настройки для всех мониторов, позволяющей использовать '''PAC'''-файл для прокси-сервисов.
* Если вы настраиваете прокси-файл '''PAC''' для одного скрипта синтетического мониторинга, он применяется только к этому монитору.
* Если указан '''PAC'''-файл, он переопределяет настройки прокси-сервера, заданные на уровне АктивногоШлюза для связи с тестируемым ресурсом. В частности, он переопределяет свойства в соответствующем разделе <code>[synthetic]</code>.
* Файл '''PAC''' должен передаваться по протоколу '''HTTP'''/'''S'''.

== Настройка прокси-сервера для режима FIPS ==
При установке синтетической локации в режиме '''FIPS''' трафик монитора браузера должен маршрутизироваться через локальный перехватывающий прокси-сервер, чтобы весь трафик, покидающий хост, шифровался с помощью криптографической библиотеки, сертифицированной по стандарту '''FIPS''':

В этом примере мы используем прокси-сервер '''Squid''', подключённый к встроенной библиотеке '''OpenSSL''', но вы можете использовать другое прокси-программное обеспечение, если его криптографическая библиотека сертифицирована по стандарту '''FIPS'''.

Установите прокси-сервер на том же хосте, что и синтетический движок:

=== Red Hat ===
<pre>
sudo dnf install squid
</pre>

=== Ubuntu Pro ===
<pre>
sudo apt install squid-openssl
</pre>Предоставьте сертификат центра сертификации для повторной подписи перехваченных запросов:

=== Red Hat ===
<pre>
sudo mkdir /etc/squid/ssl_cert
sudo mv ~/prepared_ca_cert.pem /etc/squid/ssl_cert/squid.pem
sudo chown --recursive squid:squid /etc/squid/ssl_cert
sudo chmod 700 /etc/squid/ssl_cert
sudo chmod 600 /etc/squid/ssl_cert/squid.pem
</pre>

=== Ubuntu Pro ===
<pre>
sudo mkdir /etc/squid/ssl_cert
sudo mv ~/prepared_ca_cert.pem /etc/squid/ssl_cert/squid.pem
sudo chown --recursive proxy:proxy /etc/squid/ssl_cert
sudo chmod 700 /etc/squid/ssl_cert
sudo chmod 600 /etc/squid/ssl_cert/squid.pem
</pre>Если включена функция '''SELinux''', может потребоваться корректировка меток файлов. Подробности см. в документации '''Red Hat''' для '''Red Hat Enterprise Linux 8''' или '''Red Hat Enterprise Linux 9'''.

Создать временный кэш сертификатов:

=== Red Hat ===
<pre>
sudo /usr/lib64/squid/security_file_certgen -c -s /var/spool/squid/ssl_db -M 4MB
sudo chown --recursive squid:squid /var/spool/squid/ssl_db
</pre>

=== Ubuntu Pro ===
<pre>
sudo /usr/lib/squid/security_file_certgen -c -s /var/spool/squid/ssl_db -M 4MB
sudo chown --recursive proxy:proxy /var/spool/squid/ssl_db
</pre>Настройте прокси-сервер для перехвата '''SSL'''-сообщений (по умолчанию <code>/etc/squid/squid.conf</code>):<pre>
acl SSL_ports port 443
acl Safe_ports port 80 443 1025-65535
acl CONNECT method CONNECT

http_access deny !Safe_ports
http_access deny CONNECT !SSL_ports
http_access allow localhost
http_access deny all
http_port 3128 ssl-bump generate-host-certificates=on dynamic_cert_mem_cache_size=4MB cert=/etc/squid/ssl_cert/squid.pem

acl step1 at_step SslBump1
ssl_bump peek step1
ssl_bump bump all
cache deny all
</pre>Для вступления изменений в силу перезапустите прокси-сервер:<pre>
sudo systemctl enable squid
sudo systemctl restart squid
</pre>Убедитесь, что прокси-сервер работает корректно:<pre>
curl --proxy localhost:3128 https://example.com
</pre>(Необязательно) Если вы выбрали другой порт прокси, вам необходимо настроить синтетическую конфигурацию (по умолчанию <code>/var/lib/astromkey/synthetic/config/user.properties</code>):<pre>
com.vuc.fips.proxy.port=3128
</pre>

== Настройка прокси-сервера для режима FIPS с использованием корпоративного прокси ==
Если в вашей организации требуется использование корпоративного прокси-сервера, вам необходимо настроить второй локальный экземпляр '''Squid''' из-за ограничений '''Squid''':

Если вы используете другое прокси-программное обеспечение, это может быть к вам неактуально.

# Настройте прокси-сервер для '''FIPS''', как описано в предыдущем разделе.
# Требуется определённая версия '''Squid 5+''', поэтому версии '''Red Hat 8''' и '''Ubuntu 20''' не поддерживаются.
# На том же хосте создайте второе определение службы '''Squid''':

=== Red Hat ===
<pre>
/usr/lib/systemd/system/squid2.service

[Unit]
Description: Squid with upstream proxy.
After=network.target network-online.target nss-lookup.target

[Service]
Type=notify
LimitNOFILE=16384
PIDFile=/run/squid2.pid
ExecStart=/usr/sbin/squid --foreground -n squid2 -f "/etc/squid/squid2.conf"
ExecReload=/usr/bin/kill -HUP $MAINPID
KillMode=mixed
NotifyAccess=all

[Install]
WantedBy=multi-user.target
</pre>

=== Ubuntu Pro ===
<pre>
/lib/systemd/system/squid2.service

[Unit]
Description: Squid with upstream proxy.
After=network.target network-online.target nss-lookup.target

[Service]
Type=notify
PIDFile=/run/squid2.pid
Group=proxy
RuntimeDirectory=squid2
RuntimeDirectoryMode=0775
ExecStart=/usr/sbin/squid --foreground -sYC -n squid2 -f "/etc/squid/squid2.conf"
ExecReload=/bin/kill -HUP $MAINPID
KillMode=mixed
NotifyAccess=all

[Install]
WantedBy=multi-user.target
</pre>Создайте вторую конфигурацию прокси-сервера (<code>/etc/squid/squid2.conf</code>) и укажите хост, порт и аутентификацию вашего корпоративного прокси-сервера:<pre>
acl SSL_ports port 443
acl Safe_ports port 80 443 1025-65535
acl CONNECT method CONNECT

http_access deny !Safe_ports
http_access deny CONNECT !SSL_ports
http_access allow localhost
http_access deny all
http_port 3129

access_log daemon:/var/log/squid/access2.log squid
cache_log /var/log/squid/cache2.log
pid_filename /run/squid2.pid

cache_peer upstream-proxy.example.com parent 443 0 default no-digest proxy-only login=proxyuser:proxypass tls tls-min-version=1.2 tls-options=NO_SSLv3
never_direct allow all
visible_hostname squid2
cache deny all
</pre>Обновите конфигурацию первого прокси-сервера (<code>/etc/squid/squid.conf</code>), чтобы использовать второй прокси-сервер в качестве родительского, добавив следующие строки:<pre>
cache_peer localhost parent 3129 0 default no-digest proxy-only
never_direct allow all
visible_hostname squid1
</pre>Перезапустите обе службы '''Squid''':<pre>
sudo systemctl daemon-reload
sudo systemctl enable squid2
sudo systemctl start squid2
sudo systemctl restart squid
</pre>Убедитесь, что цепочка прокси-серверов работает корректно:<pre>
curl --proxy localhost:3128 https://example.com
</pre>

== Вопросы распределения ресурсов ==

* Каждому сервису '''Squid''' требуется дополнительно 500 МиБ оперативной памяти, что необходимо учитывать при выборе размера экземпляра для конкретной рабочей нагрузки.
* Запросы, проходящие через несколько прокси-серверов, будут выполняться дольше, поэтому показатели производительности будут хуже, чем у запросов от экземпляра, не соответствующего стандарту '''FIPS'''.

Управление частными локациями

2026-09-03T16:17:20Z

IKuznetsov: Новая страница: « = Управление частными локациями = Чтобы просмотреть и управлять частными локациями, перейдите на вкладку '''Частные локации''' в '''Синтетическом мониторинге'''. == Состояние здоровья == В столбце '''Состояние здоровья''' списка частных синтетических локаций...»

= Управление частными локациями =
Чтобы просмотреть и управлять частными локациями, перейдите на вкладку '''Частные локации''' в '''Синтетическом мониторинге'''.

== Состояние здоровья ==
В столбце '''Состояние здоровья''' списка частных синтетических локаций вы можете увидеть состояние здоровья АктивныхШлюзов для каждой частной локации в вашей среде. Столбец содержит три подстолбца:

* '''Предупреждения о состоянии здоровья''' — в этих предупреждениях отображаются причины возникновения проблем со здоровьем АктивныхШлюзов. Предупреждения также выделяются цветными индикаторами в зависимости от степени серьезности проблемы:
** Жёлтый:
*** '''Емкость''' — использование емкости хотя бы одного типа синтетических мониторов превышает 80%.
*** '''Резервирование''' — если какой-либо АктивныйШлюз выйдет из строя, это может привести к тому, что частная локация будет использоваться сверх своей максимальной пропускной способности.
*** '''Совместимость''' — по крайней мере один АктивныйШлюз не поддерживает хотя бы один тип монитора, назначенный данной локации. Для получения подробной информации обратитесь к предупреждению ('''Warning''') в столбце '''Назначенные мониторы'''.
** Красный:
*** '''Емкость''' — использование емкости хотя бы одного типа синтетических мониторов превышает 90%.
*** '''Вне сети AG''' — как минимум один АктивныйШлюз не работает.
*** '''Проблема с подключением''' — недоступна частная локация. Это происходит, когда к частной локации не назначены АктивныеШлюзы.
*** '''Отменено''' — за последние 30 минут было выполнено как минимум одно отменённое выполнение монитора.

* '''ActiveGates''' — количество устройств АктивныхШлюзов, назначенных определённой локации в зависимости от состояния здоровья. Состояние здоровья обозначается одним из следующих цветов:
** Зелёный цвет — нет проблем с АктивнымиШлюзами.
** Жёлтый цвет означает, что у одного или нескольких устройств АктивногоШлюза возникли проблемы, которые пока не являются серьёзными, но могут потребовать внимания.
** Красный цвет означает, что в одном или нескольких устройствах АктивныхШлюзов возникли серьёзные проблемы, требующие немедленного решения.

* '''Назначенные мониторы''' — тип и количество синтетических мониторов, назначенных данной локации. Количество '''HTTP'''-мониторов также включает '''HTTP'''-мониторы с высокими требованиями к ресурсам.

Даже если не зафиксировано никаких проблем, связанных с АктивнымиШлюзами в данной локации, может наблюдаться следующее поведение:

* Метрика <code>dt.sfm.synthetic.location.health_status</code> отображает <code>FAILOVER_WARNING</code> для данной локации.
* В столбце '''Предупреждения о состоянии здоровья''' в пользовательском интерфейсе отображается жёлтое предупреждение о избыточности для данной локации.

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

Для каждого типа мониторов Ключ-АСТРОМ:

* Собирает следующие данные о нагрузке/использовании сети за последние 30 минут, используя указанные метрики:
** Загрузка АктивногоШлюза: значение метрики <code>dt.sfm.location.executions</code> для каждого типа монитора.
** Использование АктивногоШлюза: значение метрики <code>dt.sfm.synthetic.__monitor_type__.engine_utilization</code>. Например, для браузерных мониторов метрика выглядит так: <code>dt.sfm.synthetic.browser.engine_utilization</code>.
* Определяет наиболее загруженный АктивныйШлюз (АктивныйШлюз с наибольшей нагрузкой за последние 30 минут).

* Анализирует общее количество выполнений, совершённых сотрудниками, следящими за ситуацией в данной локации, за последние 30 минут.

* Вычисляет, какой объём пропускной способности останется, если выйдет из строя самый загруженный АктивныйШлюз. Если хотя бы для одного типа мониторов оставшимся АктивнымШлюзам придётся обрабатывать более 95% операций, выполняемых мониторами данной локации в течение 30 минут, то оставшаяся пропускная способность ниже безопасного предела, и отображается предупреждение.

== Посмотреть подробную информацию о локации и отредактировать локацию ==
Выберите локацию, чтобы просмотреть её подробные сведения и отредактировать её. Для классических локаций вы можете увидеть назначенные им АктивныеШлюзы. Они отображаются красным цветом, когда синтетический движок или сам АктивныйШлюз находятся в автономном режиме; в столбце '''Статус''' отображается соответствующее сообщение.

Идентификатор АктивногоШлюза можно увидеть в столбце, который по умолчанию скрыт. Чтобы отобразить его, выберите значок столбцов > '''Идентификатор АктивногоШлюза''' > '''Применить'''.

Добавить или удалить АктивныеШлюзы можно на странице с подробной информацией о локации. Также можно внести другие изменения и нажать кнопку '''Сохранить''', чтобы сохранить их.

== Диагностика ==
На карте '''Диагностика''' отображается состояние здоровья каждого типа монитора.

* '''Использование ресурсов''' — показатель использования ресурсов для данного типа монитора. Если использование ресурсов составляет менее 80%, в столбце отображается значение <code>OK</code>, а если данных нет, отображается значение <code>0</code>.
* '''Совместимость''' — количество устройств АктивногоШлюза, поддерживающих определённый тип монитора. Например, если к локации назначено три устройства АктивногоШлюза, но только два из них поддерживают данный тип монитора, вы увидите <code>2/3</code>.
* '''Мониторы''' — количество мониторов по типам, назначенных для данной локации.
* '''Количество выполнений в час''' — число выполнений в час для определённого типа монитора.
* '''ActiveGates''' — количество активных шлюзов АктивныхШлюзов, назначенных локации. Сюда также входит количество отключённых шлюзов АктивныхШлюзов. Например, если к локации назначено три шлюза АктивныхШлюзов, но один из них отключён, вы увидите <code>1/3</code>.

Для параметров '''Использование емкости''', '''Совместимость''' и '''Активные шлюзы''' состояние работоспособности дополнительно обозначается одним из следующих цветов:

* Зелёный — никаких проблем.
* Жёлтым цветом обозначены проблемы, которые пока не являются серьёзными, но могут потребовать внимания.
* Красный цвет означает наличие серьёзных проблем, требующих немедленного внимания.

== Показатели состояния здоровья ==
Для построения графиков и формирования оповещений доступны метрики состояния каждого типа мониторов. Метрики для построения графиков и формирования оповещений о состоянии каждого типа мониторов доступны в блокнотах. Например, для построения графиков и формирования оповещений можно выбрать следующие метрики:

* Синтетический HTTP — Использование движка
* Синтетический HTTP — Высокая загрузка ресурсов — Использование поискового движка
* Синтетический — Браузер — Использование движка

Мы настоятельно рекомендуем разделить эти показатели по локациям, чтобы получить точное представление о состоянии сети в каждом регионе.

== Обработка сбоев в работе локации ==
Для каждой локации включите соответствующие переключатели, чтобы генерировать ошибки при недоступности локации или любого из её механизмов АктивногоШлюза. В настоящее время доступны следующие переключатели:

* Проблема может возникнуть, если вся частная локация недоступна (все АктивныеШлюзы отключены) или если локация не обладает необходимыми возможностями для выполнения заданного типа мониторинга.
* Проблема может возникнуть, если хотя бы один из АктивныхШлюзов в этой локации будет отключён.

Например, предположим, что в вашей локации установлено два АктивныхШлюза, и вы включаете оба переключателя проблем. В случае недоступности вашей локации вы увидите три проблемы — одну для всей локации и по одной для каждого отключённого АктивногоШлюза.

Для контейнеризированных локаций проблема может возникнуть только в том случае, если вся частная локация недоступна (все АктивныеШлюзы отключены) или если локация не обладает необходимыми возможностями для выполнения мониторинга соответствующего типа.

Установка и обновление Chromium для Linux

2026-09-03T16:15:30Z

IKuznetsov: /* Red Hat Enterprise Linux, Oracle Linux 8 и Rocky Linux */

= Установка и обновление Chromium для Linux =
Если установка через веб-интерфейс не удалась или вы предпочитаете самостоятельно подготовить хост для синтетического движка, вы можете установить '''Chromium''' и другие зависимости вручную или из собственного репозитория.

== Установка браузера и зависимостей вручную из S3 ==
Этот раздел неактуален для сайтов, не использующих браузер.

=== Amazon Linux 2023, Ubuntu и Oracle Linux 9 ===
В '''Amazon Linux 2023''', '''Ubuntu''' и '''Oracle Linux 9''' вместо '''Chromium''' используется '''Chrome for Testing'''. Инструкции по ручной установке '''Chrome for Testing''' в этих операционных системах см. в разделе «Amazon Linux 2023, Ubuntu и Oracle Linux 9 (Chrome for Testing)».

Убедитесь, что у вас есть возможность подключиться к <code><nowiki>https://synthetic-packages.s3.amazonaws.com</nowiki></code> для доступа к пакетам браузера. В целях безопасности публичный доступ к хранилищу '''S3''' разрешён только для определённых файлов; попытка доступа к чему-либо другому приведёт к ошибке 403.

См. также раздел «Установка браузера из пользовательского репозитория» ниже.

Инструкции по обновлению браузера вручную см. в разделе «Управление частными синтетическими расположениями в Classic». Мы настоятельно рекомендуем обновлять версии АктивногоШлюза и браузера на базе '''Linux''' с поддержкой синтетических вычислений — Ключ-АСТРОМ поддерживает версии браузера, отстающие от последней поддерживаемой Ключ-АСТРОМ версии не более чем на две версии для конкретного выпуска АктивногоШлюза.

=== Ubuntu Server 20.04 и 22.04 ===
Этот раздел актуален только для версий 1.329 и более ранних.

'''Установите зависимости синтетического движка:'''<pre>
sudo apt-get update && sudo apt-get -y install xvfb x11-xkb-utils xfonts-100dpi xfonts-75dpi xfonts-scalable libnss3-tools auditd
</pre>'''Зависимости Chromium:'''<pre>
sudo apt-get -y install fonts-dejavu-core
sudo snap install gnome-3-38-2004 gtk-common-themes
</pre>'''Скачайте и установите Chromium.'''

Загрузите архив пакетов snap (для '''Ubuntu Server 20.04''' и '''22.04'''). Это безопасный и проверенный архив, размещённый на Ключ-АСТРОМ.

'''Версия АктивногоШлюза 1.329'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/snap/chromium-142.0.7444.175-3313.tgz
</pre>'''Версия АктивногоШлюза 1.327'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/snap/chromium-141.0.7390.122-3285.tgz
</pre>'''Версия АктивногоШлюза 1.325'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/snap/chromium-140.0.7339.185-3251.tgz
</pre>'''Версия АктивногоШлюза 1.323'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/snap/chromium-139.0.7258.138-3235.tgz
</pre>'''Версия АктивногоШлюза 1.321'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/snap/chromium-138.0.7204.157-3203.tgz
</pre>Подлинность пакетов можно проверить с помощью файлов подписей, хранящихся вместе с архивами пакетов.

'''Распакуйте установочные пакеты.''' Перейдите в каталог, куда вы сохранили архив, и выполните следующую команду:<pre>
mkdir /tmp/chromium ; tar xzf chromium.tgz -C /tmp/chromium
</pre>Это создаст директорию <code>/tmp/chromium</code> и извлечёт в неё пакеты.

'''Установите извлечённые пакеты.'''<pre>
sudo chown -R root:root /tmp/snap-private-tmp
sudo snap ack /tmp/chromium/chromium.assert
sudo snap install --devmode /tmp/chromium/chromium.snap
</pre>Если они отличаются от значений по умолчанию, замените <code>dtuserag</code> их именами пользователя и группы службы АктивногоШлюза.<pre>
sudo chown -R dtuserag:dtuserag /tmp/snap-private-tmp
</pre>Это установит все пакеты, извлечённые в указанную директорию. После успешной установки '''Chromium''' вы можете удалить директорию <code>/tmp/chromium/</code> и загруженный архив <code>chromium.tgz</code>.

После того как вы удовлетворите все зависимости, запустите установщик АктивногоШлюза с правами root, установив параметр <code>--enable-synthetic</code> в значение <code>manual</code>. Например:<pre>
/bin/bash ./astromkey-ActiveGate-Linux.sh --enable-synthetic=manual
</pre>Подлинность пакетов можно проверить с помощью файлов подписей, хранящихся вместе с архивами пакетов.

=== Red Hat Enterprise Linux, Oracle Linux 8 и Rocky Linux ===
'''Установка Chromium необходима, если для доступа в интернет требуется прокси-сервер.''' Если вам необходимо загрузить и установить '''Chromium''', и вашей системе требуется прокси-сервер для доступа в интернет, вам следует настроить <code>curl</code> использование правильного прокси. Укажите данные прокси и порта, выполнив команды, как показано в этом примере:<pre>
vi /root/.curlrc
proxy=http://proxy.example.com:8080
</pre>'''Настройте репозитории и установите зависимости.'''

==== Red Hat 9 ====
Зарегистрируйте экземпляр '''Red Hat''':<pre>
sudo subscription-manager register --auto-attach
</pre>Включите репозитории '''Red Hat Extras''' и '''Optional''', а также '''EPEL''' (дополнительные пакеты для Enterprise Linux):<pre>
sudo subscription-manager repos --enable rhel-9-for-x86_64-baseos-rpms
sudo subscription-manager repos --enable rhel-9-for-x86_64-appstream-rpms
sudo rpm -Uvh https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
</pre>Установите зависимости синтетического движка:<pre>
sudo dnf install -y xorg-x11-server-Xvfb xkbcomp xorg-x11-server-utils xorg-x11-fonts-100dpi xorg-x11-fonts-75dpi xorg-x11-fonts-Type1 libwayland-server mesa-libgbm curl nss-tools
</pre>

==== Oracle Linux 8 ====
Устаревшая операционная система: АктивныйШлюз версии 1.325 — это последняя версия АктивногоШлюза с поддержкой синтетического анализа, которая поддерживает '''Oracle Linux 8'''.

Включить '''EPEL''' (Дополнительные пакеты для Enterprise Linux):<pre>
sudo dnf install -y oracle-epel-release-el8
</pre>Установите зависимости синтетического движка:<pre>
sudo dnf install -y xorg-x11-server-Xvfb xorg-x11-xkb-utils xorg-x11-server-utils xorg-x11-fonts-100dpi xorg-x11-fonts-75dpi xorg-x11-fonts-Type1 libwayland-server mesa-libgbm curl nss-tools
</pre>

==== Rocky Linux 8 ====
Устаревшая операционная система: АктивныйШлюз версии 1.325 — это последняя версия АктивногоШлюза с поддержкой синтетического анализа, которая поддерживает '''Rocky Linux 8'''.

Включить '''EPEL''' (Дополнительные пакеты для Enterprise Linux):<pre>
sudo dnf install epel-release
</pre>Установите зависимости синтетического движка:<pre>
sudo dnf install -y xorg-x11-server-Xvfb xorg-x11-xkb-utils xorg-x11-server-utils xorg-x11-fonts-100dpi xorg-x11-fonts-75dpi xorg-x11-fonts-Type1 libwayland-server mesa-libgbm curl nss-tools
</pre>'''Скачайте и установите Chromium.'''

Загрузите архив с пакетом rpm. Это безопасный и проверенный архив, размещённый на сервере Ключ-АСТРОМ.

'''Версия АктивногоШлюза 1.345 (Red Hat Enterprise Linux/Rocky Linux 9)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-151.0.7922.137-1.el9.tgz
</pre>'''Версия АктивногоШлюза 1.343 (Red Hat Enterprise Linux/Rocky Linux 9)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-150.0.7871.128-1.el9.tgz
</pre>'''Версия АктивногоШлюза 1.341 (Red Hat Enterprise Linux/Rocky Linux 9)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-148.0.7778.215-1.el9.tgz
</pre>'''Версия АктивногоШлюза 1.339 (Red Hat Enterprise Linux/Rocky Linux 9)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-147.0.7727.137-1.el9.tgz
</pre>'''Версия АктивногоШлюза 1.337 (Red Hat Enterprise Linux/Rocky Linux 9)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-146.0.7680.177-1.el9.tgz
</pre>'''Версия АктивногоШлюза 1.335 (Red Hat Enterprise Linux/Rocky Linux 9)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-146.0.7680.177-1.el9.tgz
</pre>'''Версия АктивногоШлюза 1.333 (Red Hat Enterprise Linux/Rocky Linux 9)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-144.0.7559.132-1.el9.tgz
</pre>'''Версия АктивногоШлюза 1.331 (Red Hat Enterprise Linux/Rocky Linux 9)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-143.0.7499.192-1.el9.tgz
</pre>'''Версия АктивногоШлюза 1.329 (Red Hat Enterprise Linux/Rocky Linux 9)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-142.0.7444.175-2.el9.tgz
</pre>'''Версия АктивногоШлюза 1.327 (Red Hat Enterprise Linux/Rocky Linux 9)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-141.0.7390.122-1.el9.tgz
</pre>'''Версия АктивногоШлюза 1.325 (Red Hat Enterprise Linux/Oracle/Rocky Linux 8)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-133.0.6943.141-1.el8.tgz
</pre>'''Версия АктивногоШлюза 1.325 (Red Hat Enterprise Linux/Rocky Linux 9)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-140.0.7339.185-1.el9.tgz
</pre>'''Версия АктивногоШлюза 1.323 (Red Hat Enterprise Linux/Oracle/Rocky Linux 8)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-133.0.6943.141-1.el8.tgz
</pre>'''Версия АктивногоШлюза 1.323 (Red Hat Enterprise Linux/Rocky Linux 9)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-139.0.7258.138-1.el9.tgz
</pre>'''Версия АктивногоШлюза 1.321 (Red Hat Enterprise Linux/Oracle/Rocky Linux 8)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-133.0.6943.141-1.el8.tgz
</pre>'''Версия АктивногоШлюза 1.321 (Red Hat Enterprise Linux/Rocky Linux 9)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-138.0.7204.157-1.el9.tgz
</pre>Подлинность пакетов можно проверить с помощью файлов подписей, хранящихся вместе с архивами пакетов.

'''Распакуйте установочные пакеты.''' Перейдите в каталог, куда вы сохранили архив, и выполните следующую команду:<pre>
mkdir /tmp/chromium ; tar xzf chromium.tgz -C /tmp/chromium
</pre>'''Установите извлечённые пакеты.'''<pre>
sudo dnf install -y /tmp/chromium/*.rpm
</pre>После успешной установки '''Chromium''' вы можете удалить директорию <code>/tmp/chromium/</code> и загруженный архив <code>chromium.tgz</code>.

'''Отключите автоматическое обновление пакетов Chromium:'''<pre>
sudo dnf -y install python3-dnf-plugin-versionlock
sudo dnf versionlock add chromium
sudo dnf versionlock add chromium-common
</pre>(Необязательно) Установите шрифты TrueType, не содержащие латинские символы:<pre>
sudo dnf install dejavu-fonts-common.noarch dejavu-sans-fonts.noarch
</pre>После того как вы удовлетворите все зависимости, запустите установщик АктивногоШлюза с правами root, установив параметр <code>--enable-synthetic</code> в значение <code>manual</code>. Например:<pre>
/bin/bash ./astromkey-ActiveGate-Linux.sh --enable-synthetic=manual
</pre>

=== Amazon Linux 2023, Ubuntu и Oracle Linux 9 (Chrome for Testing) ===
В отличие от '''Chromium''' в других дистрибутивах, обновления '''Chrome for Testing''' не используют менеджеры пакетов. Вы вручную управляете исполняемыми файлами '''Chrome''', а зависимости управляются системным менеджером пакетов.

На '''Ubuntu Server 20.04''' и '''22.04''' '''Chrome for Testing''' поддерживается начиная с версии 1.331.

'''Настройте репозитории и установите зависимости.'''

==== Ubuntu 20/22 ====
Установите зависимости синтетического движка:<pre>
sudo apt-get update && sudo apt-get -y install xvfb x11-xkb-utils xfonts-100dpi xfonts-75dpi xfonts-scalable libnss3-tools auditd fonts-dejavu-core
</pre>Установите зависимости '''Chrome for Testing''':<pre>
sudo apt-get -y install libasound2 libatk-bridge2.0-0 libatk1.0-0 libcairo2 libcups2 libgbm1 libnspr4 libnss3 libpango-1.0-0 libxcomposite1 libxdamage1 libxfixes3 libxkbcommon0 libxrandr2
</pre>

==== Oracle Linux 9 ====
Включить '''EPEL''' (Дополнительные пакеты для Enterprise Linux):<pre>
sudo dnf install -y oracle-epel-release-el9
</pre>Установите зависимости синтетического движка:<pre>
sudo dnf install -y lsof psmisc xorg-x11-server-Xvfb xkbcomp xorg-x11-server-utils xorg-x11-fonts-100dpi xorg-x11-fonts-75dpi xorg-x11-fonts-Type1 nss-tools unzip
</pre>Установите зависимости '''Chrome for Testing''':<pre>
sudo dnf install -y alsa-lib at-spi2-atk atk cairo cups-libs libXcomposite libXdamage libXrandr libxkbcommon mesa-libgbm nspr nss pango
</pre>'''Скачайте и настройте Chrome for Testing.'''

Создайте каталог '''Chrome for Testing''':<pre>
sudo mkdir -p /usr/lib/chrome_for_testing
</pre>Загрузите архив пакета '''Chrome for Testing''' во временное местоположение. Это безопасный и проверенный архив, размещённый на сервере Ключ-АСТРОМ.

'''Версия АктивногоШлюза 1.345'''<pre>
curl --output /tmp/chrome.zip https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-151.0.7922.138.zip
</pre>'''Версия АктивногоШлюза 1.343'''<pre>
curl --output /tmp/chrome.zip https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-150.0.7871.181.zip
</pre>'''Версия АктивногоШлюза 1.341'''<pre>
curl --output /tmp/chrome.zip https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-148.0.7778.215.zip
</pre>'''Версия АктивногоШлюза 1.339'''<pre>
curl --output /tmp/chrome.zip https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-147.0.7727.137.zip
</pre>'''Версия АктивногоШлюза 1.337'''<pre>
curl --output /tmp/chrome.zip https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-146.0.7680.178.zip
</pre>'''Версия АктивногоШлюза 1.335'''<pre>
curl --output /tmp/chrome.zip https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-146.0.7680.178.zip
</pre>'''Версия АктивногоШлюза 1.333'''<pre>
curl --output /tmp/chrome.zip https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-144.0.7559.133.zip
</pre>'''Версия АктивногоШлюза 1.331'''<pre>
curl --output /tmp/chrome.zip https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-143.0.7499.192.zip
</pre>'''Версия АктивногоШлюза 1.329'''<pre>
curl --output /tmp/chrome.zip https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-142.0.7444.175.zip
</pre>'''Версия АктивногоШлюза 1.327'''<pre>
curl --output /tmp/chrome.zip https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-141.0.7390.122.zip
</pre>Подлинность пакетов можно проверить с помощью файлов подписей, хранящихся вместе с архивами пакетов.

'''Распакуйте установочный пакет и выполните очистку:'''<pre>
sudo unzip /tmp/chrome.zip -d /usr/lib/chrome_for_testing
rm /tmp/chrome.zip
</pre>Это создаст директорию <code>chrome-linux64</code> внутри <code>/usr/lib/chrome_for_testing</code> и извлечёт в неё исполняемый файл '''Chrome''' и вспомогательные файлы.

'''Проверьте работоспособность Chrome for Testing''', убедившись, что он поддерживает следующую версию:<pre>
/usr/lib/chrome_for_testing/chrome-linux64/chrome --version
</pre>В результате выполнения команды должна отобразиться загруженная вами версия '''Chrome'''.

После того как вы устраните все зависимости, запустите установщик АктивногоШлюза с правами root. Установщик автоматически обнаружит и проверит '''Chrome for Testing'''. Например:<pre>
/bin/bash ./astromkey-ActiveGate-Linux.sh --enable-synthetic=manual
</pre>'''Настройка каталога Chrome for Testing:''' Если вы хотите использовать другой каталог, отличный от каталога по умолчанию <code>/usr/lib/chrome_for_testing</code>, укажите его с помощью переменной среды <code>CFT_DIR</code> во время установки:<pre>
CFT_DIR=/custom/path /bin/bash ./astromkey-ActiveGate-Linux.sh --enable-synthetic=manual
</pre>Вы также можете настроить путь, задав соответствующее свойство <code>synthetic_chrome_for_testing_path</code> в файле <code>custom.properties</code> после установки. Новая директория будет использоваться после обновления модуля '''Synthetic'''.

Файлы '''Chrome for Testing''' сохраняются во время удаления АктивногоШлюза. Если вы удалите АктивныйШлюз, каталог '''Chrome for Testing''' и его содержимое останутся в системе и могут быть использованы повторно при переустановке.

== Обновление браузера вручную из S3 ==
Если у вас автономная среда, или вы установили АктивныйШлюз вручную для управления зависимостями, или из-за ограниченного доступа к '''Amazon S3''', вам необходимо обновить браузер и зависимости вручную.

Для каждого АктивногоШлюза необходимо вручную обновить браузер, и процесс немного различается в зависимости от операционной системы. Обратите внимание, что ручное обновление браузера применимо только к АктивномуШлюзу на базе '''Linux'''; на АктивномШлюзе на базе '''Windows''' браузер обновляется автоматически во время обновления синтетического движка.

'''Предварительные требования:'''

* Убедитесь, что для вашего местоположения отключено автоматическое обновление '''Chrome(-ium)'''. Если вы отключите автоматическое обновление для какого-либо местоположения, вам потребуется обновить браузер вручную на каждом устройстве АктивногоШлюза, подключённом к этому местоположению.
* Убедитесь, что у вас есть возможность подключиться к <code><nowiki>https://synthetic-packages.s3.amazonaws.com</nowiki></code> для доступа к пакетам браузера.
* После завершения обновления синтетический движок будет использовать новую версию браузера — обратите внимание, что статус обновляется раз в час, поэтому обновление версии браузера, отображаемой для вашего АктивногоШлюза в статусе развертывания, может занять до часа.
* Мы настоятельно рекомендуем обновлять версии ваших АктивныхШлюзов с поддержкой синтетического тестирования на базе '''Linux''' и браузеров — Ключ-АСТРОМ поддерживает версии браузеров, отстающие от последней поддерживаемой Ключ-АСТРОМ версии для конкретного выпуска АктивногоШлюза не более чем на две версии.
* Мы настоятельно рекомендуем обновить все устройства АктивныхШлюзов в каждом местоположении до одной и той же версии.
* См. также автоматическое обновление браузера из пользовательского репозитория.
* Начиная с АктивногоШлюза 1.331, на '''Ubuntu Server 20.04''' и '''22.04''' мы используем '''Chrome for Testing'''. Поддержка дистрибутива '''Chromium Snap''' прекращена. Если вы используете автоматизацию для обновления браузера, переведите её на использование '''Chrome for Testing'''.

=== Ubuntu (Snap) ===
Если ваши версии АктивногоШлюза и '''Chromium''' больше не поддерживаются или не обновлялись в течение нескольких выпусков, проверьте зависимости '''Synthetic Engine''' и '''Chromium''' и переустановите их при необходимости. См. инструкции по ручной установке для '''Ubuntu Server'''.

Загрузите архив пакетов snap (для '''Ubuntu Server 20.04''' и '''22.04''') с <code>https://synthetic-packages.s3.amazonaws.com</code>. Обязательно используйте команду, указанную для вашей версии АктивногоШлюза и '''Ubuntu Server''' в инструкциях по ручной установке '''Ubuntu Server'''.

Распакуйте и установите загруженные пакеты. Убедитесь, что используете правильную команду установки для вашей версии '''Ubuntu Server''' (см. инструкции по ручной установке для '''Ubuntu Server''').

Проверьте обновление '''Chromium''', выполнив следующую команду из каталога установки по умолчанию. Результат выполнения команды должен соответствовать установленной вами версии '''Chromium''':<pre>
/opt/astromkey/synthetic/browser --version
</pre>

=== Red Hat Enterprise Linux ===
Если вы установили '''Chromium''' вручную, то во время обновления нет необходимости регистрировать экземпляр '''Red Hat''' в менеджере подписок, а также включать репозитории '''Red Hat''' или пакеты '''EPEL'''.

Если ваши версии АктивногоШлюза и '''Chromium''' давно не обновлялись, возможно, вам потребуется снова установить зависимости движка '''Synthetic'''. См. инструкции по ручной установке для '''Red Hat Enterprise Linux''', '''Oracle Linux''' и '''Rocky Linux'''.

Загрузите архив с пакетом rpm с <code><nowiki>https://synthetic-packages.s3.amazonaws.com</nowiki></code>. Обязательно используйте команду, указанную для вашей версии АктивногоШлюза и ОС в инструкциях по ручной установке для '''Red Hat Enterprise Linux''', '''Oracle Linux''' и '''Rocky Linux'''.

Распакуйте и установите загруженные пакеты. Инструкции по ручной установке для '''Red Hat Enterprise Linux''', '''Oracle Linux''' и '''Rocky Linux''' см. в сопроводительных документах.

При необходимости отключите автоматическое обновление пакетов '''Chromium'''. Обратите внимание, что для '''Red Hat Enterprise Linux''' и '''CentOS''' блокировка пакетов, однажды выполненная, сохраняется при всех последующих обновлениях.<pre>
sudo dnf -y install python3-dnf-plugin-versionlock
sudo dnf versionlock add chromium
sudo dnf versionlock add chromium-common
</pre>Проверьте обновление '''Chromium''', выполнив следующую команду из каталога установки по умолчанию:<pre>
/opt/astromkey/synthetic/browser --version
</pre>

=== Amazon Linux 2023, Ubuntu и Oracle Linux 9 (Chrome for Testing) ===
'''Chrome for Testing''' управляется иначе, чем '''Chromium'''. Для обновления вручную загрузите новую версию и распакуйте её в каталог '''Chrome for Testing'''.

В отличие от '''Chromium''' в других дистрибутивах, обновления '''Chrome for Testing''' не используют менеджеры пакетов. Вы вручную управляете исполняемыми файлами '''Chrome''', а зависимости управляются системным менеджером пакетов.

'''Ubuntu Server 20.04 и 22.04'''

При переходе с '''Chromium Snap''' сначала обновите АктивныйШлюз, затем установите '''Chrome for Testing''' и, при необходимости, удалите файлы '''Chromium Snap'''.

Если ваши версии АктивногоШлюза и '''Chrome for Testing''' давно не обновлялись, возможно, вам стоит проверить и снова установить зависимости '''Synthetic Engine''' и '''Chrome for Testing'''. См. инструкции по ручной установке '''Chrome for Testing'''.

Загрузите архив пакета '''Chrome for Testing''' во временное местоположение. Это безопасный и проверенный архив, размещённый Ключ-АСТРОМ по адресу <code>https://synthetic-packages.s3.amazonaws.com</code>. Обязательно используйте команду, указанную для вашей версии АктивногоШлюза в инструкциях по ручной установке '''Chrome for Testing''', но измените путь вывода на <code>/tmp/chrome.zip</code>.

Удалите старую папку '''Chrome for Testing''', распакуйте новую версию и выполните очистку:<pre>
sudo rm -rf /usr/lib/chrome_for_testing/chrome-linux64
sudo unzip /tmp/chrome.zip -d /usr/lib/chrome_for_testing
rm /tmp/chrome.zip
</pre>Если вы настроили собственный каталог '''Chrome for Testing''' с помощью переменной среды <code>CFT_DIR</code> или свойства <code>synthetic_chrome_for_testing_path</code> в файле <code>custom.properties</code>, замените <code>/usr/lib/chrome_for_testing</code> на свой пользовательский путь в приведённых выше командах.

Проверьте наличие обновлений '''Chrome for Testing''', выполнив следующую команду:<pre>
/usr/lib/chrome_for_testing/chrome-linux64/chrome --version
</pre>Синтетический движок немедленно начнёт использовать новую версию '''Chrome for Testing'''. Обратите внимание, что статус обновляется раз в час, поэтому обновление версии '''Chrome''', отображаемой для вашего АктивногоШлюза в статусе развертывания, может занять до часа.

== Установка браузера из собственного репозитория ==
АктивныйШлюз версии 1.243+. Помимо установки АктивногоШлюза через веб-интерфейс и ручной установки браузера и зависимостей, вы также можете установить АктивныйШлюз, указав пользовательский локальный репозиторий компонентов браузера. Поскольку этот репозиторий представляет собой '''HTTP'''-сервер, который вы настраиваете в своей сети, преимущество этого метода заключается в том, что его можно использовать в средах с доступом только через интранет или с ограниченным сетевым доступом.

Данный способ установки браузера в общих чертах состоит из следующих шагов:

# Загрузка необходимых архивов пакетов deb, snap или rpm, размещённых на сервере Ключ-АСТРОМ, и соответствующих им файлов подписи.
# Установка и запуск локального веб-сервера, на котором размещены загруженные компоненты браузера.
# Загрузка и запуск установщика АктивногоШлюза на целевом хосте с использованием переменной среды, указывающей на расположение пользовательского репозитория на '''HTTP'''-сервере.

Пользовательский репозиторий браузера можно использовать только для компонентов браузера, а не для их зависимостей. Установка браузера из пользовательского репозитория будет работать только в том случае, если все зависимости были разрешены до установки.

Пользовательские репозитории можно использовать только для установки и автоматического обновления браузера — подробности см. в разделе «Автоматическое обновление браузера из пользовательского репозитория».

Загрузите компоненты браузера — архив пакета и файл подписи — из безопасного и проверенного архива, размещённого Ключ-АСТРОМ. Ссылки на последние поддерживаемые и предоставляемые версии браузера см. в разделе «Требования к частным синтетическим хранилищам».

Мы рекомендуем обновлять версии АктивногоШлюза и браузера, поддерживающих синтетический анализ на базе '''Linux'''; для АктивногоШлюза выбирайте последнюю предоставленную версию браузера.

Например, для АктивногоШлюза версии 1.331 на '''Ubuntu 24''' необходимы следующие файлы:

* Архив пакетов — <code><nowiki>https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-143.0.7499.192.zip</nowiki></code>
* Файл с подписями — <code><nowiki>https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-143.0.7499.192.zip.sig</nowiki></code>

Соответствующие команды для загрузки:<pre>
curl -o chrome-for-testing-linux64-143.0.7499.192.zip https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-143.0.7499.192.zip
curl -o chrome-for-testing-linux64-143.0.7499.192.zip.sig https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-143.0.7499.192.zip.sig
</pre>Установите веб-сервер по вашему выбору и создайте каталог, например, <code>chromium-repo</code>, для предоставления доступа к компонентам '''Chromium''' хосту АктивногоШлюза. Скопируйте загруженные компоненты браузера в этот каталог.

Загрузите установщик АктивногоШлюза с '''astromkey Hub'''.

Устраните все зависимости и включите необходимые репозитории, как показано в разделе «Установка браузера и зависимостей вручную из S3» выше. Пользовательский репозиторий можно использовать только для пакетов браузера, а не для их зависимостей.

Установите АктивныйШлюз с включённым модулем '''Synthetic''' (<code>--enable-synthetic</code>) и переменной среды <code>astromkey_SYNTHETIC_CUSTOM_CHROMIUM_REPO</code>, указывающей на местоположение пользовательского репозитория (<code><nowiki>https://172.18.0.100/chromium-repo</nowiki></code> в этом примере).<pre>
sudo astromkey_SYNTHETIC_CUSTOM_CHROMIUM_REPO=http://172.18.0.100:8000/chromium-repo /bin/bash astromkey-ActiveGate-Linux-x86-*.sh --enable-synthetic
</pre>Вместо IP-адреса можно использовать имя хоста '''HTTP'''-сервера, если хост АктивногоШлюза может разрешить это имя хоста.

После установки браузера таким способом из пользовательского репозитория его можно будет только обновлять автоматически. Подробную информацию и варианты обновления см. в разделе «Автоматическое обновление браузера из пользовательского репозитория» в подразделе «Управление частными синтетическими расположениями».

== Автоматическое обновление браузера из пользовательского репозитория ==
Если вы включили пользовательский локальный репозиторий для установки браузера, автоматическое обновление возможно только через него. Для автоматического обновления браузера через тот же пользовательский репозиторий выполните следующие действия.

После установки АктивногоШлюза укажите пользовательский репозиторий АктивногоШлюза в разделе файла <code>[synthetic]</code> в <code>custom.properties</code> в каталоге <code>/var/lib/astromkey/gateway/config</code>. Это позволит автоматически обновлять браузер из пользовательского репозитория во время ручных или автоматических обновлений синтетического движка.<pre>
[synthetic]
chromium_repo = https://172.18.0.100/chromium-repo
</pre>Включите автоматическое обновление '''Chrome(-ium)''' для вашего местоположения.

Обратите внимание, что настройка автоматического обновления пользовательского интерфейса браузера применяется ко всем устройствам АктивногоШлюза, назначенным для вашего частного местоположения.

Убедитесь, что необходимые для обновления компоненты браузера доступны в расположении пользовательского репозитория. После этого браузер будет автоматически обновляться из пользовательского репозитория во время обновлений АктивногоШлюза и синтетического движка.

Если вы не укажете пользовательский репозиторий в файле конфигурации <code>custom.properties</code>, браузер будет загружен и обновлён из '''S3''' во время ручного или автоматического обновления АктивногоШлюза и '''Synthetic Engine'''.

== Пользовательская версия браузера ==
Вы можете установить пользовательскую версию браузера, то есть переопределить версию браузера, которую ищет установщик АктивногоШлюза. Это применимо для ручной установки АктивногоШлюза, как описано в разделе «Установка браузера через S3 или через пользовательский репозиторий».

В этой команде для ручной установки АктивногоШлюза через '''S3''' переменная среды указывает на конкретный номер версии браузера <code>143.0.7499.192</code>, который входит в архив пакета '''Chrome for Testing'''.<pre>
sudo /bin/bash -c "export astromkey_SYNTHETIC_EXPLICIT_CHROMIUM_VERSION=143.0.7499.192; /bin/bash astromkey-ActiveGate-Linux-x86-*.sh --enable-synthetic"
</pre>Эта команда выполняет поиск версии браузера <code>143.0.7499.192</code> в пользовательском репозитории <code><nowiki>https://172.18.0.100/chromium-repo</nowiki></code>.<pre>
sudo astromkey_SYNTHETIC_EXPLICIT_CHROMIUM_VERSION=143.0.7499.192 astromkey_SYNTHETIC_CUSTOM_CHROMIUM_REPO=http://172.18.0.100:8000/chromium-repo /bin/bash astromkey-ActiveGate-Linux-x86-*.sh --enable-synthetic
</pre>

Установка и обновление Chromium для Linux

2026-09-03T16:14:03Z

IKuznetsov: Новая страница: « = Установка и обновление Chromium для Linux = Если установка через веб-интерфейс не удалась или вы предпочитаете самостоятельно подготовить хост для синтетического движка, вы можете установить '''Chromium''' и другие зависимости вручную или из собственного репози...»

= Установка и обновление Chromium для Linux =
Если установка через веб-интерфейс не удалась или вы предпочитаете самостоятельно подготовить хост для синтетического движка, вы можете установить '''Chromium''' и другие зависимости вручную или из собственного репозитория.

== Установка браузера и зависимостей вручную из S3 ==
Этот раздел неактуален для сайтов, не использующих браузер.

=== Amazon Linux 2023, Ubuntu и Oracle Linux 9 ===
В '''Amazon Linux 2023''', '''Ubuntu''' и '''Oracle Linux 9''' вместо '''Chromium''' используется '''Chrome for Testing'''. Инструкции по ручной установке '''Chrome for Testing''' в этих операционных системах см. в разделе «Amazon Linux 2023, Ubuntu и Oracle Linux 9 (Chrome for Testing)».

Убедитесь, что у вас есть возможность подключиться к <code><nowiki>https://synthetic-packages.s3.amazonaws.com</nowiki></code> для доступа к пакетам браузера. В целях безопасности публичный доступ к хранилищу '''S3''' разрешён только для определённых файлов; попытка доступа к чему-либо другому приведёт к ошибке 403.

См. также раздел «Установка браузера из пользовательского репозитория» ниже.

Инструкции по обновлению браузера вручную см. в разделе «Управление частными синтетическими расположениями в Classic». Мы настоятельно рекомендуем обновлять версии АктивногоШлюза и браузера на базе '''Linux''' с поддержкой синтетических вычислений — Ключ-АСТРОМ поддерживает версии браузера, отстающие от последней поддерживаемой Ключ-АСТРОМ версии не более чем на две версии для конкретного выпуска АктивногоШлюза.

=== Ubuntu Server 20.04 и 22.04 ===
Этот раздел актуален только для версий 1.329 и более ранних.

'''Установите зависимости синтетического движка:'''<pre>
sudo apt-get update && sudo apt-get -y install xvfb x11-xkb-utils xfonts-100dpi xfonts-75dpi xfonts-scalable libnss3-tools auditd
</pre>'''Зависимости Chromium:'''<pre>
sudo apt-get -y install fonts-dejavu-core
sudo snap install gnome-3-38-2004 gtk-common-themes
</pre>'''Скачайте и установите Chromium.'''

Загрузите архив пакетов snap (для '''Ubuntu Server 20.04''' и '''22.04'''). Это безопасный и проверенный архив, размещённый на Ключ-АСТРОМ.

'''Версия АктивногоШлюза 1.329'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/snap/chromium-142.0.7444.175-3313.tgz
</pre>'''Версия АктивногоШлюза 1.327'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/snap/chromium-141.0.7390.122-3285.tgz
</pre>'''Версия АктивногоШлюза 1.325'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/snap/chromium-140.0.7339.185-3251.tgz
</pre>'''Версия АктивногоШлюза 1.323'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/snap/chromium-139.0.7258.138-3235.tgz
</pre>'''Версия АктивногоШлюза 1.321'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/snap/chromium-138.0.7204.157-3203.tgz
</pre>Подлинность пакетов можно проверить с помощью файлов подписей, хранящихся вместе с архивами пакетов.

'''Распакуйте установочные пакеты.''' Перейдите в каталог, куда вы сохранили архив, и выполните следующую команду:<pre>
mkdir /tmp/chromium ; tar xzf chromium.tgz -C /tmp/chromium
</pre>Это создаст директорию <code>/tmp/chromium</code> и извлечёт в неё пакеты.

'''Установите извлечённые пакеты.'''<pre>
sudo chown -R root:root /tmp/snap-private-tmp
sudo snap ack /tmp/chromium/chromium.assert
sudo snap install --devmode /tmp/chromium/chromium.snap
</pre>Если они отличаются от значений по умолчанию, замените <code>dtuserag</code> их именами пользователя и группы службы АктивногоШлюза.<pre>
sudo chown -R dtuserag:dtuserag /tmp/snap-private-tmp
</pre>Это установит все пакеты, извлечённые в указанную директорию. После успешной установки '''Chromium''' вы можете удалить директорию <code>/tmp/chromium/</code> и загруженный архив <code>chromium.tgz</code>.

После того как вы удовлетворите все зависимости, запустите установщик АктивногоШлюза с правами root, установив параметр <code>--enable-synthetic</code> в значение <code>manual</code>. Например:<pre>
/bin/bash ./Dynatrace-ActiveGate-Linux.sh --enable-synthetic=manual
</pre>Подлинность пакетов можно проверить с помощью файлов подписей, хранящихся вместе с архивами пакетов.

=== Red Hat Enterprise Linux, Oracle Linux 8 и Rocky Linux ===
'''Установка Chromium необходима, если для доступа в интернет требуется прокси-сервер.''' Если вам необходимо загрузить и установить '''Chromium''', и вашей системе требуется прокси-сервер для доступа в интернет, вам следует настроить <code>curl</code> использование правильного прокси. Укажите данные прокси и порта, выполнив команды, как показано в этом примере:<pre>
vi /root/.curlrc
proxy=http://proxy.example.com:8080
</pre>'''Настройте репозитории и установите зависимости.'''

==== Red Hat 9 ====
Зарегистрируйте экземпляр '''Red Hat''':<pre>
sudo subscription-manager register --auto-attach
</pre>Включите репозитории '''Red Hat Extras''' и '''Optional''', а также '''EPEL''' (дополнительные пакеты для Enterprise Linux):<pre>
sudo subscription-manager repos --enable rhel-9-for-x86_64-baseos-rpms
sudo subscription-manager repos --enable rhel-9-for-x86_64-appstream-rpms
sudo rpm -Uvh https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
</pre>Установите зависимости синтетического движка:<pre>
sudo dnf install -y xorg-x11-server-Xvfb xkbcomp xorg-x11-server-utils xorg-x11-fonts-100dpi xorg-x11-fonts-75dpi xorg-x11-fonts-Type1 libwayland-server mesa-libgbm curl nss-tools
</pre>

==== Oracle Linux 8 ====
Устаревшая операционная система: АктивныйШлюз версии 1.325 — это последняя версия АктивногоШлюза с поддержкой синтетического анализа, которая поддерживает '''Oracle Linux 8'''.

Включить '''EPEL''' (Дополнительные пакеты для Enterprise Linux):<pre>
sudo dnf install -y oracle-epel-release-el8
</pre>Установите зависимости синтетического движка:<pre>
sudo dnf install -y xorg-x11-server-Xvfb xorg-x11-xkb-utils xorg-x11-server-utils xorg-x11-fonts-100dpi xorg-x11-fonts-75dpi xorg-x11-fonts-Type1 libwayland-server mesa-libgbm curl nss-tools
</pre>

==== Rocky Linux 8 ====
Устаревшая операционная система: АктивныйШлюз версии 1.325 — это последняя версия АктивногоШлюза с поддержкой синтетического анализа, которая поддерживает '''Rocky Linux 8'''.

Включить '''EPEL''' (Дополнительные пакеты для Enterprise Linux):<pre>
sudo dnf install epel-release
</pre>Установите зависимости синтетического движка:<pre>
sudo dnf install -y xorg-x11-server-Xvfb xorg-x11-xkb-utils xorg-x11-server-utils xorg-x11-fonts-100dpi xorg-x11-fonts-75dpi xorg-x11-fonts-Type1 libwayland-server mesa-libgbm curl nss-tools
</pre>'''Скачайте и установите Chromium.'''

Загрузите архив с пакетом rpm. Это безопасный и проверенный архив, размещённый на сервере Ключ-АСТРОМ.

'''Версия АктивногоШлюза 1.345 (Red Hat Enterprise Linux/Rocky Linux 9)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-151.0.7922.137-1.el9.tgz
</pre>'''Версия АктивногоШлюза 1.343 (Red Hat Enterprise Linux/Rocky Linux 9)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-150.0.7871.128-1.el9.tgz
</pre>'''Версия АктивногоШлюза 1.341 (Red Hat Enterprise Linux/Rocky Linux 9)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-148.0.7778.215-1.el9.tgz
</pre>'''Версия АктивногоШлюза 1.339 (Red Hat Enterprise Linux/Rocky Linux 9)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-147.0.7727.137-1.el9.tgz
</pre>'''Версия АктивногоШлюза 1.337 (Red Hat Enterprise Linux/Rocky Linux 9)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-146.0.7680.177-1.el9.tgz
</pre>'''Версия АктивногоШлюза 1.335 (Red Hat Enterprise Linux/Rocky Linux 9)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-146.0.7680.177-1.el9.tgz
</pre>'''Версия АктивногоШлюза 1.333 (Red Hat Enterprise Linux/Rocky Linux 9)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-144.0.7559.132-1.el9.tgz
</pre>'''Версия АктивногоШлюза 1.331 (Red Hat Enterprise Linux/Rocky Linux 9)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-143.0.7499.192-1.el9.tgz
</pre>'''Версия АктивногоШлюза 1.329 (Red Hat Enterprise Linux/Rocky Linux 9)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-142.0.7444.175-2.el9.tgz
</pre>'''Версия АктивногоШлюза 1.327 (Red Hat Enterprise Linux/Rocky Linux 9)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-141.0.7390.122-1.el9.tgz
</pre>'''Версия АктивногоШлюза 1.325 (Red Hat Enterprise Linux/Oracle/Rocky Linux 8)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-133.0.6943.141-1.el8.tgz
</pre>'''Версия АктивногоШлюза 1.325 (Red Hat Enterprise Linux/Rocky Linux 9)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-140.0.7339.185-1.el9.tgz
</pre>'''Версия АктивногоШлюза 1.323 (Red Hat Enterprise Linux/Oracle/Rocky Linux 8)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-133.0.6943.141-1.el8.tgz
</pre>'''Версия АктивногоШлюза 1.323 (Red Hat Enterprise Linux/Rocky Linux 9)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-139.0.7258.138-1.el9.tgz
</pre>'''Версия АктивногоШлюза 1.321 (Red Hat Enterprise Linux/Oracle/Rocky Linux 8)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-133.0.6943.141-1.el8.tgz
</pre>'''Версия АктивногоШлюза 1.321 (Red Hat Enterprise Linux/Rocky Linux 9)'''<pre>
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-138.0.7204.157-1.el9.tgz
</pre>Подлинность пакетов можно проверить с помощью файлов подписей, хранящихся вместе с архивами пакетов.

'''Распакуйте установочные пакеты.''' Перейдите в каталог, куда вы сохранили архив, и выполните следующую команду:<pre>
mkdir /tmp/chromium ; tar xzf chromium.tgz -C /tmp/chromium
</pre>'''Установите извлечённые пакеты.'''<pre>
sudo dnf install -y /tmp/chromium/*.rpm
</pre>После успешной установки '''Chromium''' вы можете удалить директорию <code>/tmp/chromium/</code> и загруженный архив <code>chromium.tgz</code>.

'''Отключите автоматическое обновление пакетов Chromium:'''<pre>
sudo dnf -y install python3-dnf-plugin-versionlock
sudo dnf versionlock add chromium
sudo dnf versionlock add chromium-common
</pre>(Необязательно) Установите шрифты TrueType, не содержащие латинские символы:<pre>
sudo dnf install dejavu-fonts-common.noarch dejavu-sans-fonts.noarch
</pre>После того как вы удовлетворите все зависимости, запустите установщик АктивногоШлюза с правами root, установив параметр <code>--enable-synthetic</code> в значение <code>manual</code>. Например:<pre>
/bin/bash ./Dynatrace-ActiveGate-Linux.sh --enable-synthetic=manual
</pre>

=== Amazon Linux 2023, Ubuntu и Oracle Linux 9 (Chrome for Testing) ===
В отличие от '''Chromium''' в других дистрибутивах, обновления '''Chrome for Testing''' не используют менеджеры пакетов. Вы вручную управляете исполняемыми файлами '''Chrome''', а зависимости управляются системным менеджером пакетов.

На '''Ubuntu Server 20.04''' и '''22.04''' '''Chrome for Testing''' поддерживается начиная с версии 1.331.

'''Настройте репозитории и установите зависимости.'''

==== Ubuntu 20/22 ====
Установите зависимости синтетического движка:<pre>
sudo apt-get update && sudo apt-get -y install xvfb x11-xkb-utils xfonts-100dpi xfonts-75dpi xfonts-scalable libnss3-tools auditd fonts-dejavu-core
</pre>Установите зависимости '''Chrome for Testing''':<pre>
sudo apt-get -y install libasound2 libatk-bridge2.0-0 libatk1.0-0 libcairo2 libcups2 libgbm1 libnspr4 libnss3 libpango-1.0-0 libxcomposite1 libxdamage1 libxfixes3 libxkbcommon0 libxrandr2
</pre>

==== Oracle Linux 9 ====
Включить '''EPEL''' (Дополнительные пакеты для Enterprise Linux):<pre>
sudo dnf install -y oracle-epel-release-el9
</pre>Установите зависимости синтетического движка:<pre>
sudo dnf install -y lsof psmisc xorg-x11-server-Xvfb xkbcomp xorg-x11-server-utils xorg-x11-fonts-100dpi xorg-x11-fonts-75dpi xorg-x11-fonts-Type1 nss-tools unzip
</pre>Установите зависимости '''Chrome for Testing''':<pre>
sudo dnf install -y alsa-lib at-spi2-atk atk cairo cups-libs libXcomposite libXdamage libXrandr libxkbcommon mesa-libgbm nspr nss pango
</pre>'''Скачайте и настройте Chrome for Testing.'''

Создайте каталог '''Chrome for Testing''':<pre>
sudo mkdir -p /usr/lib/chrome_for_testing
</pre>Загрузите архив пакета '''Chrome for Testing''' во временное местоположение. Это безопасный и проверенный архив, размещённый на сервере Ключ-АСТРОМ.

'''Версия АктивногоШлюза 1.345'''<pre>
curl --output /tmp/chrome.zip https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-151.0.7922.138.zip
</pre>'''Версия АктивногоШлюза 1.343'''<pre>
curl --output /tmp/chrome.zip https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-150.0.7871.181.zip
</pre>'''Версия АктивногоШлюза 1.341'''<pre>
curl --output /tmp/chrome.zip https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-148.0.7778.215.zip
</pre>'''Версия АктивногоШлюза 1.339'''<pre>
curl --output /tmp/chrome.zip https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-147.0.7727.137.zip
</pre>'''Версия АктивногоШлюза 1.337'''<pre>
curl --output /tmp/chrome.zip https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-146.0.7680.178.zip
</pre>'''Версия АктивногоШлюза 1.335'''<pre>
curl --output /tmp/chrome.zip https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-146.0.7680.178.zip
</pre>'''Версия АктивногоШлюза 1.333'''<pre>
curl --output /tmp/chrome.zip https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-144.0.7559.133.zip
</pre>'''Версия АктивногоШлюза 1.331'''<pre>
curl --output /tmp/chrome.zip https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-143.0.7499.192.zip
</pre>'''Версия АктивногоШлюза 1.329'''<pre>
curl --output /tmp/chrome.zip https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-142.0.7444.175.zip
</pre>'''Версия АктивногоШлюза 1.327'''<pre>
curl --output /tmp/chrome.zip https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-141.0.7390.122.zip
</pre>Подлинность пакетов можно проверить с помощью файлов подписей, хранящихся вместе с архивами пакетов.

'''Распакуйте установочный пакет и выполните очистку:'''<pre>
sudo unzip /tmp/chrome.zip -d /usr/lib/chrome_for_testing
rm /tmp/chrome.zip
</pre>Это создаст директорию <code>chrome-linux64</code> внутри <code>/usr/lib/chrome_for_testing</code> и извлечёт в неё исполняемый файл '''Chrome''' и вспомогательные файлы.

'''Проверьте работоспособность Chrome for Testing''', убедившись, что он поддерживает следующую версию:<pre>
/usr/lib/chrome_for_testing/chrome-linux64/chrome --version
</pre>В результате выполнения команды должна отобразиться загруженная вами версия '''Chrome'''.

После того как вы устраните все зависимости, запустите установщик АктивногоШлюза с правами root. Установщик автоматически обнаружит и проверит '''Chrome for Testing'''. Например:<pre>
/bin/bash ./Dynatrace-ActiveGate-Linux.sh --enable-synthetic=manual
</pre>'''Настройка каталога Chrome for Testing:''' Если вы хотите использовать другой каталог, отличный от каталога по умолчанию <code>/usr/lib/chrome_for_testing</code>, укажите его с помощью переменной среды <code>CFT_DIR</code> во время установки:<pre>
CFT_DIR=/custom/path /bin/bash ./Dynatrace-ActiveGate-Linux.sh --enable-synthetic=manual
</pre>Вы также можете настроить путь, задав соответствующее свойство <code>synthetic_chrome_for_testing_path</code> в файле <code>custom.properties</code> после установки. Новая директория будет использоваться после обновления модуля '''Synthetic'''.

Файлы '''Chrome for Testing''' сохраняются во время удаления АктивногоШлюза. Если вы удалите АктивныйШлюз, каталог '''Chrome for Testing''' и его содержимое останутся в системе и могут быть использованы повторно при переустановке.

== Обновление браузера вручную из S3 ==
Если у вас автономная среда, или вы установили АктивныйШлюз вручную для управления зависимостями, или из-за ограниченного доступа к '''Amazon S3''', вам необходимо обновить браузер и зависимости вручную.

Для каждого АктивногоШлюза необходимо вручную обновить браузер, и процесс немного различается в зависимости от операционной системы. Обратите внимание, что ручное обновление браузера применимо только к АктивномуШлюзу на базе '''Linux'''; на АктивномШлюзе на базе '''Windows''' браузер обновляется автоматически во время обновления синтетического движка.

'''Предварительные требования:'''

* Убедитесь, что для вашего местоположения отключено автоматическое обновление '''Chrome(-ium)'''. Если вы отключите автоматическое обновление для какого-либо местоположения, вам потребуется обновить браузер вручную на каждом устройстве АктивногоШлюза, подключённом к этому местоположению.
* Убедитесь, что у вас есть возможность подключиться к <code><nowiki>https://synthetic-packages.s3.amazonaws.com</nowiki></code> для доступа к пакетам браузера.
* После завершения обновления синтетический движок будет использовать новую версию браузера — обратите внимание, что статус обновляется раз в час, поэтому обновление версии браузера, отображаемой для вашего АктивногоШлюза в статусе развертывания, может занять до часа.
* Мы настоятельно рекомендуем обновлять версии ваших АктивныхШлюзов с поддержкой синтетического тестирования на базе '''Linux''' и браузеров — Ключ-АСТРОМ поддерживает версии браузеров, отстающие от последней поддерживаемой Ключ-АСТРОМ версии для конкретного выпуска АктивногоШлюза не более чем на две версии.
* Мы настоятельно рекомендуем обновить все устройства АктивныхШлюзов в каждом местоположении до одной и той же версии.
* См. также автоматическое обновление браузера из пользовательского репозитория.
* Начиная с АктивногоШлюза 1.331, на '''Ubuntu Server 20.04''' и '''22.04''' мы используем '''Chrome for Testing'''. Поддержка дистрибутива '''Chromium Snap''' прекращена. Если вы используете автоматизацию для обновления браузера, переведите её на использование '''Chrome for Testing'''.

=== Ubuntu (Snap) ===
Если ваши версии АктивногоШлюза и '''Chromium''' больше не поддерживаются или не обновлялись в течение нескольких выпусков, проверьте зависимости '''Synthetic Engine''' и '''Chromium''' и переустановите их при необходимости. См. инструкции по ручной установке для '''Ubuntu Server'''.

Загрузите архив пакетов snap (для '''Ubuntu Server 20.04''' и '''22.04''') с <code>https://synthetic-packages.s3.amazonaws.com</code>. Обязательно используйте команду, указанную для вашей версии АктивногоШлюза и '''Ubuntu Server''' в инструкциях по ручной установке '''Ubuntu Server'''.

Распакуйте и установите загруженные пакеты. Убедитесь, что используете правильную команду установки для вашей версии '''Ubuntu Server''' (см. инструкции по ручной установке для '''Ubuntu Server''').

Проверьте обновление '''Chromium''', выполнив следующую команду из каталога установки по умолчанию. Результат выполнения команды должен соответствовать установленной вами версии '''Chromium''':<pre>
/opt/dynatrace/synthetic/browser --version
</pre>

=== Red Hat Enterprise Linux ===
Если вы установили '''Chromium''' вручную, то во время обновления нет необходимости регистрировать экземпляр '''Red Hat''' в менеджере подписок, а также включать репозитории '''Red Hat''' или пакеты '''EPEL'''.

Если ваши версии АктивногоШлюза и '''Chromium''' давно не обновлялись, возможно, вам потребуется снова установить зависимости движка '''Synthetic'''. См. инструкции по ручной установке для '''Red Hat Enterprise Linux''', '''Oracle Linux''' и '''Rocky Linux'''.

Загрузите архив с пакетом rpm с <code><nowiki>https://synthetic-packages.s3.amazonaws.com</nowiki></code>. Обязательно используйте команду, указанную для вашей версии АктивногоШлюза и ОС в инструкциях по ручной установке для '''Red Hat Enterprise Linux''', '''Oracle Linux''' и '''Rocky Linux'''.

Распакуйте и установите загруженные пакеты. Инструкции по ручной установке для '''Red Hat Enterprise Linux''', '''Oracle Linux''' и '''Rocky Linux''' см. в сопроводительных документах.

При необходимости отключите автоматическое обновление пакетов '''Chromium'''. Обратите внимание, что для '''Red Hat Enterprise Linux''' и '''CentOS''' блокировка пакетов, однажды выполненная, сохраняется при всех последующих обновлениях.<pre>
sudo dnf -y install python3-dnf-plugin-versionlock
sudo dnf versionlock add chromium
sudo dnf versionlock add chromium-common
</pre>Проверьте обновление '''Chromium''', выполнив следующую команду из каталога установки по умолчанию:<pre>
/opt/dynatrace/synthetic/browser --version
</pre>

=== Amazon Linux 2023, Ubuntu и Oracle Linux 9 (Chrome for Testing) ===
'''Chrome for Testing''' управляется иначе, чем '''Chromium'''. Для обновления вручную загрузите новую версию и распакуйте её в каталог '''Chrome for Testing'''.

В отличие от '''Chromium''' в других дистрибутивах, обновления '''Chrome for Testing''' не используют менеджеры пакетов. Вы вручную управляете исполняемыми файлами '''Chrome''', а зависимости управляются системным менеджером пакетов.

'''Ubuntu Server 20.04 и 22.04'''

При переходе с '''Chromium Snap''' сначала обновите АктивныйШлюз, затем установите '''Chrome for Testing''' и, при необходимости, удалите файлы '''Chromium Snap'''.

Если ваши версии АктивногоШлюза и '''Chrome for Testing''' давно не обновлялись, возможно, вам стоит проверить и снова установить зависимости '''Synthetic Engine''' и '''Chrome for Testing'''. См. инструкции по ручной установке '''Chrome for Testing'''.

Загрузите архив пакета '''Chrome for Testing''' во временное местоположение. Это безопасный и проверенный архив, размещённый Ключ-АСТРОМ по адресу <code>https://synthetic-packages.s3.amazonaws.com</code>. Обязательно используйте команду, указанную для вашей версии АктивногоШлюза в инструкциях по ручной установке '''Chrome for Testing''', но измените путь вывода на <code>/tmp/chrome.zip</code>.

Удалите старую папку '''Chrome for Testing''', распакуйте новую версию и выполните очистку:<pre>
sudo rm -rf /usr/lib/chrome_for_testing/chrome-linux64
sudo unzip /tmp/chrome.zip -d /usr/lib/chrome_for_testing
rm /tmp/chrome.zip
</pre>Если вы настроили собственный каталог '''Chrome for Testing''' с помощью переменной среды <code>CFT_DIR</code> или свойства <code>synthetic_chrome_for_testing_path</code> в файле <code>custom.properties</code>, замените <code>/usr/lib/chrome_for_testing</code> на свой пользовательский путь в приведённых выше командах.

Проверьте наличие обновлений '''Chrome for Testing''', выполнив следующую команду:<pre>
/usr/lib/chrome_for_testing/chrome-linux64/chrome --version
</pre>Синтетический движок немедленно начнёт использовать новую версию '''Chrome for Testing'''. Обратите внимание, что статус обновляется раз в час, поэтому обновление версии '''Chrome''', отображаемой для вашего АктивногоШлюза в статусе развертывания, может занять до часа.

== Установка браузера из собственного репозитория ==
АктивныйШлюз версии 1.243+. Помимо установки АктивногоШлюза через веб-интерфейс и ручной установки браузера и зависимостей, вы также можете установить АктивныйШлюз, указав пользовательский локальный репозиторий компонентов браузера. Поскольку этот репозиторий представляет собой '''HTTP'''-сервер, который вы настраиваете в своей сети, преимущество этого метода заключается в том, что его можно использовать в средах с доступом только через интранет или с ограниченным сетевым доступом.

Данный способ установки браузера в общих чертах состоит из следующих шагов:

# Загрузка необходимых архивов пакетов deb, snap или rpm, размещённых на сервере Ключ-АСТРОМ, и соответствующих им файлов подписи.
# Установка и запуск локального веб-сервера, на котором размещены загруженные компоненты браузера.
# Загрузка и запуск установщика АктивногоШлюза на целевом хосте с использованием переменной среды, указывающей на расположение пользовательского репозитория на '''HTTP'''-сервере.

Пользовательский репозиторий браузера можно использовать только для компонентов браузера, а не для их зависимостей. Установка браузера из пользовательского репозитория будет работать только в том случае, если все зависимости были разрешены до установки.

Пользовательские репозитории можно использовать только для установки и автоматического обновления браузера — подробности см. в разделе «Автоматическое обновление браузера из пользовательского репозитория».

Загрузите компоненты браузера — архив пакета и файл подписи — из безопасного и проверенного архива, размещённого Ключ-АСТРОМ. Ссылки на последние поддерживаемые и предоставляемые версии браузера см. в разделе «Требования к частным синтетическим хранилищам».

Мы рекомендуем обновлять версии АктивногоШлюза и браузера, поддерживающих синтетический анализ на базе '''Linux'''; для АктивногоШлюза выбирайте последнюю предоставленную версию браузера.

Например, для АктивногоШлюза версии 1.331 на '''Ubuntu 24''' необходимы следующие файлы:

* Архив пакетов — <code><nowiki>https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-143.0.7499.192.zip</nowiki></code>
* Файл с подписями — <code><nowiki>https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-143.0.7499.192.zip.sig</nowiki></code>

Соответствующие команды для загрузки:<pre>
curl -o chrome-for-testing-linux64-143.0.7499.192.zip https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-143.0.7499.192.zip
curl -o chrome-for-testing-linux64-143.0.7499.192.zip.sig https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-143.0.7499.192.zip.sig
</pre>Установите веб-сервер по вашему выбору и создайте каталог, например, <code>chromium-repo</code>, для предоставления доступа к компонентам '''Chromium''' хосту АктивногоШлюза. Скопируйте загруженные компоненты браузера в этот каталог.

Загрузите установщик АктивногоШлюза с '''astromkey Hub'''.

Устраните все зависимости и включите необходимые репозитории, как показано в разделе «Установка браузера и зависимостей вручную из S3» выше. Пользовательский репозиторий можно использовать только для пакетов браузера, а не для их зависимостей.

Установите АктивныйШлюз с включённым модулем '''Synthetic''' (<code>--enable-synthetic</code>) и переменной среды <code>astromkey_SYNTHETIC_CUSTOM_CHROMIUM_REPO</code>, указывающей на местоположение пользовательского репозитория (<code><nowiki>https://172.18.0.100/chromium-repo</nowiki></code> в этом примере).<pre>
sudo DYNATRACE_SYNTHETIC_CUSTOM_CHROMIUM_REPO=http://172.18.0.100:8000/chromium-repo /bin/bash Dynatrace-ActiveGate-Linux-x86-*.sh --enable-synthetic
</pre>Вместо IP-адреса можно использовать имя хоста '''HTTP'''-сервера, если хост АктивногоШлюза может разрешить это имя хоста.

После установки браузера таким способом из пользовательского репозитория его можно будет только обновлять автоматически. Подробную информацию и варианты обновления см. в разделе «Автоматическое обновление браузера из пользовательского репозитория» в подразделе «Управление частными синтетическими расположениями».

== Автоматическое обновление браузера из пользовательского репозитория ==
Если вы включили пользовательский локальный репозиторий для установки браузера, автоматическое обновление возможно только через него. Для автоматического обновления браузера через тот же пользовательский репозиторий выполните следующие действия.

После установки АктивногоШлюза укажите пользовательский репозиторий АктивногоШлюза в разделе файла <code>[synthetic]</code> в <code>custom.properties</code> в каталоге <code>/var/lib/astromkey/gateway/config</code>. Это позволит автоматически обновлять браузер из пользовательского репозитория во время ручных или автоматических обновлений синтетического движка.<pre>
[synthetic]
chromium_repo = https://172.18.0.100/chromium-repo
</pre>Включите автоматическое обновление '''Chrome(-ium)''' для вашего местоположения.

Обратите внимание, что настройка автоматического обновления пользовательского интерфейса браузера применяется ко всем устройствам АктивногоШлюза, назначенным для вашего частного местоположения.

Убедитесь, что необходимые для обновления компоненты браузера доступны в расположении пользовательского репозитория. После этого браузер будет автоматически обновляться из пользовательского репозитория во время обновлений АктивногоШлюза и синтетического движка.

Если вы не укажете пользовательский репозиторий в файле конфигурации <code>custom.properties</code>, браузер будет загружен и обновлён из '''S3''' во время ручного или автоматического обновления АктивногоШлюза и '''Synthetic Engine'''.

== Пользовательская версия браузера ==
Вы можете установить пользовательскую версию браузера, то есть переопределить версию браузера, которую ищет установщик АктивногоШлюза. Это применимо для ручной установки АктивногоШлюза, как описано в разделе «Установка браузера через S3 или через пользовательский репозиторий».

В этой команде для ручной установки АктивногоШлюза через '''S3''' переменная среды указывает на конкретный номер версии браузера <code>143.0.7499.192</code>, который входит в архив пакета '''Chrome for Testing'''.<pre>
sudo /bin/bash -c "export DYNATRACE_SYNTHETIC_EXPLICIT_CHROMIUM_VERSION=143.0.7499.192; /bin/bash Dynatrace-ActiveGate-Linux-x86-*.sh --enable-synthetic"
</pre>Эта команда выполняет поиск версии браузера <code>143.0.7499.192</code> в пользовательском репозитории <code><nowiki>https://172.18.0.100/chromium-repo</nowiki></code>.<pre>
sudo DYNATRACE_SYNTHETIC_EXPLICIT_CHROMIUM_VERSION=143.0.7499.192 DYNATRACE_SYNTHETIC_CUSTOM_CHROMIUM_REPO=http://172.18.0.100:8000/chromium-repo /bin/bash Dynatrace-ActiveGate-Linux-x86-*.sh --enable-synthetic
</pre>

Установка АктивногоШлюза с поддержкой синтетических алгоритмов

2026-09-03T16:05:07Z

IKuznetsov: Новая страница: «= Установка АктивногоШлюза с поддержкой синтетических алгоритмов = АктивныйШлюз с поддержкой синтетического мониторинга используется исключительно для запуска синтетических мониторов. Чистая установка АктивногоШлюза для целей синтетического мон...»

= Установка АктивногоШлюза с поддержкой синтетических алгоритмов =

АктивныйШлюз с поддержкой синтетического мониторинга используется исключительно для запуска синтетических мониторов. Чистая установка АктивногоШлюза для целей синтетического мониторинга отключает все остальные функции АктивногоШлюза, включая связь с ЕдинымиАгентами. Убедитесь, что хост, на котором вы устанавливаете АктивныйШлюз, имеет доступ к интернету.

Установить АктивныйШлюз с поддержкой синтетического анализа можно с помощью мастера установки АктивногоШлюза в разделе '''Обнаружение и покрытие'''.

# В поле '''Назначение''' выберите '''Синтетический'''.
# В поле '''Тип развертывания''' выберите операционную систему.
# Только для '''Linux''': В разделе '''Архитектура''' оставьте выбор по умолчанию: '''x86'''.
# Сгенерируйте токен или введите существующий. Этот токен имеет область действия '''Загрузка установщиков ЕдиногоАгента и АктивногоШлюза''' (<code>InstallerDownload</code>), что позволяет загружать установщик АктивногоШлюза. После предоставления токен автоматически добавляется к командам загрузки и установки, которые затем отображаются в веб-интерфейсе.
#* Список существующих токенов можно найти на странице '''Токены доступа'''. Обратите внимание, что токен отображается только один раз при создании, после чего он хранится в зашифрованном виде и не может быть раскрыт. Мы рекомендуем сохранять токен после создания в менеджере паролей, чтобы вы могли использовать его повторно по мере необходимости.
# (Необязательно) Разверните раздел '''Дополнительные параметры''' и:
#* Используйте переключатель '''Поддержка браузерных мониторов''', чтобы отключить поддержку браузерных мониторов. В этом случае синтетический АктивныйШлюз будет рассматриваться как не использующий браузерные мониторы.
#* Назначьте АктивныйШлюз частному синтетическому местоположению — выберите местоположение из выпадающего списка или создайте новое. Вы также можете назначить АктивныйШлюз местоположению после установки при создании или редактировании местоположения.
#* Назначьте АктивныйШлюз сетевой зоне и группе АктивныхШлюзов. Вы также можете создать новую сетевую зону и группу АктивныхШлюзов.
# Загрузите установщик на целевой хост.
# Только для '''Linux''': Рекомендуется '''Проверка подписи''' — выполните указанную команду на целевом хосте, чтобы загрузить файл сертификата и проверить установщик.
# Только для '''Linux''': Выберите дистрибутив '''Linux''' и следуйте инструкциям, предшествующим полю '''Установить АктивныйШлюз от имени привилегированного пользователя''', если таковые имеются.
# Запустите установщик, используя команду, указанную в поле '''Установить АктивныйШлюз от имени привилегированного пользователя''', а затем следуйте инструкциям, отображаемым в веб-интерфейсе.
#* Только для '''Linux''': Установщик автоматически загружает браузер и зависимости, необходимые для синтетического движка. В '''Red Hat''', '''Oracle Linux''' и '''Rocky Linux''' также необходимо включить репозитории, из которых установщик загружает зависимости. В качестве предварительного условия для включения проприетарных репозиториев в '''Red Hat''' необходимо зарегистрировать свой экземпляр '''Red Hat'''. Веб-интерфейс предоставляет все необходимые команды для этого, как показано в примере ниже.
#* Если установка через веб-интерфейс не удалась или вы предпочитаете самостоятельно подготовить хост для синтетического движка, вы можете установить браузер и зависимости вручную или из пользовательского репозитория.
# Выберите '''Показать статус развертывания''', чтобы проверить установку АктивногоШлюза.

Требования к частным синтетическим хранилищам

2026-09-03T16:03:20Z

IKuznetsov: Новая страница: « = Требования к частным синтетическим хранилищам = Убедитесь, что хостинг, который вы хотите использовать для своего частного местоположения, соответствует следующим требованиям. == Информация об окончании технической поддержки == Для '''Red Hat'''/'''Oracle Linux''...»

= Требования к частным синтетическим хранилищам =
Убедитесь, что хостинг, который вы хотите использовать для своего частного местоположения, соответствует следующим требованиям.

== Информация об окончании технической поддержки ==
Для '''Red Hat'''/'''Oracle Linux'''/'''Rocky Linux''' 8 новые версии '''Chromium''', кроме версии 133, отсутствуют. В целях обеспечения безопасности и стабильности мы решили прекратить поддержку установки АктивногоШлюза с поддержкой '''Synthetic''' на '''Red Hat'''/'''Oracle Linux'''/'''Rocky Linux''' 8 после версии АктивногоШлюза 1.325.

Для обеспечения непрерывности и безопасности работы ваших синтетических мониторов мы рекомендуем перевести ваш АктивныйШлюз с поддержкой синтетических мониторов на одну из поддерживаемых операционных систем, например, '''Red Hat'''/'''Oracle Linux'''/'''Rocky Linux''' 9.

АктивныйШлюз версии 1.325 — это последняя версия АктивногоШлюза с поддержкой синтетического анализа, поддерживаемая в '''Red Hat'''/'''Oracle Linux'''/'''Rocky Linux''' 8.

Кроме того, в версии Ключ-АСТРОМ 1.326 мы планируем внедрить механизмы, предотвращающие обновление АктивныхШлюзов с поддержкой синтетического анализа на '''Red Hat'''/'''Oracle Linux'''/'''Rocky Linux''' 8 до версии выше 1.325.

Чтобы узнать о самых старых поддерживаемых версиях АктивногоШлюза, ознакомьтесь с последними примечаниями к выпуску.

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

Для поддержания стабильности и производительности рекомендуется добавить перечисленные ниже каталоги и процессы в список разрешённых или исключить их из политики. Имейте в виду, что исключения антивируса обычно предотвращают сканирование файлов, но не отключают поведенческий мониторинг или перехватчики на уровне ядра. Они остаются активными и могут влиять на взаимодействие синтетического движка и браузера с системными библиотеками. В результате даже исключённые процессы могут столкнуться с нарушениями доступа или повреждением кучи.

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

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

Каталоги:

* Все каталоги, находящиеся <code>synthetic</code> в их пути. Обзор используемых каталогов см. в разделе «Каталоги АктивногоШлюза».

Процессы:

* <code>хром</code>
* <code>vucwrapper</code>
* <code>java</code>

= Требования к операционной системе =
После установки АктивногоШлюза ваши частные синтетические мониторы (как '''HTTP''', так и браузерные) могут запускаться на следующих операционных системах.

== Windows ==

=== Поддерживаемые операционные системы ===
{| class="wikitable"
!Операционная система Windows
!Версии
|-
|Windows Server
|2016, 2019, 2022, 2025
|}

=== Версии браузера в Windows ===
В '''Windows''' установочный пакет АктивногоШлюза включает браузер '''Chrome for Testing''', используемый для запуска мониторов браузера. В таблице ниже показаны версии '''Chrome for Testing''', которые входят в состав соответствующих версий АктивногоШлюза.
{| class="wikitable"
!Версия АктивногоШлюза
!Включённая версия браузера
|-
|1.345
|151
|-
|1.343
|150
|-
|1.341
|148
|-
|1.339
|147
|-
|1.337
|146
|-
|1.335
|146
|-
|1.333
|144
|-
|1.331
|143
|-
|1.329
|142
|-
|1.327
|141
|-
|1.325
|140
|-
|1.323
|139
|-
|1.321
|138
|}
Во всех версиях '''Windows Server''' для тестирования вместо '''Chromium''' используется '''Chrome'''.

'''Неподдерживаемые версии Windows приведены только для целей тестирования.''' Если вы хотите тестировать частные синтетические местоположения только на непроизводственном хосте, например, на собственном рабочем столе, вы можете установить АктивныйШлюз с поддержкой синтетических местоположений на неподдерживаемые версии '''Windows''', такие как '''Windows 10''' или '''Windows 11'''.

Начиная с АктивногоШлюза версии 1.263+, в целях тестирования АктивныйШлюз с поддержкой синтетического тестирования больше не работает на '''Windows Server 2012'''. '''Google''' прекратила поддержку '''Windows 2012 Server''' с '''Chromium 110''', который входит в состав установочного пакета АктивногоШлюза версии 1.263.

== Linux ==

=== Поддерживаемые операционные системы ===
{| class="wikitable"
!Дистрибутив Linux
!Версии
|-
|Red Hat Enterprise Linux
|9.4, 9.6, 9.7
|-
|Ubuntu
|20.04, 22.04, 24.04
|-
|Amazon Linux
|2023
|-
|Oracle Linux
|9.6, 9.7
|-
|Rocky Linux
|9.8
|}

* Синтетический установщик можно установить на все минорные версии '''Red Hat Enterprise Linux 9'''. Однако мы рекомендуем использовать версии, указанные в этой таблице, поскольку они имеют расширенную поддержку жизненного цикла ('''ELS''') в соответствии с требованиями '''Red Hat Enterprise Linux Life Cycle'''.
* Синтетический установщик можно установить на все минорные версии '''Oracle Linux 9'''. Однако мы рекомендуем использовать последние поддерживаемые в настоящее время версии в соответствии с документацией для '''Oracle Linux 9'''.
* Синтетический установщик можно установить на все минорные версии '''Rocky Linux 9'''. Однако мы рекомендуem использовать последние поддерживаемые в настоящее время версии в соответствии с руководством по версиям и релизам '''Rocky Linux'''.

=== Устаревшие операционные системы ===
{| class="wikitable"
!Дистрибутив Linux
!Версии
|-
|Red Hat Enterprise Linux
|7.9
|-
|CentOS
|7.9
|-
|Amazon Linux
|2
|-
|Red Hat Enterprise Linux
|8.8, 8.10
|-
|Oracle Linux
|8.10
|-
|Rocky Linux
|8.10
|}

* АктивныйШлюз версии 1.305 — это последняя версия АктивногоШлюза с поддержкой синтетических тестов, которая поддерживает '''Red Hat'''/'''CentOS''' 7.
* АктивныйШлюз версии 1.307 — это последняя версия АктивногоШлюза с поддержкой синтетического анализа, которая поддерживает '''Amazon Linux 2'''.
* АктивныйШлюз версии 1.325 — это последняя версия АктивногоШлюза с поддержкой '''Synthetic''', которая поддерживает '''Red Hat'''/'''Oracle Linux'''/'''Rocky Linux''' 8.

=== Версии браузера в Linux ===
Мы настоятельно рекомендуем обновлять версии АктивногоШлюза и браузеров на базе '''Linux''' с поддержкой синтетического тестирования — Ключ-АСТРОМ поддерживает версии браузеров, отстающие от последней поддерживаемой Ключ-АСТРОМ версии не более чем на две версии для конкретного выпуска АктивногоШлюза. Например, если последняя поддерживаемая версия браузера — 103, Ключ-АСТРОМ поддерживает версии браузеров до 101 включительно. Если предоставленная версия браузера значительно устарела для конкретной ОС, мы поддерживаем только предоставленную версию. См. информацию об автоматическом и ручном обновлении браузера.

В '''Linux''' установщик АктивногоШлюза загружает зависимости браузера, необходимые для синтетического движка. В '''Red Hat''' и '''Rocky''' необходимо включить определённые репозитории, из которых установщик загружает зависимости. Веб-интерфейс Ключ-АСТРОМ предоставляет все необходимые команды. Подробные инструкции см. в разделе «Создание частного синтетического расположения».

При установке АктивногоШлюза и браузера из пользовательского локального репозитория необходимо разрешить все зависимости и включить репозитории по мере необходимости; пользовательский репозиторий можно использовать только для пакетов браузера, а не для их зависимостей. Поместите архив пакета браузера и файл подписи в пользовательский репозиторий для установки. Если ваш архивный файл пакета называется <code>https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-143.0.7499.192.zip</code> ('''Chrome for Testing''' 143 для '''Ubuntu''' на АктивномШлюзе версии 1.333), вы можете найти файл подписи, добавив <code>.sig</code> к URL-адресу: <code>https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-143.0.7499.192.zip.sig</code>.

В связи с изменениями в доступности пакетов <code>libdav1d.so.6</code>, версии '''Chromium''' старше 130 не могут быть установлены на '''Red Hat'''/'''Rocky Linux''' 9. Для получения подробной информации обратитесь к руководству по устранению неполадок.
{| class="wikitable"
!Версия АктивногоШлюза
!Последняя поддерживаемая версия Chromium: Red Hat/Rocky Linux 9
!Последняя поддерживаемая версия Chrome for Testing: Amazon Linux 2023, Ubuntu, Oracle Linux 9
|-
|1.345
|151
|151
|-
|1.343
|150
|150
|-
|1.341
|148
|148
|-
|1.339
|147
|147
|-
|1.337
|146
|146
|-
|1.335
|146
|146
|-
|1.333
|144
|144
|-
|1.331
|143
|143
|}
{| class="wikitable"
!Версия АктивногоШлюза
!Последняя поддерживаемая версия Chromium для Red Hat/Oracle/Rocky Linux
!Поддерживаемые последние версии Chromium: Ubuntu 20 и 22
!Последняя поддерживаемая версия Chrome for Testing: Amazon Linux 2023, Ubuntu 24, Oracle Linux 9
|-
|1.329
|142 (Red Hat/Rocky Linux 9)
|142 (Ubuntu 20.04 и 22.04)
|142
|-
|1.327
|141 (Red Hat/Rocky Linux 9)
|141 (Ubuntu 20.04 и 22.04)
|141
|-
|1.325
|133 (Red Hat/Oracle/Rocky Linux 8), 140 (Red Hat/Rocky Linux 9)
|140 (Ubuntu 20.04 и 22.04)
|140
|-
|1.323
|133 (Red Hat/Oracle/Rocky Linux 8), 139 (Red Hat/Rocky Linux 9)
|139 (Ubuntu 20.04 и 22.04)
|139
|-
|1.321
|133 (Red Hat/Oracle/Rocky Linux 8), 138 (Red Hat/Rocky Linux 9)
|138 (Ubuntu 20.04 и 22.04)
|138
|}
В '''Ubuntu Server''' 20.04 и 22.04 для тестирования используется '''Chrome'''.

== Демон политики доступа к файлам (fapolicyd) ==
При неправильной настройке демон политики доступа к файлам ('''File Access Policy Daemon''', <code>fapolicyd</code>) может повлиять на возможности синтетического мониторинга Ключ-АСТРОМ. Аналогично антивирусному или антишпионскому программному обеспечению, <code>fapolicyd</code> может блокировать браузер или процессы Ключ-АСТРОМ, ответственные за выполнение синтетических мониторов.

Для обеспечения надлежащей стабильности и производительности рекомендуется добавить каталоги и процессы в список разрешённых или исключить их из политики. Более подробную информацию см. в документации '''Red Hat''' по <code>fapolicyd</code>. Прежде чем обращаться в службу поддержки Ключ-АСТРОМ для устранения неполадок с вашими частными синтетическими местоположениями, убедитесь, что <code>fapolicyd</code> исключён из списка источников проблем.

Платформа '''File Access Policy Daemon''' может работать в режиме отладки, в котором регистрируются все отказы, что упрощает поиск отсутствующих правил и устранение неполадок. Для получения более подробной информации о режиме отладки обратитесь к документации по устранению неполадок, связанных с <code>fapolicyd</code>.

= Требования к оборудованию =

== Общие соображения ==

* Обратите внимание, что АктивныйШлюз с поддержкой синтетического мониторинга предъявляет более высокие требования к оборудованию и системе, чем обычный АктивныйШлюз для среды или кластера. Мы настоятельно рекомендуем использовать АктивныйШлюз с поддержкой синтетического мониторинга исключительно для целей синтетического мониторинга.
* При планировании выделения ресурсов следует учитывать любые дополнительные компоненты, работающие на хосте. Например, если местоположение отслеживается с помощью ЕдиногоАгента или другого решения для глубокого мониторинга, требования к оперативной памяти ('''RAM''') возрастут.
* Для изменения размера АктивногоШлюза с поддержкой синтетического мониторинга, например, после увеличения ресурсов АктивногоШлюза размера S до требований размера M, необходимо удалить и переустановить его. Переустановка необходима до того, как вы сможете использовать обновлённые ресурсы для синтетического мониторинга; в противном случае ваш АктивныйШлюз будет по-прежнему отображаться как размер S (размер синтетического нода) в статусе развертывания и будет ограничен пределами выполнения для размера S.

== Таблица размеров ==
Исходя из количества тестов, выполняемых в час, активные шлюзы АктивногоШлюза с поддержкой синтетического анализа должны соответствовать следующим аппаратным требованиям.

'''Предельные значения''' — указанные в таблице ниже предельные значения были определены в ходе наших внутренних тестов. Фактические значения могут отличаться в зависимости от сложности ваших мониторов.

=== Размер XS ===
{| class="wikitable"
!Параметр
!Node с поддержкой монитора браузера
!Узел без браузера
|-
|Минимальное количество процессоров
|2 vCPU
|1 vCPU
|-
|Минимальное свободное место на диске
|20 ГБ
|17 ГБ
|-
|Минимальный объём оперативной памяти
|4 ГБ
|4 ГБ
|-
|Минимальное количество свободной оперативной памяти
|3 ГБ
|2,7 ГБ
|-
|Минимальное количество операций ввода-вывода на диске (Windows)
|100
|100
|-
|Расчётное максимальное количество запусков HTTP-монитора в час
|300 тыс.
|300 тыс.
|-
|Расчётное максимальное количество выполнений HTTP-монитора с высокими требованиями к ресурсам в час
|10 тыс.
|10 тыс.
|-
|Расчётное максимальное количество запусков монитора браузера в час
|300
|–
|-
|Расчётное максимальное количество пакетов мониторинга ICMP NAM в час
|500 тыс.
|500 тыс.
|-
|Расчётное максимальное количество запросов мониторинга TCP NAM в час
|1M
|1M
|-
|Предполагаемое максимальное количество запросов монитора NAM DNS в час
|100 тыс.
|100 тыс.
|}

=== Размер S ===
{| class="wikitable"
!Параметр
!Node с поддержкой монитора браузера
!Узел без браузера
|-
|Минимальное количество процессоров
|4 vCPU
|2 vCPU
|-
|Минимальное свободное место на диске
|25 ГБ
|22 ГБ
|-
|Минимальный объём оперативной памяти
|8 ГБ
|8 ГБ
|-
|Минимальное количество свободной оперативной памяти
|5 ГБ
|4 ГБ
|-
|Минимальное количество операций ввода-вывода на диске (Windows)
|200
|200
|-
|Расчётное максимальное количество запусков HTTP-монитора в час
|300 тыс.
|300 тыс.
|-
|Расчётное максимальное количество выполнений HTTP-монитора с высокими требованиями к ресурсам в час
|20 тыс.
|20 тыс.
|-
|Расчётное максимальное количество запусков монитора браузера в час
|650
|–
|-
|Расчётное максимальное количество пакетов мониторинга ICMP NAM в час
|1M
|1M
|-
|Расчётное максимальное количество запросов мониторинга TCP NAM в час
|2M
|2M
|-
|Предполагаемое максимальное количество запросов монитора NAM DNS в час
|200 тыс.
|200 тыс.
|}

=== Размер M ===
{| class="wikitable"
!Параметр
!Node с поддержкой монитора браузера
!Узел без браузера
|-
|Минимальное количество процессоров
|8 vCPU
|4 vCPU
|-
|Минимальное свободное место на диске
|30 ГБ
|23 ГБ
|-
|Минимальный объём оперативной памяти
|16 ГБ
|16 ГБ
|-
|Минимальное количество свободной оперативной памяти
|8 ГБ
|6,5 ГБ
|-
|Минимальное количество операций ввода-вывода на диске (Windows)
|400
|400
|-
|Расчётное максимальное количество запусков HTTP-монитора в час
|300 тыс.
|300 тыс.
|-
|Расчётное максимальное количество выполнений HTTP-монитора с высокими требованиями к ресурсам в час
|60 тыс.
|60 тыс.
|-
|Расчётное максимальное количество запусков монитора браузера в час
|1200
|–
|-
|Расчётное максимальное количество пакетов мониторинга ICMP NAM в час
|1,5 млн.
|1,5 млн.
|-
|Расчётное максимальное количество запросов мониторинга TCP NAM в час
|3M
|3M
|-
|Предполагаемое максимальное количество запросов монитора NAM DNS в час
|300 тыс.
|300 тыс.
|}

=== Размер L ===
{| class="wikitable"
!Параметр
!Node с поддержкой монитора браузера
!Узел без браузера
|-
|Минимальное количество процессоров
|16 vCPU
|8 vCPU
|-
|Минимальное свободное место на диске
|40 ГБ
|25 ГБ
|-
|Минимальный объём оперативной памяти
|32 ГБ
|32 ГБ
|-
|Минимальное количество свободной оперативной памяти
|12 ГБ
|10 ГБ
|-
|Минимальное количество операций ввода-вывода на диске (Windows)
|750
|750
|-
|Расчётное максимальное количество запусков HTTP-монитора в час
|300 тыс.
|300 тыс.
|-
|Расчётное максимальное количество выполнений HTTP-монитора с высокими требованиями к ресурсам в час
|100 тыс.
|100 тыс.
|-
|Расчётное максимальное количество запусков монитора браузера в час
|2200
|–
|-
|Расчётное максимальное количество пакетов мониторинга ICMP NAM в час
|2M
|2M
|-
|Расчётное максимальное количество запросов мониторинга TCP NAM в час
|4M
|4M
|-
|Предполагаемое максимальное количество запросов монитора NAM DNS в час
|400k
|400k
|}

== Права доступа к хранилищу и файловой системе ==
В таблице ниже показаны места установки по умолчанию ('''Linux''' и '''Windows''') различных каталогов АктивногоШлюза и минимальные требования к их размеру. Эта информация составлена на основе данных из каталогов АктивногоШлюза.
{| class="wikitable"
!Параметр установки
!Путь по умолчанию
!Минимальный размер
!Примечания
|-
|<INSTALL>
|<code>/opt/astromkey/</code>
<code>%PROGRAMFILES%\astromkey</code>
|600 МБ
|Для исполняемых файлов, библиотек и связанных файлов. 300 МБ для АктивногоШлюза, 270 МБ для частных синтетических файлов.
|-
|<LOGS>
|<code>/var/log/astromkey</code>
<code>%PROGRAMDATA%\astromkey</code>
|1,7 ГБ
|500 МБ для журналов АктивногоШлюза, 1 ГБ для частных синтетических логов, 200 МБ для журналов автообновления.
|-
|<CONFIG>
|<code>/var/lib/astromkey</code>
<code>%PROGRAMDATA%\astromkey</code>
|1 МБ
|–
|-
|<TEMP>
|<code>/var/tmp/astromkey</code>
<code>%PROGRAMDATA%\astromkey</code>
|21 ГБ
|1 ГБ для временных файлов АктивногоШлюза (без кэшированных установщиков ЕдиногоАгента и образов контейнеров), 20 ГБ для временных файлов синтетических файлов (включая журналы выполнения, кэш и скриншоты). Для АктивногоШлюза XS требуется больше места для журналов выполнения, чем для АктивногоШлюза большего размера.
|}

=== Разрешения для /tmp ===
Для работы АктивногоШлюза с поддержкой синтетического программирования требуется доступ на запись в каталог <code>/tmp</code> во время выполнения. Его зависимости, включая <code>xvfb</code>, используют этот каталог <code>/tmp</code> для хранения временных файлов и данных, используемых во время выполнения. Отсутствие прав на запись в этот каталог может привести к неожиданным сбоям или ухудшению функциональности. Убедитесь, что среда хоста предоставляет достаточные права доступа и достаточно свободного места в каталоге <code>/tmp</code> для надёжной поддержки этих операций.

== Связанные темы ==

* Каталоги АктивногоШлюза

Частные синтетические локации

2026-09-03T16:00:41Z

IKuznetsov: Новая страница: « = Частные синтетические локации = Цель использования частных локаций — запуск синтетических мониторов. Частные локации необходимы для мониторинга приложений и конечных устройств в корпоративных сетях, недоступных из общедоступного интернета. Кроме...»

= Частные синтетические локации =
Цель использования частных локаций — запуск синтетических мониторов. Частные локации необходимы для мониторинга приложений и конечных устройств в корпоративных сетях, недоступных из общедоступного интернета. Кроме того, частные локации обязательны для запуска мониторов '''NAM'''.

Благодаря мониторингу, выполняемому из частного помещения, вы можете перенести возможности тестирования, доступные в общественных местах, непосредственно в свою собственную среду. Использование частных помещений позволяет:

* Оценить производительность и доступность внутренних веб-страниц.
* Измерять производительность сложных внутренних приложений с помощью анализа clickpatch в браузере.
* Измерять потребление внешних ресурсов с помощью синтетических мониторов, запускаемых из внутренних локаций.
* Отслеживать '''API''', как внутренние, так и внешние.

С помощью '''Синтетического мониторинга''' можно создавать только классические расположения, хотя в списке отображаются как классические, так и контейнеризированные (например, '''Kubernetes''' и '''OpenShift''') расположения. Если вам всё же необходимо создать контейнеризированное расположение, вы можете сделать это в '''Settings Classic'''.

Вкладка '''Частные локации''' в '''Синтетическом мониторинге''' отображает список всех доступных частных локаций в данной среде. Для каждой частной локации указана информация о количестве назначенных ей синтетических мониторов, а также ссылки на эти мониторы.

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

= Системные и аппаратные требования для частных помещений =
Убедитесь, что целевой хост, который вы планируете использовать для запуска синтетических мониторов, соответствует системным и аппаратным требованиям для частных синтетических местоположений. Обратите внимание, что АктивныйШлюз с поддержкой синтетических мониторов предъявляет более высокие требования к оборудованию и системе, чем обычный АктивныйШлюз для среды или кластера.

== Информация об окончании технической поддержки ==
Для '''Red Hat'''/'''Oracle Linux'''/'''Rocky Linux''' 8 новые версии '''Chromium''', кроме версии 133, отсутствуют. В целях обеспечения безопасности и стабильности мы решили прекратить поддержку установки АктивногоШлюза с поддержкой синтетического тестирования на '''Red Hat'''/'''Oracle Linux'''/'''Rocky Linux''' 8 после версии АктивногоШлюза 1.325. АктивныйШлюз версии 1.325 — последняя версия АктивногоШлюза с поддержкой синтетического тестирования, поддерживаемая на '''Red Hat'''/'''Oracle Linux'''/'''Rocky Linux''' 8. Кроме того, в версии Ключ-АСТРОМ 1.326 мы планируем внедрить механизмы, предотвращающие обновление АктивногоШлюза с поддержкой синтетического тестирования на '''Red Hat'''/'''Oracle Linux'''/'''Rocky Linux''' 8 до версии выше 1.325.

До версии 1.329 АктивныйШлюз с поддержкой синтетических тестов в '''Ubuntu''' 20 и '''Ubuntu''' 22 использовали '''Snap''' на основе '''Chromium'''. При настройке временного каталога по умолчанию для частных файлов синтетических тестов — <code>/var/tmp/astromkey/synthetic</code> путь должен начинаться с <code>/var/tmp</code>, например, <code>TEMP=/var/tmp/syn</code>. Ключ-АСТРОМ требует права на запись в <code>/var/tmp</code> для установки пакетов '''Snap''' на основе '''Chromium'''. Начиная с версии 1.331, эти ограничения больше не действуют. Последняя версия АктивногоШлюза в '''Ubuntu''' 20 и '''Ubuntu''' 22 использует '''Chrome для тестирования''', как и в '''Ubuntu''' 24.

= Прежде чем начать =

* Вы не можете запускать синтетические мониторы, используя '''Environment АктивныйШлюз''', настроенный для поддержки нескольких сред.
* Вы можете создать частное местоположение, используя чистую установку АктивногоШлюза версии 1.169+ с поддержкой синтетических сценариев или кластер АктивныхШлюзов с управляемым Ключ-АСТРОМ версии 1.176+. Если вы хотите использовать существующий хост АктивногоШлюза, сначала удалите АктивныйШлюз.
* АктивныйШлюз с поддержкой синтетического мониторинга используется исключительно для запуска синтетических мониторов. Чистая установка АктивногоШлюза для целей синтетического мониторинга отключает все остальные функции АктивногоШлюза, включая связь с ЕдинымиАгентами.
* Убедитесь, что АктивныйШлюз может подключаться к другим компонентам Ключ-АСТРОМ, а также к ресурсу, который вы хотите протестировать. См. раздел «Настройка прокси для частного синтетического мониторинга».
* Для настройки сети поддерживаются только '''IPv4''' и '''DNS UDP'''.
* Как ручное, так и автоматическое обновление браузера требует доступа к <code>https://synthetic-packages.s3.amazonaws.com</code>. В целях безопасности публичный доступ к хранилищу '''S3''' разрешён только для определённых файлов; попытка доступа к чему-либо другому приведёт к ошибке 403.

= Создать приватное местоположение =
Чтобы добавить классическое уединённое место:

# Перейдите во вкладку '''Частные локации''' в верхнем левом углу главной страницы '''Синтетический мониторинг'''.
# Выберите '''Новые частные локации''' > '''Классические'''.
# Укажите ваше местоположение.
# Отобразите на карте существующее географическое местоположение или добавьте пользовательское местоположение, заданное страной, регионом, городом, широтой и долготой.
# Выберите '''Существующий АктивныйШлюз''', чтобы добавить существующий АктивныйШлюз с поддержкой синтетического анализа в указанное местоположение, или '''Развернуть новый АктивныйШлюз''', чтобы развернуть новый (развёртывание нового АктивногоШлюза перенаправит вас в раздел '''Обнаружение и покрытие''', откуда вы сможете установить АктивныйШлюз).
# Добавьте несколько АктивныхШлюзов, если планируете запускать большое количество синтетических мониторов. Дополнительные АктивныеШлюзы используются для обеспечения отказоустойчивости и балансировки нагрузки.
#* Мы рекомендуем использовать как минимум два АктивныхШлюза для одного местоположения.
#* Использовать одни и те же АктивныеШлюзы для нескольких местоположений невозможно.
# (Необязательно) Включите '''автоматическое обновление Chrome(-ium)''' — оно будет запускаться во время обновлений синтетического движка по этому адресу.
#* Вы можете включить автоматическое обновление '''Chrome(-ium)''' на уровне местоположения, то есть для всех АктивныхШлюзов, назначенных частному местоположению. Автоматическое обновление '''Chromium''' происходит как при ручном, так и при автоматическом обновлении АктивногоШлюза и синтетического движка.
#* Поскольку мы рекомендуем использовать последнюю поддерживаемую версию '''Chromium''' для бесперебойной и безопасной работы браузерных мониторов из вашего личного местоположения, автоматическое обновление '''Chromium''' включено по умолчанию для местоположений с АктивнымШлюзом на базе '''Linux'''. Если вы не хотите, чтобы '''Chromium''' обновлялся автоматически, например, для использования определённой версии '''Chromium''', или если у вас есть автономные среды, отключите этот переключатель перед запуском обновления АктивногоШлюза.
#* Этот параметр применяется только к АктивнымШлюзам на базе '''Linux'''; в АктивныхШлюзах на базе '''Windows''' '''Chromium''' всегда обновляется во время обновлений синтетического движка. Если в вашем регионе используются только АктивныеШлюзы на базе '''Windows''', переключатель будет включён, но недоступен (заблокирован).
#* Для успешного автоматического обновления '''Chromium''' требуется доступ к репозиториям операционной системы (ОС) для зависимостей '''Chromium''' и доступ к <code>https://synthetic-packages.s3.amazonaws.com</code> компонентам '''Chromium'''. Если вы включили пользовательский локальный репозиторий, компоненты '''Chromium''' (но не зависимости) должны быть доступны по указанному адресу '''HTTP'''-сервера. См. раздел «Автоматическое обновление Chromium из пользовательского репозитория».
#* В случае сбоя автоматического обновления '''Chromium''' по этой или другим причинам вы увидите соответствующее сообщение. Мы рекомендуем либо выполнить требования для автоматического обновления (например, иметь доступ к репозиториям), либо отключить автоматическое обновление '''Chromium''' для вашего местоположения.
#* Мы настоятельно рекомендуем обновлять версии АктивногоШлюза и '''Chromium''', поддерживающих синтетический анализ на базе '''Linux''' — Ключ-АСТРОМ поддерживает версии '''Chromium''', отстающие от последней поддерживаемой Ключ-АСТРОМ версии АктивногоШлюза не более чем на две версии. Если вы не используете автоматическое обновление '''Chromium''', вы можете обновить его вручную.
#* Если вы отключите автоматическое обновление '''Chromium''', вы сможете обновлять '''Chromium''' вручную для каждого АктивногоШлюза. Однако автоматическое обновление '''Chromium''' требуется при использовании пользовательских репозиториев. См. раздел «Автоматическое обновление Chromium из пользовательского репозитория».
#* Функция автообновления обновляет '''Chromium''' до последней версии, предоставляемой Ключ-АСТРОМ для конкретного релиза АктивногоШлюза. В некоторых случаях эта версия может отличаться от последней версии '''Chromium''', поддерживаемой Ключ-АСТРОМ для данного релиза АктивногоШлюза.
#* Также ознакомьтесь с нашей информацией по ручной установке '''Chromium''' и других зависимостей (только для '''Linux''').
# (Необязательно) Если у вас возникли проблемы с подключением к вашему местоположению, воспользуйтесь параметрами обработки сбоев в работе местоположения, чтобы получать соответствующие уведомления. Подробную информацию см. в инструкциях на экране.
#* Вы можете настроить местоположение таким образом, чтобы проблема возникала, когда всё частное местоположение недоступно (все АктивныеШлюзы отключены) или если местоположение не обладает необходимыми возможностями для выполнения мониторинга данного типа.
#* Вы можете настроить местоположение таким образом, чтобы проблема возникала, когда хотя бы один из АктивныхШлюзов в этом месте находится в автономном режиме.
#* Например, предположим, что в вашем местоположении установлено два АктивныхШлюза, и вы включаете оба переключателя проблем. В случае недоступности вашего местоположения вы увидите три проблемы — одну для всего местоположения и по одной для каждого отключённого АктивногоШлюза.
#* Для контейнеризированных локаций проблема может возникнуть только в том случае, если вся частная локация недоступна (все АктивныеШлюзы отключены) или если локация не обладает необходимыми возможностями для выполнения мониторинга соответствующего типа.
# Выберите '''Сохранить'''.

= Дополнительные режимы развертывания =
Дополнительные режимы развёртывания, доступные вам:

* Без браузера
* Kerberos
* Соответствует стандарту FIPS

== АктивныйШлюз без браузера с поддержкой синтетических данных ==
В целом, мы рекомендуем использовать АктивныйШлюз с поддержкой синтетических тестов для выполнения всех типов синтетических мониторов ('''HTTP''', браузерный, '''NAM''').

Если вам не требуется запускать мониторы браузера, рассмотрите возможность развёртывания нода в режиме без браузера. В этом режиме нод развёртывается без браузера, что снижает требования к оборудованию. Однако мониторы браузера не могут работать на ноде без браузера.

Рассмотрите ноды без браузера в качестве альтернативы нодам с поддержкой браузерного монитора, если вы сосредоточены исключительно на:

* Примерах использования сети и инфраструктуры (с помощью мониторов '''NAM''')
* Мониторинге '''API''' (с использованием '''HTTP'''-мониторов)

== Настройка клиента Kerberos ==
Если вы хотите запускать мониторы браузера с использованием аутентификации '''Kerberos''', необходимо настроить частное местоположение таким образом, чтобы оно могло получать билет из Центра распространения ключей '''Kerberos'''.

=== Windows ===
Каждый компьютер под управлением '''Windows''', использующий '''Kerberos''', должен быть корректно настроен для работы с '''Active Directory'''. Если вам не удаётся пройти аутентификацию по '''Kerberos''' в '''Windows''', используйте следующую команду для регистрации машины.<pre>
ksetup /addkdc DOMAIN.TO.ADD address.of.kerberos.server
</pre>Это <code>DOMAIN.TO.ADD</code> — ваше доменное имя, а <code>address.of.kerberos.server</code> — это центр распространения ключей '''Kerberos''' (контроллер '''Active Directory''', если вы используете решение '''Microsoft'''). Обратите внимание, что в используемых учётных данных доменное имя должно быть написано заглавными буквами (например, <code>user@EXAMPLE.COM</code>).

=== Linux ===
В '''Синтетическом мониторинге''' используется аутентификация '''Kerberos''' путём выполнения команды <code>kinit</code>. Подробности см. в документации '''MIT''' по '''Kerberos''' — <code>kinit</code>.

Для получения билета из Центра распространения ключей '''Kerberos''' необходимо правильно настроить частную директорию '''Linux'''. Убедитесь, что директория содержит следующие параметры:

* Установлены пакеты для клиента '''Kerberos''' (рабочая станция).
* Правильно настроенный файл <code>/etc/krb5.conf</code> (или файл конфигурации, указанный переменной среды <code>KRB5_CONFIG</code>).

Конфигурация зависит от дистрибутива '''Linux'''. Более подробную информацию можно найти в официальной документации.

'''Ubuntu:'''<pre>
sudo apt install krb5-user
</pre>Дополнительная информация: Документация '''Ubuntu Server''' — Как настроить базовую аутентификацию рабочих станций.

'''Red Hat/Rocky:'''<pre>
dnf install krb5-workstation krb5-libs
</pre>Дополнительная информация: Документация '''Red Hat''' — Настройка клиента '''Kerberos'''.

== Синтетическое соответствие стандарту FIPS ==
АктивныйШлюз версии 1.315+

=== Установка ===
Для установки АктивногоШлюза с поддержкой синтетического моделирования в режиме, соответствующем стандарту '''FIPS''', необходимо добавить соответствующий флаг <code>--fips-mode</code>. См. также раздел «Настройка установки АктивногоШлюза для соответствия стандарту FIPS».<pre>
/bin/bash ./astromkey-ActiveGate-Linux.sh --enable-synthetic --fips-mode
</pre>Обратите внимание, что режим соответствия стандарту '''FIPS''' нельзя изменить после установки. Для изменения режима необходимо удалить АктивныйШлюз и переустановить его с нужными настройками. Кроме того, если вы планируете запускать мониторинг браузера, потребуется дополнительная настройка, как описано в разделах «Настройка прокси для режима FIPS» и «Настройка прокси для режима FIPS с использованием корпоративного прокси».

=== Требования и ограничения ===

* Для работы требуется операционная система с включённым режимом соответствия стандарту '''FIPS''', см. также информацию о соответствии стандарту '''FIPS''' в АктивномШлюзе.
* В настоящее время поддерживаются следующие операционные системы:
** '''Ubuntu Pro 22.04'''
** '''Red Hat Enterprise Linux 9'''
* В настоящее время поддержка частных синтетических местоположений в '''Kubernetes''' не реализована.

=== Обеспечение соответствия ===

* Для обеспечения соответствия трафика монитора браузера стандарту '''FIPS''', он должен маршрутизироваться через локальный перехватывающий прокси-сервер, который шифрует трафик с помощью криптографической библиотеки, сертифицированной по стандарту '''FIPS'''. Подробности см. в разделе «Конфигурация прокси-сервера для режима FIPS».
* Для мониторинга '''HTTP''' мы используем сертифицированную по стандарту '''FIPS''' криптографическую библиотеку '''Amazon Corretto Crypto Provider''', которая использует '''AWS-LC-FIPS''' 2.x в качестве криптографического модуля. См. сертификат № 4816.
* В режиме, соответствующем стандарту '''FIPS''', модуль АктивногоШлюза с поддержкой синтетического шифрования использует тот же набор алгоритмов шифрования, что и обычный модуль АктивногоШлюза.

= Часто задаваемые вопросы =

== Как проверить подлинность загруженных пакетов Chrome(-ium)? ==

=== Хром ===
Каждый <code>tgz</code>-архивный пакет хранится в хранилище '''S3''' вместе с файлом подписи <code>*.tgz.sig</code>. Чтобы проверить, являются ли пакеты на вашем диске подлинными архивами, предоставленными Ключ-АСТРОМ:

# Загрузите файл с подписью. Имя файла идентично имени архива пакета, но имеет расширение <code>sig</code>. Например, для '''Chromium''' 140 команда выглядит так:
<pre>
curl --output chromium.tgz.sig https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-140.0.7339.185-1.el9.tgz.sig
</pre>

# Проверьте упаковку:
<pre>
wget https://ca.astromkey.com/dt-root.cert.pem ; openssl cms \
-verify \
-in chromium.tgz.sig \
-inform PEM \
-content chromium.tgz \
-binary \
-CAfile dt-root.cert.pem > /dev/null
</pre>

# Проверьте отметку времени подписи.
# Вы также можете получить точную метку времени подписи. Загрузите файл <code>*.tgz.sig.tsr</code> из того же места, где находятся установочные пакеты и подпись, а затем выполните следующую команду:
<pre>
openssl ts -reply -in chromium.tgz.sig.tsr -text
</pre>

=== Chrome для тестирования ===
Каждый <code>zip</code>-архивный пакет хранится в хранилище '''S3''' вместе с файлом подписи <code>*.zip.sig</code>. Чтобы проверить, являются ли пакеты на вашем диске подлинными архивами, предоставленными Ключ-АСТРОМ:

# Загрузите файл с подписью. Имя файла идентично имени архива пакета, но имеет расширение <code>sig</code>. Например, для '''Chrome for Testing''' 141.0.7390.122 команда выглядит так:
<pre>
curl --output chrome.zip.sig https://synthetic-packages.s3.amazonaws.com/Chrome/chrome-for-testing-linux64/chrome-for-testing-linux64-141.0.7390.122.zip.sig
</pre>

# Проверьте упаковку:
<pre>
wget https://ca.astromkey.com/dt-root.cert.pem ; openssl cms \
-verify \
-in chrome.zip.sig \
-inform PEM \
-content chrome.zip \
-binary \
-CAfile dt-root.cert.pem > /dev/null
</pre>

# Проверьте отметку времени подписи.
# Вы также можете получить точную метку времени подписи. Загрузите файл <code>*.zip.sig.tsr</code> из того же места, где находятся установочные пакеты и подпись, и выполните следующую команду:
<pre>
openssl ts -reply -in chrome.zip.sig.tsr -text
</pre>

== Можно ли использовать прокси с АктивнымШлюзом, поддерживающим синтетический анализ? ==
Начиная с версии АктивногоШлюза 1.175 и выше, АктивныйШлюз, выполняющий синтетический мониторинг, может подключаться через прокси-сервер как к кластеру Ключ-АСТРОМ, так и к тестируемому ресурсу. Для получения дополнительной информации см. раздел «Настройка прокси-сервера для частного синтетического мониторинга».

== Можно ли обновить более раннюю версию АктивногоШлюза до 1.169+ и настроить её для работы с частными синтетическими мониторами? ==
Нет, вам необходимо выполнить чистую установку специально для целей синтетического мониторинга, чтобы ваш АктивныйШлюз мог запускать мониторинговые задачи из частных местоположений.

== Можно ли включить синтетический режим в уже установленной системе АктивногоШлюза? ==
Для мониторинга частных синтетических локаций требуется чистая установка АктивногоШлюза, специально предназначенная для целей синтетического мониторинга.

Недостаточно просто отредактировать файл <code>custom.properties</code> вручную, для того чтобы АктивныйШлюз мог запускать синтетические мониторы.

= Поиск неисправностей =
В результатах поиска браузера не отображаются скриншоты.

Для получения дополнительной информации по устранению неполадок посетите форум по устранению неполадок в сообществе Ключ-АСТРОМ.

Выполнение мониторов по запросу

2026-09-03T15:38:49Z

IKuznetsov: Новая страница: « = Выполнение мониторов по запросу = Для запуска выполнения через веб-интерфейс: # В правом верхнем углу страницы с подробными сведениями о мониторе выберите '''Выполнение по запросу'''. # В списке '''Местоположения''' выберите местоположения, для которых вы...»

= Выполнение мониторов по запросу =
Для запуска выполнения через веб-интерфейс:

# В правом верхнем углу страницы с подробными сведениями о мониторе выберите '''Выполнение по запросу'''.
# В списке '''Местоположения''' выберите местоположения, для которых вы хотите запускать выполнение по запросу.
#* Обратите внимание, что для выполнения этой операции вы можете выбрать комбинацию назначенных и неназначенных общедоступных местоположений.
# Выберите '''режим обработки''' — это будет применено ко всем выбранным местам при данном выполнении.
#* '''Стандартный (по умолчанию) режим''' — выполнение этих операций способствует обнаружению проблем, а также сбору статистики доступности и производительности. Результаты выполнения можно просмотреть в разделе '''Анализ выполнений'''.
#* '''Отключите обнаружение проблем''' — результаты выполнения учитываются в статистике доступности и производительности, но не в обнаружении проблем. Вы можете просмотреть результаты выполнения при анализе выполнений.
#* '''Представлены только подробные сведения о выполнении''' — данные о выполнении не используются для составления статистики доступности и производительности, а также для выявления проблем. Вы по-прежнему сможете получить доступ к результатам при анализе выполнений.
#* Обратите внимание, что для всех режимов обработки результаты выполнения отображаются в списке выполнения по запросу в веб-интерфейсе и могут быть получены через '''API''' выполнения по запросу.
# При необходимости настройте:
#* '''Сбой при нарушении порогового значения производительности''' — по умолчанию выполнение по запросу завершается с ошибкой при нарушении порогового значения производительности, поскольку его основная цель — проверка новых версий программного обеспечения в вашем конвейере CI/CD. Однако вы можете отключить эту настройку, чтобы выполнение по запросу вело себя как обычное запланированное выполнение (нарушение порогового значения производительности не приводит к сбою этого выполнения, но способствует возникновению проблемы с производительностью).
#* '''Создание скриншота''' (только для мониторов браузера) — при успешном выполнении система делает скриншот. Чтобы просмотреть скриншот, перейдите в раздел '''Анализ выполнений'''.
#* '''Обработка проблем с SSL''' (только для '''HTTP'''-мониторов) — монитор выдаёт ошибку, если один или несколько его запросов обнаруживают просроченный, отсутствующий или истекающий '''SSL'''-сертификат.
# Выберите '''Запустить сейчас''' — появится диалоговое окно со сводкой, в котором будут перечислены места выполнения; в списке выполнения отобразятся новые записи для запущенных запусков. Начальный этап выполнения — '''Triggered'''.

Любые изменения, внесённые вами в скрипт мониторинга (конфигурацию), немедленно становятся доступны для выполнения по запросу в общедоступных или частных локациях.

Обратите внимание, что исполнение приказов может начинаться не одновременно из разных мест — начало исполнения приказов из общественных мест может занять больше времени, чем из частных. Дополнительную информацию о регулировании скорости выполнения приказов см. ниже.

= Регулирование и ограничения =
Для каждого пользователя предусмотрен обязательный 60-секундный перерыв между последовательными запусками монитора по запросу из одного и того же места (независимо от того, запускается ли он через веб-интерфейс или '''API''').

== Примеры регулирования скорости ==
Все эти примеры предполагают выполнение из одного и того же места.

* Пользователь A запускает монитор через '''API''' в течение 60 секунд после запуска того же монитора через пользовательский интерфейс — с ограничением частоты.
* Пользователь B запускает монитор через '''API''' в течение 60 секунд после того, как пользователь A запустит тот же монитор через пользовательский интерфейс — без ограничения скорости.
* Пользователь B активирует монитор через пользовательский интерфейс в течение 60 секунд после того, как пользователь A активирует тот же монитор через пользовательский интерфейс — ограничение скорости не происходит.
* Пользователь B запускает мониторинг через '''API''' в течение 60 секунд после того, как пользователь A запустил тот же мониторинг через '''API''' — без ограничения скорости.

При запуске нескольких операций по запросу через '''API''' существует ограничение в 100 операций в одной партии.

В среде Ключ-АСТРОМ существует ограничение в 5000 выполнений по запросу в минуту.

В каждом пакете можно определить до 64 пар ключ-значение метаданных, при этом длина каждого ключа и значения может составлять до 1024 символов.

= Сбои при запуске =
Выполнение запросов по требованию может не удаться по различным причинам, например, когда монитор отключён, местоположение недоступно или когда для монитора в данном местоположении действует ограничение скорости.

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

Если запуск выполнения через веб-интерфейс не удаётся, причины отображаются в сводке статуса запуска после выбора пункта '''Запустить сейчас'''. Этап выполнения в списке запусков — '''Not triggered'''. Подробная информация о запусках, не запущенных через '''API''', возвращается в параметрах ответа '''POST'''-запроса (<code>triggeringProblemsCount</code>, <code>triggeringProblemsDetails</code>).

Задания, которые не могут быть запущены, отличаются от заданий, которые запущены, но не могут быть выполнены. Подробнее см. раздел '''API'''.

= Список выполнений =
В списке выполнений отображаются все выполнения по запросу (инициированные любым пользователем через веб-интерфейс или '''API''') для данного монитора в течение выбранного временного интервала.

Для просмотра списка выполнений вам потребуется лицензия '''DPS'''.

Идентификатор выполнения — это уникальный идентификатор, присваиваемый каждому выполнению; если вы запускаете выполнения из всех мест, то для выполнения в каждом месте будет присвоен свой уникальный идентификатор.

В поле '''Запущено''' отображается время начала выполнения в часовом поясе пользователя, выполнившего вход в систему.

'''Исходный код''' показывает, было ли выполнение запущено через веб-интерфейс '''UI''' или через '''API'''.

'''User''' — это идентификатор пользователя Ключ-АСТРОМ, который инициировал выполнение операции.

'''Местоположение''' — это название общественного или частного места, откуда осуществлялся контроль.

Этап выполнения определяет различные этапы выполнения по запросу. Начальное значение равно '''Triggered''' или '''Not triggered'''. После завершения выполнения значение изменяется на '''Executed'''. На этом этапе доступны основные результаты, такие как продолжительность и код состояния. Индикатор выполнения продолжает отображаться на этом этапе '''Executed''' до тех пор, пока не станут доступны подробные результаты и значение не изменится на '''Data retrieved'''. Если для одного местоположения запускается несколько последовательных выполнений, первое выполнение помечается как '''Triggered'''; остальные выполнения помечаются как '''Waiting'''.

'''Результат''' указывает, было ли выполнение операции '''Success''' или '''Failure''' (с указанием причины сбоя).

Для просмотра подробностей выполнения выберите значок развёртывания в первом столбце.

Создание монитора NAM

2026-09-03T15:34:15Z

IKuznetsov: Новая страница: « = Создание монитора NAM = С помощью мониторов доступности сети ('''NAM''') вы можете проверить доступность ваших хостов, устройств и служб. Существует три типа мониторов '''NAM''': '''ICMP''', '''TCP''' и '''DNS'''. Подробнее о них см. в разделе '''Типы NAM'''. Вы можете создавать мо...»

= Создание монитора NAM =
С помощью мониторов доступности сети ('''NAM''') вы можете проверить доступность ваших хостов, устройств и служб.

Существует три типа мониторов '''NAM''': '''ICMP''', '''TCP''' и '''DNS'''. Подробнее о них см. в разделе '''Типы NAM'''. Вы можете создавать мониторы '''NAM''' в '''Синтетическом мониторинге''' или через '''API'''.

== Настройка NAM ==
С помощью мониторов '''NAM''' можно включить более одного этапа.

* Каждый шаг может содержать один или несколько запросов.
* Как и в случае с '''HTTP'''- и браузерными мониторами, шаги выполняются последовательно.
* В отличие от '''HTTP'''- и браузерных мониторов, мониторы '''NAM''' могут обрабатывать несколько запросов в рамках одного шага. Все запросы, назначенные определённому шагу, выполняются параллельно. Если один запрос завершается неудачей, это не влияет на выполнение других запросов в рамках этого шага.
* Шаг пропускается, если в конфигурации монитора нет ничего, что соответствовало бы его определению. Например, когда тег указан в списке целевых фильтров, но ничто не соответствует этому тегу.
* Концепция параллельного выполнения запросов существует только для мониторов '''NAM'''.

Например, если вы хотите отслеживать группу из 4 хостов с помощью теста '''ICMP''', вам нужно применить одинаковые условия (такие как частота, место выполнения теста и количество пакетов) для каждого хоста из вашей группы.

'''NAM''' предоставляет вам возможность решить эту проблему несколькими способами:

* Вы можете определить 4 отдельных теста, по одному для каждого хоста. Преимущество такого подхода заключается в том, что Ключ-АСТРОМ запускает отдельную проблему для каждого хоста, и вы можете назначить отдельные уведомления для каждого из них. Вы также можете настраивать параметры теста для каждого хоста отдельно.
* Вы можете определить один тест с 4 запросами (в рамках одного шага). Выполняются те же проверки '''ICMP''', но будут различия в отчётности и оповещениях. Количество или процент недоступных хостов отображается в метрике '''Успешность запросов'''. Вы можете настроить собственный порог для сбоя всего монитора. Например, если допустимо, что недоступен 1 из 4 хостов из-за развёртывания обновления, вы можете определить это на уровне <code>>=75%</code> всего монитора. Для монитора всегда генерируется одна проблема, но при этом он содержит подробную информацию о не отвечающих хостах. Ещё одно преимущество такого подхода — упрощение обслуживания (настройка одного параметра для всех 4 хостов).
* Наконец, фильтры позволяют определять тесты для динамически изменяющейся структуры. Например, если вы хотите определить тесты '''ICMP''' для заданной группы хостов, вам не нужно будет корректировать тест монитора '''NAM''' после изменения конфигурации группы хостов.

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

== Создайте монитор NAM ==
Чтобы создать монитор '''NAM''' в последней версии Ключ-АСТРОМ:

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

=== Выберите тип ===
Страница '''Создать синтетический монитор''' показывает типы синтетических мониторов, которые вы можете создать.

Выберите '''Сетевой монитор (NAM)''', чтобы начать.

=== Общие сведения ===

* Обязательно: Укажите '''Имя монитора''' так, как оно будет отображаться в веб-интерфейсе (до 500 символов).
* Обязательно: Выберите '''Протокол''' — тип монитора: '''DNS''', '''ICMP''' или '''TCP'''.
* Необязательно: Добавьте '''Описание''' — опишите ваш монитор.
* Необязательно: Чтобы вручную создать новый тег, выберите '''Добавить тег''' в разделе '''Теги''', введите '''Ключ''', при необходимости укажите '''Значение''' и выберите '''Добавить'''.
* Необязательно: Чтобы вручную создать новый основной тег Хранилища данных, выберите '''Добавить тег''' в разделе '''Основные теги Хранилища данных''', введите '''Ключ''' и '''Значение''' и выберите '''Добавить'''. Подробнее см. '''Основные теги Хранилища данных для синтетики'''.

После указания общих настроек выберите '''Продолжить'''.

=== Запросы ===
Раздел '''Запросы''' имеет два режима редактирования. Вы можете переключаться между этими режимами.

* '''Визуальный''' (по умолчанию) — для просмотра и настройки запросов '''NAM''' через настройки веб-интерфейса.
* '''Скрипт''' — для просмотра и редактирования настроек запросов в формате '''JSON'''. Предоставленный вами скрипт также служит полезной нагрузкой для запросов '''API'''.

Настройки для каждого запроса (можно добавить несколько запросов):

* Обязательно: '''Имя запроса''' — имя запроса.
* Обязательно: '''Список целей''' или '''Выражение фильтра'''.
** Вы можете указать цели для запросов в виде явного списка или отфильтровать отслеживаемые хосты с помощью выражения фильтра.
** Если вы хотите указать цели как IP или доменные имена, используйте '''Список целей''' для указания списка целей, разделённых запятыми. Используйте это для мониторинга одного или нескольких хостов, устройств или служб.
** Если вы хотите выбрать некоторые из отслеживаемых хостов или пользовательских устройств, используйте '''Выражение фильтра''' для указания выражения фильтра. Это позволяет отслеживать группу хостов или пользовательских устройств, соответствующих критериям фильтра. Подробнее о доступных фильтрах см. '''Целевой фильтр'''.
** Вы можете комбинировать '''Список целей''' и '''Выражение фильтра''' в одном шаге монитора. При совместном использовании шаг монитора будет включать объединённый набор целей из обоих полей.
* Обязательно: '''Атрибуты выполнения''' — это пары ключ/значение, связанные с вашим запросом. Определите '''Таймаут запроса''', '''Количество пакетов''', '''Длина данных''', '''Время жизни''', '''Таймаут ответа'''; также можно включить или выключить '''Не фрагментировать данные'''. Атрибуты выполнения доступны только для '''ICMP'''.
* Обязательно: '''Ограничения''' — условия, которые должны быть выполнены, чтобы считать выполнение монитора успешным. Необходимо определить '''Тип ограничения''', '''Оператор''' и '''Значение'''.

Если вы хотите создать ещё один запрос, выберите '''Добавить следующий запрос''' и укажите вышеперечисленное для следующего запроса.

Используйте '''Дублировать''', чтобы дублировать запрос и затем редактировать его, вместо того чтобы начинать с нуля каждый раз при добавлении запроса.

После указания всех запросов выберите '''Продолжить'''.

=== Частота и местоположение ===
В разделе '''Частота и местоположение''' укажите частоту и местоположения.

* Обязательно: Выберите '''Частоту''' — можно выбрать частоту (каждые 1 мин, 2 мин, 5 мин, 10 мин, 15 мин, 30 мин или 1 ч) или выбрать '''Только по запросу''' для ручного выполнения.
* Обязательно: Выберите '''Местоположения''' — укажите одно или несколько местоположений.

После указания частоты и местоположений выберите '''Продолжить'''.

=== Сбои и производительность ===
В разделе '''Обработка сбоев''' вы можете включить и настроить следующие параметры, связанные с генерацией проблем и оповещений:

* Необязательно: '''Сгенерировать проблему и отправить оповещение, когда монитор недоступен во всех настроенных местоположениях (глобальный сбой).'''
* Необязательно: '''Сгенерировать проблему и отправить оповещение, когда монитор недоступен только при наличии как минимум двух назначенных местоположений.''' Обратите внимание, что эта опция возможна только если вы выбрали два или более местоположений.
* Необязательно: '''Сгенерировать проблему и отправить оповещение о нарушениях пороговых значений производительности.'''

После указания настроек сбоев и производительности выберите '''Продолжить'''.

=== Краткое содержание ===
В разделе '''Краткое содержание''' проверьте ваши настройки.

После проверки выберите '''Сохранить''', чтобы создать монитор, или '''Назад''', чтобы вернуться и скорректировать настройки монитора.

== Целевой фильтр ==
Целевой фильтр даёт возможность фильтровать хосты, отслеживаемые Ключ-АСТРОМ, или пользовательские устройства с IP-адресами. С помощью этого фильтра вы можете выбирать эти два типа целей на основе:

* тип (<code>type</code>)
* теги (<code>tag</code>)
* идентификатор хоста (<code>hostId</code>) (устарело, работает только для хостов; используйте идентификатор сущности)
* идентификатор сущности (<code>entityId</code>)
* группы хостов (<code>hostGroup</code>)
* менеджмент зоны (<code>managementZone</code>)
* маска IP (<code>ipMask</code>)
* диапазон IP (<code>ipRange</code>)
* экземпляр группы процессов (<code>processGroupInstance</code>)
* сетевые интерфейсы конкретного пользовательского устройства (<code>interfacesOf</code>)
* имя расширения (<code>extensionName</code>)

Маска IP и диапазон IP — это фильтры для хостов или устройств, известных серверу Ключ-АСТРОМ, а не возможность сканирования сети.

=== Синтаксис ===

* Логические операторы: <code>AND</code> и <code>OR</code> (без учёта регистра)
* Скобки
* Операторы выражения: <code>==</code> и <code>!=</code>
* Имена и значения тегов
* Отрицание («не»): <code>!=</code>
* Подстановочный знак: <code>*</code> (выбирает все хосты, отслеживаемые Ключ-АСТРОМ)

=== Примеры ===
<pre>
tag == tagname or hostGroup == group1
(tag == tagname1:tagvalue1 or tag == tagname1:tagvalue2) and (hostGroup == group1 or managementZone == zone1)
tag != tagname1 and tag != tagname2:tagvalue
tag == tagname:tagvalue and (managementZone == zone1 or managementZone == zone2)
tag == "[tagwithbrackets and spaces]":"value, with, commas, and, spaces"
ipMask == 127.0.0.1/24
hostId == HOST-000123
type == CUSTOM_DEVICE and ipMask == 172.17.0.2/24
entityId == HOST-045BFCDA3F507D30 or entityId == CUSTOM_DEVICE-13081D4B74B3E2C8
type == HOST and processGroupInstance == PROCESS_GROUP_INSTANCE-07611353BB98908C
type == CUSTOM_DEVICE and interfacesOf == CUSTOM_DEVICE-E1A88946BF04D5E7
type == CUSTOM_DEVICE and extensionName == "Docker devices"
</pre>

== Пороговые значения производительности ==
Пороговое значение производительности сравнивается с метрикой, рассчитанной для каждого запроса в рамках монитора/шага. Например, если монитор проверки порта '''TCP''' тестирует на одном хосте порт 80 и 443 отдельно, Ключ-АСТРОМ сравнивает порог времени установления '''TCP'''-соединения дважды: один раз для порта 80 и один раз для порта 443.

Существует три метрики производительности для трёх типов мониторов '''NAM''':

* '''RTT''' для '''ICMP'''
* Время установления '''TCP'''-соединения для '''TCP'''
* Время разрешения '''DNS''' для '''DNS'''

Нарушение заданного порога производительности вызывает проблему ('''Замедление''').

Аналогично проблемам доступности:

* Проблемы открываются для каждого монитора
* Содержат информацию обо всех запросах, ответственных за проблему

Вы можете настроить способ агрегирования результатов для каждого пакета в одиночном выполнении '''ICMP'''-запросов. Ключ-АСТРОМ поддерживает '''AVG''', '''MAX''' и '''MIN''', по умолчанию используется '''AVG'''.

=== Определите пороговые значения ===
Вы можете определить пороговые значения производительности при настройке запроса для вашего синтетического монитора. Определённое пороговое значение производительности одинаково для всех запросов в рамках одного шага. Если требуется создать многошаговый монитор '''NAM''', можно определить разные пороговые значения для каждого шага.

Чтобы определить пороговые значения:

# Выполните шаги, описанные в разделе '''Создание монитора NAM'''.
# В разделе '''Запросы''' прокрутите страницу вниз и найдите раздел '''Оповещения о пороговых значениях производительности'''.
# Установите флажок '''Сгенерировать проблему и отправить оповещение о нарушениях пороговых значений производительности'''.
# Включите переключатель '''Расширенные настройки пороговых значений производительности'''.
# В этом разделе можно задать '''Количество выполнений запроса в анализируемом скользящем окне''' и '''Количество нарушающих выполнений запроса в анализируемом скользящем окне'''. Для снятия оповещений требуется '''n''' последних не нарушающих выполнений запроса.

=== Сообщение о нарушениях ===
Красная аннотация над графиками производительности указывает период времени, в течение которого было превышено пороговое значение производительности. Кроме того, на графике производительности отображается пороговое значение, и вы можете проверить, какие запросы превышают порог.

С помощью функции масштабирования вы можете сузить временной диапазон, оставив только тот период, в течение которого проблема была актуальна.

NAM отслеживает отчётность о результатах

2026-09-03T15:30:39Z

IKuznetsov: Новая страница: « = NAM отслеживает отчётность о результатах = == Выполнение монитора по запросу == Выполнение мониторинга по запросу через веб-интерфейс доступно только в рамках лицензии '''DPS'''. Срок хранения данных о выполнении мониторинга составляет 35 дней. Для пользов...»

= NAM отслеживает отчётность о результатах =

== Выполнение монитора по запросу ==
Выполнение мониторинга по запросу через веб-интерфейс доступно только в рамках лицензии '''DPS'''. Срок хранения данных о выполнении мониторинга составляет 35 дней.

Для пользователей, не имеющих лицензии '''DPS''', выполнение мониторинга возможно через '''API'''. Вы можете получить доступ к результатам за последние 6 часов.

Чтобы отобразить страницу с отчётом для вашего монитора, выберите '''Просмотреть подробности''' в правом верхнем углу панели предварительного просмотра.

== Стандартные страницы отчётов включают в себя ==

* Плитки, отображающие краткую информацию о глобальных сбоях, активных проблемах, количестве затронутых местоположений, доступности, общем времени простоя и его продолжительности.
* '''Доступность''' — график изменения доступности во времени. Доступность для мониторов '''NAM''' рассчитывается путём сравнения процента успешных запросов с заданными ограничениями. Период, когда доступность равна 0%, называется простоем (остановкой работы).

Вы можете сузить временной диапазон диаграммы, чтобы она охватывала только период простоя. Это позволяет, например, выявлять запросы, которые негативно влияют на доступность. По умолчанию диаграмма доступности свёрнута, если отображается 0% или 100% за весь временной диапазон. Чтобы открыть её, просто выберите '''Доступность'''.

Подробную информацию о том, как рассчитывается доступность, см. в разделе '''Доступность в синтетических расчётах'''.

Подробную информацию о том, как рассчитывается общее время простоя, см. в разделе '''Общее время простоя в синтетических расчётах'''.

* '''Показатель успешности''' — это график изменения показателя успешности во времени, где показатель успешности представляет собой процент всех выполненных запросов, которые оказались успешными.

Ознакомьтесь с условиями, которым должен соответствовать запрос, чтобы быть рассмотренным в качестве успешного.

Нажмите кнопку '''Показать запросы''' под диаграммой, чтобы увидеть изменения доступности, такие как средняя производительность, средняя доступность и процент успешных пакетов (этот столбец доступен только для '''ICMP''').

* '''Производительность''' — график изменения производительности во времени, где производительность рассчитывается как среднее значение для всех успешных запросов. Обратите внимание, что показатели производительности не отображаются для неудачных запросов.

* '''Изменения''' — журнал истории, отображающий:
** Когда был создан монитор и кто его создал.
** Кто изменил свойства монитора, когда были внесены изменения и какие свойства были изменены в выбранный период времени.

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

2026-09-03T15:29:43Z

IKuznetsov: Новая страница: « = Настройка времени ожидания между шагами, правил проверки содержимого и пороговых значений производительности = При настройке шагов вы можете: * Настроить время ожидания между шагами. * Настроить правила проверки контента и пороговые значения произв...»

= Настройка времени ожидания между шагами, правил проверки содержимого и пороговых значений производительности =
При настройке шагов вы можете:

* Настроить время ожидания между шагами.
* Настроить правила проверки контента и пороговые значения производительности.

== Время ожидания до запуска следующего шага ==
Хотя Ключ-АСТРОМ автоматически выбирает подходящее время ожидания для каждого шага, вы можете настроить этот параметр в разделе '''Условие, по которому этот шаг считается выполненным''', чтобы определить, как долго Ключ-АСТРОМ должен ждать перед выполнением следующего шага.

* '''Нет условий'''
* '''Страница загружается полностью''' — после запуска загрузки страницы монитор ожидает завершения сетевой активности. Это время ожидания по умолчанию (60 секунд), используемое при загрузке новой страницы.
* '''Прошло определенное количество времени''' — укажите количество секунд, которое Ключ-АСТРОМ должен подождать между этим шагом и следующим.
* '''Любой из элементов следующего шага появится''' — при выполнении следующего шага монитор ожидает появления на странице определенного '''HTML'''-элемента. Укажите:
** Укажите '''CSS'''- или '''DOM'''-локатор, чтобы монитор распознал элемент, которого ему следует ожидать.
** Истекло время ожидания для определения местоположения элемента.
* Вы также можете указать:
** Текст, по которому выполняется проверка, находится в элементе.
** Другая вкладка или фрейм, где монитор должен найти элемент. Используйте синтаксис, например <code>window[0].frame[3]</code>. <code>window[0]</code> — это первая открытая вкладка, а <code>window[1]</code> представляет собой вторую. Также можно использовать <code>window[N].frames[X]</code>, где <code>X</code> — это номер элемента '''iframe''', отображаемого на странице во вкладке <code>N</code>. Фреймы также можно объединять в цепочку, где <code>window[N].frames[X].frames[Y]</code> означает, что элементы с заданными локаторами находятся внутри фрейма <code>Y</code>, который находится внутри фрейма <code>X</code> на вкладке <code>N</code>.
* '''Сетевая активность завершена''' — монитор ожидает завершения всей сетевой активности после выполнения шага. Это время ожидания по умолчанию, используемое для '''XHR'''-запросов и взаимодействий внутри одностраничных приложений. Эта опция недоступна для шагов типа '''Навигация'''.
* '''Начинается следующий шаг''' — монитор ожидает, пока не будет найден один из локаторов следующего шага. Это аналогично ситуации, когда появляется любой из элементов следующего шага, но автоматически используются локаторы следующего шага.

== Проверить содержимое ==
Проверка содержимого помогает убедиться, что монитор вашего браузера загружает ожидаемое содержимое страницы или элемент. Проверка выполняется с помощью правил проверки: выберите '''Добавить правило проверки содержимого''' в разделе '''Проверка содержимого''', чтобы определить правило проверки.

В случае clickpatch в браузере вы определяете проверки для каждого шага; для мониторов, содержащих один '''URL'''-адрес и включающих один шаг, вы определяете проверку для монитора в целом.

Проверка выполняется после выполнения всех перенаправлений, даже если самый первый ответ содержит '''HTML'''-контент.

Вы можете провести проверку на основе следующих критериев:

* Конкретный текст на веб-странице.
* Конкретный элемент, который содержит конкретный текст.
* Текст в '''DOM''' или любом ресурсе.

Если ваша проверка ищет элемент с текстом, вам нужно указать '''CSS'''-селекторы или '''DOM'''-локаторы для использования во время воспроизведения: выберите '''Тип локатора''', затем выберите '''DOM''' или '''CSS''' и укажите ссылку на локатор. При вставке строки локатора обязательно удалите все символы <code>></code>.

Вы можете добавлять и изменять порядок локаторов в любом порядке. Проверка выполняется в том порядке, в котором вы определили, пока не будет найден соответствующий локатор.

Вы можете настроить прохождение или сбой вашего монитора/шага на основе критериев проверки. Если критерии прохождения не выполнены (или критерии сбоя выполнены), монитор/шаг завершается ошибкой, и выполнение прерывается.

Вы можете добавлять и изменять порядок более чем одной проверки для шага/монитора. Проверка выполняется в том порядке, в котором вы определили; если какое-либо из правил не выполняется, монитор завершается ошибкой.

Если ваша проверка основана на видимом тексте или тексте в '''DOM''' или любом ресурсе, вам нужно указать текст (без учета регистра) для проверки. Заключите значения-заполнители в скобки, например, <code>{email}</code>. Если ваша проверка основана на наличии какого-то конкретного элемента (элемент с текстом), вы можете дополнительно проверить, содержит ли элемент конкретный текст. Переключитесь на '''Validate Regex''', если хотите указать текст как регулярное выражение.

Также вы можете указать монитору искать конкретный элемент в другой вкладке или фрейме при выполнении шага. Выберите '''Искать элемент в другой вкладке или фрейме''' и укажите вкладку/фрейм, используя синтаксис наподобие <code>window[0].frame[3]</code>.

<code>window[0]</code> — это первая открытая вкладка, а <code>window[1]</code> представляет собой вторую. Также можно использовать <code>window[N].frames[X]</code>, где <code>X</code> — это номер '''iframe''', отображаемого на странице во вкладке <code>N</code>. Фреймы также можно объединять в цепочку, где <code>window[N].frames[X].frames[Y]</code> означает, что элементы с заданными локаторами находятся внутри фрейма <code>Y</code>, который находится внутри фрейма <code>X</code> на вкладке <code>N</code>.

=== Примеры ===

* Пример 1 — Проверка содержимого на основе видимого текста.
* Пример 2 — Проверка содержимого на основе элемента с текстом.
* Пример 3 — Проверка содержимого на основе '''DOM''' или текста ресурса.

== Пороговые значения производительности ==
Переключите параметр '''Создать сообщение о проблеме и отправить оповещение о нарушениях пороговых значений производительности''', чтобы установить пороговое значение времени ожидания для этого конкретного шага.

Типы шагов clickpatch

2026-09-03T15:28:39Z

IKuznetsov: Новая страница: « = Типы шагов clickpatch = При записи clickpatch в браузере ваши взаимодействия с веб-приложением фиксируются в виде последовательности шагов. Существуют различные типы шагов для имитации взаимодействия и управления clickpatch, например, переход по URL-адресу, клик, вы...»

= Типы шагов clickpatch =
При записи clickpatch в браузере ваши взаимодействия с веб-приложением фиксируются в виде последовательности шагов. Существуют различные типы шагов для имитации взаимодействия и управления clickpatch, например, переход по URL-адресу, клик, выбор опции, ввод информации или фрагмент кода '''JavaScript'''. Помимо типа, шаги имеют различные свойства, такие как цель (состоящая из локаторов для идентификации веб-элементов на странице) и стратегия ожидания.

== Типы шагов ==
Для clickpatch в браузере доступны следующие типы шагов:

* Навигация
* Нажмите
* Кран
* Нажатие клавиши
* Выберите вариант
* JavaScript
* Печенье

== Навигация ==
Шаг «Навигация» имитирует ввод URL-адреса в адресную строку браузера и последующую загрузку страницы.

Для создания монитора браузера достаточно указать всего один шаг «Навигация» — он проверит доступность и производительность одной веб-страницы. Однако, если вы хотите, чтобы монитор выполнял сценарий тестирования, включающий пользовательский путь (например, открытие главной страницы в браузере, применение критериев поиска, выполнение поиска, выбор варианта из результатов поиска), расширьте монитор, добавив шаги вручную или записав clickpatch.

Для повышения безопасности синтетических мониторов Ключ-АСТРОМ блокирует отправку запросов мониторами на локальный хост (например, <code>localhost</code> или <code>127.0.0.1</code>).

В записанных clickpatch первый шаг автоматически создаётся как шаг «Навигация». Однако при добавлении шагов вручную или редактировании clickpatch можно добавить событие '''JavaScript''' в качестве первого шага монитора. Шагам «Навигация» может предшествовать только один или несколько шагов '''JavaScript'''. Clickpatch требует наличия как минимум одного шага «Навигация».

Переход на новую веб-страницу путём нажатия на ссылку на текущей веб-странице создаёт шаг «Клик» в профилях для настольных компьютеров (или шаг «Касание» на мобильных устройствах), а не шаг «Навигация».

(Необязательно) Переключите параметр '''Использовать HTTP-аутентификацию''', если веб-сайт, который вы хотите протестировать, требует ввода учётных данных.

Вы можете выбрать способ хранения учётных данных.

* '''Хранилище учётных данных''' — рекомендуемый вариант, поскольку он обеспечивает более высокий уровень безопасности. Выберите '''HTTP-аутентификацию''' или '''Kerberos''' в качестве метода аутентификации, а затем выберите ранее существующие учётные данные или добавьте новые. Чтобы добавить новые учётные данные, выберите '''Добавить учётные данные'''.
* '''Скрипт мониторинга''' — выберите '''HTTP-аутентификацию''' или '''Kerberos''' в качестве метода аутентификации, а затем укажите имя пользователя и пароль.

Если вы выбираете '''Kerberos''' в качестве метода аутентификации, укажите также имя области аутентификации и список разрешённых серверов аутентификации.

== Нажмите ==
В браузерных мониторах шаг «Клик» определяет, где выполнить щелчок мыши на странице. Он вставляется при нажатии на такой элемент, как ссылка, кнопка или поле.

Шаг «Клик» взаимодействует с конкретным элементом на веб-странице. См. информацию о локаторах ниже, чтобы определить, как найти элемент.

== Кран ==
В профилях мобильных устройств (включая планшеты, ноутбуки с сенсорным экраном и пользовательские устройства, указанные как мобильные) шаг «Касание» определяет, где на странице записать касание экрана устройства кончиком пальца. Например, «Касание» вставляется при нажатии на гиперссылку, кнопку или выборе поля.

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

''Мобильный курсор''

Шаг «Касание» взаимодействует с конкретным элементом на экране. См. информацию о локаторах ниже, чтобы определить, как найти элемент.

== Нажатие клавиши ==
Шаг «Нажатие клавиши» фиксирует строку, которую вы вводите в поле на веб-странице.

По умолчанию весь текст сохраняется как обычный текст. Однако для паролей, хранящихся в хранилище учётных данных, тип текста — '''Учётные данные'''.

Ключ-АСТРОМ хранит и управляет всеми учётными данными '''Синтетического мониторинга''' в хранилище учётных данных. Учётные данные контролируются доступом и могут быть доступны только владельцу или быть публичными.

Читайте ниже, чтобы узнать, как сохранить или задать пароль и как создать токен на шаге «Нажатие клавиши».

=== Кто может редактировать монитор с привязанными учётными данными? ===
Права на редактирование зависят от того, связан ли монитор с публичными или ограниченными учётными данными.

* Если монитор связан с публичными учётными данными, любой член вашей команды может включать/выключать, удалять или редактировать монитор.
* Если браузерный монитор (clickpatch или одиночный URL) связан с ограниченными учётными данными (доступны только владельцу или нескольким пользователям), любой пользователь может вносить изменения в определённые поля, даже если у него нет доступа к используемым учётным данным. Вы можете редактировать имя монитора, настройки эмуляции устройства, условия ожидания, частоту, местоположения, оповещения о сбоях, пороговые значения производительности, метрики, подключённые приложения, проверку и коды состояния '''HTTP''', которые следует игнорировать. И, конечно, вы можете изменить токен или учётные данные пользователя/пароля. Вы можете создать учётные данные в настройках монитора в режиме редактирования. Вам потребуется изменить все учётные данные в мониторе на те, к которым у вас есть доступ. Обратите внимание, что замена учётных данных другого пользователя на ваши необратима.

Элементы управления, которые нельзя редактировать — такие как URL-адрес, включение/выключение '''HTTP'''-аутентификации, добавление или удаление событий clickpatch, ввод данных в «Нажатие клавиши», а также расширенные настройки в параметрах монитора — отображаются серым цветом или выдают сообщение об ошибке при попытке сохранить изменения, как в режиме скрипта, так и в режиме пользовательского интерфейса.

Вы можете включать/выключать или удалять синтетический монитор, защищённый чужими учётными данными с доступом только для владельца.

Подробнее о разрешениях на учётные данные см. в разделе '''Хранилище учётных данных для синтетических мониторов'''.

Симуляция клавиши «Return» автоматически имитирует нажатие клавиши Return после ввода, например, для отправки поисковой строки или запуска входа в систему. При создании монитора в режиме пользовательского интерфейса это избавляет от необходимости настраивать шаг «Клик» после ввода данных в поле.

Симуляция событий blur (включена по умолчанию) определяет, имитируется ли шаг blur, который обычно происходит, когда текстовое поле теряет фокус.

Шаг «Нажатие клавиши» взаимодействует с конкретным элементом на экране, например с полем формы. См. информацию о локаторах ниже, чтобы определить, как найти элемент.

=== Сохранение или установка пароля на шаге «Нажатие клавиши» ===
На шаге «Нажатие клавиши» записанный пароль по умолчанию сохраняется как обычный текст, но вы можете сохранить его как учётные данные.

# Скопируйте записанный пароль.
# Выберите '''Тип учётных данных'''.
# Выберите '''Добавить учётные данные'''.
# Выберите '''Имя пользователя и пароль''' в качестве '''Типа учётных данных'''.
# Укажите '''Имя учётных данных'''.
# Укажите '''Имя пользователя''' и вставьте скопированный пароль в поле '''Пароль'''.
# Выберите '''Сохранить в хранилище'''.

Вы также можете:

* Использовать ранее созданные учётные данные из хранилища. Выберите их в списке '''Выбрать учётные данные'''. В этом списке отображаются только те учётные данные, к которым у вас есть доступ: публичные или созданные вами с доступом владельца.

* Добавить новые учётные данные как токен. Для этого выберите '''Токен''' в качестве '''Типа учётных данных''' при добавлении.

Обратите внимание, что у вас должно быть разрешение на доступ к хранилищу учётных данных, чтобы создавать учётные данные в браузерном мониторе таким образом. Вы всегда можете сохранить введённые учётные данные как часть записанного clickpatch.

=== Создание токена на шаге «Нажатие клавиши» ===
Вы можете использовать существующий токен, к которому у вас есть доступ, на шаге «Нажатие клавиши». Выберите '''Тип учётных данных''' и выберите имя нужных учётных данных ('''Выбрать учётные данные''').

Чтобы создать новый токен:

# Выберите '''Добавить учётные данные'''.
# Выберите '''Токен''' в качестве '''Типа учётных данных'''.
# Измените имя учётных данных по умолчанию.
# Укажите '''Значение токена'''.
# Выберите '''Сохранить в хранилище'''.

Учётные данные, созданные таким образом, автоматически получают права доступа только для владельца и могут использоваться только вами.

Обратите внимание, что у вас должно быть разрешение на доступ к хранилищу учётных данных, чтобы создавать учётные данные в браузерном мониторе таким образом.

== Выберите вариант ==
Шаг «Выберите вариант» описывает использование списков в clickpatch.

'''Индекс''' описывает позицию выбранного элемента сверху; первый элемент в списке всегда обозначается как 0. Поле '''Значение''' показывает текстовое значение выбранного элемента.

Выберите '''Добавить выбор''', чтобы добавить ещё один элемент для выбора в том же списке. При необходимости вы можете удалить выбранные варианты.

Шаг «Выберите вариант» взаимодействует с конкретным элементом на экране. См. информацию о локаторах ниже, чтобы определить, как найти элемент.

== JavaScript ==
Шаг '''JavaScript''' позволяет выполнять фрагменты кода '''JavaScript''' в рамках браузерных clickpatch.

С помощью шагов '''JavaScript''' можно создавать clickpatch для сценариев с динамическими частями, где может потребоваться реагировать на страницу, например:

* Потоки входа, включающие случайные контрольные вопросы
* Сложные селекторы дат
* Страницы с A/B-тестированием
* Процессы регистрации или заказа товара
* Пользовательские проверки

Выполнение '''JavaScript''' на страницах '''PDF''' не поддерживается.

Для страниц '''XML''' можно активировать поддержку, переключившись в режим скрипта и заполнив <code>experimentalProperties</code> в разделе конфигурации следующим образом. Значение свойства <code>enableXmlInjection</code> — это регулярное выражение для URL-адреса целевой XML-страницы.<pre>
"experimentalProperties": [{
"name": "enableXmlInjection",
"value": ".*.xml$"
}
]
</pre>Во время выполнения синтетического монитора целевая XML-страница отображается в '''HTML'''.

В поле '''Код''' определите свой фрагмент '''JavaScript'''.

При добавлении шагов вручную или редактировании clickpatch можно добавить шаг '''JavaScript''' в качестве первого шага монитора для таких сценариев, как получение учётных данных из хранилища учётных данных и установка переменной для использования в URL-адресе события «Навигация». Эта функция требует АктивныйШлюз версии 1.225+ и '''Chromium''' версии 88+ на частных синтетических площадках.

Шагам «Навигация» могут предшествовать только один или несколько шагов '''JavaScript'''; clickpatch требует наличия как минимум одного шага «Навигация».

=== API шагов JavaScript ===
Событие '''JavaScript''' предлагает базовый API для следующих операций.

==== Сохранение и извлечение значений между шагами монитора ====

* <code>api.setValue(key, value)</code> — устанавливает значение для ключа. Используйте отдельный экземпляр <code>api.setValue()</code> для каждой пары ключ-значение, которую хотите указать.
* <code>api.getValue(key)</code> — получает значение ключа, ранее установленное с помощью <code>api.setValue()</code>.
* <code>api.getValues()</code> — возвращает объект, содержащий пары ключ-значение, ранее установленные с помощью <code>api.setValue()</code>.

Переменные могут передаваться только в контексте одного выполнения браузерного clickpatch. Также необходимо убедиться, что при обращении к переменной данные, стоящие за ней, логически доступны монитору.

После установки глобальной переменной с помощью метода <code>api.setValue()</code> её значение можно использовать с соглашением <code>{variable_name}</code> с помощью <code>api.getValue()</code> или <code>api.getValues()</code>. Значение также можно применить в последующих полях конфигурации браузерного clickpatch, используя соглашение <code>{variable_name}</code>.

Имена переменных и ключей имеют ограничение в 100 символов. Значения глобальных переменных имеют ограничение в 5000 символов.

==== Отметка шагов как неудачных или завершённых ====

* <code>api.fail(message)</code> — помечает запрос как неудачный, указывая сообщение в качестве причины, и помечает выполнение монитора как неудачное.
* <code>api.finish()</code> — завершает шаг '''JavaScript''', чтобы был выполнен следующий шаг.
* <code>api.startAsyncSyntheticEvent()</code> — заставляет шаг '''JavaScript''' ожидать последующего вызова <code>api.finish()</code> или <code>api.fail()</code> для его завершения. Поскольку использование этого метода переопределяет условие ожидания, рекомендуется установить время ожидания на '''Нет'''.

==== Пропуск шагов clickpatch ====
Эти методы пропускают шаги после завершения текущего шага.

* <code>api.skipNextSyntheticEvent()</code> — пропускает выполнение следующего шага.
* <code>api.skipNextSyntheticEvents(n)</code> — пропускает выполнение следующих <code>n</code> последовательных шагов.
* <code>api.skipSyntheticEvent(eventIndex)</code> — пропускает выполнение шага с индексом <code>eventIndex</code>. Номера индексов событий начинаются с 1 и соответствуют номерам шагов, отображаемым в веб-интерфейсе.
* <code>api.skipSyntheticEvents(eventIndexes)</code> — пропускает выполнение нескольких шагов; массив <code>eventIndexes</code> указывает индексы шагов для пропуска, например, <code>api.skipSyntheticEvents([8, 9])</code>.

==== Базовое ведение журнала ====

* <code>api.info(message)</code> — регистрирует сообщение с уровнем журнала <code>info</code>.
* <code>api.warn(message)</code> — регистрирует сообщение с уровнем журнала <code>warning</code>.
* <code>api.error(message)</code> — регистрирует сообщение с уровнем журнала <code>error</code>.

==== Получение данных ====

* <code>api.getCredential(id, type)</code> — извлекает значение учётных данных по идентификатору учётных данных (<code>id</code>) и (<code>type</code>), который может быть <code>username</code>, <code>password</code> или <code>token</code>. Использование динамических идентификаторов, таких как переменные, не поддерживается. Список состоит только из тех учётных данных, к которым у вас есть доступ.

Требуется АктивныйШлюз версии 1.212+ для частных синтетических площадок.

В целях безопасности рекомендуется использовать только выделенные тестовые учётные данные для синтетических мониторов.

* <code>api.getContext().location</code>

** <code>api.getContext().location.name</code> — возвращает имя частного или общедоступного местоположения, из которого выполняется монитор. Это полезно при применении условной логики, например, для отображения локализованных страниц или использования разных учётных данных для входа в зависимости от местоположения.
** <code>api.getContext().location.cloudPlatform</code> — возвращает имя облачной платформы, на которой развёрнуто общедоступное синтетическое местоположение.

Во время локального воспроизведения свойства контекста не определены. Рекомендуется задать значение по умолчанию для покрытия этого сценария.

=== Примеры ===

* Пример 1 — Создание и установка динамического адреса электронной почты для мониторинга процесса регистрации.
* Пример 2 — Получение случайного имени/фамилии из API-эндпоинта и установка во время процесса регистрации.
* Пример 3 — Использование поставщика облачной платформы для различения местоположений с одинаковым именем.
* Пример 4 — Использование разных идентификаторов пользователей в зависимости от местоположения монитора.

== Печенье ==
Файлы cookie позволяют хранить информацию о состоянии браузера на стороне клиента, чтобы каждое выполнение монитора основывалось на одном и том же состоянии, и вы могли точно отслеживать базовый уровень производительности.

Вы можете устанавливать cookie в расширенных настройках в параметрах монитора в режиме редактирования. Эти cookie действительны на протяжении всего выполнения монитора. Если вы хотите установить cookie только для определённой части clickpatch, используйте событие «Cookie».

Укажите '''Имя''' и '''Значение''' cookie. Каждый cookie должен быть уникальным в списке.

Следующие символы не допускаются в значении cookie: <code>;,\"</code>. Укажите '''Домен''' cookie и, при необходимости, '''Путь''' к cookie. Сохраните cookie.

Выберите '''Добавить cookie''', чтобы определить дополнительные cookie.

== Редактировать указатели элементов ==
Этот элемент управления доступен в шагах «Клик», «Касание», «Нажатие клавиши» и «Выберите вариант».

Когда один из вышеперечисленных шагов в вашем clickpatch нацелен на конкретный элемент на веб-странице, вы можете просматривать и редактировать локаторы элементов в формате '''DOM''' или '''CSS'''. Локаторы помогают Ключ-АСТРОМ идентифицировать элемент во время воспроизведения. Мы можем захватывать несколько локаторов, чтобы убедиться, что элемент найден, даже если некоторые части кода страницы (например, имена или идентификаторы) изменятся. В большинстве случаев мы захватываем '''CSS'''-локаторы. Локаторы оцениваются последовательно; если первый локатор не найден, оценивается второй, и так далее, пока не будет найдено совпадение.

Выберите '''Добавить локатор''', затем выберите '''DOM''' или '''CSS''' и укажите ссылку на локатор. См. формат DOM-локатора ниже для получения дополнительной информации об указании DOM-локаторов.

Также можно указать монитору искать определённый элемент в другой вкладке или фрейме при выполнении шага. Выберите '''Искать элемент в другой вкладке или фрейме''' и укажите вкладку/фрейм, используя синтаксис наподобие <code>window[0].frame[3]</code>, где <code>window[0]</code> — первая открытая вкладка, а <code>window[1]</code> — вторая.

Это также может быть <code>window[N].frames[X]</code>, где <code>X</code> — номер iframe, отображаемого на странице во вкладке <code>N</code>.

Фреймы также могут быть цепочными, где <code>window[N].frames[X].frames[Y]</code> означает, что элементы с заданными локаторами находятся внутри фрейма <code>Y</code>, который находится внутри фрейма <code>X</code> на вкладке <code>N</code>.

== Формат DOM-локатора ==
Ключ-АСТРОМ версии 1.292+

Вы можете предпочесть настроить расширенные пользовательские DOM-локаторы для своих элементов. Правила ниже определяют поддерживаемый формат при использовании '''JavaScript''' в DOM-локаторах для доступа к элементам на веб-странице. Эти правила обусловлены переходом '''Ключ-АСТРОМ Synthetic Recorder''' (расширения для '''Google Chrome''') на Manifest Version 3 (MV3), последнюю версию платформы расширений Chrome.

Чтобы идентифицировать элемент, вы можете сделать одно из следующего.

Начните DOM-локатор с <code>document.</code>.<pre>
document.forms[0][1].options[0]
document.getElementById('adminusername')
document.querySelector("body > div.vf-body-container > div > div > section > flows").shadowRoot.querySelectorAll("#postalTown")[1]
</pre>Например, <code>document.getElementById('adminusername')</code> — это способ доступа к элементу по его идентификатору; <code>getElementById</code> — это метод <code>document</code>.

Используйте допустимое имя глобальной переменной '''JavaScript''' в начале DOM-локатора для доступа к элементу напрямую по его идентификатору. Имя переменной должно содержать ссылку на элемент с соответствующим идентификатором. Например, для элемента <code><div id="EmailAddress"></div></code> можно указать следующий DOM-локатор.<pre>
EmailAddress
</pre>Выражения '''XPath''' поддерживаются.

Ваш DOM-локатор, начинающийся с <code>document.</code>, может содержать выражение '''XPath''' в параметре <code>xpathExpression</code> метода <code>evaluate()</code>. В примере ниже выражение '''XPath''' — <code>'//form[@id=\'ctl00\']/div[4]/div[3]/span'</code>.<pre>
document.evaluate('//form[@id=\'ctl00\']/div[4]/div[3]/span', document, null, XPathResult.ANY_TYPE, null).iterateNext()
</pre>DOM-локатор должен представлять собой цепочку (последовательность) вызовов методов, свойств или индексных сигнатур, как показано в примерах ниже.<pre>
document.method().method1()
document.method().prop['2565']
document.method( 11 , 'erert','123')
document.getElementById ( 'deviceList' ) . querySelectorAll ( ' a ' ) [ 0 ]
</pre>Аргументами вызова метода могут быть любые из следующих значений; см. примеры ниже.

* Строки в двойных или одинарных кавычках
* Числа
* <code>null</code>
* <code>undefined</code>
* <code>document</code>
* <code>XPathResult.*</code>
<pre>
document.method ( " str1 " )
document.method ( ' str2 ' , null )
document.method ( undefined , document )
document.method ( XPathResult.ANY_TYPE )
</pre>Вычисления '''JavaScript''' внутри DOM-локаторов не поддерживаются.<pre>
// Не поддерживается
document.forms [ 1 + 2 ]
</pre>Глобальные переменные '''JavaScript''' не поддерживаются внутри DOM-локаторов.<pre>
// Не поддерживается, если someVar — глобальная переменная
document.querySelector ( someVar )
</pre>

Запись clickpatch в браузере

2026-09-03T15:26:53Z

IKuznetsov: Новая страница: « = Запись clickpatch в браузере = При желании вы можете записать последовательность кликов или добавить шаги вручную: * Имитируйте поведение пользователя. * Отслеживайте поведение ваших ресурсов, когда пользователь выполняет определённые действия — наприм...»

= Запись clickpatch в браузере =
При желании вы можете записать последовательность кликов или добавить шаги вручную:

* Имитируйте поведение пользователя.
* Отслеживайте поведение ваших ресурсов, когда пользователь выполняет определённые действия — например, открывает главную страницу в браузере, задаёт критерии поиска, выполняет поиск и выбирает вариант из результатов поиска.

Записать clickpatch можно только в браузере.

== Установите расширение Ключ-АСТРОМ Synthetic Recorder ==
Если у вас ещё не установлено расширение '''Ключ-АСТРОМ Synthetic Recorder''' для '''Chrome''', вы увидите кнопку '''Установить Ключ-АСТРОМ Synthetic Recorder'''. Выберите её, чтобы установить расширение.

== Разрешите использование расширения в режиме инкогнито ==
После установки расширения разрешите его использование в режиме инкогнито.

# Вставьте текст <code>chrome://extensions/</code> в адресную строку '''Chrome''' и нажмите '''Enter'''.
# На вкладке '''Ключ-АСТРОМ Synthetic Recorder''' выберите '''Подробности'''.
# Включите параметр '''Разрешить в режиме инкогнито'''.

== Запишите clickpatch в браузере ==

# Чтобы начать запись, выберите пункт '''Записать clickpatch''' внизу страницы.
# Проследуйте за пользовательским путём шаг за шагом. Например, задайте критерии поиска, выполните поиск и выберите нужный вариант из результатов поиска.
# Закройте окно браузера после завершения пользовательского процесса.

Вы можете выбрать пункт '''Запустить clickpatch''', чтобы проверить, как монитор отслеживает указанный вами выше сценарий взаимодействия с пользователем.

== Добавить шаги вручную ==
Вы можете добавить все или отдельные этапы пользовательского пути вручную.

# Выберите '''Добавить шаг вручную'''.
# Выберите тип шага, например, '''Нажмите'''.
# На панели справа настройте как минимум основные параметры.

== Редактировать шаги ==
В списке шагов выберите шаг, который хотите отредактировать. Доступные для редактирования параметры шага можно найти на панели справа.

=== Основные настройки ===
Основные настройки включают в себя:

* Название этапа.
* '''URL''' (для типа шага '''Навигация''').
* Тип локатора и локатор (для типов шагов '''Клик''', '''Касание''', '''Нажатия клавиш''' и '''Выбрать''').
* Индекс (для шага выбора варианта).
* Имя, значение, домен и, при необходимости, путь (для типа шага '''Cookie''').
* Фрагмент кода '''JavaScript''' в поле '''Код''' (для типа шага '''JavaScript''').

Подробную информацию о типах шагов см. в разделе '''Типы шагов clickpatch'''.

Кроме того, при необходимости вы можете указать монитору искать определённый элемент в другой вкладке или фрейме при выполнении этого шага. Укажите вкладку/фрейм, используя синтаксис, например <code>window[0].frame[3]</code>, где <code>window[0]</code> — первая открытая вкладка, а <code>window[1]</code> — вторая.

Это также может быть <code>window[N].frames[X]</code> — число <code>X</code>, '''iframe''', отображаемое на странице во вкладке <code>N</code>.

Фреймы также могут быть связаны между собой, где <code>window[N].frames[X].frames[Y]</code> означает, что элементы с заданными локаторами находятся внутри фрейма <code>Y</code>, который находится внутри фрейма <code>X</code> на вкладке <code>N</code>.

=== Дополнительные настройки ===
Кроме того, вы можете:

* Настроить время ожидания между шагами.
* Настроить правила проверки контента и пороговые значения производительности.

== Удаление шагов, замена шагов, повторная запись clickpatch после определённого шага ==
В списке шагов вы можете удалять и заменять шаги, а также перезаписывать clickpatch после определённого шага.

=== Удалите и поменяйте местами шаги ===

* Чтобы удалить шаг, выберите ('''Удалить''') рядом с шагом.
* Чтобы поменять местами шаг, выделите его рядом с шагом, который хотите поменять местами, а затем перетащите шаг вверх или вниз.

=== Повторная запись clickpatch после определённого шага ===
Возможно, вам потребуется перезаписать clickpatch после определённого шага, а не перезаписывать весь clickpatch целиком.

# Выберите ('''Повторить''') рядом с шагом, после которого вы хотите повторно записать clickpatch.
# Дождитесь завершения воспроизведения в браузере.
# Проследуйте за дальнейшим пользовательским путём шаг за шагом.
# Закройте окно браузера после завершения пользовательского процесса.

Создание и настройка браузерного монитора

2026-09-03T15:22:00Z

IKuznetsov: Новая страница: « = Создание и настройка монитора браузера = Вы можете создавать синтетические браузерные мониторы для проверки доступности ваших веб-сайтов. Браузерные мониторы могут запускаться из наших глобальных общедоступных или частных синтетических сред. Пер...»

= Создание и настройка монитора браузера =
Вы можете создавать синтетические браузерные мониторы для проверки доступности ваших веб-сайтов. Браузерные мониторы могут запускаться из наших глобальных общедоступных или частных синтетических сред.

Перейдите в раздел '''Синтетический мониторинг''' > '''Новый монитор''' > '''Браузер'''. Настройки конфигурации разделены на следующие разделы:

* Общий
* Шаги
* Частота и местоположение
* Сбои и проблемы с производительностью
* Расширенные настройки
* Краткое содержание

Пройдите по всем разделам по очереди и внесите все необходимые изменения в каждом из них.

== Общий ==
Для начала настройте общие параметры.

'''Назовите этот монитор''' — введите имя (до 500 символов) для синтетического монитора. Это имя должно в целом описывать все запросы, обрабатываемые этим браузерным монитором.

(Необязательно) '''Новый интерфейс мониторинга браузера''' — активируйте или деактивируйте мониторы браузера в последней версии Ключ-АСТРОМ для этого монитора. Подробности см. в разделе '''Активация или деактивация мониторов браузера в последней версии Ключ-АСТРОМ для нового монитора'''.

(Необязательно) Выберите '''Добавить тег''' в разделе '''Теги''', чтобы вручную применить теги к монитору.

(Необязательно) Выберите '''Добавить тег''' в разделе '''Основные теги Хранилища данных''', чтобы вручную применить основные теги Хранилища данных к монитору. Подробнее см. раздел '''Основные теги Хранилища данных для синтетических материалов'''.

Выберите '''Назначить интерфейсы''', чтобы назначить монитор для фронтенд-приложения. Вы можете назначить монитор нескольким фронтенд-приложениям, и у одного фронтенд-приложения может быть несколько назначенных мониторов. Это позволяет отслеживать доступность и производительность фронтенд-приложения. Обнаруженные проблемы затем автоматически связываются с вашим фронтенд-приложением. Если выполнение монитора завершается с ошибкой из-за проблем с фронтенд-приложением, сообщаемый уровень доступности фронтенд-приложения снижается в течение определенного периода времени.

Монитор браузера может быть автоматически назначен приложению, отображаемому на экране, если URL-адрес, проверенный монитором, соответствует шаблону, определенному в '''Ключевых показателях опыта'''.

== Расширенные настройки ==
(Необязательно) Укажите профиль устройства. Вы можете выбрать один из следующих вариантов:

* Существующие устройства с предустановленными характеристиками. Вы можете изменить только ориентацию — сделать её альбомной или портретной.
* Пользовательское устройство — добавьте новое устройство с пользовательскими характеристиками, такими как ориентация (альбомная или портретная), высота экрана и ширина экрана, и укажите пользовательское имя нового устройства.

(Необязательно) Укажите профиль полосы пропускания. Вы можете выбрать один из следующих вариантов:

* Существующий профиль с готовыми к использованию предустановками.
* Пользовательский профиль — добавьте новый профиль полосы пропускания с настраиваемыми характеристиками, такими как скорость загрузки, скорость выгрузки и задержка, и укажите пользовательское имя для нового профиля.

(Необязательно) Укажите '''User agent''', чтобы настроить HTTP-заголовок User agent, отправляемый браузером во время выполнения мониторинга. При выборе профиля устройства из списка существующих устройств Ключ-АСТРОМ автоматически заполняет поле User agent.

В качестве пользовательского агента Ключ-АСТРОМ по умолчанию во время записи и локального воспроизведения используется формат <code>Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/{version} Safari/537.36 RuxitSynthetic/1.0 v0 t0 cfeatureHash=7efgijmoqtvx caes=1 ccux=1 sia=1 smf=1</code>, где:

* <code>{version}</code> — текущая версия браузера, используемая для записи.
* <code>v0</code> и <code>t0</code> идентифицируют трафик синтетического мониторинга.
* <code>sia=1</code> указывает на более быструю инъекцию JavaScript через '''Мониторинг реального пользователя''' (значение может быть <code>1</code> или <code>0</code>).
* <code>smf=1</code> указывает на мониторинг страниц во фреймах (если в расширенных настройках включена функция '''Захват метрик производительности для страниц, загружаемых во фреймах'''; значение равно <code>0</code>, если не включено).
* <code>cfeatureHash=<value></code> — появляется при включении пользовательских настроек JavaScript в '''Мониторинге реального пользователя''' в расширенных настройках.

Строка пользовательского агента по умолчанию для запуска монитора браузера из общедоступных или частных синтетических местоположений имеет вид <code>Mozilla/5.0 (X11; Ubuntu; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/{version} Safari/537.36 RuxitSynthetic/1.0 v{id} t{id} ath{id} alt{id} cfeatureHash=7efgijmoqtvx caes=1 ccux=1 sia=1 smf=1</code>, где:

* <code>{id}</code> — длинные идентификаторы, используемые Ключ-АСТРОМ для идентификации выполнения монитора.
* Остальные параметры описаны выше.

Обратите внимание, что даже если определён пользовательский агент, Ключ-АСТРОМ всегда автоматически добавляет к нему <code>RuxitSynthetic/1.0 v{id} t{id} ath{id} alt{id}</code>, <code>sia</code>, <code>smf</code> и, если применимо, <code>cfeaturehash</code>, а также любые пары ключ-значение, начинающиеся с <code>c</code>, чтобы гарантировать возможность идентификации трафика синтетического мониторинга.

== Шаги ==
Определите шаги. При создании монитора браузера у вас есть два варианта:

* Настройте монитор для проверки доступности и производительности одной веб-страницы. Для этого выполните шаги 1–7 и шаг 9 в приведенном ниже руководстве (шаг 8 пропустите).
* Настройте монитор для проведения тестового сценария, включающего пользовательский путь — например, когда пользователь открывает главную страницу в браузере, применяет критерии поиска, выполняет поиск и выбирает вариант из результатов поиска. Для этого выполните все шаги, перечисленные ниже (1–9).

# '''Имя''' — укажите название шага.
# '''URL''' — укажите URL веб-страницы, доступность и производительность которой вы хотите проверить.
# (Необязательно) Укажите контекстные параметры. Вы можете указать:
#* Файлы cookie, которые будут отправляться вместе с запросами, выполняемыми монитором.
#* Заголовки запроса, которые будут устанавливаться для всех запросов, выполняемых монитором.
#* Запросы с определенными шаблонами будут заблокированы во время выполнения монитора.
# Хотя вы можете указать файлы cookie, заголовки и запросы с определенными шаблонами позже в расширенных настройках, в некоторых случаях может быть целесообразно сделать это здесь, чтобы обеспечить бесперебойную запись пути клика.
# (Необязательно) Включите параметр '''Использовать HTTP-аутентификацию''', если веб-сайт, который вы хотите протестировать, защищен '''HTTP'''-аутентификацией (а не аутентификацией через веб-формы).
# Мы поддерживаем базовую '''HTTP'''-аутентификацию и аутентификацию '''Kerberos'''. Если вы выбираете '''Kerberos''' в качестве метода аутентификации, укажите также имя области и список разрешенных серверов аутентификации. Более подробную информацию о методах аутентификации см. в разделе '''Поддерживаемые методы аутентификации''' в '''Синтетическом мониторинге'''.
# Вы можете выбрать способ хранения учетных данных.
#* '''Хранилище учетных данных''' — рекомендуемый вариант, поскольку он обеспечивает более высокий уровень безопасности. Выберите ранее существовавшие учетные данные или добавьте новые.
#* Вы можете добавлять новые учетные данные как в синтетическом режиме ('''Добавить учетные данные'''), так и в классическом синтетическом режиме ('''Хранилище учетных данных (классическое)''').
#* '''Скрипт мониторинга''' — укажите имя пользователя и пароль.
# (Необязательно) Выберите условие, чтобы считать этот шаг выполненным, и задайте время ожидания между шагами.
# (Необязательно) В разделе '''Проверка содержимого''' настройте правила проверки содержимого.
# (Необязательно) Установите пороговое значение производительности для загрузки страницы, указанной в URL-адресе.
# Запишите путь клика или добавьте шаги вручную. Используйте эту функцию, если хотите, чтобы монитор выполнил тестовый сценарий, включающий пользовательский путь — например, когда пользователь открывает главную страницу в браузере, применяет критерии поиска, выполняет поиск и выбирает вариант из результатов поиска. Подробнее см. раздел '''Запись пути клика в браузере'''.
# Выберите '''Продолжить''', чтобы перейти к настройке монитора.

== Частота и местоположение ==
График мониторинга зависит от двух факторов: частоты запуска монитора браузера и количества мест, откуда он запускается.

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

Частота и количество местоположений определяют количество запусков монитора в час. Например, запуск монитора из 3 местоположений каждые 15 минут приводит к 12 запускам в час (4 раза в час из каждого из 3 местоположений). Запуски монитора равномерно распределены в пределах выбранного интервала. То есть, для монитора, запускаемого из 3 местоположений каждые 15 минут, запуски происходят с интервалом в 5 минут.

Вы можете выбрать частоту запуска: каждые 5, 10, 15 или 30 минут; или каждые 1, 2 или 4 часа. Вы также можете настроить монитор на запуск только по запросу. Вы можете выбрать несколько глобальных местоположений, откуда будет запускаться ваш браузерный монитор.

Обратите внимание, что для всех общедоступных синтетических местоположений установлено всемирное координированное время (UTC). Если вашему скрипту мониторинга требуется местное время или часовой пояс, вы можете использовать метод <code>api.getContext()</code> и системные часы для реализации условной логики.

== Сбои и проблемы с производительностью ==
Вы можете установить глобальные и локальные пороговые значения для обработки сбоев и производительности, рассчитанные на основе суммы всех запросов.

'''Сгенерируйте сообщение о проблеме и отправьте оповещение, когда этот монитор станет недоступен во всех настроенных местах (глобальный сбой).'''

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

По умолчанию глобальная проблема сбоя возникает, когда все точки выходят из строя одновременно. Однако вы можете указать количество последовательных отказов (от 1 до 5), необходимых для возникновения глобальной проблемы сбоя, то есть, сколько раз все точки должны выйти из строя подряд, чтобы возникла глобальная проблема сбоя.

'''Сгенерируйте сообщение о проблеме и отправьте оповещение, если этот монитор недоступен в течение одного или нескольких последовательных запусков в любом месте. Генерация сообщений о локальных сбоях доступна только при наличии как минимум двух назначенных местоположений.'''

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

Автоматическая повторная попытка при ошибке включена по умолчанию (при необходимости её можно отключить), это означает, что при неудачных запусках монитора выполняется повторная попытка один раз, чтобы избежать ложных срабатываний, и учитывается только второй результат. Если эта функция отключена, мы сразу переходим к первому результату.

Для пороговых значений производительности можно включить следующие параметры:

'''Сгенерируйте сообщение о проблеме и отправьте оповещение о нарушениях пороговых значений производительности.'''

Этот параметр позволяет установить пороговое значение для суммы всех запросов (в секундах). Если пороговое значение превысит указанное вами время, вы получите уведомление.

Кроме того, вы можете установить пороговое значение производительности для отдельных этапов.

== Расширенные настройки ==
Эта вкладка содержит элементы управления для:

* Клиентские сертификаты
* Печенье
* HTTP-заголовки
* Блокировка запроса
* Игнорирование кодов состояния
* Пользовательские настройки JavaScript для '''Мониторинга реального пользователя'''
* Обход правил CSP
* Сбор метрик для страниц, загруженных во фреймы.

=== Используйте клиентские сертификаты ===
Ключ-АСТРОМ версии 1.272+

АктивныйШлюз версии 1.271+

Аутентификация с помощью клиентских сертификатов поддерживается для браузерных мониторов, запускаемых из:

* Любое общественное место
* Частные местоположения на базе '''Linux'''
* Контейнеризированные частные местоположения на базе '''Linux'''

Перед тем как записывать путь клика на веб-сайте, требующем аутентификации по сертификату, убедитесь, что в '''Chrome''' установлен необходимый сертификат. Затем, при переходе на веб-сайт в окне записи, встроенное диалоговое окно браузера просто выберет правильный сертификат.

Если в цепочке есть хотя бы один просроченный сертификат, вся цепочка может быть отклонена. Это приводит к сбоям при выполнении мониторинга. Результаты могут отличаться при использовании одной и той же цепочки сертификатов с '''HTTP'''-монитором или при выполнении команды <code>curl</code> вручную с хоста.

После записи пути клика необходимо указать сертификат, который будет использоваться для выполнения программы мониторинга браузера.

# Выберите '''Добавить сертификат'''.
# Введите домен, для которого действителен сертификат.
# Выберите учетные данные из отображаемого списка учетных данных сертификата. В качестве альтернативы выберите '''Создать новые учетные данные''', чтобы загрузить и использовать новый клиентский сертификат. Любые созданные вами учетные данные сертификата автоматически назначаются только владельцу и сохраняются в хранилище учетных данных.
# Вы можете указать и загрузить файлы сертификатов в форматах '''PFX''', '''P12''' или '''PEM'''.

=== Установить файлы cookie ===
Файлы cookie позволяют хранить информацию о состоянии браузера на стороне клиента, благодаря чему каждое выполнение монитора основывается на одном и том же состоянии, и вы можете точно отслеживать базовый уровень производительности.

Файлы cookie, установленные в расширенных настройках, действительны на протяжении всего выполнения монитора. Если вы хотите установить файлы cookie только для определенной части пути клика, используйте шаг '''Файлы cookie'''.

# Выберите '''Добавить cookie''', укажите имя и значение cookie. Каждый cookie в списке должен быть уникальным.
# В значении cookie-файла не допускаются следующие символы: <code>;,\"</code>. Укажите домен cookie-файла и, при необходимости, путь к cookie-файлу.

=== Добавить дополнительные HTTP-заголовки ===
Монитор создается с использованием минимального набора заголовков, необходимых для протокола.

# Выберите '''Добавить заголовок'''.
# Введите имя и значение заголовка.
# Вы можете указать несколько '''HTTP'''-заголовков. Они будут установлены для всех запросов, отправляемых монитором.
# Если вы хотите устанавливать заголовки только для определенных запросов, выберите '''Применять заголовки только к запросам, соответствующим шаблону''', а затем определите шаблон. После этого заголовок будет устанавливаться только для запросов, соответствующих определенному вами шаблону.

=== Блокировка конкретных запросов ===
Вы можете заблокировать один или несколько запросов, указав полные URL-адреса или шаблоны соответствия. Длина URL-адреса или строки регулярного выражения не должна превышать 90 символов, и регистр символов не имеет значения.

Блокировка запросов позволяет анализировать, как эти запросы влияют на производительность вашего приложения, и соответствующим образом оптимизировать его.

# Выберите '''Добавить шаблон''', а затем укажите полный URL-адрес.
# Вы также можете определить шаблоны, например, <code>http:*://*/*.png</code> для <code>https*://*/*.png</code> — блокировки всех запросов к изображениям в формате '''PNG'''.
# Соответствующие запросы блокируются на протяжении всего выполнения монитора и не зависят от событий.

=== Игнорировать конкретные коды состояния ===
Это позволяет исключить возможность возникновения сбоев/ошибок доступности из-за кодов состояния '''HTTP''' 400–599, если они встречаются в основном запросе документа. Обычно это базовая страница в действии загрузки. Если этот параметр включен, и на базовой странице действия загрузки возникают ошибки '''HTTP''' 400–599, сбой доступности не происходит.

Вы можете указать точный код состояния, диапазон или маску класса состояния. Используйте запятые для разделения нескольких значений; используйте знак минус (<code>-</code>) без пробелов для обозначения диапазона, например, <code>404, 405-410, 5xx</code>. Вы можете применять правило только к запросам документов, которые соответствуют определенному регулярному выражению ('''Применять только к запросам документов, соответствующим этому регулярному выражению''').

* Этот параметр не применяется к '''XHR'''-запросам или запросам документов во фреймах; мониторы браузера не выдают ошибку при сбое '''XHR'''-запроса или запроса документа во фрейме.
* Этот параметр применяется к будущим выполнениям, то есть к выполнениям, которые произойдут после включения этого параметра.

=== Пользовательские настройки JavaScript для RUM ===
Функции захвата запросов '''XmlHttpRequest (XHR)''' и захвата запросов '''fetch()''' включены по умолчанию. Вы можете их отключить.

=== Другой ===

* '''Обход политики безопасности контента (CSP) отслеживаемой страницы''' — если у вас настроена политика безопасности контента, она, вероятно, предотвратит отправку браузером данных мониторинга в кластер Ключ-АСТРОМ. В качестве первого и предпочтительного способа заставить '''Chrome''' обходить '''CSP''' любых отслеживаемых страниц в вашем браузере с одним URL-адресом или в пути клика браузера, включите эту опцию. Если по какой-либо причине вы не можете использовать эту опцию, обратитесь к расширенным решениям по обходу '''CSP''' в статье сообщества Ключ-АСТРОМ «Базовые мониторы: проблемы с политикой безопасности контента».
* '''Собирайте метрики производительности для страниц, загружаемых во фреймах''' — включите эту опцию, чтобы начать сбор данных о производительности для страниц в '''iframe''' или '''frameset'''.

== Краткое содержание ==
Ознакомьтесь с кратким обзором всех шагов и предполагаемым ежемесячным количеством действий. Если все в порядке и никаких дополнительных настроек не требуется, сохраните настроенный монитор.

Результаты работы браузерных мониторов

2026-09-03T15:19:29Z

IKuznetsov: Новая страница: « = Результаты работы браузерных мониторов = Система мониторинга браузера предоставляет следующие отчёты: * Панель предварительного просмотра отображает результаты выполнения монитора, проблемы, ошибки и свойства монитора. Она предоставляет информац...»

= Результаты работы браузерных мониторов =
Система мониторинга браузера предоставляет следующие отчёты:

* Панель предварительного просмотра отображает результаты выполнения монитора, проблемы, ошибки и свойства монитора. Она предоставляет информацию, которую можно быстро просмотреть, с удобными ссылками для перехода к подробностям проблемы и редактирования настроек монитора.
* Страница с результатами отчёта отображает более подробную информацию, включая визуализацию результатов, такую как диаграммы и таблицы, показывающие показатели доступности и производительности монитора за выбранный период времени.
* Анализ выполнений — позволяет детально анализировать выполнение отдельных мониторов.

Для отображения результатов мониторинга браузера:

# Перейдите в раздел '''Синтетический мониторинг'''.
# (Необязательно) Чтобы отфильтровать таблицу по мониторам браузеров, выберите '''Браузер''' в разделе '''Параметры фильтра''' слева.
# Из списка мониторов браузера выберите тот, который хотите просмотреть. Справа отобразится панель предварительного просмотра.
# Чтобы перейти на страницу с подробной информацией, выберите '''Просмотреть подробности''' в правом верхнем углу панели предварительного просмотра.

== Визуализация метрик ==
На верхней панели отображается общая доступность и производительность монитора за выбранный период времени.

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

Под панелью фильтров вы увидите плитки с важной информацией:

* '''Сбой/Доступен/Нет данных''' — статус доступности монитора на момент последнего выполненного теста.
* '''Активные вопросы''' — количество вопросов, которые наблюдаются в данный момент.
* '''Затронутые населённые пункты''' — количество мест, где произошли сбои в течение определённого периода времени.
* '''Доступность''' — показатель доступности мониторов в процентах за определённый период времени.
* '''Общее время простоя''' — суммарное время простоя для всех объектов за определённый период времени.
* '''Продолжительность''' — среднее время ответа для всех местоположений за определённый период времени.

В правом верхнем углу страницы вы можете получить доступ к параметрам '''Анализ выполнений''', '''Выполнение по запросу''' и другим настройкам монитора браузера:

* '''Редактировать'''
* '''Дополнительные параметры''' ('''Отключить''' и '''Удалить''')

== Доступность ==
На вкладке '''Доступность''' отображается доступность монитора за выбранный период времени, как в агрегированном виде для всех местоположений, так и для каждого местоположения отдельно. Она содержит информацию обо всех проблемах доступности, связанных с данным монитором, окнах технического обслуживания и незавершённых выполнениях. Проблемы отображаются в виде полосок на диаграмме доступности. Они содержат подробную информацию о проблеме и отмечают период, когда она возникла.

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

Монитор может быть недоступен в одном или во всех местах. В течение определённого периода времени может произойти несколько простоев. Их продолжительность суммируется для расчёта общей продолжительности простоя. Перекрывающиеся простои не учитываются.

Подробную информацию о том, как рассчитывается доступность, см. в разделе '''Доступность в синтетических расчётах'''.

Подробную информацию о том, как рассчитывается общее время простоя, см. в разделе '''Общее время простоя в синтетических расчётах'''.

=== Диаграмма уведомлений о доступности ===
Кроме того, на карточке '''Доступность''' поверх диаграммы доступности отображаются уведомления. В уведомлениях содержится информация об окне технического обслуживания, сбоях и невыполненных или незавершённых тестах. Уведомление отображается в виде полосы над временным интервалом, когда было применено окно технического обслуживания, произошёл сбой или некоторые тесты не были выполнены или завершены. Наведите курсор на полосу, чтобы увидеть подробности:

* '''Сбой в работе локального монитора браузера''' — сбой произошёл в одном или нескольких местах, из которых монитор выполнял тесты.
* '''Сбой в работе глобального монитора браузера''' — сбой произошёл во всех местах, из которых монитор выполнял тесты.

=== Локальное и глобальное отключение — посмотреть подробности проблемы ===
Чтобы ознакомиться с подробностями проблемы:

# Выберите полосу, чтобы закрепить всплывающую подсказку о локальном сбое монитора браузера или о глобальном сбое монитора браузера.
# Наведите курсор на всплывающую подсказку.
# Выберите '''Просмотреть подробности проблемы'''.
# Выберите один из доступных вариантов:
#* Чтобы просмотреть подробности проблемы в последней версии Ключ-АСТРОМ, обратитесь к соответствующему разделу.
#* Чтобы просмотреть подробности проблемы в Ключ-АСТРОМ Classic, воспользуйтесь функцией '''Problems Classic'''.

=== Период технического обслуживания ===
В течение указанного периода времени проводилось техническое обслуживание.

Чтобы увидеть окно технического обслуживания:

# Выберите полосу, чтобы закрепить всплывающую подсказку окна '''Обслуживание'''.
# Наведите курсор на всплывающую подсказку окна '''Обслуживание'''.
# Выберите '''Просмотр настроек окна обслуживания'''.
# Выберите '''Настройки''' > '''Классические'''.

Если в окне обслуживания включена опция '''Отключить выполнение синтетического мониторинга''', запланированные автоматические тесты отключаются на период обслуживания, поэтому результаты тестов за этот период отсутствуют. Отключаются только тесты по запросу.

Если в окне технического обслуживания отключена опция '''Отключить выполнение синтетического монитора''', тесты выполняются в течение периода технического обслуживания, но из-за технического обслуживания результаты тестов могут отличаться от результатов, наблюдаемых в нормальных условиях.

=== Тесты не выполнены или не завершены ===
Если какие-либо тесты не были выполнены или завершены из-за неправильных настроек монитора или проблем на стороне Ключ-АСТРОМ, вы можете увидеть причину этого:

* '''Результата нет''' — выполнение началось, но результаты не были получены. Обратитесь в службу поддержки Ключ-АСТРОМ.
* '''Отсутствует возможность''' — вы пытаетесь запустить мониторы, которые не поддерживаются данным местоположением (например, мониторы '''NAM ICMP''' — из местоположения с неактивным '''ICMP''').
* '''Операция отменена, а не выполнена''' — вероятная причина: перегрузка частного хранилища. Проверьте показатели загрузки. Если с показателями проблем нет, обратитесь в службу поддержки Ключ-АСТРОМ.

== Производительность ==
На карте '''Производительность''' отображается:

* Средняя продолжительность каждого этапа по всем локациям (вкладка '''Производительность этапов''').
* Общая продолжительность всех этапов для каждого местоположения (разделено по местоположениям).

Это помогает выявить замедления или региональные проблемы с производительностью.

=== Проблемы отображаются в разделе «Производительность» ===

* Красная полоса над диаграммой указывает на сохраняющуюся проблему.
* Серая полоса над диаграммой указывает на закрытую проблему.

В этом разделе отмечаются только проблемы с производительностью.

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

Чтобы просмотреть подробности проблемы:

# Наведите курсор на панель с описанием проблемы, чтобы увидеть подробную информацию о текущей/закрытой проблеме в виде всплывающей подсказки.
# Выберите панель с описанием проблемы и наведите курсор на всплывающую подсказку, чтобы отобразить дополнительные параметры.
# Выберите '''Просмотреть подробности проблемы''', чтобы открыть подробную информацию о проблеме в разделе '''Проблемы''' (Приложение для решения проблем — новое).

== Проблемы ==
В карточке '''Проблемы''' отображаются проблемы с производительностью (нарушение порогового значения) и доступностью (локальный или глобальный сбой).

Существует три основных типа проблем, связанных с мониторингом браузера:

* Глобальный сбой (доступность).
* Местное отключение (доступность).
* Нарушение порогового значения производительности (проблема с производительностью для суммы всех шагов или отдельных шагов).

Проблемы с производительностью могут быть вызваны сочетанием нарушений пороговых значений на уровне монитора, а также на уровне отдельных шагов.

В разделе '''Проблемы''' отображаются все проблемы за выбранный период времени, как открытые, так и закрытые. Кроме того, вы можете:

* Подробности проблемы представлены в виде таблицы с указанием даты начала и продолжительности.
* Разверните каждую проблему, чтобы увидеть затронутые объекты и профили оповещений.

Содержимое списка проблем, а также сопутствующих событий, позволяет получить полное представление о количестве и масштабе неполадок вашего монитора.

== Синтетические этапы и действия ==
На вкладке '''Синтетические шаги и действия''' отображается подробная информация о каждом шаге в браузере, который настроен на выполнение монитором. Это может быть, например, загрузка страницы или щелчок по кнопке или другому элементу управления. Для каждого шага можно увидеть такие подробности, как:

* Тип действия — например, '''клик'''.
* Средняя продолжительность — среднее время ответа за определённый период времени, например, за последний час.
* Скриншот — снимок экрана, сделанный во время выполнения этого шага.

Выберите значок развёртывания для шага, чтобы увидеть время отклика отдельных выполнений за определённый период времени (например, за последний час). Это позволяет оценить общую производительность шага. Значок развёртывания недоступен и не может быть выбран, если для шага отсутствуют данные о производительности.

== События ==
На вкладке '''События''' отображаются все события, составляющие проблемы. События как для активных, так и для решённых проблем отображаются в списке и на временной шкале.

Наведите курсор на временной интервал на временной шкале событий, чтобы увидеть тип и количество событий, сгенерированных в этом интервале. Выберите временной интервал, чтобы просмотреть всплывающую подсказку со списком событий, произошедших в нём.

Выберите тип события, чтобы просмотреть список событий. Событие создаётся для каждого местоположения, например, если ваш монитор нарушает пороговые значения производительности на уровне шага или монитора. Выберите отдельное событие, чтобы просмотреть подробности.

== Ошибки ==
На вкладке '''Ошибки''' отображаются ошибки, обнаруженные в выбранный период времени.

На карте вы можете:

* Подробности ошибки представлены в виде таблицы с указанием шага и количества повторений.
* Выберите '''Анализ ошибок'''.

== Фронтенды ==
На вкладке '''Фронтенды''' отображаются интерфейсы, к которым назначен монитор.

== Места расположения ==
На вкладке '''Местоположения''' отображается статус последнего выполнения монитора для каждого местоположения. Статус отображается с помощью цветов:

* Зелёный цвет означает, что местоположение было доступно во время последнего выполнения монитора.
* Красный цвет — во время последнего выполнения мониторинга обнаружен сбой.
* Серый цвет — данных о выполнениях в этом месте нет.

== Свойства и теги ==
Эта информационная карточка отображает количество шагов, количество и список местоположений, частоту выполнения монитора и любые применённые теги.

Выберите '''Редактировать''', чтобы изменить текст или добавить дополнительные теги.

== Анализ выполнения ==
При использовании браузерного монитора вы можете детально анализировать выполнение отдельных мониторов.

=== Анализ выполнения программ без использования браузерных мониторов в последней версии Ключ-АСТРОМ ===
Не применимо к новым средам Ключ-АСТРОМ, созданным после 26 января 2026 года.

Если новый интерфейс мониторинга браузера не активирован, вы можете анализировать выполнения на странице многомерного анализа в '''Синтетический мониторинг Классический'''.

# В верхней части страницы с подробными сведениями о мониторе выберите пункт '''Анализ выполнений'''.
# Вы перенаправлены на страницу многомерного анализа в Ключ-АСТРОМ Classic.
# В разделе '''Подробный анализ временного интервала''' выберите выполнение, чтобы закрепить его всплывающую подсказку.
# Наведите курсор на всплывающую подсказку и выберите '''Просмотреть выполнение'''.

=== Анализ выполнения с помощью браузерных мониторов в последней версии Ключ-АСТРОМ ===
Лицензия DPS

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

В процессе выполнения монитора может быть загружена одна или несколько страниц. Вместе со страницей загружается набор компонентов (ресурсов). На диаграмме '''Водопад запросов''' можно увидеть подробную информацию о каждом ресурсе, загруженном вместе со страницей во время выполнения монитора. В частности, это включает:

* Тип ресурса, например, '''скрипт''', '''изображение''', '''шрифт''', '''данные'''.
* Название ресурса.
* Длительность загрузки ресурсов в миллисекундах.
* Инициатор ресурса, например, '''fetch''', '''script''', '''link'''. Подробнее см. раздел '''Инициатор ресурса'''.
* Статус блокировки рендеринга.
* Время начала и окончания загрузки ресурсов.

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

Для анализа выполнения мониторов с помощью диаграммы '''Водопад запросов''':

# В правом верхнем углу страницы с подробными сведениями о мониторе выберите пункт '''Анализ выполнений'''.
# Найдите нужное исполнение в таблице '''Исполнения'''. Каждая строка таблицы представляет собой запись об исполнении. Вы можете использовать фильтр, чтобы сузить список исполнений. Фильтрация может осуществляться по местоположению или временному интервалу.
# Если включена функция автоматического повтора при ошибке, монитор выполняет вторую попытку выполнения в случае неудачи первой. В таблице '''Выполнения''' по умолчанию отображается вторая попытка, а в записи о выполнении появляется значок — выберите его, чтобы увидеть и первую попытку.
# Выберите способ выполнения.
# Отобразится таблица '''Страницы''' с подробными сведениями о выполнении. В строке '''Шаги''' отображаются все шаги, выполненные во время работы монитора. Временной интервал, в течение которого был выполнен шаг, выделен синей полосой. Наведите курсор на полосу, чтобы увидеть подробные сведения о шаге, такие как продолжительность шага, тип шага и элемент пользовательского интерфейса, к которому он был применён. Вы можете отфильтровать определённый шаг. В этом случае синим останется только полоса, связанная с отфильтрованным шагом. Все остальные полосы станут серыми.
# В строке '''Шаги''' отображаются страницы, загруженные во время выполнения монитора.
# Во время работы монитора страницы могут открываться в отдельных окнах или вкладках браузера. В этом случае для каждого окна в таблице отображается запись со значком рядом с записью. Выберите значок, чтобы увидеть страницы, загруженные в это окно.
# В строке '''Шаги и окно (если применимо)''' каждая последующая строка таблицы представляет собой запись о загруженной странице. Временной интервал загрузки страницы выделен синей полосой, отображаемой в записи.
# Чтобы найти нужную страницу, выберите запись страницы в таблице.

Диаграмма '''Водопад запросов''' отображает все ресурсы, загруженные вместе со страницей во время выполнения следующих действий:

* Этап мониторинга, выполняемый при загрузке страницы.
* Все последующие действия монитора, когда браузер взаимодействовал со страницей (например, клики, нажатия клавиш).

Вы можете выбрать ресурс, чтобы просмотреть подробную информацию о его производительности. Ресурсы, загруженные с ошибками, отмечены красной меткой в столбце '''Тип'''.

=== Инициатор ресурса ===
Инициатор ресурса — это функция веб-платформы, которая инициировала загрузку ресурса. Зная, что именно послужило инициатором ресурса, можно, например, определить действия '''XHR''' — их инициаторами обычно являются '''xmlhttprequest''' и '''fetch'''.

Инициатор ресурса не обозначает тип загружаемого содержимого. Например, <code>.css</code>-файл может быть загружен с помощью элемента <code><link></code> — в этом случае <code>link</code> в качестве инициатора ресурса указывается.
{| class="wikitable"
!Инициатор
!Запрос инициирован
|-
|<code>audio</code>
|атрибут <code>src</code> элемента <code><audio></code>
|-
|<code>beacon</code>
|метод <code>navigator.sendBeacon()</code>
|-
|<code>body</code>
|атрибут <code>background</code> элемента <code><body></code>
|-
|<code>css</code>
|функция <code>url()</code> в '''CSS'''
|-
|<code>early-hint</code>
|ответ 103 (Early Hints)
|-
|<code>embed</code>
|атрибут <code>src</code> элемента <code><embed></code>
|-
|<code>fetch</code>
|метод <code>fetch()</code>
|-
|<code>frame</code>
|загрузка элемента <code><frame></code>
|-
|<code>icon</code>
|значок сайта (favicon); нестандартный и отображается только браузером '''Safari'''.
|-
|<code>iframe</code>
|атрибут <code>src</code> элемента <code><iframe></code>
|-
|<code>image</code>
|элемент <code><image></code>
|-
|<code>img</code>
|атрибут <code>src</code> или <code>srcset</code> элемента <code><img></code>
|-
|<code>input</code>
|элемент <code><input></code> типа <code>image</code>
|-
|<code>link</code>
|элемент <code><link></code>
|-
|<code>navigation</code>
|запрос на навигацию
|-
|<code>object</code>
|элемент <code><object></code>
|-
|<code>other</code>
|(нет совпадающих условий)
|-
|<code>ping</code>
|атрибут <code>ping</code> элемента <code><a></code>
|-
|<code>script</code>
|элемент <code><script></code>
|-
|<code>track</code>
|атрибут <code>src</code> элемента <code><track></code>
|-
|<code>video</code>
|атрибут <code>poster</code> или <code>src</code> элемента <code><video></code>
|-
|<code>xmlhttprequest</code>
|'''XMLHttpRequest'''
|}

Приложение Синтетический мониторинг

2026-09-03T15:14:57Z

IKuznetsov: Новая страница: « = Приложение Синтетический мониторинг = С помощью приложения '''Синтетический мониторинг''' вы можете создавать и управлять синтетическими мониторами. == Предварительные требования == === Разрешения === В таблице ниже описаны необходимые разрешения. {| class=...»

= Приложение Синтетический мониторинг =
С помощью приложения '''Синтетический мониторинг''' вы можете создавать и управлять синтетическими мониторами.

== Предварительные требования ==

=== Разрешения ===
В таблице ниже описаны необходимые разрешения.
{| class="wikitable"
!Разрешение
!Описание
|-
|<code>synthetic:locations:read</code>
|Позволяет запрашивать конфигурации синтетических местоположений. Рекомендуемый уровень доступа.
|-
|<code>synthetic:locations:write</code>
|Позволяет создавать, обновлять и удалять частные настройки местоположения. Рекомендуемый уровень доступа.
|-
|<code>geolocation:locations:lookup</code>
|Позволяет запрашивать данные о географическом местоположении для частных объектов.
|-
|<code>synthetic:monitors:read</code>
|Позволяет запрашивать конфигурации синтетических мониторов. Рекомендуемое разрешение.
|-
|<code>synthetic:monitors:write</code>
|Позволяет создавать, обновлять и удалять конфигурацию синтетического монитора. Рекомендуемое разрешение.
|-
|<code>synthetic:monitors:execute</code>
|Позволяет запускать выполнение монитора по запросу. Рекомендуемое разрешение.
|-
|<code>synthetic:environment-configuration:read</code>
|Позволяет запрашивать синтетические конфигурации, включая тайм-ауты мониторинга.
|-
|<code>storage:buckets:read</code>
|Позволяет запрашивать данные из Хранилища данных.
|-
|<code>storage:entities:read</code>
|Позволяет запрашивать данные об отслеживаемых объектах из Хранилища данных.
|-
|<code>storage:smartscape:read</code>
|Позволяет запрашивать данные об узлах и рёбрах '''Smartscape''' из Хранилища данных.
|}

== Установка ==
Приложение '''Синтетический мониторинг''' предустановлено в вашей системе.

== Навигация и фильтрация ==

=== Обзор ===
Когда вы переходите в раздел '''Синтетический мониторинг''', открывается вкладка '''Обзор'''.

В разделе '''Обзор''' отображаются три плитки:

* Мониторы браузера
* HTTP-мониторы
* NAM мониторы

На каждом блоке отображаются четыре значения для соответствующего типа монитора:

* Серый — количество деактивированных (отключённых) мониторов.
* Красный — количество мониторов с проблемами доступности или производительности.
* Зелёный — количество мониторов, у которых нет проблем с доступностью или производительностью.
* Без цвета — общее количество мониторов выбранного типа. Выберите любое число, чтобы отобразить вкладку '''Синтетические мониторы''' с соответствующими применёнными фильтрами. Например, выберите красное число для '''HTTP'''-мониторов, чтобы открыть вкладку '''Синтетические мониторы''' с фильтрами '''Тип: HTTP''' и '''Предупреждение: Критическое'''.

=== Рекомендуемые панели мониторинга ===
В разделе '''Рекомендуемые панели мониторинга''' перечислены рекомендуемые готовые дашборды, которые можно выбрать.

=== Разрешения ===
Если у вас отсутствуют разрешения, связанные с '''Синтетическим мониторингом''', об этом сообщит диалоговое окно.

* Если у вас нет минимальных прав для использования приложения, вы увидите надпись '''Нет разрешения на доступ к синтетическим данным''' и список необходимых разрешений.
* Если у вас отсутствуют некоторые разрешения, которые могут ограничивать доступ к определённым функциям приложения, вы можете выбрать '''Просмотреть разрешения''', чтобы увидеть отсутствующие разрешения.

== Таблица мониторов ==
Для проверки и управления мониторами выберите вкладку '''Синтетические мониторы'''. По умолчанию на странице отображаются все мониторы в вашей среде, активные и неактивные, в таблице с ключевыми показателями доступности и производительности, что позволяет быстро оценить состояние ваших мониторов. Фильтры позволяют сузить поиск синтетических мониторов.

Чтобы узнать, как создать новый монитор, см. раздел «Создание мониторов».

По умолчанию мониторы с открытыми проблемами отображаются в алфавитном порядке вверху таблицы. Далее в алфавитном порядке отображаются включённые мониторы без проблем, а затем в алфавитном порядке — отключённые мониторы.

Вы можете скрывать и сортировать столбцы в порядке возрастания или убывания. Выберите '''Столбцы''' в правом верхнем углу таблицы, чтобы указать, какие столбцы отображать или скрывать.

В столбцах отображается следующая информация для каждого монитора.
{| class="wikitable"
!Столбец
!Описание
|-
|Скриншот
|Только для браузерных мониторов. Отображает снимок экрана последнего выполнения из любого места. Если монитор никогда не запускался, отображается изображение-заглушка.
|-
|Имя монитора
|Выберите этот пункт, чтобы просмотреть краткий обзор монитора справа на странице '''Синтетические мониторы'''.
|-
|ИДЕНТИФИКАТОР
|Полный идентификатор монитора.
|-
|Созданный
|Отслеживайте дату и время создания.
|-
|Создано
|Идентификатор пользователя, создавшего монитор.
|-
|Последнее изменение
|Дата и время внесения изменений в монитор.
|-
|Изменено пользователем
|Идентификатор пользователя, который последним внёс изменения в монитор.
|-
|Тип
|Тип монитора, например, '''HTTP'''.
|-
|Частота
|Частота выполнения или '''On demand''', как указано в конфигурации монитора.
|-
|Последнее исполнение
|Дата и время последнего выполнения из любого места.
|-
|Предупреждения о состоянии здоровья
|Информационные значки, отображаемые для мониторов, имеющих проблемы с доступностью или производительностью. Чтобы исследовать проблему, выберите значок, наведите на него курсор, а затем выберите '''Исследовать проблему''' — появится панель предварительного просмотра, и будет указан временной интервал, в течение которого была обнаружена проблема. Информационные значки не отображаются для мониторов без проблем.
|-
|Пользовательские оповещения
|Чипы оповещений отображаются для мониторов, нарушивших настроенные условия оповещений. Чтобы исследовать проблему, выберите чип, наведите на него курсор и выберите '''Исследовать проблему''' — отобразится панель предварительного просмотра, и будет указан временной интервал, в течение которого была обнаружена проблема. Чипы оповещений не отображаются для мониторов, которые не нарушили настроенные условия оповещений или для которых такие условия не настроены.
|-
|Доступность
|Средняя доступность в течение определённого периода времени.
|-
|Производительность
|Производительность в течение определённого периода времени. Расчёт производительности зависит от типа монитора.
|}

== Предварительный просмотр монитора ==
Чтобы отобразить панель предварительного просмотра для монитора, выберите строку с этим монитором в таблице '''Синтетические мониторы'''.

Для переключения между мониторами откройте панель предварительного просмотра для любого монитора, а затем выберите другой монитор, чтобы переключить предварительный просмотр на новый выбранный монитор. Фильтры сохраняются.

На панели предварительного просмотра отображается:

* Чипы, отображающие состояние доступности и производительности. Чипы могут быть одного из следующих цветов:
** Зелёный — проблем с доступностью или производительностью нет.
** Красный — наличие проблем с доступностью или производительностью.
** Серый — данных нет.

Если отображается красный индикатор, вы можете выяснить причину проблемы:

# Выберите микросхему.
# Наведите курсор на проблему.
# Выберите '''Исследовать проблему'''. Применяется временной интервал, в течение которого была обнаружена проблема. На панели предварительного просмотра отображаются все данные за этот период. Для получения более подробной информации выберите '''Просмотреть подробности''' — вы будете перенаправлены на страницу отчётов мониторинга с тем же временным интервалом. Там вы можете:
#* Просматривать диаграммы на вкладках '''Доступность''' и '''Производительность'''.
#* Для мониторов браузера и '''HTTP''': для более детального анализа выполнения запросов выберите пункт '''Анализ выполнения''' в правом верхнем углу страницы отчётов монитора.

Чтобы выйти из режима исследования проблемы:

# Выберите микросхему.
# Наведите курсор на проблему.
# Выберите '''Расследование увольнения'''.

Показатели, отображаемые на чипах, отражающих состояние здоровья:

* Доступность — показатель доступности мониторов в процентах в течение определённого периода времени.
* Общее время простоя — общее время простоя для всех объектов в течение определённого периода времени.
* Количество местоположений — число местоположений. Если есть местоположения с проблемами, отображается количество затронутых местоположений по сравнению с общим числом местоположений (например, 2/10).
* Производительность — производительность в течение определённого периода времени. Расчёт производительности зависит от типа монитора.

Вкладки:

* '''Обзор'''
** Последний статус — статус последнего выполнения из любого места (успех, неудача или отсутствие данных).
** Доступность — показатель доступности мониторов в процентах за определённый период времени (здесь отображаются те же значения, что и в индикаторе '''Доступность''' под чипами состояния здоровья).
** Производительность — производительность за определённый период времени (здесь отображаются те же значения, что и в индикаторе '''Производительность''' под чипами состояния здоровья). Расчёт производительности зависит от типа монитора.
** Изменения — изменения в настройках монитора: когда были внесены изменения, кто их внёс и что именно было изменено. Доступ к изменениям возможен только за определённый период времени.
* '''Свойства''' — такие параметры, как тип монитора, местоположения, количество запросов в последнем выполнении, частота, шаги и теги.

Элементы управления в правом верхнем углу панели предварительного просмотра:

* '''Редактировать монитор'''.
* Для просмотра подробной информации о мониторе вы будете перенаправлены на страницу отчётов монитора.
* '''Включить отключённый монитор'''.
* '''Отключить включённый монитор'''.
* '''Закрыть панель предварительного просмотра'''.

== Фильтры ==
Фильтры, позволяющие выбирать несколько параметров, помогут вам найти нужные мониторы. Разворачивайте или сворачивайте фильтры, чтобы сосредоточиться на поиске или результатах по мере необходимости. Фильтры автоматически сворачиваются при просмотре краткого обзора монитора.

Следующие категории фильтров (каждая с несколькими вариантами) позволяют искать мониторы.
{| class="wikitable"
!Категория
!Описание
|-
|Тип
|Тип монитора.
|-
|Тревога
|Мониторы с проблемами доступности или производительности и без них.
|-
|Статус
|Активны ли мониторы или неактивны (отключены).
|-
|Количество шагов
|Мониторы, имеющие количество шагов в заданном диапазоне, например, от '''Min: 1''' до '''Max: 5''' шагов.
|-
|Частота
|Частота мониторинга.
|-
|Создано
|Идентификатор пользователя, создавшего монитор.
|-
|Последний редактор
|Идентификатор пользователя, который последним редактировал монитор.
|-
|Расположение
|Общедоступные синтетические местоположения и частные места мониторинга.
|-
|Внешний интерфейс
|Соответствующее приложение '''Мониторинга реальных пользователей''' ('''RUM''').
|-
|Теги
|Значения или пары ключ-значение, применяемые к мониторам; вы можете выбрать теги для включения или исключения из поиска.
|-
|Профиль устройства
|Например, '''desktop''', '''Apple iPhone 8'''.
|}

=== Как работают фильтры ===
При выборе нескольких фильтров в рамках одной категории используется логика '''in'''. Например, при фильтрации мониторов по типу можно выбрать '''HTTP''' и '''NAM-DNS'''. В этом случае система запросит возврат всех мониторов, относящихся либо к типу '''HTTP''', либо к типу '''NAM-DNS'''. В строке фильтров запрос будет выглядеть следующим образом:

<code>Введите (HTTP, "NAM - DNS")</code>

Параметры фильтрации, отображаемые в большинстве категорий, зависят от ваших мониторов; доступны только те фильтры, которые актуальны для ваших мониторов. Например, если у вас нет '''HTTP'''-мониторов, вы не увидите опцию фильтрации по '''HTTP'''.

Вы можете выбирать фильтры в нескольких категориях. Например, если вы выберете '''NAM-DNS''' и '''NAM-ICMP''' в категории '''Тип''', а '''IP''' и '''host-group''' в категории '''Тег''', система вернёт все мониторы, которые:

* относятся либо к типу '''NAM-DNS''', либо к типу '''NAM-ICMP''';
* имеют либо тег '''IP''', либо тег '''host-group'''.

В строке фильтра запрос будет выглядеть следующим образом:

<code>Введите ("NAM - DNS", "NAM - ICMP") и укажите тег (IP, "host-group")</code>

=== Панель фильтров ===
В верхней части страницы находится панель фильтров, отображающая выбранные фильтры. Вы можете добавлять или удалять фильтры непосредственно в панели фильтров. Например, если вы хотите отфильтровать мониторы браузера, введите <code>Type = Browser</code> в строку фильтров. Чтобы удалить фильтр, выберите его рядом с фильтром.

=== Применить выбранные фильтры ===
Чтобы применить выбранные фильтры, выберите '''Обновить''' рядом с панелью фильтров.

=== Фильтры для обмена ===
Вы можете поделиться применёнными фильтрами — после применения фильтров скопируйте URL страницы и поделитесь им.

== Управление синтетическими мониторами ==
В разделе '''Создать монитор''' вы можете выбрать тип синтетического монитора, который хотите создать.

=== Создать мониторы ===
Чтобы создать монитор:

# В правом верхнем углу приложения '''Синтетический мониторинг''' выберите пункт '''+ Новый монитор'''.
# Выберите один из следующих вариантов:
#* '''Браузер''' — выбор этого параметра позволит вам создать монитор браузера. Узнайте, как создать и настроить монитор браузера.
#* '''HTTP''' — выбор этой опции позволит вам создать '''HTTP'''-монитор. Узнайте, как создавать '''HTTP'''-мониторы, отображающие результаты.
#* '''Доступность сети''' — выбор этой опции позволит вам создать монитор '''NAM'''. Узнайте, как создать монитор '''NAM'''.

=== Отчётность ===
Для каждого типа монитора можно отобразить страницу с отчётом. См.:

* Отчёты монитора браузера
* Отчёты '''HTTP'''-монитора
* Мониторинг '''NAM'''

== Учебные модули ==
Чтобы узнать, как использовать '''Синтетический мониторинг''', ознакомьтесь со следующими учебными материалами:

* Создайте и настройте '''HTTP'''-монитор.
* '''HTTP'''-мониторы сообщают о результатах.
* Создайте и настройте монитор браузера.
* Браузерные мониторы сообщают о результатах.
* Создайте монитор '''NAM'''.
* '''NAM''' отслеживает отчётность о результатах.
* Выполнение мониторных операций по запросу.
* Частные синтетические площадки.

== Варианты использования ==

* Автоматический мониторинг и тестирование доступности и производительности приложений в производственной и тестовой средах.
* Устранение неполадок и оптимизация работы цифровых сервисов до того, как это повлияет на пользователей.
* Возможности синтетического мониторинга расширены для мониторинга инфраструктуры и сервисов, которые не предоставляют интерфейсы, работающие по протоколу '''HTTPS'''.

Расширения

2026-08-26T00:51:45Z

IKuznetsov: /* Расширения 2.0 */

В зависимости от архитектуры вашего развертывания и целей, которых вы хотите достичь, вы можете выбрать один из следующих методов расширения:

== ЕдиныйАгент SDK ==
Пакет SDK для ЕдиногоАгента позволяет вручную настраивать приложения для расширения сквозной видимости платформ и технологий. С помощью SDK вы получаете полный доступ ко всем функциям анализа и мониторинга, включая автоматический анализ первопричин на основе искусственного интеллекта. Дополнительные сведения см. В разделе [[ЕдиныйАгент SDK]] .

== Расширения Ключ-Астром ==
*Если вы можете установить ЕдиныйАгент на хост, используйте расширения '''ЕдиногоАгента'''.
* Если вам нужно контролировать удаленную технологию, где установка ЕдиногоАгента невозможна, используйте расширения '''АктивногоШлюза'''.
* Если вы просто хотите отслеживать приложение Java, которое предоставляет компоненты MBeans, используйте расширения '''JMX'''.

Расширения '''ЕдиногоАгента'''

С помощью расширений ЕдиногоАгента вы можете расширить мониторинг ЕдиногоАгента на любые обнаруженные ЕдинымАгентом процессы, которые предоставляют интерфейс (например, процессы, обслуживаемые по протоколу HTTP - базы данных, приложения и балансировщики нагрузки). Расширения работают в ЕдиномАгенте и полностью интегрируют мониторинг новых технологий в Ключ-Астром Smartscape и обнаружение проблем. Для разработки расширений ЕдиногоАгента вам потребуется некоторый опыт работы с Python. Дополнительные сведения см. в разделе [[Расширения ЕдиногоАгента]] .

Расширения '''АктивногоШлюза'''

С помощью расширений АктивногоШлюза вы можете распространить мониторинг Ключ-АСТРОМ на любую удаленную технологию, которая предоставляет интерфейс, где установка ЕдиногоАгента невозможна. Например, технологии PaaS, сетевые устройства или облачные технологии. Расширения АктивногоШлюза (также известные как удаленные плагины) выполняются на АктивномШлюзе и могут получать метрики и топологию из удаленных источников, полностью интегрируя мониторинг новых технологий в Ключ-АСТРОМ Smartscape и обнаружение проблем. Для разработки расширений АктивногоШлюза вам потребуется некоторый опыт работы с Python. Для получения дополнительной информации см. [[Введение в расширения АктивногоШлюза]].

Расширения '''JMX/PMI'''

С помощью расширений JMX/PMI вы расширяете мониторинг Ключ-АСТРОМ на любое приложение на основе Java, открывающее MBeans. Кодирования не требуется, используйте наш мастер для настройки и развертывания расширения. Дополнительные сведения см. в разделе [[Как отслеживать показатели JMX в моих приложениях Java?]].

* [[Расширения JMX]]

Расширение '''SDK'''

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

=== Поддержка "из коробки" ===

* [[Мониторинг Cassandra]]

== Ключ-АСТРОМ OpenKit ==
Если у вашего бизнеса есть цифровые точки соприкосновения за пределами ваших приложений, вы можете использовать Ключ-АСТРОМ OpenKit для их инструментария, независимо от того, являются ли они традиционными полнофункциональными клиентскими приложениями, интеллектуальными приложениями IoT или даже навыками Alexa. Ключ-АСТРОМ OpenKit лучше всего подходит для клиент-серверных приложений, которые обмениваются данными через HTTP (например, многофункциональные клиентские приложения, встроенные устройства и терминалы). Для получения дополнительной информации см. [[Ключ-АСТРОМ OpenKit]] .

== Прием и анализ пользовательских метрик ==
Пользовательская метрика определяется как новый тип метрики, который предлагает предоставленный пользователем идентификатор метрики и единицу измерения. Семантика настраиваемых показателей определяется вами. После определения настраиваемой метрики ее можно сообщить для нескольких отслеживаемых компонентов.

== [[Расширения 2.0]] ==

* [[Ceph]]
*[[Apache Storm]]
*[[Custom Database Queries]]
*[[Microsoft Active Directory replication]]
*[[IBM MQ]]
*[[Microsoft SQL Server]]
*[[Filesystem monitoring]]
*[[PostgresDB (remote monitoring)]]
*[[SAP ABAP platform monitoring]]
*[[MySQL (remote monitoring)]]
*[[Redis]]
*[[IBM i]]
*[[Apache Kafka]]
*[[Мониторинг SSL-сертификатов]]
*[[Generic network device]]
*[[SNMP Autodiscovery]]
*[[Источник данных SNMP Traps]]
*[[Справочник по источнику данных SNMP]]
*[[Мониторинг F5 BIG-IP LTM (Расширения 2.0)|Мониторинг F5 BIG-IP LTM]]
*[[Мониторинг Microsoft Hyper-V]]

*[[ClickHouse]]
*[[Cassandra]]
*[[DB Query]]
*[[KA-monitor]]
*[[Linux command extension]]
*[[MongoDB]]
*[[MS SQL]]
*[[Custom sessions monitor]]
*[[Zabbix]]

== [[Расширенный пользовательский опыт и поведение]] ==

== Лицензии ВИД Ключ-АСТРОМ ==

* [[Блоки данных ИИ (DDU) для метрик|Лицензии ВИД для метрик]]

== [[Расширение топологии - Пользовательская модель топологии]] ==

== Разработка ==

* Расширения АктивногоШлюза
** [[Введение]]
**[[Возможности]]
**[[Руководство]]

* Расширения
** [[Развёртывание расширения]]
**[[Диаграммы]]
** [[Ключевые показатели производительности]]
** [[Оповещения о расширениях]]
** [[Групповые показатели]]
**[[Метрики состояний]]
** [[Пользовательская конфигурация плагина АктивныйШлюз]]
** [[Конфигурация расширения]]
** [[Топология]]
** [[Проблемы и события]]
** [[Пользовательские свойства]]
*[[Обновление до Python 3.8]]

Zabbix

2026-08-25T22:56:51Z

IKuznetsov: Новая страница: «= Интеграция Zabbix с Ключ-АСТРОМ = Расширение: <code>ru.ruscomtech.python.zabbix</code> Версия: 0.1.27 Минимальная версия Ключ-АСТРОМ: 1.285.0 == Назначение == Расширение интегрирует данные '''Zabbix''' в платформу Ключ-АСТРОМ, обеспечивая единое окно наблюдаемости для гибридных сред,...»

= Интеграция Zabbix с Ключ-АСТРОМ =
Расширение: <code>ru.ruscomtech.python.zabbix</code>

Версия: 0.1.27

Минимальная версия Ключ-АСТРОМ: 1.285.0

== Назначение ==
Расширение интегрирует данные '''Zabbix''' в платформу Ключ-АСТРОМ, обеспечивая единое окно наблюдаемости для гибридных сред, где часть инфраструктуры мониторится только через '''Zabbix'''. Оно не заменяет '''Zabbix''', а делает его данные доступными в Ключ-АСТРОМ для корреляции, анализа ИИ и визуализации.

Основные задачи:

* Синхронизация хостов, групп хостов и проблем '''Zabbix''' как кастомных сущностей и событий в Ключ-АСТРОМ.
* Экспорт числовых метрик '''Zabbix''' в формате пользовательских метрик Ключ-АСТРОМ.
* Привязка проблем '''Zabbix''' к существующим сущностям Ключ-АСТРОМ (хостам, сервисам и др.) по IP или через тег с entity selector.
* Поддержка фильтрации по host group, тегам проблем и ключам метрик (включая регулярные выражения).

== Архитектура и сущности ==
Расширение создаёт следующие типы кастомных сущностей в Ключ-АСТРОМ:
{| class="wikitable"
!Тип сущности
!Идентификатор
!Описание
|-
|Zabbix Server
|<code>zabbix:server</code>
|Представляет один '''Zabbix'''-сервер
|-
|Host Group
|<code>zabbix:hostgroup</code>
|Группа хостов из '''Zabbix'''
|-
|Host in Group
|<code>zabbix:host_on_group</code>
|Промежуточная связь между хостом и группой
|-
|Host
|<code>zabbix:host</code>
|Отдельный хост '''Zabbix'''
|}
Сущности связаны отношениями:

* <code>zabbix:hostgroup</code> → <code>CHILD_OF</code> → <code>zabbix:server</code>
* <code>zabbix:host_on_group</code> → <code>CHILD_OF</code> → <code>zabbix:hostgroup</code>
* <code>zabbix:host_on_group</code> → <code>CALLS</code> → <code>zabbix:host</code>

Для сущности <code>zabbix:host</code> могут быть заполнены:

* IP-адрес (из item’а <code>interfaces</code> или '''Zabbix API''')
* Поля инвентаря (при включении соответствующих флагов в <code>inventory_keys</code>)
* '''Zabbix'''-теги как строковое свойство <code>zabbix_tags</code>

== Синхронизация проблем ==
Проблемы '''Zabbix''' (триггеры в состоянии <code>PROBLEM</code>) передаются в Ключ-АСТРОМ как события с типом <code>CUSTOM_ALERT</code>.

=== Severity mapping ===
Уровни серьёзности '''Zabbix''' сопоставляются уровням проблем Ключ-АСТРОМ через настройки:
{| class="wikitable"
!Zabbix severity
!Dynatrace problem level
|-
|<code>zbx2dt_disaster</code>
|Availability
|-
|<code>zbx2dt_high</code>
|Error
|-
|<code>zbx2dt_average</code>
|Slowdown
|-
|<code>zbx2dt_warning</code>
|Resource
|-
|<code>zbx2dt_information</code>, <code>zbx2dt_not_classified</code>
|Suppress (по умолчанию)
|}
Сопоставление можно изменить в разделе '''Advanced configuration'''.

=== Привязка к существующим сущностям ===
По умолчанию проблема привязывается к сущности <code>zabbix:host</code>. Для привязки к другим объектам используется тег в '''Zabbix''':

* В конфигурации расширения задаётся имя тега: параметр '''Zabbix tag for Dynatrace entities''' (<code>tag_entities</code>, по умолчанию <code>DT_Entity</code>).
* В '''Zabbix''' на триггере/шаблоне/хосте добавляется тег с этим ключом.
* Значение тега должно быть валидным entity selector Ключ-АСТРОМ, например:
** <code>type("HOST"),entityName.equals("{HOST.NAME}")</code>
** <code>entityId("SERVICE-ABC123")</code>
** <code>type("PROCESS_GROUP"),tag("db")</code>

Если selector возвращает одну или несколько сущностей — событие создаётся на каждой из них. Поведение при множественных совпадениях регулируется флагом '''Allow Davis merge''' (<code>dt_allow_davis_merge</code>).

== Метрики ==
Расширение экспортирует три типа метрик:
{| class="wikitable"
!Метрика
!Ключ
!Назначение
|-
|Проблемная метрика
|<code>zabbix.problem_count.gauge</code>
|Число активных проблем на хосте (включается опцией <code>problem_metric</code>)
|-
|Пользовательские item’ы
|<code>zabbix.item</code>
|Значения '''Zabbix'''-метрик по списку ключей из <code>item_keys</code>
|-
|Топологическая метрика
|<code>zabbix.topology</code>
|Служебная метрика для создания и поддержки сущностей
|}
Ключи item’ов задаются как список строк или регулярных выражений в поле '''Zabbix item keys to export''' (<code>item_keys</code>).

== Инвентарь хостов ==
При включении опций в разделе '''Zabbix host inventory''' (<code>inventory_keys</code>) данные из '''Zabbix Inventory''' передаются как свойства сущности <code>zabbix:host</code> с префиксом <code>in_</code> (например, <code>in_os</code>, <code>in_host_networks</code>).

По умолчанию включены:

* <code>host_networks</code> → <code>in_host_networks</code>
* <code>os</code> → <code>in_os</code>

Остальные поля (оборудование, контакты, геолокация и т.д.) включаются явно.

== Настройка ==

=== Требования ===

* '''Zabbix''': пользователь или '''API'''-токен с правами '''Read''' на нужные host groups.
* Ключ-АСТРОМ: АктивныйШлюз окружения с поддержкой '''Python'''-расширений.
* Расширение загружено и активировано в Расширениях.

=== Конфигурация endpoint’а ===
Обязательные параметры:

* <code>url</code> — URL '''Zabbix''' (например, <code>https://zabbix.example.com/zabbix</code>)
* <code>username</code> / <code>password</code> — учётные данные или '''API'''-токен в поле <code>password</code>
* <code>groups</code> — список host groups для синхронизации (минимум одна)

Опциональные (в '''Advanced configuration'''):

* <code>timeout</code> — таймаут запроса к '''Zabbix API''' (по умолчанию 5 сек)
* <code>cert_verify</code> — проверка '''SSL'''-сертификата (по умолчанию <code>false</code>)
* <code>refresh_*</code> — интервалы обновления данных (хосты: 20 мин, проблемы: 15 мин)
* <code>interfaces_key</code> — ключ item’а с IP-адресами (по умолчанию <code>interfaces</code>)
* <code>synchronize_problems</code> — включить синхронизацию проблем (по умолчанию <code>true</code>)
* <code>problem_resend</code> — интервал переотправки/закрытия проблем (по умолчанию 5 мин)
* <code>tag_entities</code> — имя тега для маппинга на сущности Ключ-АСТРОМ (по умолчанию <code>DT_Entity</code>)
* <code>dt_allow_davis_merge</code> — разрешить объединение событий ИИ (по умолчанию <code>true</code>)

Если требуется '''HTTP/HTTPS'''-прокси, он настраивается отдельно в блоке '''Proxy''' (<code>proxy.url</code>, <code>proxy.user</code>, <code>proxy.password</code>).

== Интерфейс в Ключ-АСТРОМ ==
После первого цикла синхронизации доступны:

* Экраны: '''Zabbix Servers''', '''Zabbix HostGroups''', '''Zabbix Hosts'''
* Дашборд: '''Zabbix Overview''' (автоматически импортируется из пакета расширения)
* Метрики в '''Metrics browser''' по пространству имён <code>zabbix.*</code>
* События в разделах '''Events''' и '''Problems'''

Каждый '''Zabbix'''-хост отображает:

* Свойства (IP, инвентарь, теги)
* Ссылку на '''Zabbix UI''' (<code>zabbix_host_url</code>)
* Метрику <code>zabbix.problem_count.gauge</code>
* Привязанные события

== Тегирование ==
Расширение автоматически добавляет тег <code>technology: zabbix</code> ко всем создаваемым сущностям.

Рекомендуется настроить дополнительные auto-tag’и:

* Глобальный тег '''Zabbix''' для всех <code>zabbix:*</code> сущностей.
* Теги по группам, например <code>ZabbixHG:Linux servers</code>, с использованием entity selector:
<pre>
type("zabbix:hostgroup"),entityName.equals("Linux servers")
</pre>и<pre>
type("zabbix:host"),toRelationships.calls(
type("zabbix:host_on_group"),
fromRelationships.isChildOf(
type("zabbix:hostgroup"),
entityName.equals("Linux servers")
)
)
</pre>

== Ограничения ==

* Проблемы, живущие менее <code>problem_resend</code> минут (по умолчанию 5), могут не попасть в Ключ-АСТРОМ.
* Закрытие проблемы в Ключ-АСТРОМ происходит с задержкой до следующего цикла опроса.
* Порт не передаётся из '''Zabbix''' → невозможно точное совпадение сущности по (IP, port).
* Acknowledgements отображаются только в свойствах события, не влияют на состояние проблемы.
* Максимум 100 endpoint’ов на один экземпляр расширения.

== Release Notes ==

=== Версия 0.1.27 (custom) ===
Версия плагина с префиксом <code>custom</code>.

=== Версия 0.1.27 ===
Стандартная версия плагина.

Custom sessions monitor

2026-08-25T22:55:02Z

IKuznetsov: Новая страница: «= Расширение custom-sessions-monitor для Ключ-АСТРОМ = Расширение '''custom-sessions-monitor''' предназначено для сбора статистики активных пользователей кластера Ключ-АСТРОМ. Оно подключается к '''Cluster API''' и передаёт метрики, позволяющие анализировать вовлечённость пользова...»

= Расширение custom-sessions-monitor для Ключ-АСТРОМ =
Расширение '''custom-sessions-monitor''' предназначено для сбора статистики активных пользователей кластера Ключ-АСТРОМ. Оно подключается к '''Cluster API''' и передаёт метрики, позволяющие анализировать вовлечённость пользователей.

== Возможности ==

* Сбор метрик '''MAU''' (Monthly Active Users) и '''DAU''' (Daily Active Users).
* Настраиваемое расписание запуска: ежедневно или еженедельно с указанием дня недели и времени.
* Поддержка проверки или отключения проверки '''TLS/SSL'''-сертификата.
* Аутентификация через '''API'''-токен кластера.
* Автоматическая отправка собранных метрик в Ключ-АСТРОМ.

== Конфигурация ==
Для настройки расширения используются следующие поля:
{| class="wikitable"
!Поле
!Описание
|-
|<code>cluster_url</code>
|URL кластера, например <code><nowiki>https://ka.example.local</nowiki></code>.
|-
|<code>cluster_token</code>
|API-токен для доступа к '''Cluster API'''.
|-
|<code>ssl_verify</code>
|Проверка '''TLS/SSL'''-сертификата: <code>true</code> — проверять, <code>false</code> — не проверять.
|-
|<code>use_weekly_schedule</code>
|Включает фиксированное расписание запуска. Если <code>false</code>, сбор выполняется не чаще одного раза в сутки по внутреннему интервалу.
|-
|<code>schedule_frequency</code>
|Частота запуска: <code>daily</code> или <code>weekly</code>.
|-
|<code>schedule_day_of_week</code>
|День недели для <code>weekly</code>: <code>MON..SUN</code> или <code>0..6</code>.
|-
|<code>schedule_time</code>
|Время запуска в формате <code>HH:MM</code>, например <code>12:00</code>.
|-
|<code>schedule_timezone_offset</code>
|Часовой пояс расписания, например <code>+03:00</code>.
|}

== Требования к токену кластера ==
'''Scope''' токена кластера должен включать:

* Управление токенами кластера
* API поставщика сервисов

== Метрики ==
Расширение отправляет следующие метрики:
{| class="wikitable"
!Метрика
!Описание
|-
|<code>custom.sessions_monitor.mau</code>
|Количество уникальных пользователей за последние 30 дней ('''Monthly Active Users''').
|-
|<code>custom.sessions_monitor.dau</code>
|Количество уникальных пользователей за последние 1 день ('''Daily Active Users''').
|}

== Работа расширения ==

* Если <code>use_weekly_schedule</code> установлен в <code>false</code>, расширение выполняет сбор данных не чаще одного раза в сутки, руководствуясь внутренним интервалом.
* Если включено фиксированное расписание, сбор происходит в указанное время с учётом дня недели и часового пояса.

== См. также ==

* Мониторинг кластера Ключ-АСТРОМ
* API поставщика сервисов

MS SQL

2026-08-25T22:51:29Z

IKuznetsov: Новая страница: «= Глубокий мониторинг Microsoft SQL Server с Ключ-АСТРОМ = Ключ-АСТРОМ — это интеллектуальная платформа для всестороннего мониторинга '''Microsoft SQL Server''', позволяющая перейти от реактивного реагирования к проактивному предотвращению проблем. == Ключевые возможнос...»

= Глубокий мониторинг Microsoft SQL Server с Ключ-АСТРОМ =
Ключ-АСТРОМ — это интеллектуальная платформа для всестороннего мониторинга '''Microsoft SQL Server''', позволяющая перейти от реактивного реагирования к проактивному предотвращению проблем.

== Ключевые возможности ==

=== 1. Автоматическое обнаружение и инвентаризация ===
Платформа находит все экземпляры '''SQL Server''' в инфраструктуре:

* Локальные серверы (физические и виртуальные)
* Контейнеры ('''Docker''', '''Kubernetes''')
* Кластеры высокой доступности ('''Always On AG''', '''FCI''')

=== 2. Мониторинг производительности ===
Сбор более 500 метрик в реальном времени:

* Ресурсы: '''CPU''', память, диски, сеть
* Производительность запросов: время выполнения, блокировки, взаимоблокировки
* Нагрузка: соединения, транзакции, сессии
* Репликация и журналы транзакций

=== 3. Глубокий анализ SQL-запросов ===

* Выявление медленных и ресурсоемких запросов
* Просмотр планов выполнения
* Связь запросов с прикладными транзакциями
* Рекомендации по оптимизации (индексы, переписывание)

=== 4. Прогнозирование проблем (ИИ) ===
Использование искусственного интеллекта для:

* Обнаружения аномалий
* Прогнозирования сбоев (например, нехватка памяти)
* Формирования рекомендаций по устранению

=== 5. Full-Stack Observability ===
Интеграция данных '''SQL Server''' с мониторингом всего стека:

* Трассировка запросов от фронтенда до БД
* Анализ влияния '''SQL''' на микросервисы
* Корреляция ошибок базы данных и приложений

== Установка и настройка ==

=== Требования к АктивномуШлюзу ===

* Ресурсы: 2 '''vCPU''', 4 ГБ '''RAM''', 30 ГБ '''HDD'''
* Поддерживаемые ОС: '''RHEL''', '''CentOS''', '''Oracle Linux''', '''Ubuntu''', '''SUSE''', '''Windows''', '''Астра Линукс''' и др.

=== Необходимые разрешения ===
Для пользователя мониторинга требуются:

* <code>VIEW SERVER STATE</code> (<code>VIEW SERVER PERFORMANCE STATE</code> для '''SQL''' 2022+)
* <code>VIEW DATABASE STATE</code>
* <code>VIEW ANY DEFINITION</code>

=== Процесс установки ===

# Перейдите в раздел '''Расширения''' интерфейса Ключ-АСТРОМ.
# Загрузите расширение '''MSSQL''' через UI (перетаскивание или выбор файла).
# Введите параметры подключения:
#* Хост и порт базы данных
#* Имя базы данных
#* Логин и пароль пользователя
# Сохраните конфигурацию и проверьте соединение.

Примечание: Расширение выполняет только '''SELECT'''-запросы к системным представлениям (<code>sys.*</code>, <code>msdb</code>). Нагрузка на БД минимальна благодаря кэшированию.

MongoDB

2026-08-25T22:49:11Z

IKuznetsov: Новая страница: «= Мониторинг MongoDB в Ключ-АСТРОМ = Инструкция по настройке расширения для мониторинга '''MongoDB'''. Расширение подключается к экземпляру '''MongoDB''' через сетевой порт (по умолчанию 27017) и собирает метрики сервера, баз данных, операций, памяти и подключений. == Воз...»

= Мониторинг MongoDB в Ключ-АСТРОМ =
Инструкция по настройке расширения для мониторинга '''MongoDB'''.

Расширение подключается к экземпляру '''MongoDB''' через сетевой порт (по умолчанию 27017) и собирает метрики сервера, баз данных, операций, памяти и подключений.

== Возможности расширения ==

=== Что делает ===

* Подключается к экземпляру '''MongoDB''' через сетевой порт.
* Собирает метрики сервера (<code>serverStatus</code>), включая статистику операций, подключений, памяти, блокировок и транзакций.
* Создает сущности '''MongoDB Instance''' и '''Database''' со связями между ними.
* Предоставляет данные для анализа производительности и работоспособности СУБД.

=== Что не делает ===

* Не устанавливает и не настраивает '''MongoDB'''.
* Не использует '''Management API''' или веб-интерфейс — только прямое сетевое подключение к СУБД.
* Не выполняет трассировку запросов между приложениями.
* Не создает и не изменяет объекты баз данных, кроме создания учетной записи для мониторинга.

Метрики начинают поступать после завершения настройки и первого цикла сбора (в течение 2–3 минут).

== Предварительные условия ==

* Версия '''MongoDB''': 4.0 или выше (рекомендуется 5.0+).
* Версия Ключ-АСТРОМ: 1.308 или выше.
* На хосте с '''MongoDB''' установлен ЕдиныйАгент Ключ-АСТРОМ, контроллер выполнения расширений ('''EEC''') включен.
* Подготовлен пакет расширения (<code>.zip</code>) для загрузки в Расширения — либо расширение уже доступно в каталоге Расширений.
* Сетевая доступность: порт '''MongoDB''' (по умолчанию 27017) должен быть открыт для подключений со стороны ЕдиногоАгента.
* Учетная запись с правами мониторинга (рекомендуется пользователь с ролью <code>clusterMonitor</code>).

== Рекомендация по подключению ==
При локальном мониторинге (ЕдиныйАгент на том же хосте, что и '''MongoDB''') в конфигурации установите флажок '''Connect via 'localhost'?'''. Это позволит использовать loopback-адрес для подключения.

Для защищенного соединения можно настроить '''TLS''' (флажок '''Enable insecure TLS''' устанавливать не рекомендуется — используйте правильно настроенные сертификаты).

== Шаг 0. Подготовка MongoDB к мониторингу ==
Данный этап выполняется непосредственно на сервере с '''MongoDB''' от имени администратора базы данных.

=== 0.1 Подключение к MongoDB ===
Подключитесь к экземпляру '''MongoDB''' с помощью <code>mongosh</code>.

'''Без аутентификации:'''<pre>
mongosh
</pre>'''С аутентификацией (рекомендуется):'''<pre>
mongosh --username admin --password <пароль_admin> --authenticationDatabase admin
</pre>Переключитесь на административную базу данных:<pre>
use admin
</pre>Проверьте существующих пользователей (опционально):<pre>
db.getUsers()
</pre>Создайте пользователя для мониторинга с ролью <code>clusterMonitor</code>:<pre>
db.createUser({user: "dt_user", pwd: "<пароль>", roles: ["clusterMonitor"]})
</pre>Примечание: Роль <code>clusterMonitor</code> предоставляет необходимые права для сбора метрик производительности и состояния кластера, включая доступ к командам <code>serverStatus()</code>, <code>dbStats()</code> и другим диагностическим данным.

=== 0.3 Проверка доступности баз данных ===
Убедитесь, что '''MongoDB''' работает корректно и базы данных доступны для мониторинга:<pre>
show dbs
</pre>Ожидаемый результат: список существующих баз данных.

== Шаг 1. Загрузка расширения в Расширения ==
Если расширение еще не установлено в окружении:

# Откройте '''Расширения''' → раздел '''Extensions'''.
# Нажмите '''Загрузить Расширение 2.0''' и выберите загрузку пользовательского / custom-расширения.
# Укажите файл <code>.zip</code>-пакета расширения '''MongoDB''' (доступен в каталоге Расширений или загружен из внешнего источника).
# Дождитесь успешной проверки подписи и загрузки.
# Активируйте нужную версию расширения для окружения.

Если расширение уже присутствует в Расширениях окружения, откройте его карточку и убедитесь, что требуемая версия активна. После активации перейдите на вкладку '''Конфигурация''' — можно добавлять конфигурацию мониторинга.

== Шаг 2. Добавление конфигурации мониторинга ==

# Откройте '''Расширения''' → расширение '''MongoDB''' → вкладка '''Конфигурация'''.
# Нажмите '''Добавить конфигурацию мониторинга'''.

== Шаг 3. Выбор источника мониторинга ==
Для типичного сценария «ЕдиныйАгент на хосте с MongoDB» выберите '''Мониторить локально''' и нужный хост. Убедитесь, что у хоста '''EEC''' отображается как «Включено».

Нажмите '''Следующий шаг'''.

== Шаг 4. Параметры подключения к MongoDB ==
{| class="wikitable"
!Поле
!Описание
!Пример
|-
|Port
|Порт '''MongoDB''' (по умолчанию 27017)
|27017
|-
|User
|Пользователь с правами мониторинга (создан на шаге 0)
|dt_user
|-
|Password
|Пароль пользователя
|–
|-
|Auth Mechanism
|Механизм аутентификации (оставьте пустым для использования стандартного)
|–
|-
|Authentication Database
|База данных аутентификации (обычно admin)
|admin
|}
Рекомендации по настройке:

* '''Порт''': Оставьте значение по умолчанию (27017), если только '''MongoDB''' не использует нестандартный порт.
* '''Пользователь''': Используйте учетную запись, созданную на шаге 0 с ролью <code>clusterMonitor</code>.
* '''Authentication Database''': Укажите <code>admin</code> (база данных, где создан пользователь).
* '''Enable insecure TLS''': Не устанавливайте данный флажок в production-средах. Используйте корректно настроенные сертификаты для '''TLS'''-соединений.
* '''Connect via 'localhost'?''': Установите флажок при локальном мониторинге (ЕдиныйАгент на том же хосте, что и '''MongoDB'''). Это гарантирует подключение через loopback-адрес.

== Шаг 5. Ярлык конфигурации и наборы метрик ==

* Оставьте конфигурацию включенной ('''Enabled''').
* Укажите понятный ярлык ('''Description'''), например имя кластера или окружения.
* Рекомендуется включить все наборы функций:
** '''Instance''' (метрики сервера)
** '''Database''' (метрики баз данных)
* Сохраните конфигурацию.

== Шаг 6. Проверка статуса ==
В разделе '''Конфигурация''' расширения убедитесь, что:

* Конфигурация включена.
* Состояние отображается как '''Ok'''.
* Указан корректный хост выполнения.

При статусе '''Ok''' можно перейти к дашборду кнопкой '''Перейти на дашборд'''.

Через 1–3 минуты в Ключ-АСТРОМ появляются сущности '''MongoDB Instance''' (а также '''Database''' — если они есть в '''MongoDB''').

== Контрольный список ==
{| class="wikitable"
!№
!Пункт
|-
|1
|На сервере '''MongoDB''' создана учетная запись <code>dt_user</code> с ролью <code>clusterMonitor</code>.
|-
|2
|Пакет расширения загружен в Расширения и активирован.
|-
|3
|Конфигурация мониторинга добавлена и включена, состояние '''Ok'''.
|-
|4
|Выбран корректный режим (локально / удаленно).
|-
|5
|Указаны корректные параметры подключения (порт, пользователь, пароль, Authentication Database).
|-
|6
|При локальном мониторинге установлен флажок '''Connect via 'localhost'?'''.
|-
|7
|На дашбордах и в сущностях отображаются метрики '''MongoDB'''.
|}

== Возможные проблемы ==
{| class="wikitable"
!Симптом
!Что проверить
|-
|Состояние конфигурации не '''Ok'''
|Сетевая доступность порта '''MongoDB''' (27017) с хоста ЕдиногоАгента / АктивногоШлюза, корректность учетных данных, статус '''EEC'''.
|-
|Ошибка авторизации
|Проверьте логин и пароль пользователя, а также Authentication Database (обычно <code>admin</code>). Убедитесь в наличии роли <code>clusterMonitor</code>.
|-
|Нет сущностей Database
|В '''MongoDB''' нет баз данных, либо еще не завершился первый цикл сбора.
|-
|Нулевые значения метрик
|Ожидаемо при отсутствии нагрузки; расширение отражает фактическое состояние СУБД.
|-
|Требуется удаленный сбор
|Группа АктивныхШлюзов с сетевым доступом к <code>host:27017</code> и отдельная учетная запись с ролью <code>clusterMonitor</code>.
|-
|Ошибка подключения при '''TLS'''
|Проверьте сертификаты. Временно для тестирования можно установить флажок '''Enable insecure TLS''' (не рекомендуется для production).
|-
|Расширение не видит базы данных
|Проверьте права пользователя <code>dt_user</code> — необходима роль <code>clusterMonitor</code>. Также убедитесь, что базы данных существуют и доступны (<code>show dbs</code>).
|}

Linux command extension

2026-08-25T22:46:54Z

IKuznetsov: Новая страница: «= Расширение linux_command для Ключ-АСТРОМ = Расширение '''linux_command''' предназначено для выполнения произвольных '''bash'''-команд на удалённых хостах по '''SSH''' и преобразования вывода в метрики Ключ-АСТРОМ. Метрики имеют префикс <code>custom.linux_command</code>. == Возможности расш...»

= Расширение linux_command для Ключ-АСТРОМ =
Расширение '''linux_command''' предназначено для выполнения произвольных '''bash'''-команд на удалённых хостах по '''SSH''' и преобразования вывода в метрики Ключ-АСТРОМ. Метрики имеют префикс <code>custom.linux_command</code>.

== Возможности расширения ==

* Выполнение произвольной '''bash'''-команды на удалённом хосте.
* Подключение по '''SSH''' с паролем или по приватному ключу.
* Запуск команды от имени другого пользователя через <code>su <user> -c <command></code>.
* Разбор вывода в двух режимах:
** <code>SINGLE_VALUE</code> — первое числовое значение из вывода.
** <code>MULTI_VALUE</code> — набор пар <code>key=value</code>.
* Отправка метрик с измерением <code>endpoint</code>, соответствующим имени endpoint.

== Требования ==
На хосте, где запускается расширение (АктивныйШлюз или среда выполнения), должны быть установлены:

* <code>ssh</code>
* <code>sshpass</code>

== Конфигурация ==
Конфигурация задаётся через '''activation.json'''.

=== Пример activation.json ===
<pre>
{
"enabled": true,
"description": "linux_command activation",
"version": "0.0.6",
"activationContext": "REMOTE",
"pythonRemote": {
"endpoints": [
{
"endpoint_name": "test-endpoint",
"execution_frequency": 1,
"hostname": "172.18.38.131",
"ssh_port": 22,
"username": "test-user",
"password": "{{sshPassword}}",
"second_username": "",
"second_password": "",
"private_key_file": "",
"private_key_passphrase": "",
"command": "id -u",
"metric_extraction_mode": "SINGLE_VALUE",
"metric_pair_delimiter": "",
"key_value_delimiter": ""
}
]
}
}
</pre>

== Параметры endpoint ==
{| class="wikitable"
!Параметр
!Описание
|-
|<code>endpoint_name</code>
|Имя endpoint (попадает в измерение <code>endpoint</code>).
|-
|<code>execution_frequency</code>
|Частота запуска в минутах (минимум 1).
|-
|<code>hostname</code>
|Хост для '''SSH'''-подключения.
|-
|<code>ssh_port</code>
|'''SSH'''-порт (по умолчанию 22).
|-
|<code>username</code>
|'''SSH'''-пользователь.
|-
|<code>password</code>
|'''SSH'''-пароль.
|-
|<code>second_username</code>
|Второй пользователь для <code>su</code> (опционально).
|-
|<code>second_password</code>
|Пароль второго пользователя (опционально).
|-
|<code>private_key_file</code>
|Путь к приватному ключу на АктивномШлюзе/среде выполнения (опционально).
|-
|<code>private_key_passphrase</code>
|Парольная фраза ключа (опционально).
|-
|<code>command</code>
|Команда для запуска.
|-
|<code>metric_extraction_mode</code>
|Режим извлечения метрик: <code>SINGLE_VALUE</code> или <code>MULTI_VALUE</code>.
|-
|<code>metric_pair_delimiter</code>
|Разделитель пар в <code>MULTI_VALUE</code> (по умолчанию <code>\n</code>).
|-
|<code>key_value_delimiter</code>
|Разделитель ключ/значение в <code>MULTI_VALUE</code> (по умолчанию <code>=</code>).
|}

== Режимы извлечения метрик ==

=== SINGLE_VALUE ===
Берётся первая строка, которую можно преобразовать в число с плавающей точкой.

'''Пример:'''

Команда: <code>id -u</code>

Вывод: <code>1001</code>

Метрика: <code>custom.linux_command.value = 1001</code>

=== MULTI_VALUE ===
Ожидается вывод в формате <code>key=value</code> (или с заданными разделителями).

'''Пример:'''

Команда: <code>printf 'cpu=12\nmem=45.5\nerrors=0\n'</code>

<code>metric_pair_delimiter</code>: <code>\n</code>

<code>key_value_delimiter</code>: <code>=</code>

Метрики:

* <code>custom.linux_command.cpu = 12</code>
* <code>custom.linux_command.mem = 45.5</code>
* <code>custom.linux_command.errors = 0</code>

== Примеры сценариев ==

=== Команда от второго пользователя ===

* <code>username</code>: пользователь для '''SSH'''.
* <code>second_username</code>: пользователь, от которого выполнить команду.
* <code>command</code>: например, <code>id -u</code>.

Фактически выполняется:<pre>
su <second_username> -c '<command>'
</pre>

=== Подключение по приватному ключу ===

* <code>private_key_file</code>: путь к приватному ключу (например, <code>/root/.ssh/id_rsa</code>).
* Если ключ защищён парольной фразой:
** Заполните <code>private_key_passphrase</code>.
** Поле <code>password</code> остаётся обязательным по схеме, но при наличии <code>private_key_file</code> + <code>private_key_passphrase</code> используется парольная фраза ключа.

KA-monitor

2026-08-25T22:43:51Z

IKuznetsov: Новая страница: «= Расширение dt-monitor для Ключ-АСТРОМ = '''dt-monitor''' — плагин для сбора данных кластера. Для Ключ-АСТРОМ используется вариант '''ka-monitor'''. == Возможности расширения == * Сбор метрик потребления лицензий и активности пользователей кластера. * Запуск по расписанию (...»

= Расширение dt-monitor для Ключ-АСТРОМ =
'''dt-monitor''' — плагин для сбора данных кластера. Для Ключ-АСТРОМ используется вариант '''ka-monitor'''.

== Возможности расширения ==

* Сбор метрик потребления лицензий и активности пользователей кластера.
* Запуск по расписанию (например, еженедельно) с настраиваемым временем.
* Проверка '''TLS/SSL'''-сертификата кластера (можно отключить для самоподписанных сертификатов).
* Аутентификация через токен кластера с заданными областями доступа.
* Отправка собранных метрик в Ключ-АСТРОМ для дальнейшего анализа и отображения на дашбордах.

== Метрики ==
Собираются следующие метрики:

* Метрика потребления ЕА (ЕдиныйАгент)
* Метрика потребления ВИД (веб-интерфейсы данных)
* Метрика потребления ЦО (центр обработки)
* '''WAU''' — количество уникальных пользователей за неделю
* Количество сессий за неделю

== Требования и конфигурация ==

=== Обязательные настройки ===

* Желательно синхронизировать время в кластере и на хосте, где запущено расширение.
* Обязательно включить '''Аудит логов''': '''Настройки''' → '''Предпочтения''' → '''Лог событий аудита''' → '''Включить'''.
* Параметр '''Verify TLS/SSL''' отвечает за проверку сертификата кластера. Выключите его, если кластер использует самоподписанный сертификат.
* '''Scope''' токена кластера должен включать: '''Управление токенами кластера''' и '''API поставщика сервисов'''.

=== Пример конфигурации ===
Пример настройки для сбора данных по понедельникам в 11:30:

[[Файл:(4CF724F2-6258-4D2E-B78B-7E4B13F013B9).png|граница|669x669пкс]]

* Запуск по расписанию: включено.
* День недели: понедельник.
* Время: 11:30.
* Verify TLS/SSL: в зависимости от сертификата.

== Release Notes ==

=== Версия 0.3.0 ===

* Исправлена ошибка, из-за которой плагин запускался чаще, чем раз в неделю.
* Добавлен запуск по расписанию.
* Мелкие исправления внешнего вида дашборда.

Файл:(4CF724F2-6258-4D2E-B78B-7E4B13F013B9).png

2026-08-25T22:43:32Z

IKuznetsov:

(4CF724F2-6258-4D2E-B78B-7E4B13F013B9)

DB Query

2026-08-25T22:41:08Z

IKuznetsov: Новая страница: «= Расширение DB Query для Ключ-АСТРОМ = Расширение '''DB Query''' предназначено для мониторинга баз данных через выполнение пользовательских запросов и извлечения метрик. Оно поддерживает основные реляционные СУБД и '''MongoDB''', позволяя превращать результаты запр...»

= Расширение DB Query для Ключ-АСТРОМ =
Расширение '''DB Query''' предназначено для мониторинга баз данных через выполнение пользовательских запросов и извлечения метрик. Оно поддерживает основные реляционные СУБД и '''MongoDB''', позволяя превращать результаты запросов в метрики и измерения Ключ-АСТРОМ.

== Возможности расширения ==

* Подключение к базам данных '''PostgreSQL''', '''Oracle''', '''MySQL''', '''MariaDB''', '''SQL Server''' и '''MongoDB'''.
* Выполнение произвольных запросов ('''SQL''' или '''MongoDB'''-команд) и преобразование результатов в метрики и размерности.
* Настройка интервала выполнения запросов и расписания запуска по времени.
* Ограничение времени выполнения запроса.
* Проверка доступности подключения лёгким запросом ('''fastcheck''').
* Создание сущностей '''DB Query Host''' и '''DB Query Endpoint''' с топологическими связями.
* Готовый обзорный дашборд.
* Отображение ошибок подключения и выполнения в статусе расширения.

== Поддерживаемые базы данных ==

* '''PostgreSQL'''
* '''Oracle'''
* '''MySQL'''
* '''MariaDB'''
* '''SQL Server'''
* '''MongoDB'''

== Требования ==

* АктивныйШлюз с включённым выполнением расширений (или ЕдиныйАгент с '''EEC''').
* Сетевой доступ к базе данных.
* Учётные данные с правами на выполнение запросов.
* Для '''MongoDB''' — зависимость '''pymongo''' (включена в расширение).

== Конфигурация ==
Конфигурация каждого endpoint задаётся через '''JSON''' со следующими основными полями:

* <code>name</code> — имя endpoint.
* <code>db_name</code> — имя базы данных.
* <code>query</code> — запрос ('''SQL''' или '''JSON''' для '''MongoDB''').
* <code>metric_columns</code> — колонки, значения которых станут метриками.
* <code>dimension_columns</code> — колонки, значения которых станут измерениями.
* <code>Query interval (minutes)</code> — интервал выполнения в минутах.
* <code>Query timeout (minutes)</code> — ограничение времени выполнения (по умолчанию 10 минут).
* <code>Execution times</code> — конкретное время запуска ('''HH:MM''', можно несколько через запятую); если пусто, используется интервал.

== Метрики ==
Расширение отправляет служебную метрику <code>ru.ruscomtech.dbquery.host.status</code> для отображения хоста на обзорном дашборде.

== История версий ==

=== Версия 0.2.30 ===

* Лимит поля '''Query''' увеличен до 10000 символов.
* Добавлено поле '''Query timeout (minutes)''' для ограничения времени выполнения одного запроса. По умолчанию 10 минут; применяется для '''Postgres''', '''Oracle''', '''MySQL''', '''MariaDB''', '''SQLServer''' и '''MongoDB'''.
* Добавлено поле '''Execution times''' для запуска конкретного endpoint по расписанию. Формат: '''HH:MM''' по локальному времени хоста/АктивногоШлюза; несколько значений через запятую, например <code>09:00,18:30</code>.
* Запуск по '''Execution times''' выполняется в окне от указанного времени до +5 минут. Если поле пустое, endpoint выполняется по старому правилу через '''Query interval (minutes)'''.
* <code>fastcheck()</code> проверяет подключение к БД лёгким запросом: '''MongoDB''' — <code>ping</code>, '''Oracle''' — <code>SELECT 1 FROM dual</code>, '''MySQL/MariaDB/SQLServer''' — <code>SELECT 1</code>, '''Postgres''' — <code>SELECT 1</code>.
* Ошибки выполнения '''query''' больше не отображаются как '''OK''': последняя ошибка endpoint сохраняется и возвращается в '''runtime status'''.
* Ошибки подключения, авторизации и конфигурации мапятся в соответствующие '''StatusValue'''; ошибка '''Oracle''' <code>DPY-6005: cannot connect to database</code> классифицируется как <code>DEVICE_CONNECTION_ERROR</code>.
* Исправлена ошибка '''UnboundLocalError''' после неуспешного подключения к '''MongoDB''' или другой БД.
* Русифицированы описания полей.
* Добавлена служебная метрика <code>ru.ruscomtech.dbquery.host.status</code> для отображения '''DB Query Host''' на '''overview dashboard'''.
* Плитка '''DB Query Host''' теперь содержит '''Data Explorer''' query и показывает хосты по <code>device.address</code>.
* Метрика <code>ru.ruscomtech.dbquery.host.status</code> отправляется в каждом цикле <code>query()</code> для валидной конфигурации, даже если endpoint пропущен по расписанию или интервалу.

=== Версия 0.2.11 ===

* Добавлена поддержка '''MongoDB'''.
* Добавлена зависимость '''pymongo'''.
* Для '''MongoDB''' поле '''query''' принимает '''JSON''':
** raw '''MongoDB''' command для выполнения через <code>db.command(...)</code>;
** wrapper с <code>collection</code> и <code>operation</code>.
* Поддержанные операции '''MongoDB''': <code>find</code>, <code>find_one</code>, <code>count_documents</code>, <code>estimated_document_count</code>, <code>aggregate</code>.
* Поля <code>dimension_columns</code> и <code>metric_columns</code> работают для '''MongoDB''' по возвращаемым полям документов, так же как для '''SQL'''-колонок.

=== Версия 0.2.10 ===

* Добавлены '''topology''' entities для '''DB Query Host''' и '''DB Query Endpoint'''.
* Добавлен '''overview dashboard'''.

=== Версия 0.2.1 ===

* Добавлена поддержка '''Oracle'''.
* Добавлена функция ожидания после каждого выполнения.

== Примеры конфигурации ==

=== Пример MongoDB count ===
<pre>
{
"name": "mongo_orders_open",
"db_name": "mydb",
"query": "{\"collection\":\"orders\",\"operation\":\"count_documents\",\"filter\":{\"status\":\"open\"}}",
"metric_columns": "count"
}
</pre>

=== Пример MongoDB aggregate ===
<pre>
{
"name": "mongo_orders_by_status",
"db_name": "mydb",
"query": "{\"collection\":\"orders\",\"operation\":\"aggregate\",\"pipeline\":[{\"$group\":{\"_id\":\"$status\",\"total\":{\"$sum\":1}}}]}",
"dimension_columns": "_id",
"metric_columns": "total"
}
</pre>

Cassandra

2026-08-25T22:37:07Z

IKuznetsov: Новая страница: «= Мониторинг Cassandra в Ключ-АСТРОМ = Инструкция по настройке расширения '''Apache Cassandra JMX'''. Расширение подключается к серверу '''Cassandra''' через '''JMX''' ('''Java Management Extension''') и собирает метрики кластера, нодов, кэшей, пулов потоков и исключений. Обеспечивает полную наб...»

= Мониторинг Cassandra в Ключ-АСТРОМ =
Инструкция по настройке расширения '''Apache Cassandra JMX'''.

Расширение подключается к серверу '''Cassandra''' через '''JMX''' ('''Java Management Extension''') и собирает метрики кластера, нодов, кэшей, пулов потоков и исключений. Обеспечивает полную наблюдаемость за производительностью и работоспособностью СУБД '''Cassandra'''.

== Возможности расширения ==

=== Что делает ===

* Подключается к серверу '''Cassandra''' через '''JMX'''.
* Собирает метрики кластера и отдельных нодов: исключения, неудачные запросы, задержки операций чтения/записи, загрузка хранилища, состояние пулов потоков и сборка мусора '''JVM'''.
* Создает сущности '''Cluster''' и '''Node''' со связями между ними.
* Предоставляет готовый дашборд «Cassandra JMX Overview» для визуализации ключевых метрик.
* Автоматически обнаруживает хосты с '''Cassandra''' при включении глобального мониторинга.

=== Что не делает ===

* Не устанавливает и не настраивает '''Cassandra'''.
* Не собирает метрики со стороны клиентских приложений (только серверная часть).
* Не выполняет трассировку запросов между приложениями (для этого требуется ЕдиныйАгент на клиентских приложениях).
* Не подключается через '''Management API''' или '''HTTP''' — только через '''JMX'''.

== Предварительные условия ==

# Версия '''Cassandra''': 2.xx или выше.
# Версия Ключ-АСТРОМ: 1.308 или выше.
# На хосте с '''Cassandra''' установлен ЕдиныйАгент Ключ-АСТРОМ, контроллер выполнения расширений ('''EEC''') включен.
# Подготовлен пакет расширения (<code>.zip</code>) для загрузки в Расширения — либо расширение уже доступно в каталоге Расширений.
# '''JMX'''-порт '''Cassandra''' (по умолчанию 7199) должен быть доступен для ЕдиногоАгента.
# Для сбора метрик с удаленных нодов требуется настроенный АктивныйШлюз с сетевым доступом к '''JMX'''-портам '''Cassandra'''.

== Рекомендация по подключению ==
При локальном мониторинге (ЕдиныйАгент на том же хосте, что и '''Cassandra''') расширение подключается к '''JMX''' через loopback-адрес. Для удаленного сбора убедитесь, что АктивныйШлюз имеет сетевой доступ к нодам '''Cassandra''' и порт '''JMX''' (7199) открыт.

Важно: Расширение использует '''JMX''' для сбора метрик. Убедитесь, что '''JMX'''-сервер '''Cassandra''' включен и настроен для удаленного доступа при необходимости.

== Шаг 1. Включение глобального мониторинга Cassandra ==
Для автоматического обнаружения хостов с '''Cassandra''':

# Откройте веб-интерфейс Ключ-АСТРОМ.
# Перейдите в '''Настройки''' → '''Мониторинг''' → '''Отслеживаемые технологии'''.
# В списке '''Поддерживаемые технологии''' найдите строку '''Cassandra JMX'''.
# Включите переключатель '''Cassandra JMX'''.

После включения ЕдиныйАгент будет автоматически обнаруживать процессы '''Cassandra''' на всех хостах.

== Шаг 2. Загрузка расширения в Расширения ==
Если расширение еще не установлено в окружении:

# Откройте '''Расширения''' → раздел '''Extensions'''.
# Нажмите '''Загрузить расширение''' и выберите загрузку пользовательского/custom-расширения.
# Укажите файл <code>.zip</code>-пакета расширения '''Apache Cassandra JMX'''.
# Дождитесь успешной проверки подписи и загрузки.
# Активируйте нужную версию расширения для окружения.

Если расширение уже присутствует в Расширениях окружения, откройте его карточку и убедитесь, что требуемая версия активна.

После активации перейдите на вкладку '''Конфигурация''' — можно добавлять конфигурацию мониторинга.

== Шаг 3. Выбор источника мониторинга ==
Для типичного сценария «ЕдиныйАгент на хосте с Cassandra» выберите нужный хост. Убедитесь, что у хоста '''EEC''' отображается как «Включено».

== Контрольный список ==
{| class="wikitable"
!№
!Пункт
|-
|1
|На сервере '''Cassandra''' включен и доступен '''JMX'''-сервер (порт 7199).
|-
|2
|Включен глобальный мониторинг '''Cassandra JMX''' в '''Настройки''' → '''Отслеживаемые технологии'''.
|-
|3
|Пакет расширения загружен в Расширения и активирован.
|-
|4
|Конфигурация мониторинга добавлена и включена, состояние '''Ok'''.
|-
|5
|Выбран корректный режим (локально / удаленно).
|-
|6
|Указаны корректные параметры подключения (порт '''JMX''', при необходимости — учетные данные).
|-
|7
|На дашборде и в сущностях отображаются метрики '''Cassandra'''.
|}

== Возможные проблемы ==
{| class="wikitable"
!Симптом
!Что проверить
|-
|Состояние конфигурации не '''Ok'''
|Сетевая доступность '''JMX'''-порта '''Cassandra''' (7199) с хоста ЕдиногоАгента/АктивногоШлюза, статус '''EEC'''. Убедитесь, что '''JMX'''-сервер запущен.
|-
|Ошибка авторизации
|Проверьте логин и пароль для '''JMX'''-аутентификации. Убедитесь, что пользователь имеет права.
|-
|Нулевые значения метрик
|Ожидаемо при отсутствии нагрузки или если расширение еще не завершило первый цикл сбора.
|-
|Требуется удаленный сбор
|Группа АктивныхШлюзов с сетевым доступом к '''JMX'''-портам '''Cassandra'''. Убедитесь, что '''JMX'''-сервер настроен для удаленного доступа.
|}

ClickHouse

2026-08-25T22:33:16Z

IKuznetsov: Новая страница: « = Расширение Ключ-АСТРОМ для мониторинга ClickHouse = Python-расширение '''Extensions 2.0''' для мониторинга серверов '''ClickHouse''' через '''HTTP'''-интерфейс. == Требования == * АктивныйШлюз с включённым выполнением расширений. * С АктивногоШлюза должен быть доступен '''HTTP'''- или '...»

= Расширение Ключ-АСТРОМ для мониторинга ClickHouse =
Python-расширение '''Extensions 2.0''' для мониторинга серверов '''ClickHouse''' через '''HTTP'''-интерфейс.

== Требования ==

* АктивныйШлюз с включённым выполнением расширений.
* С АктивногоШлюза должен быть доступен '''HTTP'''- или '''HTTPS'''-интерфейс '''ClickHouse'''.
* Пользователь '''ClickHouse''' с правами чтения системных таблиц мониторинга.

== Какие данные собираются ==
Коллектор получает все числовые значения из следующих таблиц:
{| class="wikitable"
!Таблица ClickHouse
!Префикс метрик Ключ-АСТРОМ
!Назначение
|-
|<code>system.metrics</code>
|<code>clickhouse.metrics.*</code>
|Текущие значения: выполняемые запросы, слияния, память и другие показатели
|-
|<code>system.events</code>
|<code>clickhouse.events.*</code>
|Накопительные счётчики запросов, строк, байтов, '''CPU''' и операций ввода-вывода
|-
|<code>system.asynchronous_metrics</code>
|<code>clickhouse.asynchronous.*</code>
|'''CPU''', память, '''MergeTree''' и другие системные показатели
|}
Дополнительно расширение отправляет:
{| class="wikitable"
!Метрика
!Описание
|-
|<code>clickhouse.topology</code>
|Служебная метрика для создания сущности хоста
|-
|<code>clickhouse.host.availability</code>
|Результат проверки <code>/ping</code>: 1 — доступен, 0 — недоступен
|-
|<code>clickhouse.host.replica_status</code>
|Результат <code>/replicas_status</code>: 1 — реплика исправна, 0 — недоступна или отстаёт
|-
|<code>clickhouse.host.uptime</code>
|Время работы сервера в секундах
|}
Метрика <code>OSIOWaitMicroseconds</code> формируется '''ClickHouse''' только при включённом '''Linux''' <code>task_delayacct</code>.

При необходимости включите его на сервере '''ClickHouse''':<pre>
sudo sysctl -w kernel.task_delayacct=1
</pre>Для постоянного применения добавьте параметр в конфигурацию <code>sysctl</code> согласно правилам вашей '''ОС'''.

== Создание пользователя ClickHouse ==
Пример пользователя с минимальными правами чтения:<pre>
CREATE USER astromkey
IDENTIFIED WITH sha256_password BY 'ЗАМЕНИТЕ_ПАРОЛЬ';

GRANT SELECT ON system.metrics TO astromkey;
GRANT SELECT ON system.events TO astromkey;
GRANT SELECT ON system.asynchronous_metrics TO astromkey;
</pre>

Навигация 2.0

2026-08-19T18:56:31Z

IKuznetsov:

'''''[[Применение Ключ-АСТРОМ]] / [https://doc.ruscomtech.ru/index.php/Применение_Ключ-АСТРОМ#.D0.9D.D0.B0.D0.B2.D0.B8.D0.B3.D0.B0.D1.86.D0.B8.D1.8F_2.0 Навигация 2.0]'''''

== Начало работы с Ключ-АСТРОМ ==

* [[Что такое Ключ-АСТРОМ|'''Что такое Ключ-АСТРОМ''']]
* '''[[Мониторинг Среды|Мониторинг среды]]'''
* [[Навигация по платформе Ключ-АСТРОМ|'''Навигация по платформе Ключ-АСТРОМ''']]
** [[Страницы ошибок HTTP в среде Ключ-АСТРОМ]]
** [[Обозначение порядка величин]]
** [[Требования к веб-интерфейсу Ключ-АСТРОМ|Требования к веб-интерфейсу]]

* '''[[Проектирование платформ]]'''

== Развертка Ключ-АСТРОМ ==

* [[АктивныйШлюз Ключ-АСТРОМ|'''АктивныйШлюз Ключ-АСТРОМ''']]
** [[Цели АктивногоШлюза]]
*** [[Направление трафика ЕдиногоАгента]]
*** [[Запуск синтетических мониторов из частных локаций]]
*** [[Установка модуля zRemote для мониторинга z/OS]]
** [[Схемы подключения АктивныхШлюзов]]
** [[Установка АктивногоШлюза]]
*** [[Установка АктивногоШлюза на Linux|Linux]]
*** [[Установка АктивногоШлюза на Windows|Windows]]
**** [[Инструкция по установке компонента АктивныйШлюз с синтетикой на платформу РЕД ОС]]
**** [[Инструкция по установке компонента АктивныйШлюз с синтетикой на платформу РЕД ОС без Интернета]]
** [[Конфигурация АктивногоШлюза]]
*** [[Параметры АктивногоШлюза]]
*** [[Настройка прокси АктивногоШлюза]]
*** [[Обратный прокси (балансировщик загрузки) для АктивногоШлюза]]
*** [[Пользовательский SSL-сертификат для АктивногоШлюза]]
*** [[Доверенные корневые сертификаты для АктивногоШлюза]]
*** [[Конфигурация шифра для АктивногоШлюза]]
*** [[Развертывание АктивногоШлюза в нескольких средах]]
*** [[Директории АктивногоШлюза]]
** [[Образ АтивногоШюза в контейнере]]
*** [[Различия АктивныхШлюзов]]
*** [[Конфигурация АктивныхШлюзов]]
*** [[Вместимость АктивныхШлюзов]]
** [[Группы АктивныхШлюзов]]
** [[Диагностика АктивногоШлюза]]
** [[Самостоятельный мониторинг АктивногоШлюза]]
** Операции с АктивнымиШлюзами
*** [[Запуск/остановка/перезапуск АктивногоШлюза]]
*** [[Обновление АктивногоШлюза]]
*** [[Удаление АктивногоШлюза]]
** [[Безопасность АктивногоШлюза]]
*[[ЕдиныйАгент Ключ-АСТРОМ|'''ЕдиныйАгент Ключ-АСТРОМ''']]
** [[ЕдиныйАгент требования к памяти|Требования к памяти для ЕдиногоАгента]]
** [[Установка и эксплуатация ЕдиногоАгента]]
*** [[Установка ЕдиногоАгента на AIX|AIX]]
*** [[Установка ЕдиногоАгента на Linux|Linux]]
*** [[Установка ЕдиногоАгента на Solaris|Solaris]]
*** [[Установка ЕдиногоАгента на Windows|Windows]]
*** z/OS
****[[Установка ЕдиногоАгента на Z/OS|Установка]]
****[[Операции ЕдиногоАгента на Z/OS|Операции]]
****[[Мониторинг ЕдиногоАгента на Z/OS|Мониторинг]]
** [[Возможности ЕдиногоАгента]]
** [[Обзор работоспособности ЕдиногоАгента|Состояние ЕдиногоАгента]]
**[[Безопасность ЕдиногоАгента]]
** [[Обновление ЕдиногоАгента]]
** [[Оркестровка развертывания ЕдиногоАгента|Оркестрация развертывания ЕдиногоАгента]]
*** [[Установка ЕдиногоАгента с помощью Ansible|Ansible]]
** [[ЕдиныйАгент настройка через интерфейс командной строки|Интерфейс командной строки ЕдиногоАгента]]
** Поиск неисправностей ЕдиногоАгента
*** [[Устранение неполадок при установке ЕдиногоАгента|Проблемы с установкой]]
*** [[Устранение неполадок при мониторинге ЕдиногоАгента|Проблемы прерывания мониторинга]]
*** [[Устранение неполадок глубокого мониторинга ЕдиногоАгента|Проблемы глубокого мониторинга]]
*** [[Диагностика ЕдиногоАгента]]
** [[Механизм устаревания файлов ЕдиногоАгента]]
*'''[[Расширение|Расширения]]'''
** [[О расширениях]]
** Расширенная конфигурация
*** [[Специальная конфигурация профиля производительности|Специальный профиль производительности]]
*** [[Настройка данных с помощью расширений|Настройте данные с помощью расширений]]
*** [[Распространение пользовательских дашбордов с расширениями|Распространение пользовательских дашбордов]]
*** [[Пользовательская конфигурация контроллера выполнения расширений]]
*** [[Оповещения о расширениях|Оповещение о расширениях]]
** [[Изучите поддерживаемые расширения]]
*** [[Расширение Apache Kafka]]
*** [[Расширение Microsoft SQL Server]]
*** [[Расширение IBM MQ]]
***[[Расширение UPS Device]]
***[[Расширение Oracle Database]]
***[[Расширение PostgreSQL]]
***[[Расширение Redis]]
***[[Расширение Elasticsearch]]
***[[Расширение Hadoop]]
***[[Расширение NVIDIA]]
*** Источники данных
**** [[Управление расширениями SNMP|SNMP]]
**** [[Управление расширениями WMI|WMI]]
**** [[Расширения SQL|SQL]]
***** [[Управление расширениями базы данных Oracle|Oracle]]
***** [[Управление расширениями Microsoft SQL Server|Microsoft SQL Server]]
***** [[Управление расширениями PostgreSQL|PostgreSQL]]
***** [[Управление расширениями MySQL|MySQL]]
***** [[Управление расширениями базы данных Snowflake|Snowflake]]
***** [[Управление расширениями базы данных SAP Hana|SAP Hana DB]]
***** [[Управление расширениями базы данных IBM|IBM DB2]]
** [[Управление расширениями]]
** [[Ограничения расширений|Ограничения]]
** [[Поиск неисправностей расширений|Поиск неисправностей]]
** [[Разработка собственных расширений]]
*** [[Дополнение для VS Code]]
**** [[Начало работы с VS Code|Начало работы]]
****[[Поддержка разработки для VS Code|Поддержка разработки]]
****[[Справочник команд для VS Code|Справочник команд]]
****[[Настройки для VS Code|Настройки]]
****[[Специализированные представления для VS Code|Специализированные представления]]
****[[Поиск неисправностей VS Code|Поиск неисправностей]]
****Руководства по применению
*****[[Создание расширений Python]]
*****[[Перенос расширений Python]]
*****[[Перенос расширений JMX]]
*** [[Расширения YAML-файла|Расширение файла YAML]]
*** [[Расширения знаков]]
*** [[Создание пользовательских расширений]]
*** Источники данных
**** [[Источник данных SNMP|SNMP]]
***** [[Справка о источнике данных SNMP|Справка]]
***** [[Источник данных SNMP-traps|SNMP-Traps]]
***** Поиск неисправностей
**** [[Источник данных JMX|JMX]]
***** [[Справка о источнике данных JMX|Справка]]
**** [[Источник данных Prometheus|Prometheus]]
***** [[Справка о источнике данных Prometheus|Справка]]
**** [[Источник данных SQL|SQL]]
***** [[Конфигурация IBM DB2|IBM DB2]]
***** [[Конфигурация JDBC|JDBC]]
***** [[Конфигурация Microsoft SQL|Microsoft SQL]]
***** [[Конфигурация MySQL|MySQL]]
***** [[Конфигурация Oracle Database|База данных Oracle]]
***** [[Конфигурация PostgreSQL|PostgreSQL]]
***** [[Конфигурация SAP Hana Database|База данных SAP Hana]]
***** [[Конфигурация Snowflake Database|База данных Snowflake]]
***** [[Справка о источнике данных SQL|Справка]]
**** [[Источник данных WMI|WMI]]
***** [[Пособие по источнику данных WMI]]
***** [[Справка о источнике данных WMI|Справка]]
**** [[Источник данных Python SDK|Python SDK]]
*'''[[OpenTelemetry]]'''
** [[Использование OpenTelemetry с Ключ-АСТРОМ|Начало работы]]
*** [[Экспорт с помощью OTLP]]
*** [[Конфигурация Ключ-АСТРОМ]]
*** Логи
**** [[Прием логов OpenTelemetry|Прием данных]]
*** Метрики
**** [[Настройка приема метрик OpenTelemetry|Настройка]]
**** [[Ограничения метрик OpenTelemetry|Ограничения]]
**** [[Прием метрик OpenTelemetry|Прием данных]]
***** [[Переход с экспорта метрик Ключ-АСТРОМ OpenTelemetry на экспорт метрик OTLP|Переход на экспорт метрик OTLP]]
*** Трассировки
**** [[Прием трассировок OpenTelemetry|Прием данных]]
**** [[Трассировки OpenTelemetry с помощью ЕдиногоАгента]]
** [[Collector Ключ-АСТРОМ|Collector]]
***[[Развертывание Collector|Развертывание]]
***[[Настройка Collector|Настройка]]
***[[Варианты использования Collector|Варианты использования]]
****[[Пакеты запроса OTLP]]
****[[Внедрение FluentD|FluentD]]
****[[Преобразование OTLP gRPC|gRPC в HTTP]]
****[[Вычисление сводки гистограмм|Гистограмма]]
****[[Прием данных от Jaeger|Jaeger]]
****Kubernetes
***** [[Обогащение из Kubernetes|Обогащение]]
***** [[Мониторинг Kubernetes|Мониторинг]]
***** [[Логи приема pod|Логи Pod]]
****[[Получение данных из файла логов|Файлы логов]]
****[[Маскировка конфиденциальных данных|Маскировка данных]]
****[[Применение ограничения памяти|Ограничение памяти]]
****[[Отправка данных на несколько бэкэндов|Несколько бэкэндов]]
****[[Расширение с помощью ЕдиногоАгента]]
****[[Извлечение данных из Prometheus|Prometheus]]
****[[Примеры данных]]
****[[Получение данных из StatsD|StatsD]]
****[[Прием пакетов NetFlow|NetFlow]]
****[[Сбор данных системных логов с помощью OpenTelemetry Collector|Системные логи]]
****[[Преобразование и фильтрация]]
****[[Прием данных из Zipkin|Zipkin]]
***[[Системные требования]]
***[[Самоконтроль OpenTelemetry Collector|Самоконтроль]]
***[[Ссылки Collector|Ссылки]]
***[[Масштабирование Collector|Масштабирование]]
** [[Инструментарий OpenTelemetry|Инструментарий]]
***[[Java OpenTelemetry|Java]]
**** [[Автоматическое внедрение OpenTelemetry в Java-приложение|Автоматическое внедрение]]
**** [[Ручное внедрение OpenTelemetry в Java-приложение|Ручное внедрение]]
*** [[PHP OpenTelemetry|PHP]]
**** [[Автоматическое внедрение OpenTelemetry в PHP-приложение|Автоматическое внедрение]]
**** [[Ручное внедрение OpenTelemetry в PHP-приложение|Ручное внедрение]]
*** [[Python OpenTelemetry|Python]]
**** [[Автоматическое внедрение OpenTelemetry в Python-приложение|Автоматическое внедрение]]
**** [[Ручное внедрение OpenTelemetry в Python-приложение|Ручное внедрение]]
***[[C++ OpenTelemetry|C++]]
***[[.NET OpenTelemetry|.NET]]
***[[Elixir OpenTelemetry|Elixir]]
***[[Erlang OpenTelemetry|Erlang]]
***[[Go OpenTelemetry|Go]]
***[[JavaScript (Node.js) OpenTelemetry|JavaScript (Node.js)]]
***[[Ruby OpenTelemetry|Ruby]]
***[[Rust OpenTelemetry|Rust]]
** Интеграция платформ и технологий
***[[Настройка трассировки OpenTelemetry с помощью Istio|Трассировки с помощью Istio]]
***[[Настройка трассировки OpenTelemetry с помощью Envoy|Трассировки с помощью Envoy]]
** [[Обеспечение успеха с OpenTelemetry|Лучшие практики]]
*[[Настройка Ключ-АСТРОМ в Kubernetes|'''Kubernetes''']]
** [[Быстрый старт Kubernetes|Быстрый старт]]
** [[Развертывание Kubernetes|Развертывание]]
*** [[Начало работы с полной наблюдаемостью Kubernetes (развертывание полного стека в облаке)|Полная наблюдаемость Kubernetes]]
*** [[Начало работы с наблюдаемостью Kubernetes|Наблюдаемость Kubernetes]]
*** [[Начало работы с наблюдаемостью приложений|Наблюдаемость приложения]]
*** [[Токены доступа и разрешения]]
*** [[Поддерживаемые дистрибутивы Kubernetes|Дистрибутивы]]
*** [[Поиск неисправностей Kubernetes|Поиск неисправностей]]
*** Другое
**** [[Начало работы с полной наблюдаемостью (классическое развертывание полного стека) Kubernetes|Классический мониторинг полного стека]]
**** [[Начало мониторинга хоста Kubernetes|Мониторинг хоста]]
**** [[Наблюдаемость приложения с помощью внедрения Pod во время выполнения]]
**** [[Наблюдаемость приложения посредством внедрения во время сборки контейнера]]
**** [[Настройка мониторинга платформы Kubernetes с помощью DaemonSet|Полная наблюдаемость с Daemonset]]
**** [[Развертывание АктивногоШлюза как StatefulSet]]
**** [[Развертывание АктивногоШлюза на виртуальной машине]]
** Как это работает
*** [[Мониторинг платформы Kubernetes]]
*** [[Наблюдаемость приложения]]
*** [[Полная наблюдаемость]]
*** Компоненты
**** [[Ключ-АСТРОМ Operator]]
*** Другие режимы развертывания
**** [[Классический полностековый мониторинг]]
**** [[Мониторинг хоста]]
** Руководства
*** Руководства по переходу
**** [[Руководства по переходу для DynaKube apiVersions]]
**** [[Переход с классического полнофункционального стека на облачный полнофункциональный стек|Переход с классического на полнофункциональный облачный режим]]
**** [[Переход с классического полнофункционального режима на режим мониторинга приложений]]
**** [[Переход из облачного полного стека в режим мониторинга приложений]]
**** [[Перенос Ключ-АСТРОМ Operator в новую среду]]
**** [[Переход с ЕдиныйАгент Operator на Ключ-АСТРОМ Operator|Переход на Ключ-АСТРОМ Operator]]
**** [[Переход из манифестов в Helm для установки Ключ-АСТРОМ Operator|Переход из манифестов в Helm]]
*** Развертывание и настройка
**** [[Развертывание Ключ-АСТРОМ вместе с Istio]]
**** [[Управление развертываниями Ключ-АСТРОМ с помощью GitOps]]
***** [[Настройка извлечения образа узла]]
**** Мониторинг и инструментарий
***** [[Инструментарий ingress-nginx]]
***** [[Мониторинг API Kubernetes]]
***** [[Настройка мониторинга пространств имен и модулей]]
**** Управление ресурсами
***** [[Ограничения ресурсов Ключ-АСТРОМ Operator]]
***** [[Тайм-ауты тестов]]
**** Обновления и обслуживание
***** [[Обновление или удаление Ключ-АСТРОМ Operator]]
***** [[Автоматическое обновление Ключ-АСТРОМ Operator]]
***** [[Настройка автоматического обновления компонентов Ключ-АСТРОМ Operator]]
**** [[Настройка постоянного хранилища для АктивногоШлюза]]
**** [[Установка Operator в режиме FIPS]]
*** Настройки сети и безопасности
**** [[Конфигурации сети]]
***** [[Использование сетевых зон в Kubernetes]]
**** Настройки безопасности
***** [[Включение AppArmor для повышения безопасности|Включение AppArmor]]
***** [[Включение профиля seccomp для контейнеров инициализации Ключ-АСТРОМ|Настройка профиля seccomp для initContainer]]
***** [[Применение стандартов безопасности подов]]
***** [[Дополнительные конфигурации OpenShift]]
***** [[Ротация токенов]]
**** Расширенные конфигурации безопасности
***** [[Импорт сертификатов API Kubernetes]]
*** [[Реестры контейнеров]]
**** [[Использование публичного реестра]]
**** [[Использование частного реестра]]
**** [[Хранение образов Ключ-АСТРОМ в частных реестрах]]
**** [[Проверка подписей образов Ключ-АСТРОМ]]
*** Высокая доступность
**** [[Режим высокой доступности для развертываний Helm]]
**** [[Использование priorityClass для критически важных компонентов Ключ-АСТРОМ]]
**** [[Настройка минимального времени между запросами]]
**** [[Настройка политики отказов]]
*** Метаданные и автоматизация
**** [[Настройка распространения меток сборки]]
**** [[Добавление файла пользовательских свойств]]
**** [[Настройка директории расширений]]
** Интеграции
***[[Включение конечных точек приема телеметрии Ключ-АСТРОМ]]
*'''Другие контейнерные платформы'''
** [[Настройка Ключ-АСТРОМ на Cloud Foundry|Cloud Foundry]]
*** [[Развертывание релиза BOSH для комплексного мониторинга в Cloud Foundry|Развертывание релиза BOSH для комплексного мониторинга]]
*** [[Развертывание ЕдиногоАгента в Cloud Foundry для мониторинга только приложений|Развертывание ЕдиногоАгента в Cloud Foundry]]
*** [[Развертывание ЕдиногоАгента на платформе SAP BTP для мониторинга только приложений|Развертывание ЕдиногоАгента на платформе SAP BTP]]
*** [[Свяжите свои платформы Cloud Foundry с Ключ-АСТРОМ]]
*** [[Установка Ключ-АСТРОМ Service Broker на дашборд Cloud Foundry|Установка Ключ-АСТРОМ Service Broker]]
*** [[Обновление ЕдиногоАгента в Cloud Foundry|Обновление ЕдиногоАгента]]
*** [[Удаление ЕдиногоАгента из Cloud Foundry|Удаление ЕдиногоАгента]]
*** [[Устранение неполадок при развертывании ЕдиногоАгента в Cloud Foundry|Устранение неполадок]]
** [[Настройка Ключ-АСТРОМ на Docker|Docker]]
*** [[Настройка ЕдиногоАгента на контейнерах для мониторинга только приложений]]
*** [[Настройка Ключ-АСТРОМ ЕдиныйАгент как контейнер Docker]]
** [[Настройка Ключ-АСТРОМ на Heroku|Heroku]]
** [[Развертывание ЕдиногоАгента на Mesos/Marathon|Mesos/Marathon]]
** [[Привилегии ЕдиногоАгента для мониторинга контейнеров]]
*'''Другие технологии'''
** [[Расширение возможностей мониторинга метрик|Расширение метрик]]
*** Способы внедрения
**** [[Отправка метрик OpenTelemetry в Ключ-АСТРОМ|OpenTelemetry]]
**** [[Отправка метрик Micrometer в Ключ-АСТРОМ|Micrometer]]
**** [[Prometheus]]
***** [[Управление расширениями Prometheus|Расширения Prometheus]]
**** [[Отправка метрик StatsD в Ключ-АСТРОМ|StatsD]]
**** [[Отправка метрик Telegraf в Ключ-АСТРОМ|Telegraf]]
**** [[Интеграция скриптов метрик|Интеграция скриптов]]
**** [[API метрик ЕдиногоАгента]]
**** [[Расширения JMX]]
***** [[Настройка расширений JMX]]
*** Справка
**** [[Протокол приема метрических данных|Протокол приема]]
**** [[Пользовательские метаданные метрик]]
** [[Расширение возможностей мониторинга событий|Расширение событий]]
** Расширение логов
*** [[API для приема логов ЕдиногоАгента]]
** Расширение трассировок
*** [[ЕдиныйАгент SDK]]
*** [[OpenTracing]]
*** [[Настройки Span]]
** [[Расширение возможностей анализа пользовательского опыта и данных о поведении пользователей|Расширение возможности анализа пользовательского опыта и поведенческих данных]]
*** [[Внедрение инструментов мониторинга в ваше приложение с помощью Ключ-АСТРОМ OpenKit]]
*** [[Библиотеки Ключ-АСТРОМ OpenKit на GitHub]]
*** [[Методы API Ключ-АСТРОМ OpenKit]]
*** [[Ключ-АСТРОМ OpenKit logging]]
** [[Расширение топологии - Пользовательская модель топологии|Расширение топологии]]
*** [[Определение пользовательской топологии]]
*** [[Извлечение и отображение топологии событий]]
*** [[Общая топология сети]]
** [[Расширение данных]]
** Расширение веб-интерфейса Ключ-АСТРОМ
*** [[Единые страницы анализа]]
**** [[Справка о единых страницах анализа|Справка]]
**** [[Туториал по унифицированному анализу|Туториал]]
*** [[Расширение возможностей встроенных унифицированных страниц анализа]]
*'''Ключ-АСТРОМ Managed'''
**API кластера
*** API кластера v2
****АктивныйШлюз
*****Список АктивныхШлюзов кластера
*****Получить сведения об АктивномШлюзе кластера
****Токены кластера
***** [[Получение списка доступных токенов]]
***** [[Получение метаданных токена по запросу]]
***** [[Получение метаданных токена по ID]]
***** [[Создание нового токена]]
***** [[Обновление токена]]
***** [[Удаление токена]]
****Окружение
***** [[Получение списка всех окружений]]
***** [[Получение свойств окружения]]
***** [[Создание нового окружения]]
***** [[Обновление окружения]]
***** [[Удаление окружения]]
***** [[Создание токена владельца среды]]
****Лицензирование
***** [[Экспорт данных лицензии]]
**** Лог мониторинга
***** [[Включение Лога мониторинга]]
***** [[Получение состояния Лога мониторинга]]
***** [[Обновление событий в логах по кластерам]]
**** Удалённый доступ
***** [[Получение списка всех запросов удалённого доступа]]
***** [[Получение запроса удалённого доступа]]
***** [[Выдача удалённого доступа пользователю]]
***** [[Изменение статуса запроса удалённого доступа]]
**** Синтетические локации и ноды
***** [[Получение всех частных синтетических локаций (GET все локации)]]
***** [[Получение свойств указанных локаций (GET локация)]]
***** [[Создание новой частной синтетической локации (POST локация)]]
***** [[Обновление частной синтетической локации (PUT локация)]]
***** [[Удаление частной синтетической локации (DELETE локация)]]
***** [[Получение всех синтетических нод кластера (GET все ноды)]]
***** [[Получение свойств указанных нод кластера (GET нода)]]
**** Менеджмент пользовательских сессий
***** [[Получение конфигурации сессий]]
***** [[Обновление конфигурации сессий]]
***** [[Получение списка сессий]]
***** [[Удаление сессий указанного пользователя]]
*** [[Ротация токена через API]]
**Конфигурация
***[[Настраиваемые свойства Ключ-АСТРОМ Managed]]
***[[Добавление SSL-сертификата в TrustStore кластера Ключ-АСТРОМ Managed]]
***[[Настройка прокси|Могу ли я использовать прокси-сервер для доступа в Интернет?]]
***[[Настройка подключения к SMTP-серверу]]
***[[Конфигурация DNS для Ключ-АСТРОМ Managed]]
***[[Возможности ноды кластера]]
***[[Удалённый доступ к кластеру]]
***[[Настройка и управление сессиями пользователей]]
*** [[Правила сложности пароля]]
*** [[Настройка страницы входа]]
*** Настройка параметров кластера
*** [[Уведомления о работе кластера]]
*** [[Настройка экстренных контактов]]
*** [[Балансировка нагрузки]]
*** [[Настройка повышенных прав доступа]]
*** [[Периоды хранения данных]]
** Служба сведений о домене сбоя
*** [[Развертывание Managed с учетом стойки]]
*** [[Преобразование с использованием репликации с учетом стойки]]
*** [[Преобразование с использованием восстановления с учетом стойки]]
*** [[ВысокаяДоступность для дата-центров]]
*** [[ВысокаяДоступность — репликация нод между дата-центрами]]
*** [[ВысокаяДоступность — переустановка дата-центра]]
*** [[ВысокаяДоступность — восстановление дата-центра через резервную копию]]
*** [[ВысокаяДоступность — восстановление дата-центра через другой дата-центр]]
** Установка
*** [[Требования Managed к оборудованию]]
*** [[Требования Managed к системе]]
*** [[Рекомендации Managed к облачному развёртыванию]]
*** [[Порты ноды кластера]]
*** [[Включение или отключение SELinux]]
*** [[Установка кластера]]
*** [[Добавление новой ноды кластера]]
*** [[Настройка установки для Ключ-АСТРОМ Managed]]
*** [[Установка кластерного АктивногоШлюза]]
*** [[Установка собственного SSL-сертификата для ноды кластера]]
*** [[Настройка SSL-сертификата для кластерного АктивногоШлюза]]
*** Ключ-АСТРОМ офлайн
*** Ключ-АСТРОМ офлайн на защищенных системах
** [[API Контроллера Задач]]
*** [[Создание клиентского SSO]]
*** [[Создание SSO-токена]]
*** [[Получить список доступных пакетов и обновлений]]
*** [[Получить офлайн-пакет]]
*** Отменить регистрацию Контроллера Задач
** Эксплуатация
*** [[Перенос кластера]]
*** [[Управление окружениями мониторинга]]
*** [[Изменение местоположения хранилища]]
*** [[Применение патчей операционной системы к ноде]]
*** [[Обновление Ключ-АСТРОМ Managed]]
*** [[Обновление кластерного АктивногоШлюза]]
*** [[Резервное копирование и восстановление кластера]]
*** [[Примерный размер резервной копии кластера]]
*** [[Удаление ноды кластера]]
*** [[Удаление кластера]]
*** [[Диагностические архивы для установок Ключ-АСТРОМ Managed]]
*** [[Запуск/остановка/перезапуск ноды]]
*** [[Запуск/остановка/перезапуск кластера]]
*** [[Экспорт данных о лицензировании]]
** [[Самомониторинг]]
*** [[Среда локального самомониторинга]]
*** [[Среда удалённого самомониторинга]]
*** [[Среда частного самомониторинга]]

== Наблюдаемость Ключ-АСТРОМ ==

* '''[[Наблюдаемость ИИ и LLM]]'''
** [[Термины и понятия]]
** [[Начало работы с наблюдаемостью ИИ и LLM|Начать]]
*** [[OpenLLMetry]]
*** Примеры использования
**** [[Версионирование моделей ИИ и A/B-тестирование]]
**** [[Мониторинг наблюдаемости RAG‑конвейеров]]
**** [[Сквозная наблюдаемость приложений ИИ в Kubernetes]]
**** [[Наблюдаемость OpenAI]]
** Поставщики моделей и платформы
*** [[OpenAI]]
*** [[NVIDIA NIM]]
*** [[Ollama]]
*** [[Наблюдаемость TensorFlow Keras]]
** Системы оркестровки и оперативного проектирования
*** [[LangChain]]
** Безопасность, управление и организация трафика
*** [[Kong AI Gateway]]
*[[Наблюдаемость приложения|Наблюдаемость приложений]]
**[[Распределенные трассировки]]
*** [[Концепция распределенных трассировок|Концепция]]
*** Анализ
**** [[Начало работы с распределенными трассировками]]
**** [[Исправление диагностических ошибок топологии распределенных трассировок]]
**** [[Настройка трассировки между окружениями]]
*** Варианты использования
**** [[Детализация причин сбоев в работе служб трассировок|Детализация причин сбоев в работе служб]]
**** [[Использование расширения логов для отслеживания ошибок распределенных трассировок]]
**** [[Сегментация запросов для улучшения времени отклика]]
*** [[Адаптивное управление распределенными трассировками]]
**[[Многомерный анализ]]
*** [[Анализ исключений]]
*** [[Топ транзакций баз данных|Основные операторы базы данных]]
*** [[Топ веб-запросов|Самые популярные веб-запросы]]
***
**[[Профилирование и оптимизация]]
*** [[Анализ дампа памяти|Анализ дампов памяти]]
**** [[Настройка АктивногоШлюза (для хранения дампов памяти)|Настройка АктивногоШлюза]]
*** [[Аварийные завершения процессов|Анализ аварий]]
*** [[Непрерывное профилирование ЦП|Профилирование ЦП]]
*** [[Профилирование памяти]]
*** [[Непрерывный анализ потоков]]
**Сервисы
*** [[Анализ служб|Анализ сервисов]]
*** [[Детализация с учетом контекста]]
*** [[Анализ отдельных экземпляров серсиса]]
*** [[Время проведения анализа сервиса]]
*** [[Анализ распределения времени отклика и анализ выбросов|Распределение времени отклика и выбросы]]
*** [[Хотспоты сервиса с высоким временем отклика]]
*** [[Service flow|Поток обслуживания]]
**** [[Service flow метрики|Метрики]]
**** [[Service flow фильтры|Фильтры]]
*** [[Мониторинг ключевых запросов]]
*** [[Обратная трассировка сервиса]]
*Цифровой опыт
** Концепции RUM
*** [[Мониторинг реального пользователя|RUM]]
*** [[Приложения (RUM)|Приложения]]
*** [[Действия пользователя]]
*** [[События пользователя и ошибки]]
*** [[Пользовательские сеансы|Пользовательские сессии]]
*** [[Метрики действий пользователей|Метрики действий пользователя]]
*** [[Определение IP-адресов, геолокации и пользовательских агентов]]
*** [[Оценки и рейтинги Ключ-АСТРОМ]]
**** [[Рейтинг Apdex|Рейтинги Apdex]]
**** [[Оценка пользовательского опыта]]
** Веб-приложения
*** Первоначальная настройка
**** [[Разработка приложений для мониторинга реальных пользователей|Определение приложения]]
**** [[Настройка автоматического внедрения|Настроить автоматическое внедрение]]
**** [[Настройка мониторинга реальных пользователей без использования агентов|Настройка RUM без агентов]]
**** [[Выбор формата фрагмента|Выберите формат фрагмента]]
*** Дополнительная конфигурация
**** [[Управление версией JavaScript Мониторинга реального пользователя|Управление версией JavaScript в RUM]]
**** [[Захват свойств событий и сессий для веб-интерфейсов|Захват свойств событий и сессий]]
**** [[Исключение запросов XHR и Fetch из мониторинга|Исключить запросы XHR и Fetch]]
**** [[Настройка параметров конфиденциальности данных для веб-приложения|Настройка параметров конфиденциальности данных]]
**** [[Настройка атрибутов cookie RUM]]
**** [[Настройка списка разрешенных источников маяков]]
**** [[Настройка связи между фронтендом и бэкендом для веб-интерфейсов|Настройка связи между фронтендом и бэкендом]]
**** [[Настройка захвата взаимодействия пользователя с веб-интерфейсами|Настройка захвата взаимодействия пользователя]]
***** [[Настройка именования элементов пользовательского интерфейса для взаимодействия с пользователем|Настройка именования элементов пользовательского интерфейса]]
***** [[Связывайте взаимодействие пользователя с функциями и компонентами пользовательского интерфейса|Связывайте взаимодействие пользователя с функциями и компонентами пользовательского интерфейса.]]
***** [[Укажите логического предка для взаимодействий с пользователем|Укажите логического предка]]
**** [[Контроль Мониторинга реального пользователя на уровне технологической группы|Контроль RUM на уровне технологической группы]]
**** [[Удаление веб-интерфейса в Мониторинге реальных пользователей|Удалить интерфейс]]
**Мобильные интерфейсы
*** [[Концепции для мобильных интерфейсов|Концепции]]
*** Android
**** [[Первоначальная настройка для Android-интерфейсов|Первоначальная настройка]]
**** [[Поддержка и ограничения]]
**** [[Настройка конфиденциальности и сбора данных]]
**** [[Производительность приложения для Android|Производительность приложения]]
**** [[Мониторинг производительности веб-запросов|Производительность веб-запросов]]
**** [[Сообщения об ошибках и сбоях]]
**** [[Пользовательские события]]
**** [[Управление пользователями и сессиями|Пользователь и сессия]]
**** [[Инструментарий для анализа действий пользователя|Действия пользователя]]
*** iOS
**** [[Первоначальная настройка для iOS-интерфейсов|Первоначальная настройка]]
**** [[Поддержка и ограничения IOS|Поддержка и ограничения]]
**** [[Конфигурация IOS|Конфигурация]]
**** [[Конфиденциальность и сбор данных]]
**** [[Производительность приложения для iOS|Производительность приложения]]
**** [[Мониторинг производительности веб-запросов для iOS|Производительность веб-запросов]]
**** [[Сообщения об ошибках и сбоях на iOS|Сообщения об ошибках и сбоях]]
**** [[Пользовательские события для iOS|Пользовательские события]]
**** [[Управление пользователями и сессиями на iOS|Пользователь и сессия]]
**** [[Инструментарий для анализа действий пользователя для iOS|Действия пользователя]]
*** [[Настройка параметров конфиденциальности данных для мобильных интерфейсов|Конфиденциальность данных]]
*** Дополнительная конфигурация
**** [[Захват свойств событий и сессий для мобильных интерфейсов|Захват свойств событий и сессий]]
**** [[Настройка захвата взаимодействия пользователя с мобильными интерфейсами|Настройка захвата взаимодействия пользователя]]
***** [[Маскировка взаимодействия пользователя с мобильными интерфейсами|Маскировка взаимодействия пользователя]]
**** [[Удаление мобильного интерфейса|Удаление интерфейса]]
*** Анализ и оповещение
**** [[Встроенные метрики RUM|Встроенные метрики]]
**** [[Оповещения о состоянии здоровья для интерфейсов пользователей|Предупреждения о состоянии здоровья]]
**** [[Извлечение метрики из событий пользователя]]
**** [[Извлечение метрик из пользовательских сессий]]
**** [[Анализ поведения пользователей с помощью DQL|Анализ поведения пользователей с помощью DQL.]]
**** [[Отслеживание производительности веб-сайта с помощью DQL|Отслеживайте производительность веб-сайта с помощью DQL.]]
**** [[Анализ производительности от фронтенда до бэкенда]]
**** [[Управление хранилищами для RUM]]
**[[Воспроизведение сеанса|Воспроизведение сессии]]
*** Воспроизведение сессии для веб-интерфейсов
**** [[Активируйте воспроизведение сессий для веб-интерфейсов и настройте управление затратами и трафиком|Активируйте функцию воспроизведения сессий и настройте управление затратами и трафиком]]
**** Настройка воспроизведения сессии
***** [[Настройка режима согласия|Настройте режим согласия]]
***** [[Настройка исключения URL-адресов]]
***** [[Настройка маскирования|Маскирование]]
***** [[Настройка захвата ресурсов]]
**** [[Технические ограничения для воспроизведения сессий на веб-интерфейсах|Технические ограничения]]
**** [[Воспроизведение сеансов в среде со строгими требованиями к конфиденциальности для веб-интерфейсов|Воспроизведение сеанса со строгими требованиями к конфиденциальности]]
*** Воспроизведение сессии для мобильных интерфейсов
**** [[Настройка воспроизведения сеансов для Android]]
**** [[Настройка воспроизведения сеансов для iOS]]
**Синтетический мониторинг
*** Синтетическое приложение
**** HTTP-мониторы, сообщающие о результатах
**** Создайте и настройте HTTP-монитор.
**** Результаты работы браузерных мониторов.
**** Создайте и настройте монитор браузера.
***** Запишите путь клика в браузере.
***** Типы шагов маршрута клика
***** Настройка шагов мониторинга
**** NAM отслеживает отчетность о результатах
**** Создайте монитор NAM.
**** Выполнение мониторов по запросу
**** Частные синтетические локации
***** Требования к частным синтетическим хранилищам
***** Установите ActiveGate с поддержкой синтетических алгоритмов.
***** Установите и обновите Chromium для Linux.
***** Управление частными местоположениями
***** Прокси для частных местоположений
***** Приватные локации в Kubernetes
*** Активируйте браузерные мониторы в последней версии Dynatrace.
*** контроль доступа
*** Сегменты
*** Метрики синтетического мониторинга
*** Метки Первичного Грааля
*** Обзор синтетических оповещений
*** Синтетические расчеты
*** Синтетический для рабочих процессов
*** Синтетические мониторы в Smartscape
*** Синтетическая архитектура и связь

== Платформа Ключ-АСТРОМ ==

* '''Искусственный интеллект'''
** Обнаружение аномалий
*** Метрические события
**** Ключевые события метрики
**** События селектора метрик
*** Автоадаптивные пороги
*** Статические пороги
*** Конфигурация обнаружения аномалий
*** Автоматизированное многомерное базовое исследование
*** Регулировка чувствительности обнаружения
**** Приложения
**** Сервисы
**** База данных сервисов
**** Инфраструктура
**** Расширение событий
** Анализ первопричин
*** Концепции
**** Анализ событий и корреляция
***** [[Категории событий]]
****** Мониторинг недоступных событий
****** Доступность событий
****** Пользовательские оповещения
****** События ошибок
****** [[Информационные события]]
****** Ресурсные события
****** События замедления
**** Частые проблемы
** Модели ИИ
*** Причинно-следственный корреляционный анализ
*** Анализ прогноза
*** Сезонная базовая линия
* '''ЕдиныйАгент'''
** Возможности мониторинга
** Как работает ЕдиныйАгент
* '''Smartscape'''

== Решения Ключ-АСТРОМ ==

* '''Наблюдаемость приложения'''
** Сервисы
*** Обнаружение и наименование
**** Типы сервисов
***** Сервисы обмена сообщениями
***** Объединенные сервисы
***** Индивидуальные сервисы
***** Непрозрачные сервисы
***** Унифицированные сервисы
**** Правила обнаружения сервисов
**** Правила именования сервисов
*** Анализ сервисов
**** Анализ сервисов (новая страница)
**** Контекстно-зависимая детализация
**** Анализ отдельных сервисов обслуживания
**** Сроки анализа сервисов
**** Распределение времени отклика и отклонений
**** Время отклика хотспотов
**** Сервисный поток
***** Метрики
***** Фильтрация
**** Мониторинг ключевых запросов
**** Трассировка сервиса
*** Запрос атрибутов
**** Сбор данных по веб-запросу
**** Захват аргументов метода
**** Фильтрация данных мониторинга
*** Настройки
**** Настроить именование запросов
**** Мониторинг сторонних сервисов
**** Пользовательские определения API
**** Отключение мониторинга запросов на обслуживание
**** Настройка обнаружения сбоев в работе сервиса
**** Расчетные метрики для сервисов
** Очереди сообщений
*** Концепции очередей
*** Анализ очередей
*** Конфигурация очередей
**** Трассировка IBM MQ
**** Теги и менеджмент зоны
** Многомерный анализ
*** Анализ исключений
*** Лучшие операторы баз данных
*** Самые популярные веб-запросы
** [[Профилирование и оптимизация]]
*** [[Дампы памяти|Анализ дампа памяти]]
**** [[Настройка АктивногоШлюза (для хранения дампов памяти)]]
*** [[Аварийные завершения процессов]]
*** [[Непрерывное профилирование ЦП]]
*** [[Профилирование памяти]]
*** [[Непрерывный анализ потоков]]
** Базы данных
*** Databases Services Classic
**** Обнаружение и мониторинг
**** Анализ служб базы данных
**** Анализ служб базы данных (новая страница)
**** Улучшение производительности базы данных
**** Переменные SQL
**** Обзор базы данных Oracle
* '''Безопасность приложений'''
** Начните работу с безопасностью приложений
*** Активация безопасности приложений
*** Режимы мониторинга
*** Оценка уязвимости
*** Покрытие хоста
** Анализ уязвимостей во время работы
*** Начало работы с аналитикой уязвимостей во время работы
*** Обзор безопасности приложений
*** Уязвимости третьих лиц
**** Управление уязвимостями третьих лиц
**** Фильтрация или изменение статуса сторонних уязвимостей
**** Расчеты ИИ Security Advisor
**** Расчет индекса безопасности по шкале ИИ
**** Отслеживание исправления
**** Правила мониторинга
*** Уязвимости на уровне кода
**** Управление уязвимостями на уровне кода
**** Правила мониторинга
**** Фильтрация или изменение статуса уязвимостей на уровне кода
*** Уведомления безопасности об уязвимостях
**** Webhook
**** Jira
**** Email
*** Метрики Classic
** Защита приложений во время работы
*** Начало работы с Runtime Application Protection
*** Управление атаками
*** Правила мониторинга
*** Уведомления безопасности об атаках
**** Webhook
**** Jira
**** Email
*** Метрики Classic
** Часто задаваемые вопросы
** Устранение неполадок
* '''Автоматизация'''
** Цели уровня обслуживания
*** Основы целей уровня обслуживания
*** Настройка и мониторинг
*** Примеры конфигураций
*** Управление SLO с разрешениями менеджмент зон
** Автоматизированный мониторинг релизов
*** Мониторинг релизов с помощью Ключ-АСТРОМ
*** Стратегии обнаружения версий
*** Интеграция отслеживания проблем
* '''Цифровой опыт'''
** Концепции RUM
*** RUM
*** Приложения
*** Действия пользователя
*** Пользовательские и ошибочные события
*** Пользовательские сеансы
*** Метрики действий пользователя
*** Обнаружение IP-адресов, геолокаций и пользовательских агентов
*** Оценки и рейтинги Ключ-АСТРОМ
**** Рейтинги Apdex
**** Оценка пользовательского опыта
** Веб-приложения
*** Дополнительная конфигурация
**** Настройка контроля затрат и трафика
**** Настройка параметров конфиденциальности данных
**** Настройка ключевых действий пользователя
**** Захват дополнительных типов взаимодействия
**** Настройка параметров Apdex
**** Изменение пороговых значений оценки пользовательского опыта
**** Создание расчетных показателей
**** Создание пользовательских метрик USQL
**** Определения свойств действия и сеанса
**** Настройка RUM с помощью JavaScript API
**** Настройка обнаружения ошибок
**** Отметка определенных пользователей
**** Настройка определения IP-адреса
**** Сопоставление IP-адреса с местоположениями
**** Настройка обнаружения ресурсов
**** Настройка домена cookie RUM
**** Настройка списка разрешенных источников маяков
**** Настройка конечной точки маяка
**** Исключение IP-адресов, браузеров, ботов и поисковых роботов
**** Настройка своих серверов кэширования
**** Проверка правил обнаружения приложений
**** Настройка XHR для старых версий IE
**** RUM для групп процессов
**** Изменение политики безопасности контента
**** Удаление веб-приложений
*** Поиск неисправностей
** Мобильные приложения
*** Приложения для Android-приложений
**** Быстрое начало
**** Плагин Ключ-АСТРОМ Android Gradle
***** Инструментация своего приложения с помощью плагина
***** Настройка возможностей мониторинга плагинов
***** Настройка плагина для процессов инструментирования
***** Настройка конфигурации ЕдиногоАгента с помощью плагина
***** Изменение конфигурации плагина в зависимости от структуры проекта
***** Поиск неисправностей
**** ЕдиныйАгент SDK для Android
***** Инструментирование через SDK
***** Настройка связи с SDK
***** Инструментация своего приложения вручную с помощью SDK
**** Включение отладочного ведения логов
*** Приложения для iOS-инструментов
*** Гибридные приложения для инструментов
*** Кроссплатформенные фреймворки
**** Cordova
**** Flutter
**** React Native
**** Xamarin
**** .NET MAUI
*** Поиск неисправностей
** Пользовательские приложения
*** Начальная настройка
*** Поиск неисправностей
** Сегментация сеанса
*** Новое: Анализ сеанса пользователя
*** Пользовательские запросы, сегментация и агрегация данных сеанса
*** Данные пользователя
*** Контекстный анализ Apdex
*** Экспорт сеансов пользователей
** Повтор сеанса
*** Включение воспроизведения сеанса для веб-приложений
*** Настройка воспроизведения сеанса для веб-приложений
*** Технические ограничения для воспроизведения сеанса для веб-приложений
*** Настройка воспроизведения сеанса для iOS
*** Настройка воспроизведения сеанса для Android
** [[Синтетический мониторинг]]
*** Общая информация
**** [[Типы синтетических мониторов]]
**** [[Синтетические расчеты]]
**** [[Поддерживаемые методы аутентификации]]
**** [[Выполнение синтетических мониторингов по требованию для CI/CD]]
**** [[Интеграция внешнего хранилища]]
*** Браузерные мониторы
**** [[Создание мониторинга браузера с одним URL-адресом]]
**** [[Clickpath в браузере]]
**** [[Настройка мониторов браузера]]
**** [[События clickpath в браузере]]
**** [[Режим скрипта]]
**** [[Количество действий, выполненных с помощью Clickpath браузера]]
*** HTTP-мониторы
**** [[Создание HTTP-мониторинга]]
**** [[Настройка HTTP-мониторинга]]
**** [[Режим скрипта HTTP-мониторинга]]
**** [[Предварительное и последующее написание скрипта]]
**** [[Метрики HTTP-мониторинга]]
*** Анализ и оповещение
**** Обзор синтетических оповещений
**** Синтетические данные для браузерных мониторингов
**** Многомерный анализ для браузерных мониторингов
**** Waterfall графики
**** [[Синтетические данные для HTTP-мониторинга]]
*** Мониторы доступности сети
**** Мониторинг доступности сети
**** Создание мониторинга NAM
**** Показатели мониторинга NAM
* '''Инфраструктура Наблюдаемость'''
** Мониторинг облачной платформы
*** Веб-сервисы Amazon
*** Microsoft Azure
*** Google Облако
** Мониторинг контейнерной платформы
*** Kubernetes Classic
**** Использование кластера
**** События
**** Рабочие нагрузки
**** Сервисы
**** Метрики Kubernetes
**** Метрики Prometheus
**** Организация развертывания Kubernetes по тегам
**** Мониторинг постоянных требований по объему
**** Оповещение о частых проблемах
**** Мониторинг уязвимостей
**** Мониторинг SLO
**** Метрики прокси Istio/Envoy
**** Глобальные настройки мониторинга по умолчанию
*** Cloud Foundry
**** Метаданные группы процессов для Cloud Foundry
**** Организация развертывания Cloud Foundry по тегам
**** Обзор метрик Cloud Foundry
*** Heroku
*** Группы контейнеров
*** Правила мониторинга контейнеров
*** Варианты использования
**** Оповещение о частых ошибках в конфигурации и обнаружение аномалий
** Сети
*** Контроль сетевых коммуникации
*** Обнаружение сетевых ошибок
*** Расширенный сетевой мониторинг
*** Устранение неполадок сетевого мониторинга
*** F5 BIG-IP LTM-мониторинг
** Хосты
*** Режимы мониторинга инфраструктуры и обнаружения
**** Насколько эффективен мониторинг инфраструктуры сам по себе?
*** Настройки на уровне хоста
**** Группы хостов
**** Пользовательские наименования хостов
**** Теги хоста и метаданные
**** Исключение дисков и сетевого трафика
**** Обнаружение аномалий
*** Мониторинг
**** Мониторинг хоста
***** Доступность хоста
***** Аналитика диска
**** Доступность процесса
**** Мониторинг классических служб Windows
**** Мониторинг служб ОС
** Группы процессов
*** Основные понятия
**** Какие процессы наиболее важны?
**** Какие технологии лежат в основе отдельных процессов?
*** Конфигурация
**** Наименования групп процессов
**** Глубокий мониторинг процесса
**** Обнаружение группы процессов
**** Облачные приложения и обнаружение рабочей нагрузки
**** Метаданные группы процессов
**** Правила обнаружения пользовательских групп процессов (устарело)
*** Мониторинг
**** Обзор всех технологий, работающих в вашей среде
**** Анализ процессов
**** Анализ скорости реагирования процесса
**** Мониторинг и оповещение о доступности групп процессов
**** Мониторинг сетевых подключений, специфичных для процесса
** VMware vSphere
*** Просмотр данных мониторинга виртуализации
*** Измерения работоспособности хоста ESXi
*** Перенос и производительность виртуальных машин
*** Ограничение мониторинга инфраструктуры VMware с помощью разрешений

== Наблюдение и исследование ==

* [[Панели мониторинга (дашборды)|'''Дашборды''']]
** [[Визуализации и плитки]]
*** [[Доступные плитки]]
*** [[Закрепление плиток на панели инструментов|Закрепление плиток на дашборде]]
*** [[Фильтр плиток]]
*** [[Графическая визуализация]]
*** [[Визуализация многоуровневых столбцов]]
*** [[Визуализация многоуровневых областей]]
*** [[Круговая визуализация]]
*** [[Визуализация значений]]
*** [[Визуализация таблиц]]
*** [[Визуализация топ-листа]]
*** [[Визуализация тепловой карты]]
*** [[Визуализация в виде сот]]
** [[Обзор метрик]]
** [[Панели мониторинга (дашборды)|Дашборды]]
*** [[Управление дашбордами|Создание и редактирование дашбордов]]
*** [[Динамические фильтры в дашбордах]]
*** [[Организация дашбордов]]
*** [[Периодичный отчёт по дашбордам]]
*** [[Доступ к дашбордам]]
*** [[Дашборды-шаблоны]]
*** [[Создание дашбордов для нескольких окружений Ключ-АСТРОМ]]
*** [[Таймфреймы и менеджмент-зоны дашбордов]]
*** [[JSON-конфигурация дашбордов]]
*** [[Глобальная настройка дашбордов]]
* [[Визуализация метрик|'''Визуализация метрик''']]
** [[Быстрый старт Визуализации метрик]]
** [[Расширенный режим Визуализации метрик]]
** [[Часто задаваемые вопросы по Визуализации метрик]]
* [[Обновление пользовательских диаграмм|'''Обновление пользовательских диаграмм''']]
* '''Уведомления и оповещения'''
** Уведомления о проблемах
*** Ansible Tower
*** Email
*** Jira
*** Microsoft Teams
*** Opsgenie
*** PagerDuty
*** ServiceNow
*** Slack
*** Trello
*** VictorOps
*** Webhook
*** xMatters
** Окна технического обслуживания
*** Определить окно обслуживания
** Профили оповещения
** Мобильное приложение Ключ-АСТРОМ
* '''Метрики'''
** Метрики самоконтроля
** Встроенные классические метрики
** Фильтрация классических метрик по менеджмент зонам
* '''Мониторинг логов'''
** Конфигурация
*** Поддерживаемый формат данных логов
*** Подключение данных логов к трассировкам
*** Маскировка конфиденциальных данных
*** Поддерживаемые форматы временных меток
*** Конфигурация временной метки логов
** Прием и обработка логов
*** Автообнаружение
*** Модели возвращения логов
*** Пользовательский источник логов
*** Правила приема логов
*** Конфигурация сброса логов (управляемая)
*** Общий прием логов
*** Преобразование содержимого логов
*** Пересылка логов в облаке
*** Потоковая передача логов через Amazon Data Firehose
*** Логи из Kubernetes
*** Логи в Docker
*** Потоковая передача логов с помощью Logstash
*** Потоковая передача логов с помощью Fluentd
*** Потоковая передача системного логов с помощью Fluentd
*** Потоковая передача логов с помощью Fluent Bit
*** Потоковая передача логов Kubernetes с помощью Fluent Bit
*** Системные логи
*** Потоковая передача логов с помощью OpenTelemetry
** [[Анализ данных логов]]
*** [[Программа просмотра логов]]
*** [[Логи событий]]
*** [[Метрики логов]]
*** [[Пользовательские атрибуты логов]]
*** [[Менеджмент зоны]]
** Оповещение о данных логах
** [[Обработка логов]]
*** [[Примеры обработки логов]]
*** [[Команды обработки логов]]
*** [[Типы данных обработки логов]]
*** [[Функции обработки логов]]
** Ограничения мониторинга логов
** Поиск неисправностей
*** Предупреждения о приеме логов
** Методы маскировки конфиденциальных данных
* '''Распределенные трейсы'''
** Концепции
** Адаптивное управление распределёнными трейсами
*** Адаптивное управление распределёнными трейсами
*** Выборка на основе URL-адресов
** Анализ
*** Начать работу с распределенными трассами
*** Обработка диагностических сообщений
*** Настройка кросс-платформенной трассировки
** Варианты использования
*** Выявление причин сбоев в обслуживании
*** Используйте расширение логов трассировок для решения проблем
*** Сегментация запросов для улучшения времени отклика

== Расширения Ключ-АСТРОМ ==

* '''Расширения метрик'''
** Методы интеграций
*** OpenTelemetry
*** Micrometer
*** Prometheus
**** Расширения Prometheus
*** StatsD
*** Telegraf
*** Интеграция сценариев
*** OneAgent metric API
*** SNMP
*** WMI
*** Расширения JMX
**** Настройка расширений JMX
*** SQL
**** Oracle
**** Microsoft SQL Server
**** PostgreSQL
**** MySQL
**** Snowflake
**** SAP Hana DB
**** IBM DB2
** Справка
*** Протокол интеграции
*** Пользовательские метрические метаданные
* '''Расширения событий'''
* '''Расширения логов'''
** API для сбора логов ЕдиногоАгента
* '''Расширения трейсов'''
** OpenTelemetry
** ЕдиныйАгент SDK
** OpenTracing
** Настройка диапазона
* '''Расширения данных о пользовательском опыте и поведении'''
** Инструментируйте свое приложение с помощью Ключ-АСТРОМ OpenKit
** Библиотеки Ключ-АСТРОМ OpenKit на GitHub
** Методы API Ключ-АСТРОМ OpenKit
** Ведение логов Ключ-АСТРОМ OpenKit
** Устранение неполадок в инструментах Ключ-АСТРОМ OpenKit
* '''Расширения топологии'''
** Определение пользовательской топологии
** Извлечение и отображение топологии событий
* '''Расширения данных'''
* '''Расширения веб-интерфейса Ключ-АСТРОМ'''
** Единые страницы анализа
*** Единый справочник по анализу
*** Единый туториал по анализу
** Расширения встроенных единых страниц анализа
** Распространение пользовательских дашбордов
* '''Расширения'''
** [[Концепции расширений 2.0]]
** [[Настройка специализированного профиля производительности]]
** [[Пользовательская конфигурация контроллера выполнения расширений]]
**[[Распространение пользовательских дашбордов с расширениями]]
** [[Настройка данных с помощью расширений]]
** [[Жизненный цикл расширений 2.0]]
** [[Расширения знаков]]
** [[Расширения YAML-файла]]
** Источники данных
*** [[Источник данных SNMP|SNMP]]
**** [[Справка о источнике данных SNMP|Справка]]
**** [[Источник данных SNMP-traps|SNMP-traps]]
**** [[Поиск и устранение неисправностей SNMP|Поиск и устранение неисправностей]]
*** [[Источник данных JMX|JMX]]
**** [[Справка о источнике данных JMX|Справка]]
*** [[Источник данных Prometheus|Prometheus]]
**** [[Справка о источнике данных Prometheus|Справка]]
*** [[Источник данных SQL|SQL]]
**** [[Конфигурация IBM DB2|IBM DB2]]
****[[Конфигурация JDBC|JDBC]]
**** [[Конфигурация Microsoft SQL|Microsoft SQL]]
**** [[Конфигурация MySQL|MySQL]]
**** [[Конфигурация Oracle Database|Oracle Database]]
**** [[Конфигурация PostgreSQL|PostgreSQL]]
**** [[Конфигурация SAP Hana Database|SAP Hana Database]]
**** [[Конфигурация Snowflake Database|Snowflake Database]]
**** [[Справка о источнике данных SQL|Справка]]
*** [[Источник данных WMI|WMI]]
**** [[Пособие по источнику данных WMI]]
**** [[Справка о источнике данных WMI|Справка]]
*** [[Источник данных Python SDK|Python SDK]]
** [[Безопасность расширения]]
* '''Расширения 1.0'''
** Обновление до Python 3.8
** Расширения АктивногоШлюза
*** Введение
*** Возможности
*** Туториал
** Разработка
*** Команды SDK расширения
*** Установить расширение SDK
*** Установить подключаемый модуль АктивныйШлюз
*** Инструкции по расширениям
**** Развернуть расширение
**** Диаграммы
**** Ключевые показатели эффективности
**** Расширения оповещения
**** Групповые показатели
**** Метрики состояния
**** Пользовательская конфигурация модуля плагина АктивныйШлюз
**** Конфигурация расширения
**** Топология
**** Проблемы и события
**** Пользовательские свойства
*** Как использовать внешние пакеты Python
** Расширения ЕдиногоАгента
*** Жизненный цикл
*** Туториал
** Справочник
*** Справка по API расширения Python
**** Обзор процесса
*** Справка по Json
**** Объяснение JSON расширений
**** Справочник JSON расширений
** Поиск неисправностей
*** Производительность модуля плагина АктивныйШлюз
*** Устранение неполадок с расширениями
*** Симулятор расширения
*** Ограничения расширений
*** Часто задаваемые вопросы о расширении АктивногоШлюза
* '''OpenTelemetry'''

== Управление платформой Ключ-АСТРОМ ==

* '''Подписка на платформы Ключ-АСТРОМ'''
** Управление расходами
** Возможности
*** Мониторинг хоста
*** Безопасность приложений
*** Мониторинг цифрового опыта
*** Расширения платформы
* '''Классическое лицензирование Ключ-АСТРОМ'''
** Жизненный цикл лицензии Ключ-АСТРОМ
** Мониторинг приложений и инфраструктуры (хост-устройства)
** Расширения Ключ-АСТРОМ (единицы данных ИИ (DDU))
*** DDU для метрик
**** Автоматическое преобразование пользовательских метрик в DDU
*** DDU для управления логами и аналитики
*** DDU для бессерверных функций
*** DDU для Log Monitoring Classic
*** DDU для деловых мероприятий
*** DDU для пользовательских трассировок (API трассировки)
*** DDU для индивидуальных событий ИИ
** Мониторинг цифрового опыта (DEM-единицы)
** Мониторинг безопасности приложений (ASU)
** Мониторинг облачной автоматизации (CAU)
* '''Центр Ключ-АСТРОМ'''
* '''Управление счетом'''
** Управление подпиской и лицензиями
*** Управление лицензиями
**** История подписки
**** Мониторы затрат
**** Бюджеты
**** Отчеты по выставлению счетов
*** Управление лицензиями
** Настройки
*** Разрешить диапазоны IP-адресов
** Lens
** Управление пользователями, группами и разрешениями
*** Аутентификация в управлении учетными записями с помощью клиентов OAuth
* '''Конфигурация Ключ-АСТРОМ как код'''
** Monaco
*** Установка Monaco CLI
*** Управление конфигурациями
**** Папка проекта
**** Конфигурация
**** Специальные типы конфигурации
**** Конфигурация учетной записи
*** Руководства
**** Расширенные варианты использования шаблонов
**** Создание OAuth-клиента
**** Перенос устаревших типов конфигурации
**** Переход с Monaco 1.x на 2.x
**** Обеспечение порядка конфигураций
*** Справка
**** Команды
**** Требования к оборудованию
**** Ведение логов
**** Типы конфигурации и права доступа
*** Развертка первой конфигурации
** Terraform
*** Установка
*** Простой пример
*** Расширенный пример
*** Справка
**** Утилита для экспорта
**** Перенос
**** Создание OAuth-клиент
*** Примеры логов AWS
*** Ссылки Terraform
* '''Конфиденциальность и безопасность данных'''
** Конфиденциальность данных
*** Защита данных
*** Сроки хранения данных
*** Адаптивное хранение данных
*** Права на конфиденциальность
*** Персональные данные, собранные Ключ-АСТРОМ
*** Уровни защиты данных
*** Файлы cookie
*** Конфиденциальность пользователя для iOS
*** Форма безопасности данных для Android
** Безопасность данных
*** Контроль безопасности данных
*** Безопасный контроль разработки
*** Сообщение о проблеме, связанной с безопасностью
** Конфиденциальность данных и настройка безопасности
*** Настройка параметров конфиденциальности данных
*** Управление логами аудита
* '''Управление идентификацией и доступом'''
** Варианты использования
*** Группы и разрешения по умолчанию
*** Политика Ключ-АСТРОМ по умолчанию
*** Предоставление доступа к Ключ-АСТРОМ
*** Предоставление доступа к настройкам
** Управление пользователями и группами
*** Группы пользователей, разрешения и политика
*** Управление пользователями и группами через LDAP
*** Управление пользователями и группами с помощью SAML в Ключ-АСТРОМ Managed
*** Управление пользователями и группами с помощью OpenID в Ключ-АСТРОМ Managed
*** Управление пользователями
*** Управление группой
*** SAML
**** Концепция
**** Конфигурации SAML
**** Конфигурация для конкретного IdP
***** Подробности AD FS
***** Подробности Azure
***** Подробности о Google Workspaces
***** Подробности Okta
** Управление разрешениями
*** Работа с политикой
**** Управление политикой
**** Групповые разрешения
**** Границы политики
**** Синтаксис утверждения политики
**** Расширенные настройки
***** Глобальные свойства
***** Глобальные атрибуты
***** Перенос ролевых разрешений
***** Шаблонирование
***** Ссылки на политику
*** Разрешения на управление аккаунтом
*** Разрешения на основе ролей
*** Менеджмент зоны
**** Настройка менеджмент зон
**** Правила менеджмент зон
**** Применение и использование менеджмент зон
** API-токены и клиенты OAuth
*** OAuth-клиенты
*** Классические токены доступа
**** Персональный токен доступа
**** Токен арендатора
* '''Сетевые зоны'''
** Основная информация
** Подключение ЕдиногоАгента
** Подключение АктивногоШлюза
** Перенос
*** Анализ
*** План
*** Развертка
*** Проверка
** Новая установка
*** Анализ
*** План
*** Развертка
*** Проверка
** Переименование сетевой зоны
** Удаление сетевой зоны
* '''[[Владение]]'''
** [[Создание и управление владениями]]
** [[Назначение владельцев объектов]]
** [[Приложение для владения]]
** [[Лучшие команды для владения]]
* '''Теги и метаданные'''
** Варианты использования
** Основные понятия
*** Теги в сравнении с метаданными
*** Лучшие команды для тегов
*** [[Масштабирование тегов]]
** Справка
*** Регулярные выражения в Ключ-АСТРОМ
** Настройка
*** Определение и применение тегов
*** Определение тегов на основе переменных среды
* '''Настройки 2.0'''
* '''Системные уведомления'''

== API Ключ-АСТРОМ ==

* '''Основы'''
** Токены и аутентификация
** Коды ответов
** Ограничение доступа
** Предварительные версии и версии с ранним доступом
** Руководства по переносу для устаревших API
*** Токены v1 к токенам доступа
*** События v1 к Событиям v2
*** Проблемы v1 к проблемам v2
*** Профили оповещения в настройках
*** Техническое обслуживание в настройках
*** Частое обнаружение проблем в настройках
*** Топология и Smartscape в контролируемых объектов
*** Учетные записи Cloud Foundry в настройках
*** Учетные записи Kubernetes в настройках
*** События метрики в настройках
* '''API среды'''
** АктивныйШлюз
*** Информация
**** [[GET информацию о всех АктивныхШлюзах]]
**** [[GET информацию о конкретном АктивномШлюзе]]
*** Конфигурация автообновления
**** [[GET глобальную конфигурацию]]
**** [[Редактировать глобальную конфигурацию]]
**** [[GET АктивныйШлюз]]
**** [[Редактировать АктивныйШлюз]]
*** Задания автообновлений
**** [[GET все задания автообновления]]
**** [[GET конкретное задание автообновления]]
**** [[POST задание автообновления]]
**** [[DELETE задание автообновления]]
**** [[GET АктивныхШлюзов с автообновлением заданий]]
** Анонимизация
*** [[PUT задания анонимизации]]
*** [[GET статус анонимизации]]
** Безопасность приложений
*** Проблемы безопасности
**** Получить список проблем безопасности в среде
**** Получить информацию о конкретной проблеме безопасности
**** Скрыть проблему
**** Показать проблему
**** Получить список исправлений
**** Скрыть/показать исправление
**** Получить список уязвимых функций
*** [[Советник по безопасности ИИ]]
** Логи аудита
*** [[GET лога аудита]]
*** [[GET запись лога аудита]]
** Информация о кластере
*** [[GET информацию о кластере]]
** Хранилище учетных данных
** Пользовательские теги
*** [[GET теги]]
*** [[POST-теги]]
*** [[DELETE тегов]]
** Развертывание
***ЕдиныйАгент
****[[Просмотр информации о подключении]]
*** [[GET теги]]
*** [[POST-теги]]
*** [[DELETE тегов]]
** События v1
*** [[GET ленты событий]]
*** [[GET события]]
*** [[POST события]]
*** [[Отправка событий развертывания из Jenkins]]
** События v2
*** [[GET списка событий]]
*** [[GET события v2]]
*** [[POST события v2]]
*** [[GET всех типов событий]]
*** [[GET типа события]]
*** [[GET всех свойств события]]
*** [[GET свойства события]]
** Расширения 2.0
*** Конфигурации среды
**** [[Расширения 2.0 API - GET активация|GET конфигурации среды]]
**** [[PUT конфигурации среды]]
**** [[POST активации конфигурации]]
**** [[DELETE деактивация конфигурации]]
**** [[GET списка событий - Расширения 2.0|GET списка событий]]
*** Расширения
**** [[GET всех расширений - Расширения|GET всех расширений]]
**** [[GET версии расширения]]
**** [[GET расширения]]
**** [[POST файла расширения]]
**** [[DELETE версии расширения]]
**** [[GET схемы расширения]]
*** Конфигурации мониторинга
**** [[GET всех конфигураций мониторинга]]
**** [[GET конфигурации мониторинга]]
**** [[POST конфигурации мониторинга]]
**** [[PUT конфигурации мониторинга]]
**** [[DELETE конфигурации мониторинга]]
**** [[GET списка событий - Конфигурации мониторинга|GET списка событий]]
**** [[GET статуса]]
*** Схемы
**** [[GET всех схем]]
**** [[GET всех файлов]]
**** [[GET файла]]
** Элементы концентратора
** Мониторинг логов
*** [[GET лога поиска]]
*** [[GET лога экспорта]]
*** [[GET сводного лога]]
*** [[POST лога нагрузки]]
** Таймсерии v1
*** [[Пользовательские метрики]]
**** [[PUT пользовательской метрики]]
**** [[DELETE пользовательской метрики - Пользовательские метрики|DELETE пользовательской метрики]]
*** Определение метрик
**** [[GET списка метрик]]
**** [[GET определения метрик]]
*** Чтение точек данных
**** [[GET точек данных]]
**** [[POST точек данных]]
** Метрики v2
*** [[GET метрик]]
*** [[Получение дескриптора метрики]]
*** [[Получение точки данных метрики]]
*** [[Селектор показателей]]
*** [[Выражение метрик]]
*** [[POST введённых точек данных]]
*** [[DELETE пользовательской метрики]]
*** Примеры и варианты использования
**** [[Список всех метрик]]
**** [[Выбор нескольких метрик]]
**** [[Выбор полного поддерева метрик]]
*** [[FAQ]]
** Единицы метрик
*** [[GET всех единиц метрик]]
*** [[GET одной единицы метрик]]
*** [[API метрик - GET - конвертировать единицы|GET - конвертировать единицы]]
** Отслеживаемые объекты v2
*** [[GET список объектов]]
*** [[GET объект]]
*** [[GET все типы объектов]]
*** [[GET тип объектов]]
*** [[POST пользовательское устройство]]
*** [[Селектор объектов]]
** Сетевые зоны
*** [[GET всех сетевых зон]]
*** [[GET одной сетевой зоны]]
*** [[PUT сетевой зоны]]
*** [[DELETE сетевой зоны]]
*** [[GET глобальной конфигурации]]
*** [[PUT глобальной конфигурации]]
** OTLP прием
** [[Топология и Smartscape v1]]
*** [[Приложения]]
**** [[GET все приложения]]
**** [[GET приложение]]
**** [[POST тегов]]
**** [[GET базового уровня]]
*** [[Хосты]]
**** [[GET все хосты]]
**** [[GET хост]]
**** [[POST тэгов]]
**** [[DELETE тэга]]
*** Процессы
**** [[GET все процессы]]
**** [[GET процесс]]
*** Группы процессов
**** [[GET все группы процессов]]
**** [[GET группы процессов]]
**** [[POST тэгов*|POST тэгов]]
*** Сервисы
**** [[GET все сервисы]]
**** [[GET сервис]]
**** [[POST тэгов**|POST тэгов]]
**** [[GET базового уровня*|GET базового уровня]]
*** [[Пользовательские устройства]]
**** [[Создание пользовательского устройства]]
**** [[Отчёт о метрике пользовательского устройства]]
** [[ЕдиныйАгент на хосте]]
** Проблемы v2
*** [[JSON-модели]]
*** Комментарии
**** [[GET все комментарии]]
**** [[GET комментарий]]
**** [[POST комментарий]]
**** [[PUT комментарий]]
**** [[DELETE комментарий]]
*** Проблемы
**** [[GET список*|GET список]]
**** [[GET детали]]
**** [[POST закрытие проблемы]]
** Релизы
*** [[GET релизы]]
** Удаленное управление конфигурацией
*** ЕдиныйАгент
**** [[POST задание конфигурации]]
**** [[POST предпросмотр работы]]
**** [[GET текущая работа]]
**** [[GET готовые работы]]
**** [[GET задание по настройке]]
*** АктивныйШлюз
**** [[POST задание конфигурации*|POST задание конфигурации]]
**** [[POST предпросмотр работы*|POST предпросмотр работы]]
**** [[GET текущая работа*|GET текущая работа]]
**** [[GET готовые работы*|GET готовые работы]]
**** [[GET задание по настройке*|GET задание по настройке]]
** [[Браузерное расширение Real User Monitoring]]
** Мониторинг реального пользователя (RUM)
*** Географические регионы
**** [[GET страны]]
**** [[GET регионы]]
**** [[GET регионы страны]]
**** [[GET города страны]]
**** [[GET города региона]]
*** RUM JavaScript
**** [[GET список инжектированных приложений]]
**** [[GET последняя версия]]
**** [[GET текущая версия]]
**** [[GET тег JavaScript]]
**** [[GET тег JavaScript ЕдиныйАгент]]
**** [[GET фрагмент кода синхронизации]]
**** [[GET фрагмент асинхронного кода]]
**** [[GET встроенный код]]
*** Сеансы пользователей
**** [[GET таблица]]
**** [[GET дерево]]
**** [[Структура сеанса пользователя]]
** Цели уровня обслуживания
*** [[GET все SLO]]
*** [[GET один SLO]]
*** [[POST один SLO]]
*** [[PUT один SLO]]
*** [[DELETE один SLO]]
** Настройки
*** Объекты
**** [[GET объекты]]
**** [[GET объект*|GET объект]]
**** [[POST объект]]
**** [[PUT объект]]
**** [[DELETE объект]]
**** [[GET эффективные значения]]
*** Схемы
**** [[GET все схемы]]
**** [[GET схема]]
** Синтетика v1
*** Синтетические мониторы
**** [[GET все мониторы]]
**** [[GET монитор]]
**** [[POST монитор]]
**** [[PUT монитор]]
**** [[DELETE монитор]]
**** [[JSON модели*|JSON модели]]
*** Синтетические локации
**** [[GET все локации*|GET все локации]]
**** [[GET локация*|GET локация]]
**** [[POST локация*|POST локация]]
**** [[PUT локация*|PUT локация]]
**** [[DELETE локация*|DELETE локация]]
**** [[GET статус локации*|GET статус локации]]
**** [[PUT статус локации*|PUT статус локации]]
**** [[JSON модели**|JSON модели]]
*** Синтетические ноды
**** [[GET все ноды*|GET все ноды]]
**** [[GET нода*|GET нода]]
*** Прочая синтетика
**** [[POST прочие мониторы]]
**** [[POST прочие события]]
**** [[POST изменение состояния прочих мониторов]]
** Синтетика v2
*** Синтетические локации
**** [[GET все локации]]
**** [[GET локация]]
**** [[POST локация]]
**** [[PUT локация]]
**** [[DELETE локация]]
**** [[GET статус локации]]
**** [[PUT статус локации]]
**** [[JSON модели]]
*** Синтетические ноды
**** [[GET все ноды]]
**** [[GET нода]]
*** Отслеживание выполнения
**** [[GET HTTP монитор]]
**** [[GET все выполнения по требованию]]
**** [[GET основная информация о выполнении]]
**** [[GET полная информация о выполнении]]
**** [[POST пакетное выполнение]]
**** [[GET сводка о пакетном выполнении]]
*** Конфигурация
**** [[GET конфигурация]]
**** [[PUT конфигурация]]
** Токены v2
*** Токены доступа
**** [[GET все токены]]
**** [[GET токен]]
**** [[POST поиск токена]]
**** [[POST токен]]
**** [[PUT токен]]
**** [[DELETE токен]]
*** Токены АктивногоШлюза
**** [[GET все токены*|GET все токены]]
**** [[GET токен*|GET токен]]
**** [[POST токен*|POST токен]]
**** [[DELETE токен*|DELETE токен]]
*** Токены владельца
**** [[POST старт ротации]]
**** [[POST окончания ротации]]
**** [[POST отмены ротации]]
* '''API конфигурации'''
** Обнаружение аномалий
*** [[Обнаружение аномалий API - Приложения|Приложение]]
**** [[Обнаружение аномалий приложения API - GET конфигурация|GET конфигурация]]
**** [[Обнаружение аномалий приложения API - PUT конфигурация|PUT конфигурация]]
*** [[Обнаружение аномалий API - AWS|AWS]]
**** [[AWS обнаружение аномалий API - GET конфигурация|GET конфигурация]]
**** [[AWS обнаружение аномалий API - PUT конфигурация|PUT конфигурация]]
*** [[Обнаружение аномалий API - Службы базы данных|Службы базы данных]]
**** [[Обнаружение аномалий базы данных API - GET конфигурация|GET конфигурация]]
**** [[Обнаружение аномалий базы данных API - PUT конфигурация|PUT конфигурация]]
*** [[Обнаружение аномалий API - Дисковые события|Дисковые события]]
**** [[Обнаружение аномалий дисковых событий API - GET все события|GET все события]]
**** [[Обнаружение аномалий дисковых событий API - GET событие|GET событие]]
**** [[Обнаружение аномалий дисковых событий API - POST событие|POST событие]]
**** [[Обнаружение аномалий дисковых событий API - PUT событие|PUT событие]]
**** [[Обнаружение аномалий дисковых событий API - DELETE событие|DELETE событие]]
*** [[Обнаружение аномалий API - Хосты|Хосты]]
**** [[Обнаружение аномалий хоста API - GET конфигурация|GET конфигурация]]
**** [[Обнаружение аномалий хоста API - PUT конфигурация|PUT конфигурация]]
*** [[Обнаружение аномалий API - События метрик|События метрик]]
**** [[Обнаружение аномалий событий метрик API - GET все события|GET все события]]
**** [[Обнаружение аномалий событий метрик API - GET событие|GET событие]]
**** [[Обнаружение аномалий событий метрик API - POST событие|POST событие]]
**** [[Обнаружение аномалий событий метрик API - PUT событие|PUT событие]]
**** [[Обнаружение аномалий событий метрик API - DELETE событие|DELETE событие]]
**** [[Обнаружение аномалий событий метрик API - JSON модель|JSON модель]]
*** [[API обнаружения аномалий - Группы процессов|Группы процессов]]
**** [[API обнаружения аномалий групп процессов - GET конфигурация|GET конфигурация]]
**** [[API обнаружения аномалий групп процессов - PUT конфигурация|PUT конфигурация]]
**** [[API обнаружения аномалий групп процессов - DELETE конфигурация|DELETE конфигурация]]
*** [[API обнаружения аномалий - Службы|Службы]]
**** [[API обнаружения аномалий служб - GET конфигурация|GET конфигурация]]
**** [[API обнаружения аномалий служб - PUT конфигурация|PUT конфигурация]]
*** [[API обнаружения аномалий - VMware|VMware]]
**** [[API обнаружения аномалий VMware - GET конфигурация|GET конфигурация]]
**** [[API обнаружения аномалий VMware - PUT конфигурация|PUT конфигурация]]
** [[API автоматически применяемых тегов|Автоматические теги]]
*** [[API автоматически применяемых тегов - GET все автоматические теги|GET все автоматические теги]]
*** [[API автоматически применяемых тегов - GET автоматический тег|GET автоматический тег]]
*** [[API автоматически определяемых тегов - POST автоматический тег|POST автоматический тег]]
*** [[API автоматически применяемых тегов - PUT автоматический тег|PUT автоматический тег]]
*** [[API автоматически применяемых тегов - DELETE автоматический тег|DELETE автоматический тег]]
*** [[API автоматически применяемых тегов - JSON модели|JSON модели]]
** Учётные данные AWS
*** [[API учётных данных AWS - GET все учётные данные|GET все учётные данные]]
*** [[API учётных данных AWS - POST новые учётные данные|POST новые учётные данные]]
*** [[API учётных данных AWS - GET учётные данные|GET учётные данные]]
*** [[API учётных данных AWS - PUT учётные данные|PUT учётные данные]]
*** [[API учётных данных AWS - DELETE учётные данные|DELETE учётные данные]]
*** [[API учётных данных AWS - GET службы мониторинга|GET службы мониторинга]]
*** [[API учётных данных AWS - PUT службы мониторинга|PUT службы мониторинга]]
** AWS PrivateLink
** Учётные данные Azure
** Расчётные метрики
** Учётные данные Cloud Foundry
** Условное наименование
** Хранилище учётных данных
** Дашборды
*** Получить информацию о всех дашбордах
*** Получить информацию о конкретном дашборде
** [[Конфиденциальность данных]]
** Расширения
** Частота обнаружения проблем
** Учётные данные Kubernetes
** Окна обслуживания
** Зоны управления
** Мобильная символика
** [[Уведомления]]
** Конфигурация ЕдиногоАгента
** Плагины
** [[API Удалённых сред]]
** Отчёты
** RUM
** Сервисы
* '''API управления аккаунтом'''
** Управление окружающей средой
*** GET кластера
*** GET конфигурации IP
*** PUT конфигурации IP
*** GET всех сред
*** GET всех сред v2
** Управление пользователями
*** GET всех пользователей
*** POST нового пользователя
*** DELETE пользователя
*** GET групп пользователей
*** POST групп пользователей
*** PUT групп пользователей
*** DELETE пользователей из групп
** Управление группой
*** GET всех групп
*** POST новой группы
*** GET участников группы
*** PUT группы пользователей
*** DELETE группу пользователей
** Управление разрешениями
*** GET разрешения
*** POST разрешения
*** PUT разрешения
*** DELETE разрешения
** Управление политикой
*** Политика
**** GET всех политик
**** GET собственных политик
**** GET политики
**** POST политики
**** PUT политики
**** DELETE политики
*** Привязки
**** GET привязки групп пользователей
**** PUT привязки групп пользователей
**** GET привязка уровня политики
**** DELETE привязки уровня политики
**** GET привязки политики
**** POST привязки политики
**** DELETE привязки политики
** Подписка на платформу Ключ-АСТРОМ
*** Подписки
**** GET всех подписок
**** GET подписки
*** Использование
**** GET использование
**** GET использование в каждой среде
*** Расходы
**** GET расходов
**** GET расходов за среду
*** Мониторинг затрат
**** GET прогноз
**** GET события
** Справочные данные
*** GET часовые пояса
*** GET географические регионы
*** GET разрешения пользователя

Настройка воспроизведения сеансов для iOS

2026-08-19T18:52:50Z

IKuznetsov: Новая страница: «= Настройка воспроизведения сеансов для iOS = На этой странице описано, как активировать и настроить функцию '''Воспроизведения сессий''' для ваших приложений '''iOS'''. ЕдиныйАгент для '''iOS''' версии 8.323. Для приложений, скомпилированных с помощью '''Xcode''' 26, треб...»

= Настройка воспроизведения сеансов для iOS =

На этой странице описано, как активировать и настроить функцию '''Воспроизведения сессий''' для ваших приложений '''iOS'''.

ЕдиныйАгент для '''iOS''' версии 8.323. Для приложений, скомпилированных с помощью '''Xcode''' 26, требуется более поздняя версия.

== Используйте воспроизведение сессии ==

Функция '''Воспроизведение сессий''' на '''iOS''' позволяет записывать взаимодействие ваших клиентов с мобильным приложением и воспроизводить каждое касание, свайп и поворот экрана в режиме, напоминающем кинофильм.

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

== Предварительные требования ==

Убедитесь, что ваша система соответствует следующим требованиям:

* Ключ-АСТРОМ версия 1.303.
* ЕдиныйАгент для '''iOS''', версия 8.323.
* Для вашего приложения активирован '''Мониторинг реального пользователя'''.
* Действующая лицензия '''Ключ-АСТРОМ Мониторинг цифрового опыта'''.
* '''Swift''' 5+.
* '''iOS''' 15+.
* '''Xcode''' 16+.
* Поддерживается '''SwiftUI'''.
* URL-адрес веб-интерфейса имеет доверенный сертификат.

== Известные ограничения и проблемы ==

* Поддерживается '''iOS''' 15.0 и выше.
* '''Swift''' 5+.
* '''Xcode''' 16+.
* Поддерживается '''SwiftUI'''.
* Функция '''Воспроизведение сессий''' недоступна для '''tvOS''' и '''iPadOS'''.
* Функция '''Воспроизведение сессий''' недоступна для кроссплатформенных фреймворков, таких как '''Cordova''', '''React Native''', '''Flutter''' и '''Xamarin'''.
* В гибридных приложениях функция '''Воспроизведение сессий''' поддерживается только для нативной части приложения. В браузерной части '''Воспроизведение сессий''' поддерживает только события загрузки веб-страницы.
* Мы не рекомендуем использовать другие инструменты для создания отчетов о сбоях одновременно с '''Воспроизведением сессий''' Ключ-АСТРОМ.
* Функция '''Воспроизведение сессий''' может фиксировать только определенные события. Однако, если вам необходимо отслеживать конкретное представление или событие, которое не поддерживается по умолчанию, вы можете фиксировать пользовательское событие.
* Воспроизведение пользовательских сессий, записанных с помощью функции '''Воспроизведение сессий''', возможно только в определенных браузерах.
* Для приложений '''iOS''' 26, созданных с помощью '''Xcode''' 26, функция маскирования доступна только с ЕдинымАгентом для '''iOS''' версии 8.323 и выше.
* Воспроизведение сессии — это видеоподобная реконструкция взаимодействия пользователя с мобильными приложениями, основанная на захваченных событиях и данных. Из-за такого подхода воспроизведенные сессии могут отличаться от реального пользовательского опыта.

== В iOS активируйте функцию воспроизведения сессий и отрегулируйте количество записанных сессий ==

Если вы еще этого не сделали, выполните все шаги, описанные в разделе первоначальной настройки для '''iOS'''-интерфейсов.

# Перейдите в раздел '''Ключевые показатели опыта''' > '''Обзор'''.
# Выберите '''Мобильные устройства''', чтобы просмотреть все мобильные версии сайта.
# Выберите интерфейс, который хотите настроить.
# Перейдите во вкладку '''Настройки'''.
# В рамках обеспечения возможностей и контроля затрат:
#* Включите '''классический режим мониторинга реальных пользователей''' или оба режима: '''классический''' и '''мониторинг реальных пользователей'''.
#* Выберите '''Воспроизведение сессий Classic''' или оба варианта: '''Воспроизведение сессий Classic''' и '''Воспроизведение сессий''', а затем введите новое значение коэффициента захвата для ценности воспроизведения сессии:
#** 100 процентов для учета всех сессий.
#** Процент, меньший чем 100 процентов, необходимый для захвата случайно выбранных сессий.
# Чтобы записывать все сессии со сбоями независимо от частоты записи, выберите '''Воспроизведение сессий для классических сбоев''' или оба варианта: '''Воспроизведение сессий для классических сбоев''' и '''Воспроизведение сессий для сбоев'''.
# В настройках приложения выберите '''Мастер инструментов''', а затем выберите '''iOS'''.
# Следуйте инструкциям мастера настройки приборов.

== Активировать воспроизведение сессий для приложений SwiftUI ==

ЕдиныйАгент для '''iOS''' версии 8.249+.

Если вы уже настроили поддержку своего приложения '''SwiftUI''', вы можете дополнительно активировать функцию '''Воспроизведения сессий''' для такого мобильного приложения.

Чтобы активировать функцию '''Воспроизведения сессий''' для вашего инструментированного приложения '''SwiftUI''':

# Выполните все шаги инструкции по активации воспроизведения сессии, описанной выше.
# Установите ключ конфигурации <code>DTXSwiftUIEnableSessionReplayInstrumentation</code> в значение <code>true</code> в файле <code>Info.plist</code> вашего проекта.
<pre>
<key>DTXSwiftUIEnableSessionReplayInstrumentation</key>
<true/>
</pre>

=== Поддерживаемые контейнеры SwiftUI ===

Мы поддерживаем '''Воспроизведение сессий''' для следующих контейнеров '''SwiftUI''':

* Список
* '''LazyVGrid'''
* '''LazyHGrid'''

=== Известные ограничения для приложений SwiftUI ===

Ключ-АСТРОМ не поддерживает следующие контейнеры '''SwiftUI''':

* Списки внутри расширений
* Списки со статическим содержимым
* Список случаев, когда объект кормления не соответствует протоколу '''Equatable'''.

== Скрыть конфиденциальные данные ==

=== Уровни маскирования данных ===

Функция '''Воспроизведение сессий''' имеет три предустановленных уровня маскировки:

* Наиболее безопасный вариант — все редактируемые текстовые поля, изображения, метки, веб-представления и переключатели скрыты.
* Безопасно — все редактируемые текстовые поля замаскированы.
* Пользовательский режим — по умолчанию маскирует те же элементы, что и '''Наиболее безопасный режим''', но вы можете точно определить, какие компоненты или представления приложения следует маскировать. Подробнее см. раздел «Настройка пользовательского маскирования».

=== Изменить уровень маскировки ===

По умолчанию ЕдиныйАгент применяет самый безопасный уровень маскирования. Чтобы изменить его на безопасный или пользовательский уровень, используйте API для настройки ЕдиногоАгента. Если вы выбрали пользовательский уровень, см. раздел «Настройка пользовательского маскирования» для получения подробной информации о том, как указать, какие компоненты или представления приложения должны быть замаскированы.

==== Пример 1: Измените уровень маскирования на «Безопасный» ====

Используйте следующий код, чтобы установить уровень маскирования на «Безопасный».

<pre>
let maskingConfiguration = MaskingConfiguration(maskingLevelType: .safe)
try? AgentManager.setMaskingConfiguration(maskingConfiguration)
</pre>

=== Настройка пользовательского маскирования ===

Если вы установите уровень маскирования данных на «Пользовательский», вы сможете использовать дополнительные методы API для определения того, какие компоненты или представления приложения следует маскировать. Вы сможете:

* Активировать или деактивировать правила маскирования.
* Маскировать представления с помощью <code>accessibilityIdentifier</code>.
* Маскировать изображения с помощью тега маскирования.

==== Активировать или деактивировать правила маскирования ====

Вы можете активировать или деактивировать правила глобально или для выбранных компонентов, таких как текстовые поля, изображения, метки, веб-представления и переключатели.

<pre>
try? maskingConfiguration.add(rule: .maskAllImages) // Добавляет одно правило
try? maskingConfiguration.remove(rule: .maskAllSwitches) // Удаляет одно правило
try? maskingConfiguration.addAllRules() // Добавляет все правила
try? maskingConfiguration.removeAllRules() // Удаляет все правила
</pre>

Если удалить все правила маскирования, функция '''Воспроизведение сессий''' ничего не будет маскировать. Если активировать все правила маскирования, это будет эквивалентно самому безопасному уровню маскирования.

==== Маскирование изображений с помощью <code>accessibilityIdentifier</code> ====

Вы можете активировать или деактивировать маскирование выбранных представлений в зависимости от их параметров <code>accessibilityIdentifier</code>.

<pre>
try? maskingConfiguration.addMaskedView(viewIds: ["masked_view_id"])
try? maskingConfiguration.removeMaskedView(viewIds: ["masked_view_id"])
try? maskingConfiguration.addNonMaskedView(viewIds: ["nonMasked_view_id"])
try? maskingConfiguration.removeNonMaskedView(viewIds: ["nonMasked_view_id"])
</pre>

==== Маскируйте изображения с помощью тега маскирования ====

Также можно замаскировать представление, добавив тег <code>data-dtrum-mask</code> к его содержимому <code>accessibilityIdentifier</code>. Представление с этим тегом всегда будет замаскировано.

== Активировать журналы воспроизведения сеансов ==

Активировать журналы воспроизведения сессий можно так же, как и для ЕдиногоАгента. Дополнительную информацию см. в разделе «Отладка».

== Захват пользовательских событий ==

Функция '''Воспроизведение сессий''' записывает только определенные события. Кроме того, вы можете записывать пользовательские события, которые не поддерживаются по умолчанию. Вы можете записать пользовательское событие с добавлением снимка экрана определенного вида, определенной области экрана или всего экрана.

Все методы перехвата пользовательских событий могут выдавать ошибку <code>TrackCustomEventError.notInMainThread</code>, если вы попытаетесь перехватить пользовательское событие из потока, не являющегося основным. Мы рекомендуем добавить блок <code>do-catch</code> до тех пор, пока все не заработает должным образом; затем вы можете заменить этот блок более простой версией, которая, даже в случае ошибки, просто не будет перехватывать пользовательское событие.

<pre>
do {
try AgentManager.trackCustomEvent(name: "my_event_name", view: nil)
} catch {
print(error)
}
</pre>

=== Конкретный вид ===

Зафиксируйте пользовательское событие, сделав снимок экрана конкретного представления.

<pre>
try? AgentManager.trackCustomEvent(name: "my_view_name", view: myView)
</pre>

=== Конкретная область экрана ===

Зафиксируйте пользовательское событие, сделав снимок экрана определенной области.

<pre>
try? AgentManager.trackCustomEvent(name: "my_view_name", frame: anyFrame)
</pre>

=== Полноэкранный ===

Зафиксируйте пользовательское событие, сделав снимок экрана в полном объеме.

<pre>
try? AgentManager.trackCustomEvent(name: "my_view_name")
</pre>

== Измените режим передачи изображений на Wi-Fi ==

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

<pre>
AgentManager.setTransmissionMode(.wifi) // по умолчанию используется .data
</pre>

== Используйте отладчик скриншотов ==

Отладчик скриншотов '''Воспроизведение сессий''' позволяет увидеть, когда были сделаны скриншоты, какие части экрана были захвачены и какие данные — текстовые поля, изображения, метки, веб-представления и переключатели — были скрыты.

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

После активации отладчика скриншотов '''Воспроизведение сессий''' вы сможете увидеть соответствующие ключи в своем проекте. Обратите внимание, что эти ключи не отправляются в код приложения при компиляции в релизную или архивную версии, поэтому они никогда не включаются в производственный код. Эти ключи используются только для отладочных запусков.

Чтобы активировать отладчик скриншотов воспроизведения сессии:

# В '''Xcode''' выберите пункт '''Изменить схему''' в меню '''Схема''', чтобы изменить схему вашего приложения.
# В настройках схемы приложения выберите действие '''Выполнить''', а затем перейдите на вкладку '''Аргументы'''.
# В разделе '''Переменные среды''' добавьте один или оба следующих ключа:
#* <code>DTXDebugMasking</code>. Этот ключ отображает скриншоты, сделанные функцией '''Воспроизведение сессий''', включая замаскированное содержимое и элементы управления пользовательского интерфейса. Для каждого сделанного скриншота вы увидите кратковременную вспышку.
#* <code>DTXDebugFrameHighlight</code>. Этот ключ выделяет захваченную часть экрана красной рамкой, чтобы вы могли точно определить, какая часть экрана была захвачена.

== Поиск неисправностей ==

* Пользовательские сессии вообще не записываются.
* Пользовательские сессии записываются, но функция воспроизведения сессии недоступна.

== Связанные темы ==

* Повтор сессии

Настройка воспроизведения сеансов для Android

2026-08-19T18:51:15Z

IKuznetsov: Новая страница: «= Настройка воспроизведения сеансов для Android = На этой странице описано, как активировать и настроить функцию '''Воспроизведения сессий''' для ваших приложений '''Android'''. == Используйте воспроизведение сессии == Функция '''Воспроизведение сессий''' на '''Android''...»

= Настройка воспроизведения сеансов для Android =

На этой странице описано, как активировать и настроить функцию '''Воспроизведения сессий''' для ваших приложений '''Android'''.

== Используйте воспроизведение сессии ==

Функция '''Воспроизведение сессий''' на '''Android''' позволяет записывать взаимодействие ваших клиентов с мобильным приложением и воспроизводить каждое касание, свайп и поворот экрана в режиме, напоминающем кинофильм.

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

== Предварительные требования ==

Убедитесь, что ваша система соответствует следующим требованиям:

* Ключ-АСТРОМ версия 1.303.
* ЕдиныйАгент для '''Android''', версия 8.303.
* Для вашего приложения активирован '''Мониторинг реального пользователя'''.
* Действующая лицензия '''Ключ-АСТРОМ Мониторинг цифрового опыта'''.

== Поддерживаемые технологии и известные ограничения ==

* Поддерживается '''Android''' 6.0+ (уровень API 23+).
* Поддерживается плагин '''Android Gradle''' версии 8.1.1 и выше.
* Поддерживается '''Kotlin''' версии 2.1.0 и выше.
* Начиная с версии '''Jetpack Compose''' 1.4 и выше, поддерживается следующее: ЕдиныйАгент для '''Android''', версия 8.325.
* Функция '''Воспроизведение сессий''' недоступна для кроссплатформенных фреймворков, таких как '''Cordova''', '''React Native''', '''Flutter''', '''Xamarin'''.
* Для гибридных приложений функция '''Воспроизведение сессий''' поддерживается только для нативной части приложения. Для браузерной части гибридного приложения функция '''Воспроизведение сессий''' не поддерживается.
* Поддерживаются только библиотеки поддержки '''AndroidX'''. Классы, такие как '''Activity''' или '''Fragment''' из '''com.android.support''', не поддерживаются.
* Мы не рекомендуем использовать другие инструменты для создания отчетов о сбоях одновременно с '''Воспроизведением сессий''' Ключ-АСТРОМ.
* Функция '''Воспроизведение сессий''' может фиксировать только определенные события. Однако, если вам необходимо отслеживать конкретное представление или событие, которое не поддерживается по умолчанию, вы можете фиксировать пользовательское событие.
* Воспроизведение пользовательских сессий, записанных с помощью функции '''Воспроизведение сессий''', возможно только в определенных браузерах.
* Воспроизведение сессии — это видеоподобная реконструкция взаимодействия пользователя с мобильным приложением, использующая захваченные события и данные. Из-за такого подхода воспроизведенная сессия может отличаться от реального пользовательского опыта. Известные проблемы:
** Фрагменты с анимацией появления и исчезновения могут вызывать проблемы, особенно если анимация короткая.
** Плавающие кнопки действий могут вызывать проблемы с маскированием данных.
** Использование атрибута <code>inputType</code> внутри компонента '''Button''' может привести к тому, что кнопки будут отображаться без текста при захвате.

== Активируйте функцию воспроизведения сессий на Android и отрегулируйте количество записанных сессий ==

Если вы еще этого не сделали, выполните все шаги, описанные в разделе первоначальной настройки интерфейсов '''Android'''.

# Перейдите в раздел '''Ключевые показатели опыта''' > '''Обзор'''.
# Выберите '''Мобильные устройства''', чтобы просмотреть все мобильные версии сайта.
# Выберите интерфейс, который хотите настроить.
# Перейдите во вкладку '''Настройки'''.
# В рамках обеспечения возможностей и контроля затрат:
#* Включите '''классический режим мониторинга реальных пользователей''' или оба режима: '''классический''' и '''мониторинг реальных пользователей'''.
#* Выберите '''Воспроизведение сессий Classic''' или оба варианта: '''Воспроизведение сессий Classic''' и '''Воспроизведение сессий''', а затем введите новое значение коэффициента захвата для ценности воспроизведения сессии:
#** 100 процентов для учета всех сессий.
#** Процент, меньший чем 100 процентов, необходимый для захвата случайно выбранных сессий.
# Чтобы записывать все сессии со сбоями независимо от частоты записи, выберите '''Воспроизведение сессий для классических сбоев''' или оба варианта: '''Воспроизведение сессий для классических сбоев''' и '''Воспроизведение сессий для сбоев'''.
# В настройках приложения выберите '''Мастер инструментов''', а затем выберите '''Android'''.
# Следуйте инструкциям мастера настройки приборов.

Для версий плагина '''Android Gradle''' 4.0 и 4.1 необходимо изменить параметр компиляции на '''Java''' 8. Это можно сделать на этапе мастера инструментирования, называемом '''Применить плагин Ключ-АСТРОМ и добавить конфигурацию плагина'''. Добавьте следующий код в главный файл сборки:

<pre>
compileOptions {
sourceCompatibility 1.8
targetCompatibility 1.8
}
</pre>

Для плагина '''Android Gradle''' версии 4.2 и выше по умолчанию используется '''Java''' 8, поэтому никаких изменений в конфигурации не требуется.

== Скрыть конфиденциальные данные ==

=== Уровни маскирования данных ===

Функция '''Воспроизведение сессий''' имеет три предустановленных уровня маскировки:

* Наиболее безопасный вариант — все редактируемые текстовые поля, изображения, метки, веб-представления и переключатели скрыты.
* Безопасно — все редактируемые текстовые поля замаскированы.
* Пользовательский режим — по умолчанию маскирует те же элементы, что и '''Наиболее безопасный режим''', но вы можете точно определить, какие компоненты или представления приложения следует маскировать. Подробнее см. раздел «Настройка пользовательского маскирования».

=== Изменить уровень маскировки ===

По умолчанию ЕдиныйАгент применяет самый безопасный уровень маскирования. Чтобы изменить его на безопасный или пользовательский уровень, используйте API для настройки ЕдиногоАгента. Если вы выбрали пользовательский уровень, см. раздел «Настройка пользовательского маскирования» для получения подробной информации о том, как указать, какие компоненты или представления приложения должны быть замаскированы.

==== Пример 1: Измените уровень маскирования на «Безопасный» ====

Используйте следующий код, чтобы установить уровень маскирования на «Безопасный».

<pre>
MaskingConfiguration config = new MaskingConfiguration.Safe();
// .Safest или .Custom
AstromkeySessionReplay.setConfiguration(Configuration.builder()
.withMaskingConfiguration(config)
.build());
</pre>

==== Пример 2: Измените уровень маскирования на «Пользовательский» ====

Используйте следующий код, чтобы установить уровень маскирования на «Пользовательский». Дополнительные параметры см. в разделе «Настройка пользовательского маскирования».

<pre>
MaskingConfiguration config = new MaskingConfiguration.Custom();
// .Safest или .Safe
AstromkeySessionReplay.setConfiguration(Configuration.builder()
.withMaskingConfiguration(config)
.build());
</pre>

==== Пример 3: Измените уровень маскирования на «Пользовательский» и удалите все замаскированные представления ====

Используйте следующий код, чтобы установить уровень маскирования на «Пользовательский» и удалить все замаскированные представления (<code>removeAllMaskedViews</code>). Дополнительные параметры см. в разделе «Настройка пользовательского маскирования».

<pre>
MaskingConfiguration config = new MaskingConfiguration.Custom().removeAllMaskedViews();
AstromkeySessionReplay.setConfiguration(Configuration.builder()
.withMaskingConfiguration(config)
.build());
</pre>

=== Настройка пользовательского маскирования ===

Если вы установите уровень маскирования данных на «Пользовательский», вы сможете использовать дополнительные методы API для определения того, какие компоненты или представления приложения следует маскировать. Вы сможете:

* Маскировать изображения.
* Маскировать представления с помощью <code>android:tag</code>.
* Маскировать изображения с помощью тега маскирования.
* Маскировать '''Jetpack Compose''' composables.

==== Виды масок ====

Вы можете включить или отключить маскирование глобально или для выбранных компонентов, таких как текстовые поля, изображения, метки, веб-представления и переключатели.

<pre>
Set<Class<? extends View>> set = new HashSet<Class<? extends View>>() {
add(ImageView.class);
add(WebView.class);
};
new MaskingConfiguration.Custom().addMaskedView(ImageView.class); // Добавляет одно маскированное представление
new MaskingConfiguration.Custom().addMaskedViews(set); // Добавляет все замаскированные представления
new MaskingConfiguration.Custom().removeMaskedView(ImageView.class); // Удаляет один замаскированный элемент
new MaskingConfiguration.Custom().removeAllMaskedViews(); // Удаляет все замаскированные представления
</pre>

Для того чтобы изменения вступили в силу, необходимо применить пользовательскую конфигурацию маскирования. Пример кода см. в разделе «Изменение уровня маскирования на пользовательский и удаление всех замаскированных представлений».

==== Маскирование изображений с помощью <code>android:tag</code> ====

Вы также можете активировать или деактивировать маскирование выбранных представлений в зависимости от их параметров <code>android:tag</code>.

<pre>
Set<Integer> set = new HashSet<Integer>() {
add(R.id.view_id1);
add(R.id.view_id2);
};
new MaskingConfiguration.Custom().addMaskedIds(set);
new MaskingConfiguration.Custom().addNonMaskedIds(set);
new MaskingConfiguration.Custom().removeMaskedIds(set);
new MaskingConfiguration.Custom().removeNonMaskedIds(set);
</pre>

Для того чтобы изменения вступили в силу, необходимо применить пользовательскую конфигурацию маскирования. Пример кода см. в разделе «Изменение уровня маскирования на пользовательский и удаление всех замаскированных представлений».

==== Маскируйте изображения с помощью тега маскирования ====

Также можно замаскировать представление, добавив тег <code>data-dtrum-mask</code> к его содержимому <code>android:tag</code>. Представление с этим тегом всегда будет замаскировано.

==== Mask Jetpack Compose composables ====

'''Jetpack Compose''' предоставляет функцию ручного маскирования, позволяющую управлять тем, какие элементы композиции будут замаскированы в режиме воспроизведения сессии. Для маскирования элемента композиции используйте модификатор <code>dtMask</code>.

<pre>
import com.astromkey.agent.compose.api.dtMask

@Composable
fun MyScreen() {
Column {
Text(
text = "Этот текст будет замаскирован",
modifier = Modifier.dtMask()
)
}
}
</pre>

== Активировать журналы воспроизведения сеансов ==

Вы можете активировать ведение журналов воспроизведения сессий так же, как и для ЕдиногоАгента. Подробности см. в разделе «Включение отладочного логирования для плагина Ключ-АСТРОМ Android Gradle или SDK ЕдиногоАгента».

== Захват пользовательских событий ==

Функция '''Воспроизведение сессий''' записывает только определенные события. Однако вы можете отслеживать события, которые не поддерживаются по умолчанию.

<pre>
AstromkeySessionReplay.trackCustomEvent("Пользователь вошел в систему")
</pre>

== Измените режим передачи изображений на Wi-Fi ==

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

<pre>
AstromkeySessionReplay.setConfiguration(
Configuration.builder()
.withDataTransmissionMode(DataTransmissionMode.NOT_METERED_NETWORK)
.build()
)
</pre>

== Поиск неисправностей ==

* Пользовательские сессии вообще не записываются.
* Пользовательские сессии записываются, но функция воспроизведения сессии недоступна.

== Связанные темы ==

* Повтор сессии