フェイルオーバー

graph TD
    Start[リクエストがプロキシに到達] --> Send[現在のプロバイダーに送信]
    Send --> CheckSuccess{成功？}
    CheckSuccess -- はい --> Return[レスポンスを返却]
    CheckSuccess -- いいえ --> LogFail[失敗を記録]
    LogFail --> CheckCircuit{サーキットブレーカーの状態確認}
    CheckCircuit -- 発動中 --> Skip[このプロバイダーをスキップ]
    CheckCircuit -- 未発動 --> IncFail[失敗カウントを増加]
    Skip --> Next{キューに次がある？}
    IncFail --> Next
    Next -- あり --> Switch[プロバイダーを切り替え]
    Switch --> Retry[リクエストをリトライ]
    Retry --> Send
    Next -- なし --> Error[エラーを返却]

サーキットブレーカーの設定

サーキットブレーカーは、失敗したプロバイダーへの頻繁なリトライを防止します。

設定項目

アプリごとに独立したデフォルト設定があります。以下は共通のデフォルト値で、Claude には独自の緩やかな設定があります。

設定	説明	共通デフォルト	Claude デフォルト	範囲
失敗閾値	連続何回失敗でサーキットブレーカーが発動	4	8	1-20
復旧成功閾値	ハーフオープン状態で何回成功したら閉じるか	2	3	1-10
復旧待機時間	サーキットブレーカー発動後の復旧試行までの時間（秒）	60	90	0-300
エラー率閾値	この値を超えるとサーキットブレーカーが発動	60%	70%	0-100%
最小リクエスト数	エラー率計算前の最小リクエスト数	10	15	5-100

Claude はリクエストに時間がかかるため、デフォルト設定はより緩やかで、多くの失敗を許容します。

タイムアウト設定

設定	説明	共通デフォルト	Claude デフォルト	範囲
ストリーム初バイトタイムアウト	最初のデータチャンクの最大待機時間（秒）	60	90	1-120
ストリームサイレントタイムアウト	データチャンク間の最大間隔（秒）	120	180	60-600（0 で無効化）
非ストリームタイムアウト	非ストリームリクエストの総タイムアウト時間（秒）	600	600	60-1200

リトライ設定

設定	説明	共通デフォルト	Claude デフォルト	範囲
最大リトライ回数	リクエスト失敗時のリトライ回数	3	6	0-10

Gemini のデフォルト最大リトライ回数は 5 です。

サーキットブレーカーの状態

状態	説明
閉（Closed）	正常状態、リクエストを許可
開（Open）	サーキットブレーカー発動中、このプロバイダーをスキップ
半開（Half-Open）	復旧試行中、探査リクエストを送信

状態遷移

stateDiagram-v2
    [*] --> Closed: 初期化
    Closed --> Open: 失敗回数 >= 閾値
    Open --> HalfOpen: サーキットブレーカー期間満了
    HalfOpen --> Closed: 探査成功 (>= 復旧閾値)
    HalfOpen --> Open: 探査失敗

ヘルスステータスの表示

プロバイダーカード

カードにヘルスステータスバッジが表示されます：

バッジ	状態	説明
緑	健康	連続失敗回数 0
黄	警告	失敗はあるがサーキットブレーカー未発動
赤	サーキットブレーカー発動	一時的にスキップ

キューリスト

フェイルオーバーキューにも各プロバイダーのヘルスステータスが表示されます。

フェイルオーバーログ

各フェイルオーバーの記録内容：

情報	説明
時間	発生時刻
元のプロバイダー	失敗したプロバイダー
新しいプロバイダー	切り替え先のプロバイダー
失敗理由	エラー情報

使用量統計のリクエストログで確認できます。