> ## Documentation Index
> Fetch the complete documentation index at: https://docs.axottle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Метрики и службы

> Что агент сообщает панели: метрики системы, каталог служб, heartbeats и поведение QoS.

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

<Info>Для кого: администратор панели, SRE. Требуемые права: администратор панели (чтение метрик и служб).</Info>

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

Частоту отчётов агенту сообщает сервер при регистрации; значения по умолчанию:

| Отчёт         | Периодичность по умолчанию |
| ------------- | -------------------------- |
| 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.service` | systemd          |
| `docker.service`        | systemd          |
| `docker:remnanode`      | Docker-контейнер |
| `remnanode.service`     | systemd          |
| `caddy.service`         | systemd          |
| `nginx.service`         | systemd          |
| `docker:caddy`          | Docker-контейнер |
| `docker:nginx`          | Docker-контейнер |
| `warp-svc.service`      | systemd          |
| `docker:warp`           | Docker-контейнер |
| `fail2ban.service`      | systemd          |
| `crowdsec.service`      | systemd          |
| `ufw.service`           | systemd          |
| `firewalld.service`     | systemd          |

Статусы сервисов: если служба не установлена, она отображается как `absent` («Не установлена»), а не как «мёртвая». Перезапуск службы из панели учитывает её форму: контейнеры перезапускаются через Docker, systemd-юниты — через systemd.

Снимок статусов:

## Heartbeats

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

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

Когда антиабьюз-система панели назначает конкретной подписке ограничение скорости, агент на каждом ноде регулярно (примерно каждые 30 секунд) забирает список активных ограничений и применяет их **на уровне ядра ноды** — участие прокси-софта не требуется.

Поведение:

* **Идемпотентная синхронизация** — ограничения, снятые на сервере, автоматически снимаются на ноде при следующем проходе.
* **Недоступное применение** — если на ноде нет необходимого инструментария, агент сообщает, что не может применять QoS, и панель показывает ограничение как «сохранено, но не применено», а не делает вид, что оно работает. Скрипт установки агента по возможности доустанавливает нужные пакеты (см. [Установку агента](/ru/nodes/installation)).

## Проверка

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

## Откат

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

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

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

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

<AccordionGroup>
  <Accordion title="Метрики перестали обновляться">
    Проверьте, online ли агент (вкладка **Агент**, `systemctl status axottle-agent` на ноде). Порядок действий — в [Диагностике](/ru/nodes/troubleshooting).
  </Accordion>

  <Accordion title="Служба показана как absent, хотя должна работать">
    `absent` означает «не установлена на ноде» — агент её просто не нашёл. Проверьте на ноде, установлена ли служба и в той ли форме (systemd против Docker-контейнера).
  </Accordion>

  <Accordion title="Ограничение скорости «сохранено, но не применено»">
    На ноде нет необходимого инструментария для QoS. Выполните provision недостающих пакетов с вкладки **Агент** или переустановите агент скриптом — он доустанавливает зависимости.
  </Accordion>
</AccordionGroup>

Связанные страницы: [Обзор нод](/ru/nodes/overview), [Обновления](/ru/nodes/updates), [Диагностика](/ru/nodes/troubleshooting).

<Note>Проверено для версии Axottle текущей ветки. Дата проверки: 2026-07-11.</Note>