GroupDocs Konsol Günlüğü ile Dayanıklı .NET Günlük Kaydı Oluşturma

Giriş

.NET uygulamalarınızda hataları takip etmek ve işlemleri izlemek zor mu? Dayanıklı .NET günlük kaydı oluşturmak, performansı izlemek, sorunları ayıklamak ve sorunsuz çalışmayı sürdürmek için gereklidir. Bu öğretici, GroupDocs.Search kullanarak özel bir konsol günlüğü oluşturmayı ve aynı zamanda GroupDocs.Redaction for .NET’i nasıl entegre edeceğinizi gösterir. Sonunda, mevcut kod tabanınıza sorunsuz bir şekilde uyan şeffaf, sürdürülebilir bir günlükleme çözümüne sahip olacaksınız.

Hızlı Yanıtlar

• Özel günlüğün ne yaptığı? Geliştirme sırasında anlık geri bildirim için günlük girişlerini doğrudan konsola yazar.
• Hangi GroupDocs bileşeni dosya günlüklemesini sağlar? Yerleşik FileLogger sınıfı kalıcı günlük dosyalarını yönetir.
• Lisans gerekiyor mu? Test için geçici bir lisans yeterlidir; üretim için tam lisans gereklidir.
• Hangi .NET sürümleri destekleniyor? .NET Framework 4.5+, .NET Core 3.1+, .NET 5/6/7.
• Çözüm çok iş parçacıklı güvenli mi? Evet—hem ConsoleLogger hem de FileLogger eşzamanlı kullanım için tasarlanmıştır.

“Dayanıklı .NET günlük kaydı oluşturma” nedir?

Dayanıklı .NET günlük kaydı oluşturmak, bir uygulamanın tüm katmanlarında hataları, uyarıları ve bilgi mesajlarını yakalayan güvenilir, yüksek performanslı bir günlükleme hattı kurmak anlamına gelir. GroupDocs ile hem konsol hem de dosya hedeflerini kullanarak ve yapılandırmayı basit tutarak bunu başarabilirsiniz.

.NET günlük kaydı için GroupDocs neden kullanılmalı?

GroupDocs 30+ .NET platformunu destekler ve 2 GB‘a kadar belgeleri belirgin bir performans kaybı olmadan işleyebilir. Günlükleme API’leri hafif, çok iş parçacıklı güvenli ve mevcut istisna‑işleme desenleriyle sorunsuz bir şekilde bütünleşir, size kanıtlanmış, kurumsal düzeyde bir çözüm sunar.

Önkoşullar

• Gerekli Kütüphaneler ve Sürümler: .NET için GroupDocs.Search ve .NET için GroupDocs.Redaction (uyumlu en son sürümler).
• Ortam Kurulumu: Visual Studio 2022 veya herhangi bir .NET uyumlu IDE.
• Bilgi Önkoşulları: C# sözdizimi ve temel günlükleme kavramlarına aşinalık.

.NET için GroupDocs.Redaction Kurulumu

İlk olarak, projenize GroupDocs.Redaction ekleyin. İş akışınıza en uygun yöntemi seçin.

.NET CLI

dotnet add package GroupDocs.Redaction

Package Manager

Install-Package GroupDocs.Redaction

NuGet Package Manager UI
“GroupDocs.Redaction”ı arayın ve en son sürümü yükleyin.

Lisans Alımı

Başlamak için geçici bir lisans alabilir veya tam bir lisans satın alabilirsiniz. Bu, tüm özellikleri sınırlama olmadan keşfetmenizi sağlar. Lisans edinme hakkında daha fazla ayrıntı için GroupDocs’un resmi sitesini ziyaret edin.

Temel Başlatma ve Kurulum

Redactor sınıfı, desteklenen belgelerde içeriği değiştirmek ve redakte etmek için API’ler sunar.

using GroupDocs.Redaction;

// Initialize Redactor with a file path or stream
Redactor redactor = new Redactor("path/to/your/document.pdf");

Uygulama Kılavuzu

GroupDocs ile özel bir konsol günlüğü nasıl uygulanır?

