Диагностика¶

Порядок разбора нештатных ситуаций и решения типовых проблем.

Общий порядок¶

Проверьте состояние компонентов:
```
./bin/orbita-ctl --env production --action health
```
Посмотрите журналы того компонента, который сообщает о проблеме:
```
./bin/orbita-ctl --env production --action logs
```
Определите границу: проблема у одного пользователя, у группы или у всех.
Проверьте, менялось ли что-то в последние сутки: обновление, правка описаний доменов, изменение политик, работы на хранилище.

Эти четыре шага закрывают большинство обращений.

Признак	Что проверить
Страница не отвечает	Доступен ли сервер по сети, работает ли публикация системы по HTTPS
Ошибка сертификата	Срок действия сертификата и его соответствие доменному имени
Открывается, но вход не проходит	Доступность сервиса аутентификации, срок действия его сертификата

Признак	Вероятная причина	Решение
Неверный логин или пароль	Учётная запись заблокирована или пароль истёк	Проверить учётную запись в сервисе аутентификации
Вход проходит, но система пишет об отсутствии доступа	Не назначена роль	Назначить роль, см. Пользователи и права
Вход в плагине не сохраняется	Ограничения на рабочем месте	Проверить доступность адреса системы с рабочего места

Признак	Вероятная причина	Решение
Ошибка обращения к данным	Недоступно аналитическое хранилище	Проверить доступность хранилища и учётную запись подключения
Долгий ответ, затем ошибка	Превышен тайм-аут запроса	Проверить нагрузку на хранилище, при необходимости увеличить тайм-аут
Ошибка при обращении к языковой модели	Модель недоступна или исчерпан лимит	Проверить доступность сервиса модели и параметры доступа
Ошибки только у части пользователей	Ограничения политик доступа	Проверить применяемые политики

Это не сбой системы, а вопрос описания данных. Порядок разбора:

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

Что смотреть	Вывод
Время ответа языковой модели	Если растёт, узкое место в модели: нагрузка, размер контекста, оборудование
Время выполнения запросов к хранилищу	Если растёт, узкое место в хранилище: объём данных, отсутствие витрин
Число соединений в пуле	Постоянная работа на пределе означает нехватку пула или слишком тяжёлые запросы
Свободное место на дисках	Заполнение выше 80 процентов замедляет работу баз данных

Трассировка запроса показывает распределение времени по этапам и сразу указывает на источник задержки. См. Наблюдение за работой.