Перейти к основному содержанию
Агент — глаза панели на ноде. Он регулярно отправляет три вида отчётов: heartbeat (признак жизни и метаданные хоста), снимок системных метрик и статусы служб из фиксированного каталога. На основе этих данных панель строит вкладки Метрики и Сервисы, вычисляет статус ноды и применяет ограничения скорости.
Для кого: администратор панели, SRE. Требуемые права: администратор панели (чтение метрик и служб).

Периодичность

Частоту отчётов агенту сообщает сервер при регистрации; значения по умолчанию:
ОтчётПериодичность по умолчанию
Heartbeatкаждые 15 секунд
Метрикикаждые 30 секунд
Статусы службкаждые 30 секунд
Опрос задачкаждые 10 секунд
Если heartbeat не приходит около 90 секунд, панель помечает агента offline.

Метрики

Каждый снимок метрик содержит:
  • CPU — загрузка в процентах, load average за 1/5/15 минут, давление CPU (PSI);
  • Память — всего/использовано, swap всего/использовано;
  • Диск — всего/использовано, скорость чтения/записи;
  • Сеть — накопленные rx/tx байты и текущие скорости, ошибки и потери пакетов в секунду, TCP-ретрансмиты в секунду;
  • Соединения — TCP established/listen/time-wait, UDP-сокеты, счётчик и лимит conntrack;
  • Система — открытые файловые дескрипторы и лимит, число процессов, uptime, доступность и включённость BBR, активная дисциплина очереди (qdisc).
Агент также передаёт телеметрию для антиабьюз-системы панели — она используется детекторами злоупотреблений; в метриках ноды она отдельно не отображается. Хранение: метрики хранятся 7 дней (по умолчанию), старые записи вычищаются автоматически. Чтение временного ряда: Параметр since задаёт окно выборки; максимум — 24 часа.

Каталог служб

Агент следит за фиксированным каталогом из 14 служб:
СлужбаФорма
axottle-agent.servicesystemd
docker.servicesystemd
docker:remnanodeDocker-контейнер
remnanode.servicesystemd
caddy.servicesystemd
nginx.servicesystemd
docker:caddyDocker-контейнер
docker:nginxDocker-контейнер
warp-svc.servicesystemd
docker:warpDocker-контейнер
fail2ban.servicesystemd
crowdsec.servicesystemd
ufw.servicesystemd
firewalld.servicesystemd
Статусы сервисов: если служба не установлена, она отображается как absent («Не установлена»), а не как «мёртвая». Перезапуск службы из панели учитывает её форму: контейнеры перезапускаются через Docker, systemd-юниты — через systemd. Снимок статусов:

Heartbeats

Heartbeat — это признак жизни агента плюс метаданные хоста и ОС и краткая сводка здоровья. Heartbeat также участвует в подтверждении обновлений: задание обновления агента считается успешным только после heartbeat с целевой версией (см. Обновления).

QoS: ограничение скорости

Когда антиабьюз-система панели назначает конкретной подписке ограничение скорости, агент на каждом ноде регулярно (примерно каждые 30 секунд) забирает список активных ограничений и применяет их на уровне ядра ноды — участие прокси-софта не требуется. Поведение:
  • Идемпотентная синхронизация — ограничения, снятые на сервере, автоматически снимаются на ноде при следующем проходе.
  • Недоступное применение — если на ноде нет необходимого инструментария, агент сообщает, что не может применять QoS, и панель показывает ограничение как «сохранено, но не применено», а не делает вид, что оно работает. Скрипт установки агента по возможности доустанавливает нужные пакеты (см. Установку агента).

Проверка

Вкладка Метрики показывает свежие точки (не старше минуты), а вкладка Сервисы — актуальные статусы, включая absent для неустановленных служб.

Откат

Отчётность агента — это телеметрия, отдельного выключателя у неё нет; единственный способ прекратить её — удалить агент с ноды (см. откат установки). Ограничения QoS откатываются на стороне панели: снятое ограничение агент автоматически уберёт с ноды при следующем цикле синхронизации.

Ограничения и риски

  • Метрики хранятся 7 дней — для более долгого хранения выгружайте их внешними средствами.
  • Окно выборки метрик ограничено 24 часами на запрос.
  • Возможности агента (сбор метрик, применение QoS и т. п.) самодекларируемые и зависят от установленного на ноде инструментария; недостающие базовые пакеты можно доустановить операцией provision с вкладки Агент.

Типовые ошибки

Проверьте, online ли агент (вкладка Агент, systemctl status axottle-agent на ноде). Порядок действий — в Диагностике.
absent означает «не установлена на ноде» — агент её просто не нашёл. Проверьте на ноде, установлена ли служба и в той ли форме (systemd против Docker-контейнера).
На ноде нет необходимого инструментария для QoS. Выполните provision недостающих пакетов с вкладки Агент или переустановите агент скриптом — он доустанавливает зависимости.
Связанные страницы: Обзор нод, Обновления, Диагностика.
Проверено для версии Axottle текущей ветки. Дата проверки: 2026-07-11.