Устранение неполадок
Как локализовать сбой без хаотичной перенастройки.
Результат
Вы сводите сбой к одному воспроизводимому уровню и можете доказать, что исправление вернуло исходный критерий приёмки. Хаотичная перенастройка не требуется.
| Уровень | Первое доказательство |
|---|---|
| Установка | Версия, поддерживаемая система, диагностический вывод |
| Аутентификация | Активный аккаунт и результат входа без секретных значений |
| Разрешения | Рабочее пространство, область доступа, отклонённое действие |
| Инструкции | Действующий корневой файл, область папки, конфликтующее правило |
| Инструмент или коннектор | Точный вызов, входная структура, ошибка, идентичность сервиса |
| Данные | Путь, версия, формат, обязательное поле, кодировка |
| Результат | Ожидаемый формат, фактический артефакт, нарушенный критерий, вид в целевом приложении |
Действия
- Запишите точное действие, время, среду, версию входов, ожидаемый и фактический результат и первый нарушенный критерий приёмки.
- Сохраните полный текст ошибки и нужный фрагмент протокола без секретов; не теряйте коды и пути при пересказе.
- Воспроизведите сбой с минимальным безопасным входом и без посторонних изменений.
- Проверяйте по одному уровню, начиная со входных данных, правил проекта, активного аккаунта и границ разрешений.
- Сравните версии и конфигурацию с последним принятым запуском и сформулируйте одну проверяемую гипотезу причины.
- Измените один фактор, повторите минимальный пример и запишите, подтвердилась ли гипотеза.
- Вернитесь к исходной задаче и повторите её нарушенный критерий приёмки до закрытия проблемы.
Проверка
В записи есть минимальный пример, нарушенный уровень, доказательство причины, одно ограниченное изменение и успешный повтор исходного критерия на нужных данных или артефакте. Успех другой команды не считается достаточным.
Если не получилось
Остановите изменения и сохраните версии, конфигурацию, текст ошибки и минимальный безопасный пример. По возможности верните последнюю принятую конфигурацию. Для обращения в поддержку передайте нарушенный уровень, воспроизведение, ожидаемый и фактический результаты и уже выполненные проверки, но не учётные данные и не закрытые материалы кейса.
Дальше: Глоссарий.