Guide de gestion des incidents

Procédures de réponse aux problèmes courants.

Problèmes de connexion

Déconnexion WebSocket

Symptômes : connexion WebSocket perdue, aucun message reçu

Actions :

1. Implémentez une reconnexion automatique avec backoff exponentiel
2. Interrogez les endpoints REST pour rattraper les mises à jour manquées
3. Réabonnez-vous à tous les canaux après la reconnexion

Prévention : surveillez l'état de la connexion et implémentez une logique de reconnexion robuste

Timeout de l'API

Symptômes : les requêtes REST expirent ou renvoient des erreurs 5xx

Actions :

1. Réessayez avec un backoff exponentiel
2. Vérifiez l'endpoint de santé : GET /health
3. Réduisez le débit de requêtes si le système est surchargé

Prévention : implémentez une limitation du débit de requêtes et des circuit breakers

Problèmes d'ordres

Taux de rejet élevé

Symptômes : de nombreux ordres sont rejetés

Investigation :

1. Vérifiez les motifs de rejet via GET /orders?wallet=...
2. Examinez la marge : GET /portfolio?wallet=...
3. Vérifiez le niveau (tier) : GET /user-tier?wallet=...
4. Vérifiez que les instruments ne sont pas expirés : GET /instruments

Actions :

• En cas de problème de marge : réduisez la taille de la position ou ajoutez du collatéral
• En cas de problème de tier : passez au tier2 ou couvrez les ventes
• En cas d'expiration : utilisez d'autres instruments

Exécutions manquantes

Symptômes : ordres exécutés mais aucune notification d'exécution

Investigation :

1. Vérifiez GET /fills?wallet=... pour les exécutions
2. Vérifiez l'abonnement au canal WebSocket fills
3. Vérifiez l'état de la connexion WebSocket

Actions :

• Réabonnez-vous au canal fills
• Interrogez l'endpoint REST pour les exécutions manquées
• Réconciliez les exécutions avec le statut des ordres

Statut d'ordre obsolète

Symptômes : le statut de l'ordre en REST ne correspond pas au WS

Investigation :

1. Vérifiez l'état de la connexion WebSocket
2. Vérifiez que le cache d'ordres est à jour
3. Comparez le statut des ordres en REST et en WS

Actions :

• Interrogez REST après une reconnexion WS pour vous resynchroniser
• Utilisez REST comme source de vérité pour la réconciliation

Problèmes de MMP

Le MMP se déclenche trop fréquemment

Symptômes : de nombreux ordres annulés par le MMP

Investigation :

1. Vérifiez la configuration MMP : GET /mmp-config?wallet=...&currency=...
2. Examinez les schémas d'exécution et les métriques cumulées
3. Vérifiez si les limites sont trop basses

Actions :

• Augmentez les limites MMP (quantité, delta, véga)
• Augmentez interval_ms pour autoriser plus d'exécutions dans la fenêtre
• Réduisez la fréquence de cotation

Le MMP ne se déclenche pas

Symptômes : les exécutions dépassent les limites mais le MMP ne se déclenche pas

Investigation :

1. Vérifiez que le MMP est activé : GET /mmp-config?wallet=...&currency=...
2. Vérifiez mmp_enabled=true sur les ordres
3. Vérifiez que la devise correspond au sous-jacent de l'ordre

Actions :

• Activez le MMP sur les ordres : mmp_enabled=true
• Configurez le MMP pour la bonne devise
• Ajustez les limites si nécessaire

Problèmes de marge

Marge insuffisante

Symptômes : ordres rejetés avec le message « Insufficient margin »

Investigation :

1. Vérifiez le portefeuille : GET /portfolio?wallet=...
2. Examinez le calcul de marge
3. Identifiez le scénario qui échoue

Actions :

• Réduisez la taille de la position
• Ajoutez du collatéral (lorsque le flux de dépôt sera implémenté)
• Fermez des positions pour libérer de la marge
• Couvrez votre exposition pour réduire la perte dans le pire scénario

Prix spot manquant

Symptômes : ordres rejetés avec le message « No spot price available »

Investigation :

1. Vérifiez la connectivité du flux de prix spot Hyperliquid
2. Vérifiez que le symbole du sous-jacent est correct
3. Vérifiez si le flux de prix spot est opérationnel

Actions :

• Attendez le rétablissement du flux de prix spot
• Utilisez un autre actif sous-jacent si disponible
• Contactez le support si le problème persiste

Problèmes système

Latence élevée

Symptômes : réponses API lentes ou retards des messages WebSocket

Investigation :

1. Vérifiez la charge du système
2. Surveillez les temps de réponse
3. Vérifiez la connectivité réseau

Actions :

• Réduisez le débit de requêtes
• Implémentez une limitation du débit de requêtes
• Contactez le support si le problème persiste

Limitation de débit

Symptômes : requêtes rejetées ou ralenties

Situation actuelle : la limitation de débit est appliquée par portefeuille. Consultez Rate Limits pour plus de détails.

Actions :

• Vérifiez l'en-tête Retry-After et attendez avant de réessayer
• Surveillez X-RateLimit-Remaining pour éviter d'atteindre les limites
• Utilisez les endpoints groupés (bulk) lorsque possible

Procédures d'urgence

Arrêt d'urgence (kill switch)

Actions immédiates :

1. Annulez tous les ordres : DELETE /bulk_order ou DELETE /bulk_order_cloid
2. Déconnectez le WebSocket
3. Arrêtez le système de cotation

Reprise :

1. Vérifiez que tous les ordres sont annulés : GET /orders?wallet=...
2. Examinez le portefeuille : GET /portfolio?wallet=...
3. Recherchez la cause racine
4. Reprenez la cotation une fois le problème résolu

Réconciliation des données

Après un incident :

1. Interrogez les endpoints REST pour connaître l'état actuel
2. Réconciliez les ordres : GET /orders?wallet=...
3. Réconciliez les exécutions : GET /fills?wallet=...
4. Réconciliez le portefeuille : GET /portfolio?wallet=...
5. Reprenez les abonnements WebSocket

Escalade

Si le problème persiste :

1. Consultez les problèmes connus et les avis de staging fournis avec l'accès
2. Consultez les Runbooks pour les procédures détaillées
3. Contactez le support en fournissant :
   • L'adresse du portefeuille
   • Les messages d'erreur
   • Les horodatages
   • Les étapes pour reproduire le problème