Технический долг и известные ошибки
Относитесь к известным ошибкам и техническому долгу как к единому видимому учётному журналу отложенных исправлений, измеряйте, чего каждый элемент стоит вам каждый месяц, пока остаётся открытым, и тратьте защищённую долю ёмкости на элементы с самыми высокими процентами.
Обзор и мотивация
Каждая команда что-то откладывает в ремонте. Дефект понят, но не исправлен, срезан угол, чтобы уложиться в дату, компонент оставлен стареть, а обходной путь вписан в руководство по эксплуатации. Каждое откладывание есть разумное решение в момент принятия. Беда начинается, когда отложенное копится вне поля зрения, потому что цена хранения проявляется позже как инциденты, медленная поставка и усталые люди, без строки в каком-либо отчёте, связывающей цену с причиной.
Два словаря описывают один и тот же образец. В ITIL известная ошибка есть проблема, чья первопричина понята и для которой существует обходной путь или ещё не применённое постоянное исправление. Известные ошибки записываются, чтобы персонал службы поддержки и эксплуатации мог быстро разрешать повторные инциденты, и запись остаётся открытой, пока исправление не выпущено. В программной работе Agile технический долг есть метафора, введённая Уордом Каннингемом в 1992 году, для выборов проекта и реализации, затрудняющих будущие изменения. Метафора несёт две идеи, важные для измерения: основной долг (principal), то есть усилие, нужное для устранения долга, и проценты (interest), то есть дополнительное усилие или риск, которые вы платите каждый период, пока долг остаётся.
Два взгляда различаются тем, куда смотрят. Известные ошибки обнаруживаются через эксплуатацию: инцидент или расследование проблемы находит причину. Технический долг обычно обнаруживается через поставку: разработчик замечает, что изменение труднее, чем должно быть. Известная ошибка часто есть технический долг, уже начавший вредить клиентам. Технический долг часто есть известная ошибка, ждущая своего часа. Раздельные списки, один в инструменте ITSM и один в бэклоге или вики, прячут связь и порождают два конкурирующих довода за одну и ту же скудную ёмкость.
Эта тема даёт небольшой набор показателей для объединённого учётного журнала. Она избегает единой денежной цифры долга всей организации, которую ни один метод не даёт надёжно, и измеряет то, что можно наблюдать: открытые элементы, время ожидания, вызванные инциденты, добавленную работу и ёмкость, потраченную на починку. Журнал затем питает разговор о приоритизации между продуктом и эксплуатацией (о записях проблем и постоянных исправлениях см. тему 4.1, Метрики управления проблемами, а о нагрузке прерываний, которую создаёт долг, тему 2.9, Операционная и внеплановая работа).
Термины, используемые в этой теме:
- Обходной путь есть способ восстановить услугу или избежать сбоя, не убирая причину.
- Постоянное исправление убирает причину. Анализ первопричин есть работа, которая её находит.
- Рефакторинг кода перестраивает код, не меняя его внешнего поведения. Это обычный способ погасить долг проекта.
- Запах кода (code smell) есть поверхностный признак в коде, часто указывающий на более глубокую проблему. Это побуждение посмотреть, а не вердикт.
- Альтернативная стоимость есть ценность лучшей альтернативы, от которой вы отказываетесь, выбирая одно использование времени вместо другого. Каждое исправление конкурирует с функцией, и сравнение и есть настоящее решение.
- Цена задержки есть экономическая потеря от откладывания части работы. Это идея за оценкой процентов по элементу долга.
- Программная ошибка есть дефект в программном обеспечении. Известная ошибка может быть багом, слабостью конфигурации, пределом проекта или дефектом поставщика.
- Статический анализ программ изучает код, не запуская его. Его предупреждения и оценки сложности суть индикаторы возможного долга и более слабое свидетельство, чем история инцидентов.
Не всякий долг есть ошибка. Квадрант Мартина Фаулера различает намеренный и непреднамеренный и безрассудный и благоразумный долг (см. список источников). Благоразумный срез угла с планом погашения есть здравный заём, а безрассудный долг есть вид, который надо предотвращать. Метрики здесь не судят о происхождении. Они показывают баланс.
Ключевые принципы
- Один журнал, две двери. Известные ошибки из эксплуатации и элементы долга из поставки попадают в один и тот же видимый список, со связью между записями, описывающими одну причину.
- Измеряйте проценты, а также основной долг. Размер ремонта важен меньше, чем то, во что открытый элемент обходится вам каждый месяц в инцидентах, обходных путях и замедленных изменениях. Ранжируйте по процентам на единицу усилия ремонта.
- Делайте откладывание решением с владельцем. У каждого элемента есть владелец, заявленная причина ожидания и дата пересмотра. Элемент, который никто не выбирал откладывать, есть небрежность, и считается как таковая.
- Защищайте ёмкость раньше, чем она понадобится. Заявленная доля ёмкости каждой команды на работу по ремонту, согласованная заранее, лучше героической чистки после плохого квартала.
- Держите обходной путь честным. Обходной путь есть услуга с собственной ценой, владельцем и видами отказов. Измеряйте, как часто он используется и как часто даёт сбой.
- Описывайте системы, никогда людей. Долг принадлежит услуге или компоненту. Никогда не приписывайте его автору и никогда не ранжируйте инженеров по долгу, которого они касались.
- Оценивайте грубо. Размеров «часы», «дни» и «недели» достаточно. Точность сверх этого выдумана.
Определения метрик
Метрики ниже описывают журнал отложенных ремонтов. Часы и границы указаны в каждой формуле. Показатели времени сообщаются как распределения (медиана и 85-й или 95-й перцентиль), а не как единое среднее.
| Метрика | Определение | Формула | Единица | Источник данных | Практика ITIL | Agile-аналог | Периодичность |
|---|---|---|---|---|---|---|---|
| Возраст бэклога известных ошибок | Как долго открытые известные ошибки ждали постоянного исправления | Часы запускаются, когда запись о проблеме помечена «известная ошибка»; останавливаются, когда постоянное исправление выпущено в продуктив; элементы, закрытые как «принятый риск», сообщаются отдельно и исключаются. Сообщайте число, медианный возраст и возраст 85-го перцентиля по услуге | дни (распределение) | Записи ITSM о проблемах и известных ошибках, записи релизов | Управление проблемами | График стареющих рабочих элементов; возраст бэклога дефектов | Раз в месяц |
| Охват обходными путями | Доля открытых известных ошибок, у которых есть документированный, проверенный обходной путь, которому может следовать оператор | открытые известные ошибки с обходным путём, пересмотренным за последние 6 месяцев / открытые известные ошибки; закрытые элементы и элементы с принятым риском исключаются | процент | База знаний, связанная с записями об известных ошибках | Управление проблемами; управление знаниями | Руководство по эксплуатации или определение готовности для эксплуатационной пригодности | Раз в месяц |
| Инциденты, связанные с открытыми известными ошибками | Инциденты, чья причина есть открытая известная ошибка, прямая мера процентов, уплачиваемых в нарушении услуги | инциденты в периоде, связанные с известной ошибкой, бывшей открытой, когда инцидент начался / все инциденты в периоде; инциденты без связи с причиной сообщаются как несвязанные, а не считаются | процент и число | Связи инцидент-проблема в инструменте ITSM | Управление инцидентами; управление проблемами | Ушедшие дефекты; приток ошибок в продуктиве | Раз в месяц |
| Запас долга | Число и оценённый размер зарегистрированных элементов технического долга, остающихся открытыми | открытые элементы в реестре долга на конец периода; размер есть сумма грубых полос усилия (часы, дни, недели), присвоенных при регистрации; незарегистрированный или подозреваемый долг исключается | число и полосы усилия | Реестр долга в трекере, помеченный по услуге | Непрерывное улучшение; проектирование услуг | Элементы продуктового бэклога, помеченные как долг | Раз в месяц |
| Проценты по долгу | Дополнительная работа, вызванная открытым долгом и известными ошибками, во времени команды | часы, записанные в периоде на рабочие элементы, помеченные ссылкой на долг или известную ошибку (обходные пути, ручные шаги, переделки и дополнительное усилие на затронутых изменениях) / общие рабочие часы команды в периоде; сама работа по ремонту исключается и считается в доле ёмкости | процент рабочего времени | Метки времени или усилия на рабочих элементах, хранимые на уровне команды | Непрерывное улучшение; управление проблемами | Доля внеплановой работы и переделок | Раз в месяц |
| Доля ёмкости на долг | Доля ёмкости поставки, потраченная на погашение долга и известных ошибок | ёмкость (число элементов или усилие) завершённых рабочих элементов, помеченных как ремонт долга или исправление известной ошибки / все завершённые рабочие элементы в периоде; элементы без метки исключаются | процент | Трекер, завершённые элементы по метке | Непрерывное улучшение; управление изменениями | Распределение ёмкости | За период планирования, пересматривается раз в месяц |
| Чистое изменение долга | Растёт или сокращается журнал | зарегистрированные в периоде элементы долга и известных ошибок минус элементы, разрешённые в периоде; разрешённый значит исправление выпущено, а не слито; элементы, закрытые как «не будем исправлять», считаются отдельной строкой | число (со знаком) | Реестр долга и записи об известных ошибках | Непрерывное улучшение | Изменение бэклога по категориям | Раз в месяц |
Принятый риск есть законный способ закрыть известную ошибку, потому что некоторые проблемы не стоят исправления. Он перечисляется отдельно, чтобы закрытие элементов не улучшало тихо цифру возраста. Окно пересмотра в 6 месяцев в охвате обходными путями есть пример. Команда задаёт окно под то, как быстро меняются её системы, и записывает его в реестр метрик.
Рекомендации
Постройте журнал
1. Слейте список известных ошибок и список долга в один журнал. Ведите один реестр с полем для происхождения (эксплуатация или поставка), услуги, владельца, полосы размера и связи со связанными записями. Его может хранить инструмент ITSM или трекер, при условии что каждая система ссылается на другую. Без единого вида известная ошибка в эксплуатации конкурирует с невидимым элементом долга в поставке за одних и тех же инженеров.
2. Регистрируйте долг в момент его создания или обнаружения. Намеренно срезанный угол попадает в реестр в том же запросе на слияние или записи об изменении, с заявленной причиной и датой пересмотра. Долг, найденный позже, регистрирует тот, кто его находит. Дешёвое однострочное правило фиксации работает лучше периодического аудита, потому что люди забывают то, что знали в прошлом квартале.
Измеряйте проценты
3. Связывайте инциденты с известными ошибками каждый раз. Связь между инцидентом и его известной ошибкой есть самые сильные данные о процентах, которые у вас есть, и она стоит нескольких секунд при разрешении. Сделайте связь обязательным полем, когда причина известна, и сообщайте долю несвязанных, чтобы пробел не выглядел хорошей новостью (см. тему 3.3, Время реагирования на инциденты и их устранения). Когда одна причина появляется в нескольких инцидентах, запись о проблеме несёт свидетельства для исправления.
4. Помечайте работу, которую создаёт долг. Позвольте инженерам помечать рабочий элемент, когда обходной путь, ручной шаг или дополнительная переделка понадобились из-за известной слабости, и связывать его с элементом журнала. Метка стоит мало и даёт цифру процентов по долгу на уровне команды. Относитесь к результату как к оценке с широкой погрешностью, полезной для ранжирования элементов и наблюдения тренда, а не для бухгалтерии.
5. Оценивайте каждый элемент двумя числами: усилие ремонта и ежемесячные проценты. Используйте грубые полосы, такие как часы, дни, недели, для усилия и грубую месячную цену, взятую из связанных инцидентов, помеченной работы и любой цены простоя, которую ваша организация уже оценивает. Деление процентов на усилие даёт простой срок окупаемости. Не выдумывайте точность: полосы и заявленного допущения достаточно, чтобы отделить очевидные выигрыши от элементов, которые могут подождать.
Защитите ёмкость и решайте
6. Зарезервируйте постоянную долю ёмкости и сообщайте её. Договоритесь с владельцем продукта о доле каждого цикла на работу по ремонту, заданной трендом журнала и пересматриваемой каждый квартал. Сообщайте долю ёмкости на долг рядом с цифрами плановой работы, чтобы руководители видели работу по ремонту как намеренную инвестицию. Зарезервированная доля также защищает команду от спора о компромиссе на каждом разговоре о планировании, который бэклог функций обычно выигрывает.
7. Ранжируйте ремонт против функций в одной общей валюте. Помещайте известные ошибки и элементы долга в тот же разговор о приоритизации, что и функции, выраженные ценой задержки и сроком окупаемости. Исправление, убирающее еженедельный инцидент и возвращающее своё усилие за квартал, конкурирует по существу. Ранжирование по громкости, старшинству или дате регистрации даёт плохие результаты (см. тему 4.4, Сбои изменений и переделки).
8. Замыкайте петлю решений об откладывании. Для каждого элемента, сознательно оставленного открытым, записывайте, кто принял риск, дату пересмотра и триггер, который поднял бы его выше, например второй инцидент или планируемое изменение в этой области. Пересматривайте список принятого с собственной периодичностью. Элемент, отложенный трижды без триггера, есть решение его игнорировать, и журнал должен так и сказать.
Сохраняйте честность чисел
9. Выпускайте исправление, прежде чем закрывать запись. Известная ошибка остаётся открытой, пока постоянное исправление не в продуктиве и повторение не проверено в заявленном окне. Закрытие на «слито» или «заявка сделана» льстит цифрам возраста и чистого изменения и позже вновь открывает инцидент (см. тему 4.5, Метрики релизов и развёртывания). Отслеживайте долю повторного открытия известных ошибок как проверку качества правила закрытия.
10. Смотрите на форму журнала, а не только на итоги. Ровный счёт может прятать длинный хвост очень старых элементов, растущую долю элементов в одной услуге или журнал, удерживаемый малым закрытием всего как «не будем исправлять». Показывайте распределение возраста, разбивку по услугам и список принятого риска на одной странице. Пересматривайте его с людьми, владеющими услугами, на той же встрече, что планирует работу следующего квартала.
Векторы манипуляции и ограждения
| Метрика | Как её искажают | Парная метрика или практика-ограждение |
|---|---|---|
| Возраст бэклога известных ошибок | Закрывать старые записи как «принятый риск» или «не будем исправлять»; делить одну старую запись на новые молодые; сбрасывать часы повторной регистрацией | Число и возраст принятых рисков сообщаются на той же странице; пересмотр закрытий кем-то вне владеющей команды; происхождение записей сохраняется |
| Охват обходными путями | Писать расплывчатый обходной путь, чтобы удовлетворить поле; считать обходной путь, который ни один оператор никогда не пробовал | Использование обходных путей и доля сбоев в связанных инцидентах; периодическая проверка выборки обходных путей |
| Инциденты, связанные с открытыми известными ошибками | Оставлять инциденты несвязанными или связывать с другой причиной, чтобы доля падала | Доля несвязанных инцидентов сообщается рядом; выборочный пересмотр закрытых инцидентов на пропущенные связи |
| Запас долга | Не регистрировать долг, чтобы запас выглядел малым; сливать многие элементы в один большой; регистрировать мелочи, чтобы выглядеть усердным | Пересмотр реестра против выборки проверок кода и разборов после инцидентов; проверки размера и конкретности элементов |
| Проценты по долгу | Ставить меньше меток, чем нужно, чтобы избежать пристального взгляда, или больше, чтобы выиграть бюджет ремонта; читать цифру как оценку команды | Выборочный аудит помеченных и непомеченных элементов; вид только уровня команды, без сравнения между командами; проценты читаются вместе со связями инцидентов |
| Доля ёмкости на долг | Метить обычную работу над функциями как ремонт; выбирать лёгкие косметические элементы, чтобы заполнить долю | Проверка результата: падающий возраст самых старых элементов с высокими процентами и связей инцидентов; пересмотр того, что исправлено, относительно ранжирования |
| Чистое изменение долга | Разрешать много крошечных элементов, чтобы компенсировать несколько больших; закрывать элементы как «не будем исправлять», чтобы счёт падал | Чистое изменение показывается по полосе размера и по процентам; строка «не будем исправлять» сообщается; проверка повторения на разрешённых элементах |
Здоровое чтение показывает журнал, видимый, конкретный и движущийся в направлении, выбранном командой. Самые старые элементы с высокими процентами сокращаются в числе. Инциденты, связанные с открытыми известными ошибками, идут вниз, а доля несвязанных мала. Доля ёмкости на долг стабильна на согласованном уровне, а не подскакивает после кризиса и пропадает потом. Список принятого риска короток и пересматривается. Когда любое одно число выглядит превосходно, а остальные не двигаются, заподозрите определение, прежде чем праздновать.
Компромиссы: плюсы и минусы
| Подход | Сильная сторона | Слабая сторона |
|---|---|---|
| Один объединённый журнал известных ошибок и долга | Единая приоритизация; эксплуатация и поставка видят одни и те же цены | Нужны общие инструменты или связи; владение между двумя функциями надо уладить |
| Постоянная доля ёмкости на ремонт | Предсказуемо; защищает работу по ремонту от давления функций | Может быть потрачена на малоценные элементы, если ранжирование слабо |
| Работа по ремонту планируется только когда выигрывает спор о приоритете | Гибко; отвечает текущему приоритету | Функции почти всегда побеждают; журнал растёт до кризиса |
| Проценты, оцениваемые по инцидентам и помеченной работе | Привязывает долг к наблюдаемой цене; поддерживает ранжирование | Грубые числа; зависит от честной разметки и связей инцидентов |
| Выделенный натиск на ремонт или «неделя долга» | Фокус и видимый прогресс | Эпизодично; журнал наполняется между событиями; прерывает плановые обязательства |
Выберите самое лёгкое устройство, держащее самые старые элементы с высокими процентами в движении. Малая команда может вести журнал на одной доске с меткой и ежемесячным пересмотром. Крупным организациям нужны связи между инструментами и согласованный метод ранжирования. Цель есть намеренное решение о каждом элементе, а не пустой список.
Вопросы для обсуждения в команде
1. Какие три открытых элемента обходятся нам дороже всего каждый месяц и откуда мы это знаем? Попросите людей назвать кандидатов по памяти, затем сверьте их со связями инцидентов и помеченной работой. Сравните запомненный список с измеренным и отметьте разрывы. Договоритесь, как свидетельства для ранжирования будут собираться отныне.
2. Когда мы откладываем исправление, кто решает и когда мы смотрим снова? Пройдите по последним пяти откладываниям и спросите, кто принял риск и какая дата пересмотра задана. Где никто не решал, элемент был заброшен, а не отложен. Договоритесь о правиле, что каждое откладывание несёт владельца, причину и триггер. Обсудите, как список принятого риска будет пересматриваться и кем.
3. Сколько ёмкости нам следует зарезервировать для ремонта и что изменило бы долю? Покажите тренд журнала и текущую долю ёмкости на долг. Спросите, чем команда готова пожертвовать, чтобы её поднять, и какое свидетельство позволило бы ей упасть. Запишите число, причину и дату возвращения.
4. Настоящие ли наши обходные пути и сможет ли новый оператор им следовать? Выберите обходной путь случайно и попросите кого-то, кто его не писал, ему последовать. Договоритесь о процедуре проверки обходных путей, покрывающих ошибки с самым высоким воздействием.
5. Что считается исправленным и как долго мы наблюдаем, прежде чем закрыть запись? Сравните правила закрытия, используемые эксплуатацией, поставкой и владельцем продукта. Обсудите окно повторения, подходящее услуге, и что команда будет делать, когда закрытый элемент открывается заново. Договоритесь об одном определении и запишите его в реестр метрик.
6. Где наши числа о долге могут рассказывать нам удобную историю? Просите способы, как каждое число можно польстить: незарегистрированный долг, сначала исправленные лёгкие элементы, элементы, закрытые как «не будем исправлять». Посмотрите на долю несвязанных инцидентов и список принятого риска. Выберите одно ограждение для добавления в этом квартале и назовите, кто его проверит.
Четыре точки зрения
Продуктовые команды и команды поставки
Команды поставки видят долг первыми, обычно меняя код. Им полезны реестр, в который легко добавлять, и защищённая доля ёмкости, чтобы работа по ремонту не зависела от победы в споре на каждом разговоре о планировании. Им следует регистрировать срезанные углы, когда они их срезают, помечать работу, вызванную слабыми местами, и избегать использования долга как ярлыка для любой работы, которую они предпочли бы не делать (о влиянии долга на время выполнения см. тему 2.2, Время выполнения, время цикла и эффективность потока).
Команды услуг и эксплуатации
Команды эксплуатации видят проценты: повторные инциденты, ручные шаги, хрупкие обходные пути и следующую за ними нагрузку дежурств. Они владеют записями об известных ошибках и документами обходных путей и имеют данные об инцидентах, оценивающие проценты. Им следует связывать каждый инцидент с его известной ошибкой, проверять обходные пути и приносить на разговор о планировании ранжированные свидетельства, а не список жалоб (см. тему 5.7, Рутинная работа и метрики дежурств).
Руководство и управление
Руководители решают, сколько ёмкости получает работа по ремонту, а стимулы, которые они задают, решают, остаётся ли журнал честным. Им следует просить распределение возраста, цифры процентов и список принятого риска, а не единый балл долга. Чтение журнала как оценки команды наказывает регистрацию и загоняет долг в подполье. Форум управления должен относиться к принятию риска как к решению с владельцем и датой пересмотра.
Клиенты и пользователи
Клиенты чувствуют долг как повторные сбои и обходные пути, которым им приходится следовать. Где обходной путь затрагивает пользователей, публикуйте его с простой заметкой о том, когда ожидается исправление, и соблюдайте дату или объясняйте изменение. Меньше повторных инцидентов и честный статус по известным проблемам строят больше доверия, чем обещание отсутствия дефектов (см. тему 6.1, Метрики удовлетворённости клиентов).
На практике: пример из управления услугами
ИТ-отдел региональной больницы эксплуатирует услугу записи пациентов, поддерживаемую одной продуктовой командой и группой эксплуатации. Все числа в этом примере иллюстративны.
Группа эксплуатации ведёт 23 известные ошибки в инструменте ITSM. Продуктовая команда ведёт отдельный список из 41 элемента долга на своей доске. Квартальный пересмотр обнаруживает, что 9 из известных ошибок и 7 из элементов долга описывают одни и те же пять причин. Самой старой известной ошибке 14 месяцев, медианный возраст известных ошибок 5 месяцев, а 85-й перцентиль 11 месяцев. Охват обходными путями составляет 61 %. Инциденты, связанные с открытыми известными ошибками, составляют 18 % инцидентов квартала, а 22 % инцидентов несвязаны, так что реальная доля может быть выше.
Команда сливает два списка в один журнал из 55 различных элементов. Для десяти элементов с наибольшим числом связанных инцидентов она оценивает усилие ремонта в полосах и месячные проценты в часах. Один элемент выделяется: ночное задание синхронизации записей молча падает примерно раз в две недели и нуждается в ручном перезапуске дежурным. Его ремонт оценён в две недели. Его проценты, по связанным инцидентам и помеченной работе, около 10 часов в месяц, а каждый сбой задерживает утренние списки клиник. Срок окупаемости около четырёх месяцев, что быстрее любой функции, бывшей тогда в плане.
Решение, записанное в журнале решений, состоит в том, чтобы зарезервировать 15 % ёмкости продуктовой команды для работы по ремонту, ранжируемой по процентам на единицу усилия, и сначала исправить задание синхронизации. Руководитель эксплуатации также соглашается связывать каждый инцидент с известной ошибкой там, где она существует, и проверять пять самых используемых обходных путей.
Два квартала спустя медианный возраст известных ошибок составляет 4 месяца, а 85-й перцентиль 9 месяцев. Инциденты, связанные с открытыми известными ошибками, падают до 11 %. Доля несвязанных падает до 8 %, что даёт команде больше уверенности в цифре. Затем команда ловит риск манипуляции. Строка чистого изменения долга показывает 12 элементов, разрешённых за квартал, но 6 из них были закрыты как «не будем исправлять», и два из них были самыми старыми элементами с высокими процентами. Проверяющий вне команды читает записи и обнаруживает, что закрытия делались, чтобы улучшить цифру возраста. Элементы открываются заново, причина закрытия становится обязательным полем с названным утверждающим, а элементы принятого риска теперь появляются на той же странице, что и распределение возраста.
Agile, ИИ, автоматизация и аналитика
Agile
Тратьте защищённую долю ёмкости на долг с самыми высокими процентами и регулярно пересматривайте её с заинтересованными сторонами. Осторожность в том, что цель по числу элементов долга ведёт к дроблению и перемечиванию элементов.
ИИ
Код, порождённый ИИ, может быстро добавлять долг, и ИИ также может помогать находить и гасить его. Отслеживайте чистое изменение долга и инциденты, связанные с открытыми известными ошибками, для областей с помощью ИИ отдельно и помечайте их. Осторожность в том, что модель, предлагающая исправление, может оставить первопричину на месте.
Автоматизация
Автоматизируйте обнаружение устаревших известных ошибок и гниения зависимостей и флагов и измеряйте автоматизацию по ложным тревогам. Осторожность в том, что автоматические сканеры создают шум, хоронящий важные элементы.
Аналитика
Оценивайте проценты по инцидентам и усилию, которые порождает каждый элемент, с диапазонами. Решение, которое это информирует, состоит в том, что исправлять дальше. Осторожность в том, что оценки цены долга грубы; поэтому избегайте ложной точности.
Отраслевой взгляд
Стартап. Долг обычно намеренный и часто верный, потому что скорость до первого клиента важнее всего. Ведите один список на доске с меткой, регистрируйте срезанные углы по мере того, как срезаете, и задавайте дату пересмотра, чтобы у «позже» был смысл. Поднимайте долю ремонта, когда проценты начинают проявляться в инцидентах.
Малый бизнес. Один администратор или малая команда часто несёт и эксплуатацию, и поставку, так что два списка естественно один. Записывайте известные ошибки и их обходные пути в общий документ и отмечайте, от какого поставщика или контракта зависит каждый элемент. Дефект на стороне поставщика есть известная ошибка, которую вы не можете исправить сами, поэтому отслеживайте обещанную дату поставщика и ваш обходной путь.
Крупная компания. Много команд, много услуг и много поставщиков создают несколько конкурирующих списков и несколько определений «готово». Решите одну структуру журнала, одно правило закрытия и один метод ранжирования и позвольте командам добавлять местные поля с заявленным сопоставлением.
Государство и публичный сектор. Унаследованные системы, долгие циклы закупок и фиксированные бюджеты делают некоторый долг дорогим для погашения, а некоторые решения о замене медленными. Записывайте правовые ограничения, ограничения хранения и аудита, блокирующие исправление, поскольку они объясняют откладывание. Показывайте журнал как часть отчётности о рисках и планируйте ремонт в бюджетном цикле, а не рассматривайте его как внеплановую цену (см. тему 8.5, Регулируемая и государственная отчётность).
Бизнес-обоснование: мотивы, ROI и TCO
Мотив состоит в том, чтобы перестать платить проценты, которых вы не видите. Повторные инциденты, ручные обходные пути и медленные, рискованные изменения суть видимые цены, и они обычно записываются как отдельные проблемы в отдельных бюджетах. Объединённый журнал превращает их в одно сравнение цены ремонта и цены хранения долга.
Цена практики имеет три части. Первая: настройка, то есть реестр, связи между инструментом ITSM и трекером и соглашение о метках. Вторая: усилие эксплуатации, то есть несколько секунд на инцидент, чтобы связать его, несколько секунд на рабочий элемент, чтобы пометить его, и ежемесячный пересмотр в час-два на услугу. Третья: сама ёмкость ремонта, самая большая статья и намеренная инвестиция, а не накладные расходы.
Отдача идёт от закономерностей, которые вы можете измерить сами. Сравните инциденты, связанные с известной ошибкой, до и после её исправления, часы помеченной работы на затронутых изменениях до и после и избежанные прерывания дежурств. Добавьте цену простоя, если ваша организация уже её оценивает. Не заимствуйте отраслевую цифру цены долга: исследовательская литература по теме реальна, но цифры зависят от контекста, и ваши собственные данные об инцидентах и времени лучшее свидетельство. Исследование Accelerate связывает результативность поставки с результативностью организации (см. тему 2.8, Метрики DORA), хотя не даёт цены для вашего журнала. Более широкое рассмотрение цены и отдачи см. в теме 7.7, Возврат инвестиций и бизнес-обоснование.
Антипаттерны и ловушки
- Два списка, которые никогда не встречаются. Эксплуатация и поставка спорят за одну ёмкость с разными свидетельствами. Слейте списки или свяжите каждую общую причину.
- Единый балл долга для организации. Он прячет, где цена, и приглашает ранжирование команд. Сообщайте журнал по услугам, с возрастом, процентами и владением.
- Большая переписка как единственный ремонт. Крупные чистки застревают, а журнал наполняется заново, пока они идут. Выводите элементы малыми шагами, ранжированными по сроку окупаемости.
- Нулевой долг как цель. Погоня за ним награждает тривиальные закрытия и отбивает охоту честно регистрировать. Стремитесь к журналу, где самые старые элементы с высокими процентами движутся.
- Закрытие известных ошибок на «слито». Исправление не дошло до пользователей, и инцидент возвращается. Закрывайте по релизу, затем следите за повторением в заявленном окне.
- Сокрытие откладывания в «не будем исправлять». Цифра возраста улучшается, а риск остаётся. Считайте принятый риск отдельно, с владельцем и датой пересмотра.
- Отношение к статическому анализу как к истине. Оценки отражают форму кода, а не цену. Используйте их, чтобы находить кандидатов, затем подтверждайте связями инцидентов и историей изменений.
- Приписывание долга авторам. Это учит людей прятать срезанные углы и избегать трудных компонентов. Держите каждый показатель на уровне услуги и команды (см. тему 1.2, Закон Гудхарта и психология метрик).
Модель зрелости
| Измерение | 1 Инициирование | 2 Развитие | 3 Стандартизация | 4 Управление | 5 Оркестрация |
|---|---|---|---|---|---|
| Журнал и определения | Известные ошибки и долг живут в головах людей или в разбросанных заметках | Эксплуатация и поставка каждая ведут список с разными правилами | Один журнал с письменным определением, владельцем и правилом закрытия для каждого элемента | Возраст, принятый риск и чистое изменение пересматриваются относительно письменных определений | Определения пересматриваются с поставщиками и клиентами, когда перестают информировать решения |
| Измерение процентов | Нет связи между инцидентами и причинами | Некоторые инциденты связаны с известными ошибками вручную | Связи инцидентов обязательны, где причина известна; работа помечается на уровне команды | Проценты и срок окупаемости оцениваются для главных элементов и отслеживаются во времени | Проценты связаны с результатами услуг и разделяются между командами и поставщиками |
| Ёмкость и приоритизация | Ремонт происходит в кризис | Неформальное время, отложенное некоторыми командами | Согласованная доля ёмкости и общий метод ранжирования | Доля корректируется по тренду журнала и финансируется как плановая работа | Ёмкость ремонта координируется между общими платформами и поставщиками |
| Обходные пути и закрытие | Обходные пути недокументированы или известны одному человеку | Документированы для некоторых ошибок, не проверены | Обходные пути в базе знаний, с правилом закрытия по релизу | Использование обходных путей, сбои и повторение после закрытия измеряются | Обходные пути выводятся автоматически по мере выпуска исправлений, с обратной связью пользователей |
Контрольный список
- Известные ошибки и элементы долга лежат в одном журнале или связаны элемент за элементом.
- У каждого элемента есть владелец, полоса размера, услуга и дата пересмотра.
- Намеренные срезанные углы регистрируются, когда сделаны, с причиной.
- Инциденты связываются с известными ошибками там, где причина известна, а доля несвязанных сообщается.
- Работа, вызванная слабыми местами, помечается на уровне команды, а разметка проверяется выборкой.
- У каждого из главных элементов есть полоса усилия ремонта и оценка месячных процентов.
- Доля ёмкости на работу по ремонту согласована, сообщается и пересматривается каждый квартал.
- Известные ошибки закрываются по релизу исправления, с заявленным окном повторения.
- Закрытия с принятым риском перечисляются отдельно, с утверждающим и датой пересмотра.
- Обходные пути для ошибок с самым высоким воздействием проверяются по графику.
- Распределение возраста и разбивка по услугам показываются вместе с итогами.
- Ни один показатель долга не используется для сравнения или ранжирования людей.
Промпты для ИИ
Слейте два списка в один журнал.
I have two lists of deferred repairs. List A comes from [operations tool or
source] and holds [number] known errors. List B comes from [delivery tracker or
source] and holds [number] technical debt items. Here are the entries:
[paste entries with title, service, date registered, and a one-line description].
Group entries that appear to describe the same cause, propose a single ledger
entry for each group, and flag entries that need a human to confirm the match.
Do not invent causes, services, or dates. List your assumptions and the questions
I should answer before merging.
Оцените полосы усилия и месячные проценты для главных элементов.
For the ledger item [item title] on [service], I have this evidence: linked
incidents [list with dates and durations], tagged work [hours or item counts],
and a repair estimate from the team of [estimate]. Help me write coarse effort
and monthly interest bands, a simple payback time, and the confidence level for
each figure. Show your arithmetic. Do not invent costs, benchmark values, or
industry figures. If a figure is missing, ask me for it. List your assumptions.
Проверьте закрытие и риски манипуляции.
Here are the definitions and the last quarter's data for our known error and debt
ledger: [definitions of age, workaround coverage, debt net change, and the closure
rule] and [summary of items closed, with closure reasons]. Identify the ways
these measures could be flattered, the evidence in the data that suggests it has
happened, and a guardrail for each. Treat this as a review of the instrument, not
a review of people. Do not accuse anyone, and do not invent data. List your
assumptions.
Подготовьте разговор о приоритизации с владельцем продукта.
I need to propose how to split capacity between features and repair work for
[team] next quarter. The ledger shows [summary of ledger: counts, age
distribution, top items with effort and interest bands]. The feature plan
contains [summary of planned features and their expected value, as supplied by
the product owner]. Draft a one-page proposal that compares options for the
repair share, states the cost of delay of the main repair items, and names the
trade-offs. Do not invent value estimates or benchmark shares. List your
assumptions and the decisions the product owner must make.
Навыки ИИ
- Service Management Metrics skill: используйте, чтобы найти тему, определяющую связанную метрику, такую как повторение или сбои изменений, и ограждение, которое должно стоять рядом.
- Service Management Metrics maintainer skill: используйте, чтобы проверить, что изменённая метрика называет свои часы, вектор манипуляции и ограждение.
Главные выводы
- Известные ошибки и технический долг суть два взгляда на один журнал отложенных ремонтов, поэтому держите их вместе или связанными.
- Измеряйте проценты, которые каждый элемент стоит каждый месяц, в инцидентах, обходных путях и замедленных изменениях, и ранжируйте ремонт по сроку окупаемости.
- Делайте каждое откладывание решением с владельцем, причиной и датой пересмотра и сообщайте принятый риск отдельно.
- Резервируйте согласованную долю ёмкости на работу по ремонту и сообщайте её рядом с плановой работой.
- Закрывайте известную ошибку по релизу исправления, затем следите за повторением, прежде чем доверять результату.
- Держите каждый показатель на уровне услуги и команды и используйте ограждения, чтобы лучшее число значило лучшую систему.
Источники и дополнительное чтение
- Cunningham, W., "The WyCash Portfolio Management System," OOPSLA '92 Experience Report, ACM, 1992.
- Fowler, M., "Technical Debt Quadrant," 2009, https://martinfowler.com/bliki/TechnicalDebtQuadrant.html
- Fowler, M., Refactoring: Improving the Design of Existing Code, 2nd edition, Addison-Wesley, 2018.
- Kruchten, P., Nord, R., and Ozkaya, I., Managing Technical Debt: Reducing Friction in Software Development, Addison-Wesley, 2019.
- Sculley, D., and others, "Hidden Technical Debt in Machine Learning Systems," Advances in Neural Information Processing Systems 28, 2015, https://papers.nips.cc/paper_files/paper/2015/hash/86df7dcfd896fcaf2674f757a2463eba-Abstract.html
- Reinertsen, D. G., The Principles of Product Development Flow: Second Generation Lean Product Development, Celeritas Publishing, 2009.
- Forsgren, N., Humble, J., and Kim, G., Accelerate: The Science of Lean Software and DevOps, IT Revolution, 2018.
- Beyer, B., Jones, C., Petoff, J., and Murphy, N. R. (eds.), Site Reliability Engineering: How Google Runs Production Systems, O'Reilly Media, 2016, https://sre.google/sre-book/table-of-contents/
- Goodhart, C. A. E., "Problems of Monetary Management: The U.K. Experience," in Papers in Monetary Economics, Reserve Bank of Australia, 1975.
- Wikipedia, ITIL.
- Wikipedia, Технический долг.
- Wikipedia, Уорд Каннингем.
- Wikipedia, Анализ первопричин.
- Wikipedia, Рефакторинг.
- Wikipedia, Запах кода.
- Wikipedia, Альтернативная стоимость.
- Wikipedia, Цена задержки.
- Wikipedia, Программная ошибка.
- Wikipedia, Статический анализ программ.