Документация / Диагностика отказов
Диагностика отказов
Для администратораКогда что-то работает не так
Почти любой разбор начинается с одного вопроса, перестало работать все или одна автоматизация. Ответ на него виден на первом же экране и сразу делит поиск надвое.
Порядок разбора
- Открыть обзор платформы
Если сводное состояние «работает с ограничениями» или хуже, смотрите таблицу частей. Там названа часть с замечанием и последствие ее отказа. Если все части в работе, дело не в платформе целиком, а в конкретной автоматизации.
- Посмотреть автоматизацию
На экране настройки у автоматизации стоит состояние. «Не хватает данных» и «настройка не закончена» объясняют отказ сразу, без дальнейшего разбора.
- Открыть запись хода запуска
Она показывает, на каком шаге дело остановилось, к какой системе обращалось и что ответила модель. Это отвечает на вопрос «почему такой результат», а не только «работает или нет».
- Проверить расход
Если предел выбран, запуски останавливаются, и внешне это выглядит как поломка автоматизации. Экран моделей показывает остаток.
Быстрый маршрут по симптому
Таблица отвечает на вопрос, куда смотреть первым, и ничего не объясняет. Объяснения ниже.
| Что говорят пользователи | Первый экран |
|---|---|
| Ничего не работает, никто не может войти | Обзор платформы |
| Работает, но медленно | Обзор платформы, часть с замечанием |
| Одна автоматизация отвечает ошибкой | Настройка автоматизаций, состояние этой автоматизации |
| Автоматизация отвечает не то | Запись хода запуска этого дела |
| Дела копятся, никто их не берет | «Сводка» и вкладка людей у автоматизации |
| Запуски встали разом | Модели и маршрутизация, остаток по области |
| После обновления часть автоматизаций отвечает ошибкой | Миграции |
| Команда установщика отказала | Код возврата и сообщение проверки |
Коды возврата команд
Команды установщика возвращают код, по которому виден класс отказа. Главное, что он говорит, это тронут ли сервер.
| Код | Что означает | Тронут ли сервер |
|---|---|---|
| 0 | Готово | Да, изменения применены |
| 1 | Шаг операции упал, состояние в журнале | Частично, продолжается с места отказа |
| 2 | Ошибка в описателе или в аргументах | Нет |
| 3 | Не хватает подтверждения опасного действия | Нет |
| 4 | Операция уже идет | Нет |
| 5 | Несовместимость версий | Нет |
| 6 | Найдены правки в обход описателя | Нет |
| 7 | Состояние уже достигнуто | Нет, изменений ноль |
| 8 | Проверка целостности не прошла | Нет |
| 9 | Недоверенный вход отклонен до распаковки | Нет |
Отказы проверки готовности
Проверка готовности идет до того, как сервер тронут, и отказывает по одной из десяти причин. Ниже те, что встречаются чаще, и что за ними стоит.
| Что отказало | Что это значит | Что сделать |
|---|---|---|
| Версии Docker и Compose | Они недоступны или их версии вне диапазона, объявленного поставкой | Обновить или откатить Docker до объявленного диапазона |
| Свободное место | В каталоге данных меньше, чем нужно объявленным томам плюс запас | Освободить место или перенести каталог данных на больший диск |
| Место под поставку | Не хватает под архив и его распакованный вид одновременно | Освободить место в каталоге импорта, оно нужно временно |
| Права на запись | Каталоги данных, конфигурации или состояния недоступны на запись | Выдать права владельцу платформы, не запускать установщик от другого пользователя |
| Порты периметра | Порты, которые платформа публикует наружу, заняты на сервере | Освободить порты. Без этой проверки отказ обнаружился бы уже после развертывания |
| Часы сервера | Синхронизация времени не подтверждена | Настроить синхронизацию. В закрытой сети время подтверждается явно, и это попадает в журнал |
| Поставка в закрытой сети | Файла поставки нужной версии в вашей сети нет | Принести поставку целиком, докачать по частям в закрытой сети нельзя |
| Шифрование томов | Шифрование данных на сервере не подтверждено, а профиль его требует | Включить шифрование средствами сервера или принять риск явно, он попадет в журнал |
Работа с ограничениями
Состояние «работает с ограничениями» означает, что критические части в работе, а часть возможностей недоступна. Это не поломка и не норма, это третье состояние, и разбирать его нужно в тот же день.
Чаще всего за ним стоит одно из следующего.
- Поставщик модели не отвечает. Платформа считает через следующего по приоритету или, если следующего нет, не считает вовсе. Видно на экране моделей.
- Не отвечает часть, не входящая в критические. Например, сбор записей хода запусков. Работа идет, но разбирать дела потом будет нечем.
- Диск заполняется. До отказа далеко, но запас кончается, и это стоит увидеть за неделю, а не в ночь отказа.
Врезка под плитками на обзоре платформы называет, что именно случилось и что с этим делать, а не только степень тревоги.
Типовые отказы
| Что видно | Обычная причина | Что сделать |
|---|---|---|
| Сотрудники не могут войти | Не отвечает часть, отвечающая за вход, или ядро | Обзор платформы, смотреть критические части |
| Одна автоматизация отвечает ошибкой после обновления | Обновление не доехало до конца | Экран миграций, не осталось ли непримененных |
| Ассистент отвечает «в ваших данных этого нет» | Выгрузка не проиндексирована или не содержит нужного | Вкладка готовности у автоматизации |
| Дела копятся, их не берут в работу | Роли автоматизации не розданы | Вкладка людей и доступа |
| Запуски внезапно остановились | Выбран предел расхода | Экран моделей, остаток по области |
| Модель отвечает с задержкой или отказом | Поставщик на паузе после отказов | Экран моделей, состояние развертываний |
| Команда установщика отказывает с кодом 6 | Кто-то правил собранные файлы руками | Вернуть правку в описатель либо принять расхождение явно |
| Проверка готовности отказывает по времени | Часы сервера разошлись с эталоном | Проверить синхронизацию времени |
Когда сломалась одна автоматизация
Если платформа в порядке, а автоматизация отвечает не так, разбор идет по записи хода запуска. Она показывает каждый шаг, и вопросы к ней такие.
- Дошло ли дело до конца
Состояние прогона написано словом. «Ждет человека» означает, что дело стоит в очереди, а не сломалось, и смотреть надо, кому выданы роли.
- На каком шаге остановилось
Шаг назван своим именем. Если это обращение к вашей системе, дальше смотрят, что ответила система и не исчерпаны ли повторы шага.
- Что получила модель на вход
Персональные данные в записи заменены метками. Если на вход пришло не то, дело не в модели, а в предыдущих шагах или в том, что автоматизация читает не те поля.
- Какой класс модели и какая модель ответила
Это два разных факта. Класс говорит, что было разрешено политикой, имя модели - кто ответил на самом деле.
- Не уперлось ли в границу
Слишком длинный контекст, исчерпанный предел расхода и запрет маршрута данных выглядят для пользователя одинаково, а чинятся по-разному. Отказ назван в записи прямо.
Разбор ответов, которые формально верны, но не нравятся по существу, идет не здесь. Там смотрят выгрузку документов и тексты инструкций, и об этом рассказано на странице создания ассистента с нуля.
Что приложить к обращению
Обращение разбирается быстрее, когда в нем есть четыре вещи. Первые две видны на экране обзора платформы.
- Идентификатор платформы.
- Версия платформы.
- Номер запуска, если речь о конкретном деле.
- Время, когда это наблюдали, с указанием часового пояса.
Написать в поддержку можно с этой страницы.