← Назад к «Справочник»

Диагностика и неполадки

Обновлено:

Стартовая точка при проблеме: найдите симптом в таблице, перейдите в профильный раздел. Общие инструменты диагностики — в конце страницы.

Установка и сервер#

Симптом Вероятная причина Где решается
curl /api/v1/health не отвечает Firewall, порт не слушается, контейнер nginx/app не поднялся Развёртывание: health-проверки
connection refused на 443 Контейнер приложения упал — смотрите docker compose ps и журналы Справочник портов
Клиент не подключается к серверу Неверный server_url/порт, сертификат, backpressure 503 Клиент LSUS, backpressure
Веб-админка недоступна, нужен патч Прикладная ошибка сервера Патчи: офлайн-применение
Админка тормозит или отдаёт 504 при массовом опросе агентами Шторм клиентов занимает пул; посмотрите заголовок X-LSUS-Pool в ответах UI/API (какой пул ответил; на /repos заголовка нет) и 504 по пулам в журналах. Веб-интерфейс обслуживается отдельным админским пулом — если тормозит и он, узкое место общее: БД/PgBouncer. При регулярных импортах ISO/MSU поднимите GUNICORN_ADMIN_WORKERS до 4 Справочник переменных, backpressure
504 на всех /repos при массовой установке через прокси-репозитории Edge (Salt) Пул раздачи занят долгими прокси-скачиваниями; с 1.0.113 лишние получают быстрый 503 + Retry-After (это норма), одинаковые файлы склеиваются — обновитесь и проверьте заголовок X-LSUS-Edge-Proxy. На 1.0.112 — поднять GUNICORN_HTTP_WORKERS/THREADS справочник переменных
Пачками 502 на индексах линий с Пограничного сервера, тело ровно 12 байт Пограничный сервер не успел ответить, раздатчик короткое время отвечает отказом сам. В ответе смотрите X-LSUS-Edge-Proxy: stale — отдана прошлая копия, miss — файла на Пограничном сервере нет. В архиве диагностики мастера — repod/healthz.json (счётчики обращений и отказов). Если линия всё время ходит на Пограничный сервер, переведите её в режим зеркала Справочник переменных
Медленная раздача репозиториев (apt update висит) Сначала кеш и канал: проверьте X-Cache в ответе на индекс (MISS каждый раз — кеш выключен), лимиты WAN-канала и утилизацию диска. Если apt перестал ходить после обновления — посмотрите контейнер раздатчика (docker logs lsus-repod, состояние в docker ps) и при необходимости верните раздачу приложением: LSUS_REPOS_BACKEND=127.0.0.1:18080 (Master/Site) или 127.0.0.1:18540 (Edge) и пересоздать фронт-nginx. Пакеты .udeb/исходники идут стримом намеренно; кеш пакетов (TTL > 0) обходит лимит канала Справочник переменных

Обновления#

Симптом Вероятная причина Где решается
Хост не появляется в кампании Не в целевой коллекции, пауза, агент не опрашивает сервер Кампании Linux, Хосты
Прогон висит в «выполняется» Клиент не докачал пакеты, завис WUSA (Windows) Тестирование обновлений
Задание Windows в статусе «замер» Антивирус или EDR блокирует файлы обслуживания Windows, журнал CBS не растёт Антивирус и установка обновлений
Ошибка KB «доступ запрещён» (0x80070005) Антивирус держит блокировку на каталогах обслуживания Windows Антивирус и установка обновлений
Прогон Linux не начинается, ошибки нет Занят пакетный менеджер: блокировка dpkg/apt, в том числе из-за проверки антивирусом Антивирус и установка обновлений
OVAL-находки не обновляются Автосинк не настроен/нет доступа к источнику OVAL\MSRC
Снапшот перед обновлением не создаётся Хост без LVM или мало места в VG Снапшоты: неполадки
Шаттл: импорт бандла заблокирован, «подпись не совпала»/«ключ неизвестен» Ключ Edge сменился или первый рейс (TOFU) Файловый шаттл: устранение неполадок
Шаттл: задачи «в очереди», ничего не едет Не записан request.json («Подготовить рейс») или носитель не дошел до Edge Файловый шаттл
Шаттл: «Устарел wsusscn2.cab», бандла нет Нет нового бандла в источнике дольше 35 дней Файловый шаттл: уведомления
База Master быстро растёт (десятки ГБ), хотя репликации нет Пишется журнал событий репликации, а чистка ждёт филиал, который давно не синхронизировался Ниже, рост журнала репликации
Нет уведомлений «устаревшие сканы Windows» / «низкое соответствие» Фоновая проверка флота падала из‑за слишком длинной ссылки в карточке Исправлено в текущей версии; перезапустите worker после обновления

Рост журнала репликации#

Если на Master нет живых филиалов, события репликации больше не пишутся. Чистка игнорирует заглушку «master» и филиалы, которые не синхронизировались дольше недели; порог — последняя успешно отданная позиция каждого живого филиала.

Разовая уборка уже разросшейся таблицы — в окно обслуживания на хосте Master:

sudo DRY_RUN=1 bash /opt/lsus-docker/scripts/cleanup-sync-events-stale-sites.sh
sudo bash /opt/lsus-docker/scripts/cleanup-sync-events-stale-sites.sh

Сетевая установка (PXE)#

Симптом Вероятная причина Где решается
Машина не грузится по сети DHCP не направляет PXE-запросы на точку Сетевой runbook
«Не грузится» без видимой причины У EFI нет сетевой BootEntry или включён Secure Boot Secure Boot
Загрузка идёт, установка не начинается Истёк boot-token (TTL) Создайте задание заново или увеличьте TTL — Задания
MAC не появляется в очереди PXE Подсеть не прописана в карточке точки PXE-точки
Разобрать DHCP-обмен по MAC — Журнал «Диагностика DHCP» на вкладке точек

Хосты и доступ#

Симптом Вероятная причина Где решается
Хост «не в сети» хотя работает Пропущены heartbeat'ы, firewall, время на хосте Центр отладки хоста
Нужно посмотреть файлы/логи на хосте — Центр отладки хоста
Пользователь не видит раздел/хосты Не хватает права или scoped RBAC ограничивает RBAC
LDAP-объекты «зависли» в orphaned Объект исчез из каталога, но привязан к политике Каталог и политики

Общие инструменты#

  • Центр отладки хоста — SSH-подобный доступ из карточки хоста: терминал, файлы, журналы агента. См. руководство.
  • Журналы на сервере: docker logs lsus-master, lsus-master-worker; логи приложения в data/master/log/.
  • Журнал агента на хосте: journalctl -u lsus-client -n 50 --no-pager.
  • Сбор логов для поддержки: кнопки «Скачать отчёт за сутки» и «Скачать обезличенный отчёт за сутки» — Патчи и поддержка.
  • Состояние БД/миграций: Docker и образы.

Связанные страницы#