Мониторинг

Состояние кластера видно в админке (вкладка 🌐 Кластер), через публичные API и в плагине Lampa.

Админ-дашборд

Вкладка обновляется автоматически каждые 5 секунд.

Сводка

Карточка	Что показывает
Режим	`primary` / `node`, статус API-ключа
Стратегия	Текущий алгоритм выбора ноды
Ноды	Живые / всего (healthy / total)
Локальные коннекции	Активные соединения на самом primary

Таблица нод

Колонка	Значение
Статус	● Healthy / ● Down / ⏸ Disabled
Live	Активные соединения сейчас
Served	Всего обслужено запросов
Fail	Ошибок форварда
Users	Уникальных клиентов за последние 5 минут (≈ человек)
Traffic	Передано байт через ноду
Top балансёр	Самый частый источник на ноде
Avg ms / Last ms	Средний (EWMA) и последний пинг
Вес	Относительный вес в распределении

Клик по строке ноды разворачивает детальную разбивку запросов по балансёрам с процентами.

Под таблицей — блок 🖥 Локально на primary с теми же метриками для самого primary.

Действия по ноде

📡 — немедленный probe (не ждать 30с цикла)
⏸ / ▶ — отключить / включить ноду
✏️ — редактировать (имя, хост, вес, регион)
🗑 — удалить

Публичные эндпоинты

`GET /api/servers/info`

Инфо о текущем сервере (без авторизации):

{
  "name": "Alcopac-Main",
  "region": "EU",
  "version": "0.4",
  "mode": "primary",
  "cluster": true,
  "strategy": "hybrid",
  "nodes_total": 2,
  "nodes_healthy": 2
}

`GET /api/servers/list`

Список нод — отдаётся только если включено «Публиковать список нод» в настройках. Хосты включаются только при «Включить хосты нод»:

{
  "strategy": "hybrid",
  "servers": [
    {"self": true,  "name": "Alcopac-Main", "region": "EU", "healthy": true, "uptime_pct": 100},
    {"self": false, "name": "RU-SPB", "region": "RU", "healthy": true, "uptime_pct": 98.3, "avg_latency_ms": 37}
  ]
}

`GET /servers`

HTML-дашборд со списком серверов, авто-refresh каждые 10с + client-side ping (если хосты публичные).

Заголовки ответа

Ко всем не-/proxy/ ответам добавляется:

X-Lampac-Server — имя сервера, который обработал запрос
X-Lampac-Server-Region — регион
X-Lampac-Server-Host — хост ноды (только когда запрос был форварднут)

Используй для проверки: открой DevTools → Network → ответ /lite/... → если X-Lampac-Server = имя ноды, запрос прошёл через неё.

Плагин в Lampa

Раздел «Серверы» в настройках Lampa (включается флагом [web.plugins] server_widget = true).

Показывает по каждому серверу:

Доступность % (uptime за последний час по health-probe)
Пинг (latency)
Качество — единый бар (uptime × 0.7 + latency × 0.3) с цветовой меткой

Виджет — чисто информационный (read-only). Маршрутизация полностью на стороне primary; клиент только отображает состояние.

Включение

[web.plugins]
server_widget = true

После перезапуска primary плагин автоматически попадает в on.js и подгружается стандартной Lampa без ручной установки.

Настройки доступности

В админке (🌐 Кластер → ⚙️ Настройки):

Параметр	По умолчанию	Описание
Probe interval	30с	Интервал health-probe
Fail threshold	3	Неудач подряд до пометки down
Recover threshold	2	Успехов подряд до восстановления
Max retries при 5xx	2	Попыток на других нодах при ошибке
Имя сервера	—	Показывается в `X-Lampac-Server` и виджете
Регион сервера	—	Тег региона
Публиковать список нод	вкл	Отдавать `/api/servers/list`
Включить хосты нод	выкл	Включать хосты в публичный список

Маршрутизация