ConsoleLogger örneği oluşturarak ve bunu SearchOptions ya da bir ILogger kabul eden herhangi bir GroupDocs bileşenine geçirerek özel günlüğünüzü yükleyin. Günlük, her mesajı Console.WriteLine‘a yazar, kütüphanenin ne yaptığını gerçek zamanlı olarak görmenizi sağlar ve geliştirme sırasında sorunları hızlıca tespit etmenize yardımcı olur.

ConsoleLogger sınıfı, günlük mesajlarını doğrudan konsola yazmak için ILogger arayüzünü uygular.

using System;
using GroupDocs.Search.Common;

public class ConsoleLogger : ILogger
{
    public ConsoleLogger()
    {
    }

    // Logs an error message using the console.
    public void Error(string message)
    {
        Console.WriteLine("Error: " + message);
    }

    // Logs a trace message using the console.
    public void Trace(string message)
    {
        Console.WriteLine(message);
    }
}

Adım 1: Özel Günlüğünüzü Tanımlayın
ConsoleLogger adlı yeni bir sınıf oluşturun:

using System;
using GroupDocs.Search.Common;

public class ConsoleLogger : ILogger
{
    public ConsoleLogger()
    {
    }

    // Logs an error message using the console.
    public void Error(string message)
    {
        Console.WriteLine("Error: " + message);
    }

    // Logs a trace message using the console.
    public void Trace(string message)
    {
        Console.WriteLine(message);
    }
}

Adım 2: GroupDocs.Search ile Entegre Edin

SearchOptions, arama davranışını yapılandırır ve günlükleme için bir ILogger kabul eder.

using System;
using GroupDocs.Search.Common;
using GroupDocs.Search.Results;

public static void ImplementingCustomLogger()
{
    string indexFolder = "YOUR_DOCUMENT_DIRECTORY/Logging/ImplementingCustomLogger";
    string documentsFolder = "YOUR_DOCUMENT_DIRECTORY/DocumentsPath";
    string query = "Lorem";

    IndexSettings settings = new IndexSettings();
    settings.Logger = new ConsoleLogger(); // Set your custom logger

    Index index = new Index(indexFolder, settings);
    index.Add(documentsFolder);

    SearchResult result = index.Search(query);
}

FileLogger nedir ve ne zaman kullanılmalı?

FileLogger sınıfı ILogger arayüzünü uygular ve günlük girişlerini diskte bir dosyaya kalıcı olarak yazar, bu da denetim izlerinin gerektiği üretim ortamları için idealdir. GroupDocs tarafından sağlanan FileLogger sınıfı, günlük girişlerini belirli bir dosyaya yazar, bu da kalıcı denetim izlerine ihtiyaç duyduğunuz üretim ortamları için mükemmeldir. Günlük döndürme, dosya boyutu limitleri ve günlük seviyelerini operasyonel gereksinimlerinize göre yapılandırabilirsiniz.

FileLogger sınıfı ILogger arayüzünü uygular ve günlük girişlerini diskte bir dosyaya kalıcı olarak yazar.

using System;
using GroupDocs.Search.Common;
using GroupDocs.Search.Results;

public static void UseOfStandardFileLogger()
{
    string indexFolder = "YOUR_DOCUMENT_DIRECTORY/Logging/UseOfStandardFileLogger";
    string documentsFolder = "YOUR_DOCUMENT_DIRECTORY/DocumentsPath";
    string query = "Lorem";
    string logPath = "YOUR_OUTPUT_DIRECTORY/Logging/Log.txt";

    IndexSettings settings = new IndexSettings();
    settings.Logger = new FileLogger(logPath, 4.0); // Log file path and max size

    Index index = new Index(indexFolder, settings);
    index.Add(documentsFolder);

    SearchResult result = index.Search(query);
}

.NET günlük kaydı için GroupDocs neden seçilmeli?

GroupDocs, nicel bir avantaj sunar: 50’den fazla çıktı formatını destekler ve yüzlerce sayfalık belgeleri tüm dosyayı belleğe yüklemeden işleyebilir. Günlükleme altyapısı, her günlük girişi için 2 ms‘den az ek yük ekler, böylece yoğun yük altında bile performans optimal kalır.

Pratik Uygulamalar

Bu günlükleme tekniklerinin öne çıktığı bazı pratik senaryolar şunlardır:

