How to use Custom Logging in C

IronPDF ile Neden Özel Loglama Kullanmalıyım?

:path=/static-assets/pdf/content-code-examples/how-to/custom-logging-custom-logging.cs

IronSoftware.Logger.LoggingMode = IronSoftware.Logger.LoggingModes.Custom;
IronSoftware.Logger.CustomLogger = new CustomLoggerClass("logging");

IronSoftware.Logger.LoggingMode = IronSoftware.Logger.LoggingModes.Custom
IronSoftware.Logger.CustomLogger = New CustomLoggerClass("logging")

IronPDF logları özel loglayıcı nesnesine yönlendirilecek. Mesajlar, IronPDF loglayıcısındaki ile aynı kalır; Özel loglayıcıya iletilirler. Özel loglayıcı uygulaması, mesajları nasıl ele alacağını belirler. Aşağıdaki özel loglayıcı sınıf örneğini dikkate alın.

Özel loglama, üretim uygulamaları için birkaç avantaj sunar:

• Merkezi Log Yönetimi: IronPDF loglarını mevcut loglama altyapınızla entegre edin
• Geliştirilmiş Hata Ayıklama: Sorun gidermek için PDF işlemleri hakkında ayrıntılı bilgi yakalayın
• Performans İzleme: Render sürelerini ve kaynak kullanımını izleyin
• Hata İzleme: PDF oluşturmada başarısızlıkları otomatik olarak yakalayın ve raporlayın
• Uyumluluk: Düzenlenmiş sektörlerde belge oluşturma için denetim kayıtlarını sürdürün

Asenkron işleme gerektiren uygulamalar için, özel loglama eşzamanlı PDF işlemlerini izlemeye ve potansiyel darboğazları tanımlamaya yardımcı olur.

Özel Bir Loglayıcı Sınıf Nasıl Görünür?

:path=/static-assets/pdf/content-code-examples/how-to/custom-logging-custom-logging-class.cs

public class CustomLoggerClass : ILogger
{
    private readonly string categoryName;

    public CustomLoggerClass(string categoryName)
    {
        this.categoryName = categoryName;
    }

    public IDisposable BeginScope<TState>(TState state)
    {
        return null;
    }

    public bool IsEnabled(LogLevel logLevel)
    {
        return true;
    }

    public void Log<TState>(LogLevel logLevel, EventId eventId, TState state, Exception exception, Func<TState, Exception, string> formatter)
    {
        if (!IsEnabled(logLevel))
        {
            return;
        }

        // Implement your custom logging logic here.
        string logMessage = formatter(state, exception);

        // You can use 'logLevel', 'eventId', 'categoryName', and 'logMessage' to log the message as needed.
        // For example, you can write it to a file, console, or another destination.

        // Example: Writing to the console
        Console.WriteLine($"[{logLevel}] [{categoryName}] - {logMessage}");
    }
}

Public Class CustomLoggerClass
	Implements ILogger

	Private ReadOnly categoryName As String

	Public Sub New(ByVal categoryName As String)
		Me.categoryName = categoryName
	End Sub

	Public Function BeginScope(Of TState)(ByVal state As TState) As IDisposable
		Return Nothing
	End Function

	Public Function IsEnabled(ByVal logLevel As LogLevel) As Boolean
		Return True
	End Function

	Public Sub Log(Of TState)(ByVal logLevel As LogLevel, ByVal eventId As EventId, ByVal state As TState, ByVal exception As Exception, ByVal formatter As Func(Of TState, Exception, String))
		If Not IsEnabled(logLevel) Then
			Return
		End If

		' Implement your custom logging logic here.
		Dim logMessage As String = formatter(state, exception)

		' You can use 'logLevel', 'eventId', 'categoryName', and 'logMessage' to log the message as needed.
		' For example, you can write it to a file, console, or another destination.

		' Example: Writing to the console
		Console.WriteLine($"[{logLevel}] [{categoryName}] - {logMessage}")
	End Sub
End Class

Bu uygulama, standart Microsoft.Extensions.Logging.ILogger arayüzünü takip eder ve bu sayede .NET Standard günlük kaydı ekosistemiyle uyumludur. Loglayıcı sınıfı şu öğeleri içerir:

• Kategori Adı: Log mesajlarının kaynağını tanımlamaya yardımcı olur
• Log Seviyesi Filtreleme: Hangi ciddiyet seviyelerinin yakalanacağını kontrol edin
• Esnek Çıkış: Logları herhangi bir hedefe yönlendirin (konsol, dosya, veritabanı vb.)
• İstisna İşleme: İstisnalara ait detayları düzgünce biçimlendirip loglayın
• Durum Yönetimi: BeginScope ile yapılandırılmış günlük kaydı desteği

Gelişmiş senaryolar için, karmaşık HTML dönüştürmeleri veya Chrome render motoru ile çalışırken günlük çıktısını etkileyen render seçeneklerini keşfedin.

Özel Günlük Çıktısı Nasıl Görünür?

Bu örnekte, log mesajları ek bilgiyle öne eklenmiştir.

Konsol çıktısı, özel loglamanın IronPDF'nin iç operasyonlarına dair ayrıntılı içgörüler sağladığını gösterir. Görebileceğiniz öğeler:

• Chrome istemci başlatma adımları
• Dağıtım adayı oluşturma
• Yerel kütüphane yükleme dizileri
• Başarılı bileşen dağıtım onayları

Bu ayrıntı seviyesi, PDF oluşturma sorunları veya performans optimizasyonlarıyla uğraşırken paha biçilmezdir. Yapılandırılmış format, logları programlı bir şekilde işlemenizi veya log analizi araçlarıyla entegre etmenizi kolaylaştırır.