AI開発

性能要件の書き方と5つの合意条件

株式会社Atsumell|8分で読めます
性能要件の書き方と5つの合意条件を示すサムネイル

はじめに

「一覧画面は3秒以内」。性能要件に数値を入れても、開発の終盤で認識がずれることがあります。データが少ない検証環境では合格したのに、本番では月末だけ遅い。開発側はAPIの応答を測り、業務側は画面の表示完了を待っていた。どちらも同じ「3秒」を見ているつもりでも、測っている対象が違うためです。

性能要件は、速さの希望ではなく、どの利用条件で、何を測り、どの結果なら受け入れるかの合意です。この記事では、受注管理の一覧検索を例に、発注者と開発者で決める5つの条件を整理します。数値はすべて説明用の仮定であり、標準値や推奨値ではありません。

性能要件は「秒数+条件」で書く

まず、機能要件と性能要件を分けます。「受注を検索できる」は機能、「想定負荷のもとで所定時間内に結果を返せる」は性能です。対象機能を特定せず、全画面に同じ時間を置くと、大量出力や外部連携まで同じ扱いになってしまいます。

IPAの非機能要求グレードは、非機能要求の項目と段階的な要求レベルを使い、利用者と開発者の認識の行き違いを防ぐための資料です。重要項目から確認する考え方を、個々の性能要件にも使えます。最初から全項目を埋めるより、遅れると業務が止まる操作を先に選びましょう。

記述の骨格は、次の一文です。

> 対象操作を、指定したデータ量と負荷で実行したとき、定めた測定範囲の所要時間が、指定割合で目標内に収まること。

この一文を具体化するのが、以下の5条件です。

性能要件で合意する5つの条件

1. 対象操作を業務の完了単位で選ぶ

「検索機能」だけでは範囲が広すぎます。受注一覧なら、期間を指定する検索、顧客名による絞り込み、次ページの表示、CSV出力では負荷が異なります。画面IDやAPI IDに加え、利用者が何を完了できるまでを対象にするかを書きます。

たとえば「営業担当者が当月の受注を検索し、先頭50件を閲覧できるまで」とします。CSV全件出力は別の要件にし、受付の応答時間とファイルの生成期限を分けます。

優先順位は、利用頻度だけで決めません。締め処理に間に合わない、電話対応中に顧客を待たせる、といった業務影響も確認します。重い処理を非同期にする案なら、待機中の表示、完了通知、失敗時の再開も必要です。API仕様書の書き方で整理する入出力と失敗時の契約につなげると、速さだけの議論を避けられます。

2. 利用者数ではなく負荷の内容を決める

登録アカウントが500人いても、500人が同じ瞬間に検索するとは限りません。一方、少人数でも大きな帳票を連続出力すれば負荷は高くなります。

負荷条件には、少なくとも次を残します。

  • 対象データの件数、期間、偏り
  • 同時に操作する利用者数と操作間隔
  • 検索、登録、出力などの操作の割合
  • 通常時と月末などのピーク時
  • 同時に動くバッチや外部連携

「同時利用50人」とだけ書かず、各人がどの操作をどの頻度で行う想定かを補います。負荷試験ツールの仮想利用者数と、業務上の同時利用人数も、操作間隔の設定次第で意味が変わります。

データ量は初日だけでなく、運用後の見込みも確認します。履歴が増えるシステムでは、開始時と将来想定のデータで条件を分け、見込みの根拠と見直し時期を記録します。根拠がなければ未確定として残し、最大値を推測で埋めないことが大切です。

3. 測定の開始点と終了点をそろえる

同じ検索でも、API処理時間、通信を含む応答時間、ブラウザの描画完了までの時間は別の指標です。サーバーの測定だけで、利用者が感じる待ち時間を保証したことにはなりません。

要件表には、測定地点を具体的に書きます。

指標開始点の例終了点の例
サーバー処理時間APIが要求を受信応答の送信開始
API応答時間試験端末が要求を送信応答本文の受信完了
画面表示時間検索ボタンを操作一覧の内容が表示され操作可能
帳票生成時間生成要求の受付ダウンロード可能になった時点

どれが正しいかではなく、業務上の期待にどれを対応させるかが重要です。画面表示を対象にするなら、端末、ブラウザ、ネットワークの条件も必要です。外部サービスの待ち時間を除く場合は、除外範囲と別の確認方法を明記します。

キャッシュの扱いも決めます。初回の検索と、同じ条件を繰り返した検索を混ぜると、比較が難しくなります。利用実態に合わせて条件を分け、速い結果だけを採用しないようにします。

4. 平均値だけでなく達成率と失敗を判定する

平均が目標内でも、一部の処理が非常に遅いことがあります。GoogleのSRE解説は、平均だけでは遅い側の応答の分布を捉えにくいこと、指標の測定方法と有効条件を定義することを説明しています。

たとえば「検索応答の95パーセンタイルが2秒以下」と書けば、平均だけで判定する場合とは基準が変わります。ただし、集計対象、測定期間、サンプル数、パーセンタイルの算出方法もそろえる必要があります。複数回の試験のP95を単純平均して、一つのP95として扱わないようにしましょう。

また、失敗を速い応答として混ぜると評価が歪みます。エラー率、タイムアウト、結果の正しさを別に確認します。「HTTP応答が返った」ことと「指定した受注が正しく表示された」ことは同じではありません。

Grafana k6の公式文書では、応答時間やエラー率に閾値を設け、試験の合否を判定する方法を示しています。ツールを選ぶ前に、人が読んでも同じ判定になる条件を要件へ書くことが先です。

5. 試験環境と再判定の責任を決める

本番より小さいサーバー、異なるデータ、外部サービスの代替応答を使った試験では、その差を記録します。試験環境での合格を、そのまま本番性能の証明に広げないことが重要です。

確認するのは構成だけではありません。試験ツール側が負荷を出し切れているか、実施中に設定変更がなかったか、ログや監視の時刻を突き合わせられるかも必要です。

未達の場合の対応も、試験前に決めます。原因調査の担当、改善後の再試験、要件変更の承認者を明確にします。未達の結果を後から除外したり、都合のよい負荷へ下げたりして合格に変えないためです。

転記して使える性能要件の記入例

次は架空の受注一覧APIを対象とした記入例です。画面全体の表示性能ではなく、試験端末から見たAPI応答を測る前提です。

項目記入例
要件ID・対象PERF-01:当月受注の一覧検索API
データ受注100万件、顧客ごとの偏りを含む検証データ
負荷仮想利用者50、検索後に各5秒待機し繰り返す
操作当月・担当部門で絞り込み、先頭50件取得
測定端末の要求送信から本文受信完了まで
期間立ち上げ後の安定した30分間を評価、立ち上げ中も別記録
合格条件成功応答のP95が2秒以下、全要求のエラー率1%未満
正しさ権限・検索条件・件数・並び順を別の機能テストで確認
環境・証跡構成、データ版、スクリプト版、実績負荷、失敗ログを保存
判定業務責任者と開発責任者が結果・前提差を確認

この例では、画面描画やピーク時の別操作を含んでいません。実案件では対象外を明記し、必要なら別の要件IDを作ります。また、全体集計だけで一部の顧客の遅延が埋もれないかも確認します。

仕様書を閉じる前に確認すること

レビューでは、業務担当者が利用場面を読み、開発担当者が負荷と測定を再現し、テスト担当者が合否を判断できるかを確認します。

  • 対象操作と対象外を説明できるか
  • 通常時・ピーク時の負荷に根拠があるか
  • 測定地点、期間、除外条件が一致しているか
  • 遅さ、失敗、結果の正しさを分けているか
  • 環境差と未達時の再判定方法が残っているか

性能の判断を要求IDから試験結果まで追う考え方は、要件トレーサビリティの整理とも共通します。実装後に確認項目を探すのではなく、要件を決める時点で証跡の残し方までつなげましょう。

Kakusillは、散在する仕様書や業務の暗黙知をAIが使える形に整え、要件定義から仕様管理までを支える上流工程AIワークスペースです。性能についても、数値だけを置くのではなく、その根拠となる業務条件や未決事項を一緒に整理することが出発点になります。

まずは、待ち時間が問題になる操作を一つ選び、5条件を書き出してください。部署ごとに期待が食い違う、測定条件まで合意できない場合は、要件整理をご相談ください。

#性能要件#非機能要件#要件定義#性能テスト