Hata İşleme .NET – GroupDocs.Search Günlükleme Eğitimleri

Modern arama‑odaklı uygulamalarda, error handling .NET bir lüks değildir—gereklidir. Bu kılavuz, GroupDocs.Search for .NET ile çalışırken dayanıklı istisna işleme eklemeyi, zengin günlüklemeyi yapılandırmayı ve uygulanabilir tanı raporları üretmeyi gösterir. Doğru hata yönetiminin zaman kazandırdığını, kesinti süresini azalttığını ve bir şeyler ters gittiğinde net bir içgörü sağladığını keşfedeceksiniz.

Hızlı Yanıtlar

  • error handling .NET neyi kapsar? Çalışma zamanında oluşan istisnaları tespit etme, yakalama ve yapılandırılmış bir şekilde yanıt verme.
  • Arama olaylarını nasıl günlüğe kaydedebilirim? Özel bir konsol günlüğü uygulayın veya herhangi bir ILogger uygulamasını bağlayın.
  • Tanı raporunu otomatik olarak oluşturabilir miyim? Evet—GroupDocs.Search, indeksleme ve arama istatistiklerinin ayrıntılı bir XML/JSON raporunu dışa aktarabilir.
  • Performans etkisi nedir? Günlükleme, ortalama olarak olay başına 2 ms’den az ekler, hatta 100 k olay/saat’te bile.
  • Bu özellikler için lisansa ihtiyacım var mı? Tüm günlükleme ve raporlama API’leri standart GroupDocs.Search .NET paketinde mevcuttur; üretim kullanımında geçerli bir lisans gereklidir.

Hata İşleme .NET Nedir?

Error handling .NET, bir .NET uygulamasında beklenmeyen durumları yönetmek için try‑catch blokları, özel istisna tipleri ve günlükleme kullanma uygulamasıdır. Arama hizmetinizin çalışmaya devam etmesini ve geliştiricilere ve operatörlere faydalı geri bildirim sağlamasını garantiler. Ayrıca, yüksek yük altında sistem kararlılığını korumaya yardımcı olur.

Hata işleme ve günlükleme için GroupDocs.Search neden kullanılmalı?

GroupDocs.Search, 10 milyon belgeye kadar işleyebilir ve saatte 100 k’den fazla olayı günlükleyebilir, aynı zamanda bellek kullanımını 200 MB’nin altında tutar. Yerleşik tanı araçları, sadece birkaç metod çağrısıyla indeksleme durumu, sorgu performansı ve hata sayılarının tam bir raporunu oluşturur, üçüncü‑taraf izleme araçlarına olan ihtiyacı ortadan kaldırır.

Önkoşullar

  • .NET 6.0 veya daha yeni (kütüphane ayrıca .NET Core 3.1 ve .NET Framework 4.7.2’yi de destekler).
  • Geçerli bir GroupDocs.Search for .NET lisansı.
  • C# istisna işleme kalıpları hakkında temel bilgi.

GroupDocs.Search’te Hata İşleme .NET Nasıl Uygulanır

İndeksinizi bir try‑catch bloğu içinde yükleyin, kütüphane‑özel sorunlar için SearchException yakalayın ve hatayı özel bir günlüğe kaydedin. SearchException, GroupDocs.Search tarafından indeksleme veya sorgu hataları için atılan istisna tipidir. Bu desen, indeksleme veya arama sırasında oluşan herhangi bir hatanın yakalanıp raporlanmasını sağlar ve ana uygulamanın çökmesini önler. ILogger, log mesajları yazmak için yöntemler tanımlayan bir .NET günlükleme arayüzüdür.

Adım 1: Özel Bir Konsol Günlüğü Kurun

custom console logger, zaman damgaları ve önem seviyeleriyle konsola günlük girdileri yazan ILogger arayüzünün hafif bir uygulamasıdır. ConsoleLogger, zaman damgalarıyla konsola günlük girdileri yazan basit bir ILogger uygulamasıdır. Harici bağımlılıklar eklemeden gerçek zamanlı arama etkinliğini görmenize yardımcı olur.

Adım 2: İndeksleme Çağrılarını Saran

Index.Add ve Index.Search çağrılarını try‑catch blokları içinde sarın. Index.Add, bir belgeyi arama indeksine ekler, Index.Search ise indekslenmiş içerik üzerinde bir sorgu yürütür. Catch bloğunda, yığın izlerini ve mesaj detaylarını yakalamak için logger.Error(exception) çağırın. İsteğe bağlı olarak, sorunu daha kolay çözmek için işlem adını içeren bir SearchOperationException oluşturabilirsiniz.

Adım 3: Tanı Raporu Oluşturun

İndeksleme tamamlandıktan sonra index.GenerateDiagnosticReport("report.xml") metodunu çağırın. GenerateDiagnosticReport, indeksleme istatistiklerini, hataları ve performans metriklerini özetleyen bir XML veya JSON dosyası oluşturur. Bu yöntem, işlenen belgeleri, hata sayılarını, ortalama indeksleme süresini ve istisna tiplerinin dağılımını listeleyen bir XML dosyası üretir—sonradan analiz veya otomatik izleme için mükemmeldir.

Tanı Raporu Nasıl Oluşturulur

Index örneğinizde GenerateDiagnosticReport metodunu çağırın ve çıktı yolunu belirtin. GenerateDiagnosticReport, indeksleme istatistiklerini, hataları ve performans metriklerini özetleyen bir XML veya JSON dosyası oluşturur. Rapor, toplam indekslenen dosyaları, başarısız dosyaları, ortalama indeksleme süresini ve istisna tiplerinin dağılımını içerir; sistem sağlığı için tek bir güvenilir kaynak sağlar.

Arama Olayları Nasıl Günlüğe Kaydedilir

ILogger arayüzünü uygulayın—ILogger, log mesajları yazmak için yöntemler tanımlayan bir .NET günlükleme arayüzüdür—ve zaman damgalarıyla konsola girişler yazan sağlanan ConsoleLogger‘ı kullanın. Günlüğü SearchOptions yapıcı metoduna geçirin; SearchOptions arama davranışını yapılandırır ve olay günlüklemesi için günlüğü kabul eder. Her arama sorgusu, sonuç sayısı ve hata çıktıya yazılır, böylece kullanım desenlerini denetleyebilir ve anormallikleri hızlıca fark edebilirsiniz.

Yaygın Tuzaklar ve Çözümler

  • Pitfall: Boş catch bloklarıyla istisnaları yutmak.
    Solution: Her zaman istisnayı günlüğe kaydedin ve anlamlı bir şekilde yeniden fırlatın veya işleyin.
  • Pitfall: Sıkı döngüler içinde günlükleme yaparak performans düşüşüne neden olmak.
    Solution: Günlük girişlerini toplu olarak kaydedin veya asenkron günlükleme kullanarak yükü olay başına 2 ms’nin altında tutun.
  • Pitfall: Günlüğü kapatmayı unutmak, kayıp girişlere yol açar.
    Solution: Günlüğü bir using ifadesi içinde dispose edin veya uygulama kapanışında Flush() çağırın.

Mevcut Eğitimler

GroupDocs ile .NET Günlüklemeyi Ustalıkla: Özel Konsol Günlüğü Uygulama Kılavuzu

GroupDocs kullanarak .NET’te etkili hata takibi ve uygulama izleme için özel bir konsol günlüğü nasıl uygulanacağını öğrenin.

Ek Kaynaklar

Son Güncelleme: 2026-07-26
Test Edilen Versiyon: GroupDocs.Search 23.12 for .NET
Yazar: GroupDocs

İlgili Eğitimler