Olay Müdahale Kılavuzu

Yaygın sorunlar için müdahale prosedürleri.

Bağlantı Sorunları

WebSocket Bağlantı Kopması

Belirtiler: WebSocket bağlantısı koptu, mesaj alınmıyor

Yapılacaklar:

1. Üstel geri çekilme (exponential backoff) ile otomatik yeniden bağlanma uygulayın
2. Kaçırılan güncellemeleri yakalamak için REST uç noktalarını sorgulayın
3. Yeniden bağlandıktan sonra tüm kanallara yeniden abone olun

Önleme: Bağlantı durumunu izleyin ve sağlam bir yeniden bağlanma mantığı uygulayın

API Zaman Aşımı

Belirtiler: REST istekleri zaman aşımına uğruyor veya 5xx hataları dönüyor

Yapılacaklar:

1. Üstel geri çekilme ile yeniden deneyin
2. Sağlık uç noktasını kontrol edin: GET /health
3. Sistem aşırı yüklüyse istek hızını azaltın

Önleme: İstek kısıtlama (throttling) ve devre kesici (circuit breaker) mekanizmaları uygulayın

Emir Sorunları

Yüksek Reddedilme Oranı

Belirtiler: Çok sayıda emir reddediliyor

İnceleme:

1. Reddedilme nedenlerini kontrol edin: GET /orders?wallet=...
2. Teminatı gözden geçirin: GET /portfolio?wallet=...
3. Katmanı (tier) kontrol edin: GET /user-tier?wallet=...
4. Enstrümanların vadesinin dolmadığını doğrulayın: GET /instruments

Yapılacaklar:

• Teminat sorunları varsa: Pozisyon büyüklüğünü azaltın veya teminat ekleyin
• Katman sorunları varsa: tier2'ye yükseltin veya satışları karşılayın
• Vade dolmuşsa: Farklı enstrümanlar kullanın

Eksik Gerçekleşmeler (Fill)

Belirtiler: Emirler gerçekleşti ancak gerçekleşme bildirimi gelmiyor

İnceleme:

1. Gerçekleşmeler için GET /fills?wallet=... uç noktasını kontrol edin
2. WebSocket fills kanal aboneliğini doğrulayın
3. WebSocket bağlantı durumunu kontrol edin

Yapılacaklar:

• fills kanalına yeniden abone olun
• Kaçırılan gerçekleşmeler için REST uç noktasını sorgulayın
• Gerçekleşmeleri emir durumuyla mutabık hale getirin

Güncel Olmayan Emir Durumu

Belirtiler: REST'teki emir durumu WS ile eşleşmiyor

İnceleme:

1. WebSocket bağlantı durumunu kontrol edin
2. Emir önbelleğinin güncel olduğunu doğrulayın
3. REST ve WS emir durumlarını karşılaştırın

Yapılacaklar:

• WS yeniden bağlandıktan sonra durumu yakalamak için REST'i sorgulayın
• Mutabakat için REST'i doğruluk kaynağı (source of truth) olarak kullanın

MMP Sorunları

MMP Çok Sık Tetikleniyor

Belirtiler: Çok sayıda emir MMP tarafından iptal ediliyor

İnceleme:

1. MMP yapılandırmasını kontrol edin: GET /mmp-config?wallet=...&currency=...
2. Gerçekleşme desenlerini ve kümülatif metrikleri gözden geçirin
3. Limitlerin çok düşük olup olmadığını kontrol edin

Yapılacaklar:

• MMP limitlerini artırın (miktar, delta, vega)
• Pencere içinde daha fazla gerçekleşmeye izin vermek için interval_ms değerini artırın
• Kotasyon sıklığını azaltın

MMP Tetiklenmiyor

Belirtiler: Gerçekleşmeler limitleri aşıyor ancak MMP tetiklenmiyor

İnceleme:

1. MMP'nin etkin olduğunu doğrulayın: GET /mmp-config?wallet=...&currency=...
2. Emirlerde mmp_enabled=true olduğunu kontrol edin
3. Para biriminin emrin dayanak varlığıyla eşleştiğini doğrulayın

Yapılacaklar:

• Emirlerde MMP'yi etkinleştirin: mmp_enabled=true
• MMP'yi doğru para birimi için yapılandırın
• Gerekirse limitleri ayarlayın

Teminat Sorunları

Yetersiz Teminat

Belirtiler: Emirler "Insufficient margin" hatasıyla reddediliyor

İnceleme:

1. Portföyü kontrol edin: GET /portfolio?wallet=...
2. Teminat hesaplamasını gözden geçirin
3. Hangi senaryonun başarısız olduğunu kontrol edin

Yapılacaklar:

• Pozisyon büyüklüğünü azaltın
• Teminat ekleyin (yatırma akışı uygulandığında)
• Teminat serbest bırakmak için pozisyonları kapatın
• En kötü durum zararını azaltmak için maruziyeti hedge edin

Eksik Spot Fiyat

Belirtiler: Emirler "No spot price available" hatasıyla reddediliyor

İnceleme:

1. Hyperliquid spot fiyat beslemesinin bağlantısını kontrol edin
2. Dayanak varlık sembolünün doğru olduğunu doğrulayın
3. Spot fiyat beslemesinin çalışır durumda olup olmadığını kontrol edin

Yapılacaklar:

• Spot fiyat beslemesinin toparlanmasını bekleyin
• Mümkünse farklı bir dayanak varlık kullanın
• Sorun devam ederse destek ile iletişime geçin

Sistem Sorunları

Yüksek Gecikme

Belirtiler: Yavaş API yanıtları veya WebSocket mesaj gecikmeleri

İnceleme:

1. Sistem yükünü kontrol edin
2. Yanıt sürelerini izleyin
3. Ağ bağlantısını kontrol edin

Yapılacaklar:

• İstek hızını azaltın
• İstek kısıtlama (throttling) uygulayın
• Sorun devam ederse destek ile iletişime geçin

Hız Sınırlaması (Rate Limiting)

Belirtiler: İstekler reddediliyor veya kısıtlanıyor

Mevcut durum: Hız sınırlaması cüzdan başına uygulanır. Ayrıntılar için Hız Sınırları sayfasına bakın.

Yapılacaklar:

• Retry-After başlığını kontrol edin ve yeniden denemeden önce bekleyin
• Limitlere ulaşmamak için X-RateLimit-Remaining değerini izleyin
• Mümkün olduğunda toplu (bulk) uç noktaları kullanın

Acil Durum Prosedürleri

Acil Durdurma (Kill Switch)

Anında yapılacaklar:

1. Tüm emirleri iptal edin: DELETE /bulk_order veya DELETE /bulk_order_cloid
2. WebSocket bağlantısını kesin
3. Kotasyon sistemini durdurun

Kurtarma:

1. Tüm emirlerin iptal edildiğini doğrulayın: GET /orders?wallet=...
2. Portföyü gözden geçirin: GET /portfolio?wallet=...
3. Kök nedeni araştırın
4. Sorun çözüldükten sonra kotasyona devam edin

Veri Mutabakatı

Olay sonrasında:

1. Mevcut durum için REST uç noktalarını sorgulayın
2. Emirleri mutabık hale getirin: GET /orders?wallet=...
3. Gerçekleşmeleri mutabık hale getirin: GET /fills?wallet=...
4. Portföyü mutabık hale getirin: GET /portfolio?wallet=...
5. WebSocket aboneliklerine devam edin

Yükseltme (Escalation)

Sorun devam ederse:

1. Erişimle birlikte sağlanan bilinen sorunları ve staging duyurularını gözden geçirin
2. Ayrıntılı prosedürler için Runbook'lar sayfasını kontrol edin
3. Aşağıdaki bilgilerle destek ile iletişime geçin:
   • Cüzdan adresi
   • Hata mesajları
   • Zaman damgaları
   • Yeniden üretme adımları