4.5 KiB
Проверки по смыслу
Что это
Было: проверяем «порт открыт». Стало: проверяем «служба РАБОТАЕТ».
Разница важная: служба может отвечать кодом 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
Умная тревога
Тревога отправляется ТОЛЬКО при НОВОМ провале. Если та же проблема повторяется — не заваливает повторами.
При восстановлении приходит сообщение «всё восстановилось» с перечнем того, что сбоило.
Проверить вручную
/opt/buryan-hub/scripts/check-services.sh
tail -20 /var/log/buryan-hub/checks.log
cat /var/lib/buryan-checks/last-fail
Что это даёт
О поломке узнаём до пользователя — и узнаём, что именно сломалось, а не просто «что-то не отвечает».
Исправление ложных проверок (16.10.2026)
Что было не так
Первый запуск дал два ложных провала:
| Провал | Почему ложный |
|---|---|
PostgreSQL: не отвечает |
PostgreSQL не говорит по HTTP — я проверял базу как сайт |
Element: нет 'Buryan' |
Element — приложение на JavaScript, слова нет в начальном HTML |
Обе службы были исправны. Ошибалась проверка.
Как исправлено
PostgreSQL → убрана HTTP-проверка, оставлен РЕАЛЬНЫЙ запрос к базе
Element → проверяется /config.json (там есть наш бренд «Buryan»)
Alertmanager→ убран путь /-/healthy (у него другой), проверяется корень
Урок
Это повторение того же правила: при расхождении — сначала проверить саму проверку, а не службу.
Признак хорошей проверки: она опирается на документированный
адрес состояния (/health, /ping, /ready, /api/health),
а не на догадку о содержимом страницы.
Таблица адресов состояния
| Служба | Адрес для проверки |
|---|---|
| Gitea | /api/v1/version |
| Matrix | /_matrix/client/versions |
| Vaultwarden | /alive |
| Immich | /api/server/ping |
| Grafana | /api/health |
| Prometheus | /-/healthy |
| Loki | /ready |
| Syncthing | /rest/noauth/health |
| Sonarr/Radarr/Prowlarr | /ping |
| Element | /config.json (там бренд) |