/
Чек-лист по неполадкам

Чек-лист по неполадкам

Тип статьи

Полезное знание

Компетенции

Администратор

Версия платформы

Любая

Статус

бета

Сложность

средне

Полезные ссылки

Дополнительные сведения

 

Это общий чек-лист, который охватывает все симптомы глобального нарушения работы платформы, например, не запускаются Docker контейнеры или невозможно зайти на портал. Проверка всех пунктов из него решает немало проблем с очевидными причинами и экономит уйму времени.

Удовлетворяет ли сервер системным требованиям?

Нужно смотреть статью “Системные требования“ конкретно для вашей версии платформы. Для прод сервера мощности рассчитываются. Для тест сервера указаны явно. Для простого теста почти без данных и без Vitalk подойдет 5 Гб ОЗУ, 4 ядра и 50 Гб на накопителе, но без гарантий успешного использования.

Какова динамика использования ресурсов сервера? Используется ли swap?

Адрес_платформы/grafana - хранятся метрики за последние 7 дней. Swap смотреть на терминале сервера, его использование является критическим инцидентом, так как может привести к сильной деградации производительности Викуба вплоть до зависания.

Исправно ли железо, на котором работает машина?

RAM/HDD/SSD.

Корректно и правильной ли версии установлен Docker/Docker-Compose?

Указано в статьях по установке конкретной версии платформы. Более поздняя версия не должна вызывать проблем.
Docker часто ставят через snap - это ошибка и приводит к невозможности запустить Docker сервисы в Swarm. Через snap Docker ставится, например, если отметить флажок во время установки ОС.

Загружены ли все Docker образы и у всех есть тег latest?

Сверять лучше с файлами в папке images дистрибутива.

Работает ли на машине Firewall или дополнительное ПО по комплексной защите?

Если работает, то нужно временно выключить для подтверждения причины, а после уже настраивать отдельно.

Редактировались ли вручную цепочки в iptables?

Полезна статья https://docs.docker.com/network/iptables/ и понимание, что без веской причины менять правила не стоит.

Адрес, по которому платформа открывается в браузере совпадает с адресом, указанным с параметром -р при запуске скрипта run.sh?

По состоянию в версии 2.25 платформа может работать только на одном адресе, на котором была запущена.

Исправны ли все Docker сервисы и ожидаемый ли uptime у Docker контейнеров платформы?
Веб интерфейс платформы открывается в официально поддерживаемом браузере с актуальной версией?

Указано в системных требованиях.

Доступен ли адрес платформы изнутри Docker контейнеров?

Проверяется через CURL, например, из контейнера admin на адрес example.visiology.com/viqube/version . При отсутствии доступа его нужно предоставить.

Все ли в порядке с SSL сертификатами?

Основные причины: неполная цепочка, сертификат уровня предприятия (не добавленный в платформу), старая версия платформы с использованием сертов от Let’s Encrypt.

Есть ли в Seq/Grafana/Docker демоне логи, которые явно говорят о причине?

В Seq логи не всех компонентов, но самые удобочитаемые. Логи докера https://stackoverflow.com/questions/30969435/where-is-the-docker-daemon-log

Нет ли конфликтов с подсетями Docker?

Есть статья https://visiology.atlassian.net/wiki/spaces/v25/pages/37536586353/IP+Docker. Адреса подсетей могут меняться, поэтому смотреть на сервере нужно по факту.

Правильно ли была обновлена платформа? Не была ли пропущена версия и не учитывались ли особенности обновления?

Отталкиваться стоит от данной статьи: Обновление платформы