Hata yönetimi ve kurtarma

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

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ı:

Belirli yönlendirme için hata mesajının tamamını okuyun
Hatayı hangi bileşenin bildirdiğini belirleyin (kimlik doğrulama, yapılandırma, izinler, ağ)
Hata türüne göre hedefli eylemde bulunun
Orijinal işlemi yeniden deneyerek düzeltmeyi doğrulayın

Hata bağlamını okuma

Hatalar oluştuğunda:

Hata mesajının tamamını okuyun - Ayrıntıları atlamayın
Hata kodlarını not edin - Belirli kodlar sorunları teşhis etmeye yardımcı olur
Bileşeni belirleyin - Hatayı hangi sistem bildirdi (sunucu, API, yerel)
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

Bekleyin ve gözlemleyin

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.

Temel yeniden başlatma

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.

Ağ bağlantısını kontrol edin

İ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.

Yapılandırmayı doğrulayın

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.

Yardım isteyin

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ı:

Ne yapmaya çalışıyordunuz
Kullanılan tam istemler veya komutlar
İlgili dosyalar veya bağlam
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