# Проверки по смыслу ## Что это **Было:** проверяем «порт открыт». **Стало:** проверяем «служба РАБОТАЕТ». Разница важная: служба может отвечать кодом 200, но при этом не работать с базой, отдавать заглушку или страницу ошибки. ## Как проверяем | Способ | Что проверяет | |---|---| | **Содержимое ответа** | отдаёт ли служба ОЖИДАЕМЫЙ ответ | | **Работа с базой** | реальный SQL-запрос к каждой базе | | **Через домены** | работает ли вход так, как видит пользователь | | **Не 5xx** | служба не отдаёт ошибку сервера | ## Примеры проверок ``` Gitea → /api/v1/version должен вернуть "version" Vaultwarden → /alive должен ответить Matrix → /_matrix/client/versions должен вернуть "versions" Element → должен вернуть "Buryan" (наш бренд) Immich → /api/server/ping должен вернуть "pong" Grafana → /api/health должен вернуть "ok" Prometheus → /-/healthy должен вернуть "Healthy" Loki → /ready должен вернуть "ready" Базы (реальные запросы): gitea_db → количество репозиториев matrix_db → количество пользователей vaultwarden_db → количество пользователей ``` ## Расписание ``` каждые 5 минут: /opt/buryan-hub/scripts/check-services.sh журнал: /var/log/buryan-hub/checks.log состояние: /var/lib/buryan-checks/last-fail ``` ## Умная тревога **Тревога отправляется ТОЛЬКО при НОВОМ провале.** Если та же проблема повторяется — не заваливает повторами. **При восстановлении** приходит сообщение «всё восстановилось» с перечнем того, что сбоило. ## Проверить вручную ```bash /opt/buryan-hub/scripts/check-services.sh tail -20 /var/log/buryan-hub/checks.log cat /var/lib/buryan-checks/last-fail ``` ## Что это даёт О поломке узнаём **до пользователя** — и узнаём, что именно сломалось, а не просто «что-то не отвечает».