1. Uygulama İzleme: Geliştirme sırasında canlı tanılamaları görmek için ConsoleLogger kullanın.
2. Denetim İzleri: Düzenleyici raporlamalar için uyum seviyesinde günlükler tutmak amacıyla FileLogger dağıtın.
3. Hata Ayıklama: Karmaşık arama hatlarında sorunları tespit etmek için ayrıntılı izleme mesajlarından yararlanın.
4. Performans Analizi: Dar boğazları belirlemek ve kaynak kullanımını optimize etmek için günlük zaman damgalarını inceleyin.

Performans Düşünceleri

Günlüklemeyi hızlı ve verimli tutmak için:

• Günlük Ayrıntısını Sınırlayın: Üretimde aşırı I/O’dan kaçınmak için günlüğün seviyesini Info veya Warning olarak ayarlayın.
• Verimli Kaynak Kullanımı: FileLogger‘ı maksimum 10 MB dosya boyutu ile yapılandırın ve otomatik döndürmeyi etkinleştirin.
• Bellek Yönetimi: Kaynakları hızlıca serbest bırakmak için logger örneklerini using bloklarıyla veya açık Dispose() çağrılarıyla serbest bırakın.

Sıkça Sorulan Sorular

S: Özel konsol günlüğünü çok iş parçacıklı bir uygulamada kullanabilir miyim?
C: Evet—hem ConsoleLogger hem de FileLogger çok iş parçacıklı güvenlidir, bu yüzden paralel görevlerden yarış koşulları olmadan günlükleyebilirsiniz.

S: GroupDocs.Search ve GroupDocs.Redaction için ayrı bir lisansa ihtiyacım var mı?
C: Tek bir GroupDocs lisansı, Search ve Redaction dahil tüm modülleri kapsar, satın almayı basitleştirir.

S: FileLogger için günlük dosyası konumunu nasıl değiştiririm?
C: FileLogger örneğini oluştururken LogFilePath özelliğini ayarlayın, örn. new FileLogger("C:\\Logs\\app.log").

S: GroupDocs hangi günlük seviyelerini destekliyor?
C: Kütüphane Debug, Info, Warning, Error ve Critical seviyelerini sağlar, çıkış üzerinde ayrıntılı kontrol imkanı verir.

S: Konsol ve dosya günlüklemesini aynı anda birleştirmek mümkün mü?
C: Kesinlikle—her iki ConsoleLogger ve FileLogger‘a mesajları yönlendiren bir birleşik logger oluşturabilirsiniz.

Kaynaklar

• GroupDocs Redaction Dokümantasyonu
• API Referansı
• GroupDocs Kütüphanelerini İndir
• Ücretsiz Destek Forumları
• Geçici Lisans Alımı

Sonuç

Bu rehberde, özel bir konsol günlüğü oluşturarak ve GroupDocs’ün yerleşik FileLogger‘ını kullanarak dayanıklı .NET günlük kaydı oluşturmayı gösterdik. Bu araçlar, geliştirme sırasında gerçek zamanlı içgörü sağlar ve üretim için güvenilir, kalıcı günlükler sunar. Farklı günlük seviyesi yapılandırmalarını keşfedin, birleşik logger’larla deney yapın ve çözümü tam yığın gözlemlenebilirlik için daha büyük hizmetlere entegre edin.

Sonraki Adımlar

• Farklı günlük seviyesi ayarlarını test ederek detay ve performans arasındaki ideal dengeyi bulun.
• FileLogger‘a yapılandırılmış günlükleme (JSON çıktısı) ekleyerek log‑analiz platformlarına daha kolay entegrasyon sağlayın.
• Search ve Annotation gibi GroupDocs’ün diğer modüllerini keşfederek belge işleme hattınızı genişletin.

Son Güncelleme: 2026-07-31
Test Edilen: GroupDocs.Search 23.11, GroupDocs.Redaction 23.11 for .NET
Yazar: GroupDocs

İlgili Öğreticiler

• GroupDocs.Search .NET için Hata İşleme ve Günlükleme Öğreticileri
• .NET’te Belge Yönetimi için GroupDocs.Search ve Redaction Uygulaması
• .NET’te GroupDocs Search ve Redaction Uzmanlığı: İleri Düzey Belge Yönetimi