技術的負債と既知のエラー
既知のエラーと技術的負債を、先送りされた修正の一つの可視な台帳として扱い、各アイテムが開いたままである毎月のコストを測り、利子の最も高いアイテムに、守られたキャパシティの割合を費やす。
概要と動機
どのチームも、いくらかの修復を先送りします。欠陥は理解されているが直されず、期日に間に合わせるために近道が取られ、コンポーネントは老朽化するに任され、回避策が手順書に書き込まれます。それぞれの先送りは、行われた時点では賢明な判断です。問題が始まるのは、先送りが見えないところで蓄積するときです。それを抱えるコストが、のちにインシデント、遅いデリバリー、疲れた人々として現れ、そのコストを原因に結び付ける行がどのレポートにもないからです。
二つの語彙が、同じパターンを記述します。ITILでは、既知のエラー(known error)は、根本原因が理解され、回避策、またはまだ適用されていない恒久的な修正が存在する問題です。既知のエラーは、サービスデスクと運用のスタッフが繰り返されるインシデントを素早く解決できるよう記録され、修正がリリースされるまでレコードは開いたままです。アジャイルのソフトウェアの仕事では、技術的負債(technical debt)は、1992年にウォード・カニンガム(Ward Cunningham)が作った、将来の変更を難しくする設計と実装の選択のためのたとえです。このたとえは、測定にとって重要な二つの考え方を運びます。負債を取り除くのに要する労力である元本(principal)と、負債が残る間、期間ごとに払う余分な労力またはリスクである利子(interest)です。
二つの見方は、見る場所が異なります。既知のエラーは運用を通じて発見されます。インシデントや問題の調査が原因を見つけます。技術的負債は、通常、デリバリーを通じて発見されます。開発者が、変更が本来より難しいことに気づきます。既知のエラーは、すでに顧客を傷つけ始めている技術的負債であることがよくあります。技術的負債は、起こるのを待っている既知のエラーであることがよくあります。ITSMのツールに一つ、バックログやwikiに一つと、別々の一覧を保つことは、そのつながりを隠し、同じ乏しいキャパシティをめぐる二つの競合する議論を生みます。
このトピックは、合わせた台帳のための小さな測定値の集合を与えます。組織全体の負債の単一の金額は、確実に生み出せる方法がないので避け、観察できるものを測ります。開いているアイテム、待った時間、引き起こしたインシデント、加わった仕事、修復に費やしたキャパシティ。台帳は、プロダクトと運用の間の優先順位付けの対話に供給します(問題レコードと恒久的な修正はトピック 4.1「問題管理のメトリクス」を、負債が生む割り込みの負荷はトピック 2.9「運用作業と計画外作業」を参照)。
このトピックで使う用語です。
- 回避策(Workaround)は、原因を取り除かずに、サービスを復旧する、あるいは失敗を避ける方法。
- 恒久的な修正(Permanent fix)は、原因を取り除くもの。根本原因分析(Root cause analysis)がそれを見つける仕事。
- コードのリファクタリング(Code refactoring)は、外部から見た振る舞いを変えずにコードを再構成すること。設計の負債を返済する通常の方法。
- コードの臭い(Code smell)は、より深い問題を示すことの多い、コード上の表面的なしるし。評決ではなく、見てみるための促し。
- 機会費用(Opportunity cost)は、時間の一つの使い方を他より選ぶことで手放す、最良の代替案の価値。すべての修正は機能と競合し、その比較が本当の判断。
- 遅延のコスト(Cost of delay)は、仕事を延期することによる経済的な損失。負債のアイテムの利子を値付けする考え方の背後にあるもの。
- ソフトウェアのバグ(Software bug)は、ソフトウェアの欠陥。既知のエラーは、バグ、設定の弱さ、設計の限界、供給者の欠陥のいずれかでありうる。
- 静的プログラム解析(Static program analysis)は、コードを実行せずに検査すること。その警告と複雑さのスコアは、負債の可能性の指標であり、インシデントの履歴より弱い証拠。
すべての負債が誤りではありません。マーティン・ファウラーの四象限は、意図的なものと不注意なもの、無謀なものと慎重なものの負債を分けます(参考文献の一覧を参照)。返済計画のある慎重な近道は健全なローンで、無謀な負債は防ぐべき種類です。ここのメトリクスは、起源を判断しません。残高を示します。
主要な原則
- 一つの台帳、二つの入り口。 運用からの既知のエラーと、デリバリーからの負債のアイテムが、同じ原因を記述するレコード間のリンクとともに、同じ可視な一覧に入る。
- 元本に加えて利子も測る。 修復の大きさは、開いたアイテムが毎月、インシデント、回避策、遅くなった変更にかけるコストほど重要ではない。修復の労力あたりの利子で順位付けする。
- 先送りを、オーナーのいる判断にする。 すべてのアイテムに、オーナー、待つ理由、レビュー日がある。誰も先送りすることを選んでいないアイテムは放置であり、そのように数える。
- 必要になる前にキャパシティを守る。 事前に合意された、各チームのキャパシティの修復の仕事のための割合は、悪い四半期の後の英雄的な一掃に勝る。
- 回避策を誠実に保つ。 回避策はサービスであり、独自のコスト、オーナー、失敗モードがある。どのくらいの頻度で使われ、どのくらいの頻度で失敗するかを測る。
- システムを記述し、人は記述しない。 負債はサービスやコンポーネントに属する。作者に帰属させてはならず、触れた負債でエンジニアに順位を付けてはならない。
- 粗く見積もる。 「時間」「日」「週」の大きさで十分である。それ以上の精密さは作り事である。
メトリクスの定義
以下のメトリクスは、先送りされた修復の台帳を記述します。時計と境界は各計算式に述べています。時間の測定値は、単一の平均ではなく、分布(中央値と85または95パーセンタイル)として報告します。
| メトリクス | 定義 | 計算式 | 単位 | データソース | ITILプラクティス | アジャイルの対応物 | 頻度 |
|---|---|---|---|---|---|---|---|
| 既知のエラーのバックログの年齢 | 未解決の既知のエラーが、恒久的な修正をどのくらい待っているか | 時計は問題レコードが「既知のエラー」と印されたときに始まり、恒久的な修正が本番にリリースされたときに止まる。「リスクの受容」としてクローズされたアイテムは別に報告し、除く。件数、年齢の中央値、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「顧客満足度のメトリクス」を参照)。
実践:サービスマネジメントの例
地域の病院のIT部門が、一つのプロダクトチームと運用グループが支える、患者のスケジューリングサービスを運営しています。この例の数字はすべて例示です。
運用グループは、ITSMツールに23件の既知のエラーを保持しています。プロダクトチームは、自分たちのボードに別の41件の負債のアイテムの一覧を保持しています。四半期ごとのレビューで、既知のエラーのうち9件と負債のアイテムのうち7件が、同じ五つの原因を記述していることが分かります。最も古い既知のエラーは14か月前のもの、既知のエラーの年齢の中央値は5か月、85パーセンタイルは11か月です。回避策の網羅率は61パーセントです。未解決の既知のエラーに紐づくインシデントは四半期のインシデントの18パーセントで、22パーセントのインシデントはリンクがないため、実際の割合はもっと高いかもしれません。
チームは二つの一覧を、55件の個別のアイテムからなる一つの台帳に統合します。紐づけられたインシデントが最も多い十のアイテムについて、帯で修復の労力を、時間で毎月の利子を見積もります。一つのアイテムが際立ちます。夜間の予約の同期ジョブが、約2週間に一度、静かに失敗し、オンコールのスタッフによる手作業の再起動を要します。その修復は2週間と見積もられます。紐づけられたインシデントとタグ付けされた仕事からの利子は、月約10時間で、失敗のたびに朝のクリニックの一覧が遅れます。元が取れるまでの時間は約4か月で、その時点で計画にあるどの機能よりも速いものです。
判断ログに記録された決定は、プロダクトチームのキャパシティの15パーセントを、労力あたりの利子で順位付けした修復の仕事のために確保し、同期ジョブを最初に直すことです。運用の責任者はまた、既知のエラーが存在するところでは、すべてのインシデントをそれにリンクし、最もよく使われる五つの回避策をテストすることに合意します。
二四半期後、既知のエラーの年齢の中央値は4か月、85パーセンタイルは9か月です。未解決の既知のエラーに紐づくインシデントは11パーセントに下がります。リンクなしの割合は8パーセントに下がり、これがチームにその数字へのより大きな確信を与えます。そこでチームは悪用のリスクを捉えます。負債の純変化の行は、四半期に12件のアイテムが解決されたことを示しますが、そのうち6件は「修正しない」としてクローズされ、そのうち二つは利子の高い最も古いアイテムでした。チーム外のレビュー担当者がレコードを読み、クローズが年齢の数字を改善するために行われたことを見いだします。アイテムは再オープンされ、クローズの理由は名前付きの承認者を伴う必須の欄になり、受容されたリスクのアイテムは、今は年齢の分布と同じページに現れます。
アジャイル、AI、自動化、アナリティクス
アジャイル
最も利子の高い負債に、守られたキャパシティの割合を費やし、ステークホルダーと定期的にレビューします。注意点は、負債の件数の目標が、アイテムの分割とラベルの付け替えにつながることです。
AI
AIが生成したコードは、素早く負債を加ええますが、AIはまた、それを見つけて返済するのを助けることもできます。AI支援の領域について、負債の純変化と、未解決の既知のエラーに紐づくインシデントを別に追跡し、ラベルしてください。注意点は、修正を提案するモデルが、根本原因をそのままにしうることです。
自動化
古くなった既知のエラーと、依存関係やフラグの劣化の検出を自動化し、自動化を誤警報で測ります。注意点は、自動化されたスキャナーが、重要なアイテムを埋もれさせるノイズを生むことです。
アナリティクス
各アイテムが引き起こすインシデントと労力で、範囲とともに利子を見積もります。これが情報を与える判断は、次に何を直すかです。注意点は、負債のコストの見積もりは大まかなので、偽の精度を避けることです。
業種別の視点
スタートアップ。 負債は通常意図的で、最初の顧客までの速さが最も重要なため、しばしば正しいものです。ボード上にラベル付きの一覧を一つ保ち、近道を取るたびに登録し、「あとで」が意味を持つようレビュー日を設定します。利子がインシデントに現れ始めたら、修復の割合を上げます。
中小企業。 一人の管理者か小さなチームが、運用とデリバリーの両方を担うことが多く、二つの一覧は自然に一つです。既知のエラーとその回避策を共有の文書に記録し、各アイテムがどの供給者や契約に依存するかを記します。供給者が所有する欠陥は、自分では直せない既知のエラーなので、供給者の約束した日付と自分たちの回避策を追跡します。
大企業。 多くのチーム、多くのサービス、多くの供給者が、複数の競合する一覧と、複数の「完了」の定義を生みます。台帳の構造、クローズ規則、順位付けの方法を一つに定め、チームが述べた対応付けとともにローカルな項目を加えられるようにします。
政府・公共部門。 レガシーなシステム、長い調達のサイクル、固定された予算が、一部の負債の返済を高くつくものにし、一部の置き換えの判断を遅くします。修正を妨げる法的、保持、監査の制約を記録します。それらが先送りを説明するからです。台帳をリスクの報告の一部として示し、修復を計画外のコストとして扱うのではなく、予算のサイクルで計画します(トピック 8.5「規制対応・行政向け報告」を参照)。
ビジネスケース:動機、ROI、TCO
動機は、見えない利子を払うのをやめることです。繰り返されるインシデント、手作業の回避策、遅くリスクのある変更は、目に見えるコストで、通常、別々の予算で別々の問題として記録されます。統合された台帳は、それらを、修復のコストと負債を抱えるコストの間の一つの比較に変えます。
この実践のコストには三つの部分があります。第一はセットアップ:台帳、ITSMツールと追跡システムの間のリンク、タグ付けの規約。第二は運用の労力:インシデントをリンクするインシデントあたりの数秒、作業アイテムにタグを付ける作業アイテムあたりの数秒、サービスごとの1、2時間の月次のレビュー。第三は修復のキャパシティそのもので、最大の項目であり、オーバーヘッドではなく意図的な投資です。
見返りは、自分で測れるパターンから来ます。既知のエラーにリンクしたインシデントを、その修正の前後で、影響を受ける変更のタグ付けされた仕事の時間を前後で、避けられたオンコールの割り込みを比較します。組織がすでに見積もっているなら、ダウンタイムのコストを加えます。負債のコストについて、業界の数字を借りてはいけません。このテーマの研究文献は実在しますが、数字は文脈に依存し、自分たちのインシデントと時間のデータのほうが良い証拠です。『Accelerate』の研究は、デリバリーのパフォーマンスを組織のパフォーマンスに結び付けています(トピック 2.8「DORAメトリクス」を参照)が、あなたの台帳の値段は示しません。コストと見返りのより広い扱いは、トピック 7.7「投資対効果とビジネスケース」を参照してください。
アンチパターンと落とし穴
- 決して出会わない二つの一覧。 運用とデリバリーが、異なる証拠で同じキャパシティを求めて争う。一覧を統合するか、共有されるすべての原因をリンクする。
- 組織全体の単一の負債スコア。 コストがどこにあるかを隠し、チームの順位付けを招く。サービス別に、年齢、利子、オーナーシップとともに台帳を報告する。
- 唯一の修復としての大規模な書き直し。 大規模な整理は停滞し、その間に台帳が再び満ちる。小さな段階でアイテムを廃止し、元が取れるまでの時間で順位付ける。
- 目標としての負債ゼロ。 些細なクローズを報い、誠実な登録を妨げる。利子の高い最も古いアイテムが動く台帳を目指す。
- 「マージ済み」で既知のエラーをクローズする。 修正がユーザーに達しておらず、インシデントが戻る。リリースでクローズし、述べた窓の間、再発を見る。
- 「修正しない」に先送りを隠す。 年齢の数字は改善するが、リスクは残る。リスクの受容を、オーナーとレビュー日とともに、別に数える。
- 静的解析を真実として扱う。 スコアはコストではなくコードの形を反映する。候補を見つけるために使い、インシデントのリンクと変更履歴で確認する。
- 負債を作者に帰属させる。 人々に近道を隠すこと、難しいコンポーネントを避けることを教える。すべての測定値をサービスとチームのレベルに保つ(トピック 1.2「グッドハートの法則とメトリクスの心理学」を参照)。
成熟度モデル
| 観点 | 1 開始 | 2 発展 | 3 標準化 | 4 管理 | 5 協調 |
|---|---|---|---|---|---|
| 台帳と定義 | 既知のエラーと負債が人々の頭の中か散らばったメモにある | 運用とデリバリーがそれぞれ、異なる規則で一覧を保つ | すべてのアイテムに、書面の定義、オーナー、クローズ規則を持つ一つの台帳がある | 年齢、リスクの受容、純変化を書面の定義に照らしてレビューする | 判断に情報を与えなくなれば、定義が供給者や顧客とともに見直される |
| 利子の測定 | インシデントと原因の間にリンクがない | 一部のインシデントが手作業で既知のエラーにリンクされる | 原因が分かっているところでインシデントのリンクが必須。仕事はチームのレベルでタグ付けされる | 上位のアイテムの利子と元が取れるまでの時間を見積もり、傾向として追う | 利子がサービスのアウトカムに結び付き、チームと供給者の間で共有される |
| キャパシティと優先順位付け | 修復は危機の中で行われる | 一部のチームが非公式に時間を確保する | 合意されたキャパシティの割合と共通の順位付けの方法 | 台帳の傾向に応じて割合を調整し、計画された仕事として資金が付く | 共有のプラットフォームと供給者にまたがって、修復のキャパシティが調整される |
| 回避策とクローズ | 回避策は文書化されず、一人が保持している | 一部のエラーについて文書化されているが、テストされていない | 回避策がナレッジベースにあり、リリース時のクローズ規則がある | 回避策の使用、失敗、クローズ後の再発を測る | 修正がリリースされるにつれて回避策が自動で廃止され、ユーザーからのフィードバックがある |
チェックリスト
- 既知のエラーと負債のアイテムが一つの台帳にあるか、アイテムごとにリンクされている。
- すべてのアイテムに、オーナー、大きさの帯、サービス、レビュー日がある。
- 意図的な近道が、取られたときに理由とともに登録されている。
- 原因が分かっているところでインシデントが既知のエラーにリンクされ、リンクなしの割合が報告されている。
- 弱い箇所が引き起こした仕事がチームのレベルでタグ付けされ、そのタグ付けが抽出で監査されている。
- 上位の各アイテムに、修復の労力の帯と月次の利子の見積もりがある。
- 修復の仕事のためのキャパシティの割合が、合意され、報告され、毎四半期レビューされている。
- 既知のエラーが、修正のリリースでクローズされ、述べた再発の窓がある。
- リスクの受容でのクローズが、承認者とレビュー日とともに、別に列挙されている。
- 最も影響の大きいエラーの回避策が、予定に従ってテストされている。
- 年齢の分布とサービス別の内訳が、合計とともに示されている。
- 負債の測定値が、個人を比較したり順位付けしたりするために使われていない。
AIプロンプト
二つの一覧を一つの台帳に統合する。
先送りされた修復の二つの一覧があります。一覧Aは [運用のツールまたは情報源] から来ており、[数] 件の既知のエラーを保持しています。一覧Bは [デリバリーの追跡システムまたは情報源] から来ており、[数] 件の技術的負債のアイテムを保持しています。エントリは次のとおりです:[タイトル、サービス、登録日、一行の説明付きのエントリを貼り付け]。同じ原因を記述していると思われるエントリをグループ化し、各グループに単一の台帳エントリを提案し、一致を人が確認する必要があるエントリに印を付けてください。原因、サービス、日付を捏造しないでください。前提と、統合する前に私が答えるべき問いを列挙してください。
上位のアイテムの労力の帯と月次の利子を見積もる。
[サービス] の台帳アイテム [アイテムのタイトル] について、次の証拠があります:紐づけられたインシデント [日付と継続時間付きの一覧]、タグ付けされた仕事 [時間またはアイテム数]、チームの修復の見積もり [見積もり]。粗い労力と月次の利子の帯、単純な元が取れるまでの時間、各数字の確信度を書くのを手伝ってください。計算を示してください。コスト、ベンチマークの値、業界の数字を捏造しないでください。数字が欠けている場合は、私に尋ねてください。前提を列挙してください。
クローズと悪用のリスクをレビューする。
以下は、私たちの既知のエラーと負債の台帳の定義と先四半期のデータです:[年齢、回避策の網羅率、負債の純変化、クローズ規則の定義] と [クローズされたアイテムの理由付きの要約]。これらの測定値が良く見せかけられうる方法、それが起きたことを示唆するデータ上の証拠、それぞれの防護柵を特定してください。これは人のレビューではなく、計器のレビューとして扱ってください。誰も非難せず、データを捏造しないでください。前提を列挙してください。
プロダクトオーナーとの優先順位付けの対話を準備する。
来四半期の [チーム] の機能と修復の仕事の間のキャパシティの分割を提案する必要があります。台帳は次のとおりです:[台帳の要約:件数、年齢の分布、労力と利子の帯付きの上位のアイテム]。機能の計画には、[プロダクトオーナーが提供した、計画された機能とその期待される価値の要約] が含まれます。修復の割合の選択肢を比較し、主な修復のアイテムの遅延のコストを述べ、トレードオフを挙げる1ページの提案を起案してください。価値の見積もりやベンチマークの割合を捏造しないでください。前提と、プロダクトオーナーが決めなければならないことを列挙してください。
AIスキル
- サービスマネジメントメトリクスのスキル:再発や変更失敗など、関連するメトリクスを定義するトピックと、その隣に置くべき防護柵を探すときに使います。
- サービスマネジメントメトリクスのメンテナースキル:編集したメトリクスが、時計、悪用の手口、防護柵を明記しているかを確認するときに使います。
要点
- 既知のエラーと技術的負債は、先送りされた修復の一つの台帳の二つの見方なので、一緒に保つか、リンクする。
- 各アイテムが毎月、インシデント、回避策、遅くなった変更でかけるコストである利子を測り、元が取れるまでの時間で修復を順位付ける。
- すべての先送りを、オーナー、理由、レビュー日のある判断にし、リスクの受容を別に報告する。
- キャパシティの合意された割合を修復の仕事のために確保し、計画された仕事の隣に報告する。
- 修正がリリースされたときに既知のエラーをクローズし、結果を信頼する前に再発を見る。
- すべての測定値をサービスとチームのレベルに保ち、防護柵を使って、より良い数字がより良いシステムを意味するようにする。
参考文献とさらなる読書
- 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, Technical debt.
- Wikipedia, Ward Cunningham.
- Wikipedia, Root cause analysis.
- Wikipedia, Code refactoring.
- Wikipedia, Code smell.
- Wikipedia, Opportunity cost.
- Wikipedia, Cost of delay.
- Wikipedia, Software bug.
- Wikipedia, Static program analysis.