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ı kesildi, 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 telafi etmek 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öndürü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ı düşürün

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

Emir Sorunları

Yüksek Ret Oranı

Belirtiler: Çok sayıda emir reddediliyor

İnceleme:

1. Her emir yanıtındaki ve WebSocket order_updates mesajındaki status ve reason alanlarını kaydedin. GET /orders?wallet=... varsayılan olarak açık emirleri döndürür ve ret nedenlerini içermez
2. Teminatı gözden geçirin: GET /portfolio?wallet=...
3. Hesap limitlerini kontrol edin: GET /risk/limits?wallet=...
4. Enstrümanların vadesinin dolmadığını doğrulayın: GET /instruments?currency=...

Yapılacaklar:

• Teminat sorunu varsa: Pozisyon büyüklüğünü azaltın veya teminat ekleyin
• Kademe (tier) sorunu varsa: Satışları long envanterle karşılayın veya kademe değişikliği için Hypercall ile iletişime geçin
• Vadesi dolmuşsa: Farklı enstrümanlar kullanın

Eksik Gerçekleşmeler

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

İ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 mutabakat edin

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:

• Durumu yakalamak için WS yeniden bağlantısından sonra REST'i sorgulayın
• Mutabakat için REST'i doğruluk kaynağı olarak kullanın

MMP Sorunları

MMP Çok Sık Tetikleniyor

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

İnceleme:

1. İmzalı bir GET /mmp-config?wallet=...&currency=... isteğiyle MMP yapılandırmasını kontrol edin
2. Gerçekleşme örüntülerini 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. İmzalı bir GET /mmp-config?wallet=...&currency=... isteğiyle MMP'nin etkin olduğunu doğrulayın
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

İmzalı MMP okumaları, GetMmpConfig son geçerlilik zamanını ve imzasını X-Hypercall-Expires-At-Ms ve X-Hypercall-Signature başlıklarında gönderir.

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
• Teminatı serbest bırakmak için pozisyonları kapatın
• En kötü durum zararını azaltmak için maruziyetinizi hedge edin

Eksik Spot Fiyat

Belirtiler: Emirler "Missing spot price for underlying" ile başlayan bir nedenle reddediliyor

İnceleme:

1. GET /markets içinde ilgili dayanak varlığın index_price değerini kontrol edin
2. Dayanak varlık sembolünün doğru olduğunu doğrulayın
3. Bir oracle olayı olup olmadığını görmek için durum sayfasını kontrol edin

Yapılacaklar:

• Spot fiyat akışının düzelmesini bekleyin
• Varsa farklı bir dayanak varlık kullanın
• Sorun devam ederse destek ekibiyle 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ı düşürün
• İstek kısıtlama uygulayın
• Sorun devam ederse destek ekibiyle iletişime geçin

Hız Sınırlaması

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

Mevcut durum: Hız limitleri cüzdan başına uygulanır; iptaller, ajan yetkilendirme, MMP yazmaları ve risk simülasyonları için ayrıca kaynak başına limitler bulunur. Ayrıntılar için Hız Limitleri sayfasına bakın.

Yapılacaklar:

• Retry-After başlığını kontrol edin ve yeniden denemeden önce bekleyin
• Limitlere takılmamak 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, istek başına en fazla 50 emir
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. Güncel durum için REST uç noktalarını sorgulayın
2. Emirleri mutabakat edin: GET /orders?wallet=...
3. Gerçekleşmeleri mutabakat edin: GET /fills?wallet=...
4. Portföyü mutabakat edin: GET /portfolio?wallet=...
5. WebSocket aboneliklerine devam edin

Eskalasyon

Sorun devam ederse:

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