このページは機械翻訳されています。英語の原文が正式版です。 英語で読む →
メインコンテンツにスキップ

インシデント対応プレイブック

一般的な問題への対応手順です。

接続の問題​

WebSocket 切断​

症状: WebSocket 接続が失われ、メッセージが受信されない

対応:

  1. 指数バックオフによる自動再接続を実装する
  2. REST エンドポイントをポーリングして、見逃した更新を取得する
  3. 再接続後にすべてのチャンネルへ再サブスクライブする

予防策: 接続状態を監視し、堅牢な再接続ロジックを実装してください

API タイムアウト​

症状: REST リクエストがタイムアウトする、または 5xx エラーが返る

対応:

  1. 指数バックオフでリトライする
  2. ヘルスエンドポイントを確認する: GET /health
  3. システムが過負荷の場合はリクエストレートを下げる

予防策: リクエストのスロットリングとサーキットブレーカーを実装してください

注文の問題​

拒否率が高い​

症状: 多くの注文が拒否される

調査:

  1. GET /orders?wallet=... で拒否理由を確認する
  2. 証拠金を確認する: GET /portfolio?wallet=...
  3. ティアを確認する: GET /user-tier?wallet=...
  4. 銘柄が満期を迎えていないことを確認する: GET /instruments

対応:

  • 証拠金の問題の場合: ポジションサイズを縮小するか、担保を追加する
  • ティアの問題の場合: tier2 にアップグレードするか、売り注文をカバーする
  • 満期を迎えている場合: 別の銘柄を使用する

約定通知の欠落​

症状: 注文は約定しているが、約定通知が届かない

調査:

  1. GET /fills?wallet=... で約定を確認する
  2. WebSocket の fills チャンネルのサブスクリプションを確認する
  3. WebSocket の接続状態を確認する

対応:

  • fills チャンネルへ再サブスクライブする
  • 見逃した約定を REST エンドポイントでポーリングする
  • 約定と注文ステータスを照合する

注文ステータスの陳腐化​

症状: REST の注文ステータスが WS と一致しない

調査:

  1. WebSocket の接続状態を確認する
  2. 注文キャッシュが最新であることを確認する
  3. REST と WS の注文ステータスを比較する

対応:

  • WS 再接続後に REST をポーリングして最新状態を取得する
  • 照合の際は REST を信頼できる情報源として使用する

MMP の問題​

MMP が頻繁にトリガーされる​

症状: 多くの注文が MMP によってキャンセルされる

調査:

  1. MMP 設定を確認する: GET /mmp-config?wallet=...&currency=...
  2. 約定パターンと累積メトリクスを確認する
  3. 制限値が低すぎないか確認する

対応:

  • MMP の制限値（数量、デルタ、ベガ）を引き上げる
  • interval_ms を大きくして、ウィンドウ内でより多くの約定を許容する
  • クオートの頻度を下げる

MMP がトリガーされない​

症状: 約定が制限値を超えているのに MMP がトリガーされない

調査:

  1. MMP が有効であることを確認する: GET /mmp-config?wallet=...&currency=...
  2. 注文に mmp_enabled=true が設定されているか確認する
  3. 通貨が注文の原資産と一致しているか確認する

対応:

  • 注文で MMP を有効にする: mmp_enabled=true
  • 正しい通貨に対して MMP を設定する
  • 必要に応じて制限値を調整する

証拠金の問題​

証拠金不足​

症状: 「Insufficient margin」で注文が拒否される

調査:

  1. ポートフォリオを確認する: GET /portfolio?wallet=...
  2. 証拠金計算を確認する
  3. どのシナリオで失敗しているか確認する

対応:

  • ポジションサイズを縮小する
  • 担保を追加する（入金フローが実装されている場合）
  • ポジションをクローズして証拠金を解放する
  • エクスポージャーをヘッジして最悪ケースの損失を軽減する

スポット価格の欠落​

症状: 「No spot price available」で注文が拒否される

調査:

  1. Hyperliquid のスポット価格フィードの接続性を確認する
  2. 原資産のシンボルが正しいことを確認する
  3. スポット価格フィードが稼働しているか確認する

対応:

  • スポット価格フィードの復旧を待つ
  • 可能であれば別の原資産を使用する
  • 問題が解決しない場合はサポートに連絡する

システムの問題​

高レイテンシ​

症状: API のレスポンスが遅い、または WebSocket メッセージが遅延する

調査:

  1. システム負荷を確認する
  2. レスポンスタイムを監視する
  3. ネットワーク接続を確認する

対応:

  • リクエストレートを下げる
  • リクエストのスロットリングを実装する
  • 問題が解決しない場合はサポートに連絡する

レート制限​

症状: リクエストが拒否またはスロットリングされる

現状: レート制限はウォレット単位で適用されます。詳細はレート制限をご覧ください。

対応:

  • Retry-After ヘッダーを確認し、待機してからリトライする
  • X-RateLimit-Remaining を監視して制限到達を回避する
  • 可能な場合はバルクエンドポイントを使用する

緊急時の手順​

キルスイッチ​

即時対応:

  1. すべての注文をキャンセルする: DELETE /bulk_order または DELETE /bulk_order_cloid
  2. WebSocket を切断する
  3. クオートシステムを停止する

復旧:

  1. すべての注文がキャンセルされたことを確認する: GET /orders?wallet=...
  2. ポートフォリオを確認する: GET /portfolio?wallet=...
  3. 根本原因を調査する
  4. 問題解決後にクオートを再開する

データ照合​

インシデント後:

  1. REST エンドポイントをポーリングして現在の状態を取得する
  2. 注文を照合する: GET /orders?wallet=...
  3. 約定を照合する: GET /fills?wallet=...
  4. ポートフォリオを照合する: GET /portfolio?wallet=...
  5. WebSocket のサブスクリプションを再開する

エスカレーション​

問題が解決しない場合:

  1. アクセス時に提供された既知の問題およびステージングに関する通知を確認する
  2. 詳細な手順についてはランブックを確認する
  3. 以下の情報を添えてサポートに連絡する:
    • ウォレットアドレス
    • エラーメッセージ
    • タイムスタンプ
    • 再現手順
最終更新: