Быстрый старт: подключение Monitor к Aggregator

После установки основной задачей является связать конкретный сайт с записью агента на центральном Aggregator.

[Скриншот 1: создание агента и выдача токена]

Шаг 1. Создайте агента на Aggregator

На центральном сайте откройте раздел «Агенты» и создайте запись. Укажите понятное имя клиента или проекта. Base URL можно заполнить, если планируется direct-режим, но для рекомендуемого pull-режима он не обязателен.

После создания Aggregator показывает токен и адреса служебных endpoint-ов. Токен относится к одному агенту и не должен повторно использоваться на других сайтах.

Шаг 2. Заполните Monitor

• «URL приёма метрик агрегатора» — адрес центрального Aggregator;
• «Токен агента» — токен созданной записи;
• «URL получения команд» и «URL отправки результатов» можно оставить пустыми: они вычисляются от базового адреса;
• «Pull-команды» рекомендуется оставить включёнными;
• интервал 300–900 секунд подходит для обычного мониторинга.

[Скриншот 2: поля подключения в Monitor]

Шаг 3. Проверьте обмен

1. Сохраните настройки.
2. Запустите сбор и отправку вручную.
3. Откройте локальный дашборд Monitor и убедитесь, что сбор завершился без ошибки.
4. На Aggregator откройте «Сайты» — после первой принятой метрики сайт должен появиться автоматически.
5. Сверьте домен, SITE_ID и время последнего обмена.

Если сайт не появился

• проверьте правильность URL и токена;
• проверьте, что агент на Aggregator активен;
• убедитесь, что сервер клиента может выполнять исходящие HTTPS-запросы;
• посмотрите раздел «Журнал» Monitor;
• сверьте системное время на обоих серверах — авторизация использует временную метку.

Важно: Не копируйте один и тот же токен на несколько независимых сайтов. Для каждого установленного Monitor создавайте отдельную запись агента.

Полный URL или базовый домен

В поле Aggregator можно использовать стандартный полный endpoint или базовый адрес центра. Если инфраструктура использует нестандартный reverse proxy, отдельные поля command URL и result URL позволяют не полагаться на автоматическое построение адресов.

Проверка нескольких SITE_ID

Если одна установка Битрикс обслуживает несколько сайтов, Monitor отправляет данные по каждому зарегистрированному SITE_ID. После первой передачи проверьте, что Aggregator создал ожидаемые карточки и не показывает технические/старые сайты, которые уже не используются.

Ротация токена

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

[Скриншот 3: сайт, появившийся в Aggregator]