Monitoring & Alerts
Was Market Maker überwachen und wofür sie Alerts einrichten sollten.
Health Checks
API-Health
Endpunkt: GET /health
Antwort: {"status":"ok"}
Readiness: GET /ready liefert {"status":"ready","components":[...]} mit einem ready-Flag pro Komponente. Damit unterscheiden Sie eine erreichbare, aber noch nicht betriebsbereite API von einer funktionsfähigen.
Monitoring: Alle 30 bis 60 Sekunden prüfen
Alert: Schlägt der Health Check fehl, ist der API-Server möglicherweise ausgefallen
WebSocket-Verbindung
Monitoring: Status der WebSocket-Verbindung verfolgen
Alert: Bei Verbindungsabbruch sofort neu verbinden
Best Practice: Exponentielles Backoff beim erneuten Verbinden implementieren
Order-Monitoring
Ablehnungsquote
Metrik: Prozentsatz abgelehnter Orders
Alert: Bei einer Ablehnungsquote > 5 % prüfen Sie:
- Margin-Probleme
- Tier-Beschränkungen
- Abgelaufene Instrumente
- Systemüberlastung
Ausführungsquote
Metrik: Prozentsatz ausgeführter Orders
Alert: Sinkt die Ausführungsquote deutlich, prüfen Sie:
- Marktbedingungen
- Wettbewerbsfähigkeit der Quotes
- Tiefe des Orderbuchs
Order-Latenz
Metrik: Zeit von der Orderplatzierung bis zur Ausführung bzw. Bestätigung
Alert: Bei einer Latenz > 1 s prüfen Sie:
- Systemüberlastung
- Netzwerkprobleme
- Verzögerungen bei der Engine-Verarbeitung
Portfolio-Monitoring
Margin-Auslastung
Metrik: Margin-Auslastung aus margin_summary in GET /portfolio?wallet=.... margin_summary.initial_margin und margin_summary.maintenance_margin sind Headroom (der Rest nach Abzug der Anforderungen), nicht die genutzte Margin. Berechnen Sie die Auslastung gegen die Basis, die im jeweiligen Modus die Margin tatsächlich trägt:
margin_summary.mode | Basis | Initial-Margin-Headroom | Maintenance-Margin-Headroom |
|---|---|---|---|
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
Eine Basis von null oder weniger gilt als 100 % ausgelastet.
Alert: Liegt die Initial-Margin-Auslastung über 80 %, stehen neue Orders kurz vor der Ablehnung. Nähert sich die Maintenance-Margin-Auslastung 100 %, steht das Konto kurz vor der Liquidation. Erwägen Sie:
- Positionsgröße reduzieren
- Sicherheiten nachschießen
- Positionen schließen
Freie Sicherheiten
Metrik: available_balance aus GET /portfolio?wallet=.... Das sind freie Sicherheiten für neue Trades, nicht der USDC-Cash-Bestand. Optionsmarks, Perp-PnL und Margin-Anforderungen verändern den Wert, ohne dass Cash bewegt wird. Für den auszahlbaren Betrag nutzen Sie withdrawable_usdc.
Alert: Liegen die freien Sicherheiten unter dem Schwellenwert, reduzieren Sie das Risiko oder zahlen Sie Mittel ein
MMP-Monitoring
MMP-Auslösungen
Metrik: Anzahl der MMP-Auslösungen pro Stunde
Alert: Wird MMP häufig ausgelöst, erwägen Sie:
- MMP-Limits erhöhen
- Quote-Frequenz reduzieren
- Ausführungsmuster überprüfen
MMP-Stornoquote
Metrik: Prozentsatz der von MMP stornierten Orders
Alert: Bei einer MMP-Stornoquote > 10 % die MMP-Konfiguration überprüfen
System-Monitoring
API-Antwortzeiten
Metrik: Antwortzeiten P50, P95, P99
Alert: Bei P95 > 500 ms die Systemlast untersuchen
WebSocket-Nachrichtenrate
Metrik: Nachrichten pro Sekunde über WebSocket
Alert: Bei sprunghaft steigender Nachrichtenrate prüfen Sie:
- Marktvolatilität
- Systemüberlastung
- Verzögerungen bei der Nachrichtenverarbeitung
Empfohlene Alerts
- Health Check fehlgeschlagen: API-Server ausgefallen
- Hohe Ablehnungsquote: > 5 % der Orders abgelehnt
- Niedrige Ausführungsquote: < 50 % der Orders ausgeführt (kontextabhängig)
- Hohe Margin-Auslastung: > 80 % der Margin genutzt
- MMP-Auslösungen: > 5 Auslösungen pro Stunde
- WebSocket-Trennung: Verbindung verloren
- Hohe Latenz: P95 > 500 ms
Monitoring-Tools
Empfohlen:
- Health-Check-Endpunkt für Uptime-Monitoring
- Verfolgung des WebSocket-Verbindungsstatus
- Abgleich von Orders und Ausführungen zur Sicherstellung der Genauigkeit
- Überwachung der Portfolio-Margin
Aktuell: Kein integriertes Monitoring-Dashboard. Nutzen Sie externe Tools (z. B. Prometheus, Grafana).