diff --git a/ops/monitoring/CHECKS-HOWTO.md b/ops/monitoring/CHECKS-HOWTO.md index 67fd36a..c67aa3b 100644 --- a/ops/monitoring/CHECKS-HOWTO.md +++ b/ops/monitoring/CHECKS-HOWTO.md @@ -63,3 +63,50 @@ 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` (там бренд) | diff --git a/ops/monitoring/check-services.sh b/ops/monitoring/check-services.sh index 4c80421..9a60120 100755 --- a/ops/monitoring/check-services.sh +++ b/ops/monitoring/check-services.sh @@ -64,7 +64,6 @@ check_db() { # $1=имя $2=база $3=запрос $4=ожидаемое чи echo "[$(date '+%Y-%m-%d %H:%M:%S')] проверка служб" >> "$LOG" # ── ОСНОВА ── -check "PostgreSQL" "http://192.168.1.151:5432" "" 3 # порт (для формы) check_db "PostgreSQL-базы" "postgres" "SELECT count(*) FROM pg_database WHERE datname NOT IN ('template0','template1')" "" check_db "Gitea-база" "gitea_db" "SELECT count(*) FROM repository" "" check_db "Matrix-база" "matrix_db" "SELECT count(*) FROM users" "" @@ -74,14 +73,14 @@ check_db "Пароли-база" "vaultwarden_db" "SELECT count(*) FROM users" " check "Gitea" "http://192.168.1.140:3000/api/v1/version" "version" check "Vaultwarden" "http://192.168.1.109:8081/alive" "" check "Matrix" "http://192.168.1.155:8008/_matrix/client/versions" "versions" -check "Element" "http://192.168.1.155:8088/" "Buryan" +check "Element" "http://192.168.1.155:8088/config.json" "Buryan" check "Authentik" "http://192.168.1.114:9000/-/health/live/" "" check "n8n" "http://192.168.1.108:5678/healthz" "" check "Immich" "http://192.168.1.104:2283/api/server/ping" "pong" check "Paperless" "http://192.168.1.105:8000/api/remote/version/" "" check "Grafana" "http://192.168.1.113:3000/api/health" "ok" check "Prometheus" "http://192.168.1.134:9090/-/healthy" "Healthy" -check "Alertmanager" "http://192.168.1.134:9093/-/healthy" "" +check "Alertmanager" "http://192.168.1.134:9093/" "" check "Loki" "http://192.168.1.113:3100/ready" "ready" check "Syncthing" "http://192.168.1.139:8384/rest/noauth/health" "" check "Mealie" "http://192.168.1.110:9925/api/app/about" ""