--- title: Hata yönetimi ve kurtarma description: Hataları yorumlama ve onlardan kurtulma --- --- Hataları nasıl yorumlayacağınızı, yanıtlayacağınızı ve raporlayacağınızı anlamak, Verdent for VS Code ile verimli geliştirme oturumlarını sürdürmenize yardımcı olur. ### Neler öğreneceksiniz - Yaygın hata türleri ve nedenleri - Hata mesajlarını etkili şekilde yorumlama - Sistematik sorun giderme adımları - Ne zaman beklemeli, ne zaman harekete geçmeli - Sorunları Verdent ekibine nasıl raporlarsınız --- ## Yaygın hata türleri Kapsamlı hata belgeleri şu anda geliştirilmektedir. Aşağıdaki bilgiler en sık karşılaşılan hata kategorilerini kapsar. Belirli hata senaryoları için support@verdent.ai ile iletişime geçin veya Discord topluluğunu ziyaret edin. **Aşırı yüklenmiş sunucu hataları** - Yoğun trafik dönemlerinde oluşur - Geçici kapasite kısıtlamaları - **Eylem**: 5-10 dakika bekleyip tekrar deneyin **Dahili sunucu hataları** - Arka uç işleme sorunları - Geçici hizmet kesintileri - **Eylem**: Bekleyip tekrar deneyin, genellikle otomatik olarak çözülür **503 Service Unavailable** - Çalışan yukarı akış sunucusu yok - Geçici altyapı sorunları - **Eylem**: Hizmetin düzelmesini bekleyin **Hız sınırlama hataları** - İstek kotaları aşıldı - API kısıtlama korumaları - **Eylem**: Hız sınırının sıfırlanmasını bekleyin, istek sıklığını azaltın - Geçersiz veya süresi dolmuş kimlik bilgileri - Oturum zaman aşımı sorunları - **Eylem**: User Center üzerinden yeniden kimlik doğrulayın, aboneliğin aktif olduğunu doğrulayın - Ağ bağlantısı sorunları - Bağlantıları engelleyen güvenlik duvarı veya VPN - Kurumsal ağ kısıtlamaları - **Eylem**: Ağ bağlantısını kontrol edin, farklı bir ağ deneyin - Geçersiz ayarlar veya tercihler - Bozuk yapılandırma dosyaları - **Eylem**: Son ayar değişikliklerini gözden geçirin, yapılandırmayı doğrulayın - Yetersiz dosya sistemi izinleri - Çalışma alanı erişim kısıtlamaları - **Eylem**: Dosya/klasör izinlerini kontrol edin, çalışma alanı erişimini doğrulayın --- ## Hata mesajlarını yorumlama Ayrıntılı hata mesajı yorumlama kılavuzu geliştirme aşamasındadır. Karşılaştığınız belirli hata mesajları için Feedback düğmesini veya Discord topluluğunu kullanarak yardım alın. Sunucu tarafı hatalar geçicidir ve genellikle beklenerek çözülür. Birkaç dakika sonra yeniden denemek dışında bir eyleme gerek yoktur. **Şu anahtar kelimelere bakın:** - "Overloaded" veya "at capacity" - "Internal server error" veya "backend processing" - "503 Service Unavailable" veya "no healthy upstream" - "Rate limit" veya "quota" **Ne yapmalısınız:** - Yeniden denemeden önce 5-10 dakika bekleyin - Yerel geliştirme çalışmasına devam edin - Şimdiye kadar yapılan kod değişikliklerini gözden geçirin - Mevcut çalışmayı Git ile işleyin **Genel kural:** Hata mesajı sunucu durumundan, kapasiteden veya hız sınırlarından bahsediyorsa geçicidir. Bunlar otomatik olarak çözülen altyapı sorunlarıdır. Geçici sunucu hataları (502, 503, 504) genellikle birkaç dakika içinde çözülür. Yeniden denemeden önce 2-3 dakika bekleyin. **Ne zaman üst birime taşımalısınız:** - Hata 15 dakikadan uzun süre devam ediyorsa - Kesinti raporları için Discord'u kontrol edin - Durum sayfası güncellemelerini takip edin İstemci tarafı hatalar sizin tarafınızdan eylem gerektirir. Bunlar beklenerek çözülmez. **Şu göstergelere bakın:** - Kimlik doğrulama veya kimlik bilgisiyle ilgili mesajlar - Yapılandırma veya ayar hataları - Dosya izni hataları - Ağ bağlantısı arızaları **Ne yapmalısınız:** - **Kimlik doğrulama hataları**: User Center üzerinden yeniden kimlik doğrulayın, aboneliğin aktif olduğunu doğrulayın - **Yapılandırma hataları**: Son ayar değişikliklerini gözden geçirin, yapılandırma dosyalarını doğrulayın - **İzin hataları**: Dosya/klasör izinlerini kontrol edin, çalışma alanı erişimini doğrulayın - **Ağ hataları**: İnternet bağlantısını test edin, farklı bir ağ deneyin, VPN/güvenlik duvarını kontrol edin **Genel kural:** Hata kimlik doğrulamadan, yapılandırmadan, izinlerden veya yerel ayarlardan bahsediyorsa, düzeltici eylemde bulunmanız gerekir. **Sorun giderme adımları:** 1. Belirli yönlendirme için hata mesajının tamamını okuyun 2. Hatayı hangi bileşenin bildirdiğini belirleyin (kimlik doğrulama, yapılandırma, izinler, ağ) 3. Hata türüne göre hedefli eylemde bulunun 4. Orijinal işlemi yeniden deneyerek düzeltmeyi doğrulayın ### Hata bağlamını okuma Hatalar oluştuğunda: 1. **Hata mesajının tamamını okuyun** - Ayrıntıları atlamayın 2. **Hata kodlarını not edin** - Belirli kodlar sorunları teşhis etmeye yardımcı olur 3. **Bileşeni belirleyin** - Hatayı hangi sistem bildirdi (sunucu, API, yerel) 4. **Zamanlamayı kontrol edin** - Hemen mi yoksa gecikmeden sonra mı oldu? --- ## Sistematik sorun giderme Verdent beklenmedik şekilde davrandığında, en az kesintiye yol açan eylemlerden başlayarak bu aşamalı adımları izleyin. ### İlk yanıt Davranışın tutarlı mı yoksa aralıklı mı olduğunu kontrol edin. Beklenmedik davranışı hangi eylemin tetiklediğini not edin. Bir şeyin bozuk olduğunu hemen varsaymayın - birçok sorun geçicidir. Verdent for VS Code uygulamasını yeniden başlatın (VS Code uygulamasını kapatıp yeniden açın). Genellikle takılı durumları veya performans sorunlarını çözer. Bu en basit ilk sorun giderme adımıdır. ### Aşamalı sorun giderme Temel yeniden başlatma sorunu çözmezse: Sistematik sorun giderme adımlarını sırayla izleyin; adımları atlamak genellikle kök nedeni kaçırmak anlamına gelir. İnternet bağlantısını diğer web siteleriyle test edin. Güvenlik duvarı/VPN sorunlarını elemek için farklı bir ağ (mobil hotspot) deneyin. Kurumsal ağın bağlantıları engelleyip engellemediğini kontrol edin. Hâlâ kimlik doğrulamasının yapılı olduğunu kontrol edin. Aboneliğin User Center'da aktif olduğunu doğrulayın. Davranışı etkileyebilecek son ayar değişikliklerini gözden geçirin. Benzer raporlar için Discord topluluğunu kontrol edin: https://discord.com/invite/NGjXEZcbJq. Sorunu bildirmek için Feedback düğmesini kullanın. Beklenmedik davranışın açıklamasını ve yeniden oluşturma adımlarını ekleyin. ### Yapılmaması gerekenler Geçici sorunlar için bu eylemlerden kaçının: - Verdent uygulamasını hemen yeniden yüklemeyin - VS Code önbelleğini veya uygulama verilerini temizlemeyin - Geçici sorunlar için sistem ayarlarını değiştirmeyin - Diğer uygulamalar da etkilenmediği sürece bilgisayarı yeniden başlatmayın Manual Accept Mode içinde, tam komutu dikkatlice incelemeden asla yıkıcı işlemleri (rm, DROP, DELETE) onaylamayın. **Neden?** Bu eylemler zaman alıcıdır ve sorunları nadiren düzeltir. Çoğu sorun basit bir yeniden başlatmayla veya geçici sunucu sorunlarının geçmesini bekleyerek çözülür. --- ## Ne zaman beklemeli, ne zaman harekete geçmeli Beklemek mi yoksa harekete geçmek mi gerektiğini anlamak, boşa harcanan sorun giderme çabasını önler. Bu hatalar otomatik olarak çözülür - beklemek ve yeniden denemek dışında bir eyleme gerek yoktur. **Sunucu aşırı yüklenmesi veya kapasite hataları:** - "Overloaded" veya "at capacity" mesajları - Yoğun trafik dönemleri - Geçici hizmet kesintileri **Hız sınırlama:** - "Rate limit" veya "quota exceeded" mesajları - Kısa sürede çok fazla istek - API kısıtlama koruması **Aralıklı bağlantı sorunları:** - Yeniden denendiğinde başarılı olan ara sıra başarısız istekler - Ağ tıkanıklıkları - Kısa süreli bağlantı kopmaları **Beklerken ne yapmalısınız:** - Yerel geliştirme çalışmasına devam edin - Şimdiye kadar yapılan kod değişikliklerini gözden geçirin - Sonraki adımları veya yapılacakları planlayın - Mevcut çalışmayı Git ile işleyin **Ne kadar beklemeli:** - Standart bekleme: 5-10 dakika - 10 dakika sonra hâlâ başarısız oluyorsa sorun gidermeye geçin - Yaygın sorun raporları için Discord'u kontrol edin Bu hatalar beklenerek çözülmez - düzeltici eylemde bulunmalısınız. **Kimlik doğrulama arızaları:** - Oturum süresi doldu → User Center üzerinden yeniden kimlik doğrulayın - Geçersiz kimlik bilgileri → Aboneliğin aktif olduğunu doğrulayın - Yeniden kimlik doğrulama gerekiyor → User Center'ı kontrol edin **Kalıcı hatalar (10+ dakika):** - Birden fazla yeniden denemeden sonra aynı hata sürekli → Sorun gidermeye başlayın - Tutarlı arıza deseni → Yapılandırmayı kontrol edin - Hata yeniden başlatmalar arasında devam ediyor → Ortamı doğrulayın **Yapılandırma sorunları:** - Ayarlar yakın zamanda değişti → Değişiklikleri gözden geçirip geri alın - Yeni kurulum → Yapılandırma dosyalarını doğrulayın - Ağ ortamı değişti → Bağlantıyı test edin **İzin hataları:** - Dosya sistemi erişimi reddedildi → Dosya/klasör izinlerini kontrol edin - Çalışma alanı kısıtlamaları → Çalışma alanı erişimini doğrulayın - Klasör izinleri → Gerekli izinleri verin **Ağ sorunları:** - Tamamen bağlanamama → İnternet bağlantısını test edin - VPN veya güvenlik duvarı engelliyor → Farklı bir ağ deneyin - Kurumsal ağ kısıtlamaları → BT desteğiyle iletişime geçin **Karar kuralı:** - Sunucu/hız hataları → Bekleyin - Kimlik doğrulama/yapılandırma/izin/ağ → Hemen harekete geçin - Emin değil misiniz? → Önce 5-10 dakika bekleyin, devam ederse harekete geçin --- ## Hata bağlamı sağlama Yardım ararken veya sorunları bildirirken, daha hızlı teşhis için kapsamlı bağlam ekleyin. ### Temel bilgiler **Hata ayrıntıları:** - Tam hata mesajı metni (kopyala-yapıştır, başka sözcüklerle ifade etmeyin) - Verilmişse hata kodu - Hatanın oluştuğu zaman damgası - Sıklık (tek seferlik, aralıklı, tutarlı) **Ortam:** - Verdent for VS Code sürümü - VS Code sürümü - İşletim sistemi ve sürümü - Ağ ortamı (ev, kurumsal, VPN) **Yeniden oluşturma adımları:** 1. Ne yapmaya çalışıyordunuz 2. Kullanılan tam istemler veya komutlar 3. İlgili dosyalar veya bağlam 4. Hatadan önce yapılan eylemler **Bağlam:** - Hangi yürütme modunu kullanıyordunuz - Çalışma alanının boyutu ve karmaşıklığı - Son yapılandırma değişiklikleri - Önceki başarılı benzer işlemler ### Örnek hata raporu İyi bir hata raporu biçimi: ``` Issue: Getting "Internal server error" when requesting code analysis Error Message (exact): "Error: Internal server error occurred during processing. Please try again later." Environment: - Verdent for VS Code v1.2.3 - VS Code 1.85.0 - macOS 14.2 - Home network (no VPN) Steps to Reproduce: 1. Opened large TypeScript project (500+ files) 2. Used Auto-Run Mode 3. Requested: "Analyze authentication flow in auth.ts and suggest improvements" 4. Error occurred immediately after request Additional Context: - First time working with this project - Same request worked fine yesterday in different project - Other requests (small file edits) work normally ``` ### Bunu etkili kılan nedir - Tam hata mesajı metni - Eksiksiz ortam ayrıntıları - Net yeniden oluşturma adımları - Çalışan senaryolarla karşılaştırma - Desenler hakkında ek bağlam --- ## Sorunları raporlama **Konum:** Verdent panelinin üst çubuğu **Ne işe yarar:** - Sorun ve önerileri göndermek için açılır pencere açar - Verdent ekibine doğrudan kanal - Hata raporları ve özellik istekleri için en iyisidir **Ne zaman kullanılır:** - Net yeniden oluşturma adımları olan onaylanmış hatalar - Belirli kullanım durumları olan özellik istekleri - Doğrudan ekip iletişimi gerektiğinde - İnceleme gerektiren acil olmayan sorunlar **Neler eklenmeli:** - Sorunun net açıklaması - Hata mesajları (tam metin) - Yeniden oluşturma adımları - Beklenen ve gerçek davranış - Verdent sürümü ve platform - Sorunun ne zaman başladığı **Bağlantı:** https://discord.com/invite/NGjXEZcbJq **Neler sağlar:** - Verdent kullanıcıları ve ekip üyelerinden oluşan aktif bir topluluk - Gerçek zamanlı sorun giderme yardımı - Sorunları ekran görüntüleriyle paylaşma - Deneyimli kullanıcılardan yardım alma - Topluluk tartışması ve geçici çözümler **Ne zaman kullanılır:** - Hemen tartışma gerektiren acil sorunlar - Karşılıklı iletişim gerektiren karmaşık sorun giderme - En iyi uygulamalar hakkında topluluk görüşü - Resmi rapor göndermeden önce hızlı sorular - Toplulukla geçici çözümler paylaşma | Sorun türü | Feedback düğmesini kullanın | Discord'u kullanın | |------------|:------------------:|:-----------:| | Yeniden oluşturma adımları olan onaylanmış hata | ✓ | | | Özellik isteği | ✓ | | | Acil sorun giderme gerekiyor | | ✓ | | Tartışma gerektiren karmaşık sorun | | ✓ | | Hızlı soru | | ✓ | | Topluluk görüşü istiyorum | | ✓ | | Resmi hata raporu | ✓ | | | Genel yardım | | ✓ | **Bildirilmemesi gerekenler:** - Geçici sunucu hataları (< 10 dakika) - Yoğun trafik dönemleri - Zaten belgelenmiş sorunlar - Beklenen davranış **Bunun yerine:** Geçici sorunlar için bekleyin, son raporlar için Discord'u kontrol edin, belgeleri gözden geçirin. --- ## Önleme en iyi uygulamaları Proaktif uygulamalar hata sıklığını azaltır ve hatalar oluştuğunda kurtarmayı iyileştirir. İstemlerde belirli bir dil kullanın ve ilgili dosya bağlamını ekleyerek birçok yaygın hatayı oluşmadan önce önleyin. ### Çalışmaya başlamadan önce **1. Kurulumu doğrulayın** - User Center'da kimlik doğrulama durumunu kontrol edin - Aboneliğin aktif olduğunu onaylayın - Kararlı bir ağ bağlantısı sağlayın - Son yapılandırma değişikliklerini gözden geçirin **2. Git başlatın** - İzin verici modları kullanmadan önce her zaman sürüm denetiminiz olsun - Temiz bir başlangıç noktası için mevcut çalışmayı işleyin - Sorun oluşursa geri alma seçeneği sağlar **3. Kredi bakiyesini kontrol edin** - Planlanan çalışma için yeterli kredi olduğunu doğrulayın - Karmaşık görevlere başlamadan önce gerekirse ek kredi yüklemesi yapın - Kredi tükenmesi nedeniyle görev ortasında kesintilerden kaçının ### Geliştirme sırasında **1. Uygun yürütme modlarını kullanın** - Bilinmeyen kod için Manual Accept - Karmaşık değişiklikler için Plan Mode - Yalnızca Git güvenlik ağıyla Auto-Run - Modu risk düzeyine uydurun **2. Performansı izleyin** - Yanıt kalitesinde düşüşe dikkat edin - Daha yavaş yanıt sürelerini not edin - Performans düştüğünde yeni oturumlar başlatın - Bağlam kullanımını manuel olarak takip edin **3. Net, belirli istemler** - Yanlış anlaşılan isteklerden kaynaklanan hataları azaltın - İlgili bağlam ve kısıtlamaları ekleyin - Mevcut desenlere başvurun - Kapsamı net şekilde belirtin ### Hatalardan sonra **1. Desenlerden öğrenin** - Hataları neyin tetiklediğini not edin - Yeniden oluşturulabilir koşulları belirleyin - Tetikleyicilerden kaçınmak için iş akışını ayarlayın - Bulguları toplulukla paylaşın **2. Geçici çözümleri belgeleyin** - Etkili çözümler hakkında notlar tutun - Ekip üyeleriyle paylaşın - Topluluk bilgisine katkıda bulunun - Düzeltmeler için Verdent ekibine raporlayın **3. Yapılandırmayı güncelleyin** - Deneyime göre ayarları düzenleyin - İş akışınız için optimize edin - Sorunları önlemek için kuralları yapılandırın - AGENTS.md belgelerini güncel tutun --- ## Ayrıca bkz. Hataları azaltmak için etkili istemler yazın Performans sorunlarını önlemek için bağlamı optimize edin Riskleri en aza indirmek için uygun modları seçin