Дашборд состояния сервера
Дашборд администратора отображает четыре графика в реальном времени — RAM, CPU, частота HTTP-запросов и WebSocket-соединения — в скользящем окне на один час. Данные собираются каждые 30 секунд фоновой горутиной и отправляются в браузер через WebSocket.
Сбор данных
Services.InitHealthMonitor() запускает горутину при старте, которая вызывает runHealthCheck() немедленно и затем каждые 30 секунд. Каждая выборка читает четыре источника:
| Метрика | Источник |
|---|---|
| RAM | /proc/meminfo — парсит MemTotal, MemFree, Buffers, Cached, SReclaimable. Используется = Total − Free − Buffers − Cached − SReclaimable. |
| CPU | /proc/stat — две последовательные выборки; (deltaTotal − deltaIdle) / deltaTotal × 100. Первый тик не даёт значения CPU. |
| HTTP-запросы и задержка | Prometheus-метрики Caddy по адресу http://localhost:2019/metrics (переопределяется через CADDY_METRICS_URL). Читает caddy_http_requests_total и caddy_http_request_duration_seconds_bucket как дельты от предыдущей выборки. |
| WebSocket-соединения | Websockets.MainHub.ConnectionCount() — актуальное количество на момент выборки. |
Только Linux. /proc/meminfo и /proc/stat недоступны на macOS и Windows. Колонки RAM и CPU будут пусты на не-Linux-хостах (локальная разработка, CI). Caddy должен предоставлять admin API на :2019; если он недоступен — колонки HTTP тихо остаются пустыми.
Хранение
Каждая выборка добавляется как CSV-строка в logs/health/health_YYYY-MM-DD.csv. Один файл на календарный день. Формат:
timestamp,ram_total,ram_used,ram_available,cpu_pct,http_requests,http_latency_buckets,ws_active
Бакеты задержек хранятся в формате 0.005:12|0.01:34|… (пары le:count через |). Они сохраняются, но в текущем фронтенде не отображаются.
Хранение: pruneOldHealthLogs запускается после каждой выборки и удаляет файлы старше 30 дней по mtime.
Доставка в реальном времени
После каждой выборки, если есть подписчики, healthBroadcaster вызывает Websockets.MainHub.BroadcastToUsers:
{ "type": "health_update", "data": { ... } }
Подписки управляются типами WebSocket-сообщений:
health_subscribe— зарегистрировать текущего пользователя для push-обновленийhealth_unsubscribe— прекратить push-обновления- Отключение WebSocket — автоматически отписывает
API-эндпоинт
GET /admin/health (роль 3). Query-параметры start и end в формате 2006-01-02 15:04:05 (локальное время сервера). По умолчанию — последний час. Возвращает HealthData { ram, cpu, http, ws } как map по ключу-метке времени, прочитанный из CSV-файла(ов) для запрошенного диапазона.
Фронтенд дашборда
admin-dashboard.component.ts при ngOnInit:
- Загружает
GET admin/healthдля истории за последний час. - Отправляет
{ type: "health_subscribe" }через WebSocket. - Подписывается на
notificationService.healthUpdate$и вызываетpushPoint(event.data)для добавления новой точки.
При ngOnDestroy: отправляет health_unsubscribe, очищает графики и подписки.
Графики (Chart.js, 4 элемента <canvas>, animation: false):
| График | Датасеты | Ось Y |
|---|---|---|
| RAM | Используется (красный), Доступно (синий), Всего (серый пунктир) | ГБ |
| CPU | % CPU | 0–100 |
| HTTP | Запросов за 30 с | запросы |
| WebSocket | Активных соединений | соединения |
Все четыре графика отображают только последний час. При каждом входящем health_update evictOld() сдвигает самую старую метку и точку данных с каждого графика, удерживая окно на 60 минутах. Деления по оси X показываются через каждые 10 точек.
При начальной загрузке фильтрация ограничена записями за последние 60 минут — если API вернул больше истории, фронтенд отбрасывает лишнее.
Ключевые файлы
| Файл | Роль |
|---|---|
cuento-backend/src/Services/health_service.go |
InitHealthMonitor, горутина выборки, чтение/запись CSV, управление подписчиками |
cuento-backend/src/Controllers/health.go |
Обработчик GET /admin/health |
cuento-backend/src/Websockets/hub.go |
BroadcastToUsers, ConnectionCount |
cuento-frontend/src/app/admin/admin-dashboard/admin-dashboard.component.ts |
Инициализация графиков, WS-подписка, pushPoint, evictOld |