Surveillance et alertes
Ce que les teneurs de marché doivent surveiller et sur quoi ils doivent déclencher des alertes.
Contrôles de santé
Santé de l'API
Point de terminaison : GET /health
Réponse : {"status":"ok"}
Disponibilité : GET /ready renvoie {"status":"ready","components":[...]} avec un indicateur ready par composant. Utilisez-le pour distinguer une API joignable mais pas encore opérationnelle d'une API saine.
Surveillance : vérifiez toutes les 30 à 60 secondes
Alerte : si le contrôle de santé échoue, le serveur API est peut-être hors service
Connexion WebSocket
Surveillance : suivez l'état de la connexion WebSocket
Alerte : si la connexion est perdue, reconnectez-vous immédiatement
Bonne pratique : implémentez un backoff exponentiel lors de la reconnexion
Surveillance des ordres
Taux de rejet
Métrique : pourcentage d'ordres rejetés
Alerte : si le taux de rejet dépasse 5 %, examinez :
- Les problèmes de marge
- Les restrictions de niveau
- Les instruments arrivés à échéance
- Une surcharge du système
Taux d'exécution
Métrique : pourcentage d'ordres exécutés
Alerte : si le taux d'exécution baisse nettement, examinez :
- Les conditions de marché
- La compétitivité des cotations
- La profondeur du carnet d'ordres
Latence des ordres
Métrique : délai entre le placement de l'ordre et l'exécution ou l'accusé de réception
Alerte : si la latence dépasse 1 s, examinez :
- Une surcharge du système
- Des problèmes réseau
- Des retards de traitement du moteur
Surveillance du portefeuille
Utilisation de la marge
Métrique : utilisation de la marge à partir de margin_summary dans GET /portfolio?wallet=.... margin_summary.initial_margin et margin_summary.maintenance_margin sont des marges restantes (ce qui reste après les exigences), pas la marge utilisée. Calculez l'utilisation par rapport à la base qui soutient réellement la marge dans chaque mode :
margin_summary.mode | Base | Marge initiale restante | Marge de maintenance restante |
|---|---|---|---|
portfolio | equity | initial_margin | maintenance_margin |
standard | standard_margin.cash_margin | standard_margin.initial_margin_headroom | standard_margin.maintenance_margin_headroom |
im_utilization = (basis - initial_margin_headroom) / basis
mm_utilization = (basis - maintenance_margin_headroom) / basis
Considérez une base nulle ou négative comme utilisée à 100 %.
Alerte : si l'utilisation de la marge initiale dépasse 80 %, les nouveaux ordres sont proches du rejet. Si l'utilisation de la marge de maintenance approche 100 %, le compte est proche de la liquidation. Envisagez de :
- Réduire la taille des positions
- Ajouter du collatéral
- Clôturer des positions
Collatéral libre
Métrique : available_balance depuis GET /portfolio?wallet=.... Il s'agit du collatéral libre pour de nouvelles transactions, pas du solde de trésorerie en USDC. Les marks d'options, le PnL des perps et les exigences de marge le font varier sans mouvement de trésorerie. Pour le montant retirable, utilisez withdrawable_usdc.
Alerte : si le collatéral libre passe sous un seuil, réduisez le risque ou déposez des fonds
Surveillance du MMP
Déclenchements du MMP
Métrique : nombre de déclenchements du MMP par heure
Alerte : si le MMP se déclenche fréquemment, envisagez de :
- Relever les limites du MMP
- Réduire la fréquence de cotation
- Revoir les schémas d'exécution
Taux d'annulation par le MMP
Métrique : pourcentage d'ordres annulés par le MMP
Alerte : si le taux d'annulation par le MMP dépasse 10 %, revoyez la configuration du MMP
Surveillance du système
Temps de réponse de l'API
Métrique : temps de réponse P50, P95, P99
Alerte : si le P95 dépasse 500 ms, examinez la charge du système
Débit de messages WebSocket
Métrique : messages par seconde sur le WebSocket
Alerte : en cas de pic du débit de messages, examinez :
- La volatilité du marché
- Une surcharge du système
- Des retards de traitement des messages
Alertes recommandées
- Échec du contrôle de santé : serveur API hors service
- Taux de rejet élevé : plus de 5 % des ordres rejetés
- Faible taux d'exécution : moins de 50 % des ordres exécutés (selon le contexte)
- Utilisation de la marge élevée : plus de 80 % de la marge utilisée
- Déclenchements du MMP : plus de 5 déclenchements par heure
- Déconnexion WebSocket : connexion perdue
- Latence élevée : P95 supérieur à 500 ms
Outils de surveillance
Recommandés :
- Point de terminaison de contrôle de santé pour la surveillance de la disponibilité
- Suivi de l'état de la connexion WebSocket
- Rapprochement des ordres et des exécutions pour garantir l'exactitude
- Suivi de la marge du portefeuille
Actuellement : aucun tableau de bord de surveillance intégré. Utilisez des outils externes (par exemple Prometheus, Grafana).