APIファンアウト・リクエスト増幅

1つの起点APIへ入る要求が依存APIへ何件の要求を発生させるかを見積もる。

循環しないAPI呼出グラフについて、同じ期間の期待リクエスト数を求めます。分岐確率とキャッシュヒット率は測定値または想定値を入力してください。

入力すると自動で計算します。Enterで次の項目へ進めます。次の入力欄を選んで進めます。

必要な入力・選択は3項目です。

下のノード表と同じIDを入力します。APIのURLではなく、識別用の短い文字列です。

対象期間を揃えた整数の件数を入力します。要求数の初期値は設定していません。

APIノード一覧必須
行API ID操作
1
2

1列を左端の欄へタブ区切りで貼り付けられます。40行まで。

呼出元と呼出先に使うAPIを登録します。IDは一意にしてください。

API間の呼出辺任意
行呼出元ID呼出先ID1回当たりの呼出回数(回)分岐確率(0~1)キャッシュヒット率(0~1)操作
1
2

5列を左端の欄へタブ区切りで貼り付けられます。160行まで。

分岐確率・ヒット率は0~1(25%なら0.25)。ヒット時は呼出先への要求を送信しないと仮定します。呼出辺の全空欄行は未使用です。


計算結果

必要な値を入力すると自動で計算します。

お気に入り一覧

計算方法・適用範囲・出典

計算方法

呼出辺 i→j の期待送信数=API iの段別要求数×1回当たりの呼出回数 mᵢⱼ×分岐確率 pᵢⱼ×(1−キャッシュヒット率 hᵢⱼ)。段0は起点への要求数、段d+1は段dから発生する全辺の送信数です。各段・各APIの期待要求数を加算し、総増幅倍率=全段合計÷起点要求数とします。異なる経路から同じAPIへ到達する呼出は別々に数えます。

全API総要求数、下流要求数、増幅倍率、到達段別・API別・呼出辺別の期待要求数。

計算例(架空の数値)

例:起点Aに100件。A→Bは2回・分岐確率1・ヒット率0.25、A→Cは1回・確率0.5・ヒット率0、B→Dは3回・確率0.4・ヒット率0.5。段0は100件、段1は200件(B 150件、C 50件)、段2は90件(D 90件)。全API390件、下流290件、増幅3.9倍です。

適用対象と限界

起点の要求数と各API呼出辺の回数・分岐確率・キャッシュヒット率を同じ観測期間に対して指定できる循環のない依存グラフ。循環呼出、再試行、エラー時の代替呼出、タイムアウト、バッチ化、呼出先の自動重複排除、キャッシュTTLからのヒット率推定、同時接続数・遅延・ピーク負荷・API料金の算出は対象外。結果は観測回数ではなく期待値です。。

採用した方式

  • 非巡回呼出グラフの期待リクエスト数(DAG-expected-requests v1.0):対象範囲 呼出回数・条件付き分岐確率・各辺のキャッシュヒット率が与えられる定常的な呼出構造/適用地域 global

方法と出典

方法:期待値伝播DAG v1.0(Microsoft Gateway AggregationとAWS API Gatewayのキャッシュ定義を踏まえた独立した期待値算術)。データ記録日:2026-11-13。