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

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

Частоту отчётов агенту сообщает сервер при регистрации; значения по умолчанию: Если 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 часа.

​
Качество канала и проверка пути

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

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

Агент следит за поддерживаемым каталогом служб. Ниже приведены основные варианты; наличие и операции зависят от версии агента и способа установки: Статусы сервисов: если служба не установлена, она отображается как 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.