# エンジニアリングの成果

## どのようなものか

エンジニアリングの成果とは、技術的な取り組みを経て、人ができることやシステムが安定して提供できることに生じる、観察可能な変化です。運用担当者が、開発者にデータの手直しを頼まずに、中断した取り込みを再開できるようになります。出荷担当者は、注文が輸送中か確かめてから到着日を伝えられます。保守担当者は、同じルールを複数箇所で書き直さずに済みます。リリース、移行、手順書、依存先の廃止は、いずれも作業の区切りになり得ます。成果は、その先の実際の利用に現れます。悪化が見つかった場合も、検証結果に含めます。

納品物、利用の変化、事業への波及効果を分けると、根拠を選びやすくなります。在庫を検索できる仕組みは納品物です。一度の検索で有効な在庫記録が見つかることは、利用時に観察できる成果です。注文をより多く処理でき、返品が減ることは、起こり得る事業上の効果です。仕入れ、価格、顧客構成も、その最後の数字を動かします。三つを同じものとして扱うと、原因を調べる前に成果を事業効果へ結び付けたり、事業の数字が動くまで有用な発見を見送ったりします。

成果を言葉にするときは、誰のどの作業が、どの条件で、どう変わるかを決めます。その違いを何で確かめるかも定めます。対象は売上だけでなく、アクセシビリティ、サポートの手間、正確さ、安全性、復旧のしやすさでも構いません。複数の指標があるなら、役割を分けます。一つは狙った行動の改善をとらえます。別の指標は、改善を進める間も保つべき品質を監視します。単位や観測の担当者が異なることもあります。

## なぜ重要なのか

機能について合意しても、関係者が求める結果は同じとは限りません。倉庫の担当者は、積み込み前に信用できる数字を知りたいと考えます。当番は、手を打てる時刻までに異常を知りたいと考えます。経理は、どの記録が集計に含まれたかを確認したいと考えます。遅れて届くイベントを黙って捨てるなら、同期の処理を速くしても、三者の仕事がかえって難しくなります。先に必要な変化を言葉にしておけば、設計を調整できる段階で、何を確かめるべきか話し合えます。

数字を決めるときには、分母と時間の基準を決めます。完了率なら、どの試行を集計に含めるかを明示します。応答時間なら、起点と終点を定義し、遅い要求も観察します。復旧の所要時間なら、どの状態をもってサービスが回復したと判断するかを決めます。交通量に相当する処理件数を添えない週次の合計は、成功率の悪化を隠すことがあります。定義と変更前の観測値を残しておけば、後の数字と比較し、差が生まれた理由を検討できます。

ソフトウェアの届け方を測る指標にも価値があります。DORA は、コミットから本番環境への展開までの時間や失敗した展開からの復旧時間など、デリバリーの速さと不安定さを調べる指標を紹介しています。これらから分かるのは、変更がどのように利用に届くかです。その変更が意図した仕事を簡単にしたかは、仕事そのものを観察して確かめます。納品を振り返る際には、どちらも大切な問いです。

## 実際の活用例

Engineer ApS のサービスレベルには、文書化、支援、引き継ぎに関する取り決めが掲載されています。依頼の進め方では、納品物、役割分担、請求の基準を書面で合意することを説明しています。引き継ぎを確認する方法の一例は、別の権限のある担当者に、実際に渡すアクセス権と文書を使って復旧訓練をしてもらうことです。手順を見つけ、障害の箇所を特定し、既知のテストケースを復旧できたかを記録します。他の人の承認が必要な操作も、開始前に確認します。この訓練は引き継ぎを評価するための提案です。

架空の例として、月曜日の仕入れに使うデータを夜間に取り込む処理を考えます。報告が不完全なとき、仕入れ担当者は専門家が確認するまで待たなければなりません。求める成果は、当番が古い報告を見分け、仕入れが始まる前に信頼できる報告を取得できるようになることです。許可を得て過去の処理を確認し、何をもって古い報告とするかを書き留めます。次に、正常な取り込みと再現できる復旧例を少数選びます。到着が遅れたファイルや重複配信を含めると、対象の日付と、同じ行の二重計上を見分けられます。

担当者が一人で解決できた例の数、警告から報告の検証までの時間、残った不一致を記録します。復旧を繰り返しても合計が変わらず、現在のデータが保たれることも確認します。測定の定義と一緒に観測例を残すと、次の確認者が同じ手順をたどれます。訓練で分かるのは、試した条件でどう動いたかです。日常の運用周期を通じた観察を加えると、普段の使い方に関する証拠が増えます。

## 問題が起きるところ

集めやすい数字が、本来確かめたい成果に取って代わることがあります。多くの警告を閉じれば、監視画面の見た目は良くなっても、重大な障害の発見が遅れているかもしれません。平均応答時間が短くなっても、最も遅い処理が実用に耐えない場合があります。まず良くしたい仕事を選び、その仕事を理解できる数字を決めます。よい平均値に埋もれないように、失敗例とその条件も残します。

変更前後の比較にも注意が要ります。新しい取り込み処理の開始が閑散期に当たったり、最初の週は整ったファイルを送る一社だけが使ったりすることがあります。負荷やデータの種類をそろえた観察を残し、分母も記録します。試験導入では、対象、日付、重要な条件の違いを明記します。少数の例でも、元に戻せる試験を続ける判断や、明らかな不具合の修正には役立ちます。説明する効果の範囲は、観察できた範囲に合わせます。

リリース後に誰が確認するかも決めます。最初の確認日を置き、変更の継続、調整、取り消しを判断する材料を共有します。めったに起きない作業なら、先に訓練し、実際の発生時にも記録を確認できるようにします。次の担当者がコミットの履歴を最初からたどらなくても、変更を続けるか判断できるところまでが、使える引き継ぎです。

## 参考資料
* 英国政府のサービス標準、成功の定義と実績データの公開
* DORA のソフトウェアデリバリー指標
* Google SRE ワークブックのサービスレベル目標の導入

=> /ja/service-levels/ サービスレベル
=> /ja/why-choose-us/ 依頼の進め方
=> https://www.gov.uk/service-manual/service-standard/point-10-define-success-publish-performance-data 英国政府のサービス標準、成功の定義と実績データの公開
=> https://dora.dev/guides/dora-metrics/ DORA のソフトウェアデリバリー指標
=> https://sre.google/workbook/implementing-slos/ Google SRE ワークブックのサービスレベル目標の導入

=> https://engineer.company/ja/glossary/engineering-outcomes/ このページのウェブ版
