Comment utiliser la journalisation personnalisée dans C#;

Pourquoi utiliser la journalisation personnalisée avec IronPDF?

: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")

Les journaux IronPDF seront dirigés vers l'objet logger personnalisé. Les messages restent identiques à ceux de l'enregistreur IronPDF ; ils sont relayés vers l'enregistreur personnalisé. L'implémentation du logger personnalisé détermine comment traiter les messages. Prenons l'exemple de la classe de logger personnalisée suivante.

La journalisation personnalisée offre plusieurs avantages pour les applications de production :

• Gestion centralisée des journaux : Intégrez les journaux d'IronPDF à votre infrastructure de journalisation existante
• Débogage amélioré : Capturez des informations détaillées sur les opérations PDF à des fins de dépannage
• Surveillance des performances : suivi des temps de rendu et de l'utilisation des ressources
• Suivi des erreurs : Capture et signale automatiquement les échecs de génération de PDF
• <Conformité : Maintenir des pistes d'audit pour la génération de documents dans les secteurs réglementés

Pour les applications nécessitant un traitement asynchrone, la journalisation personnalisée permet de suivre les opérations PDF simultanées et d'identifier les goulets d'étranglement potentiels.

À quoi ressemble une classe d'enregistreur personnalisée?

: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

Cette implémentation suit l'interface standard Microsoft.Extensions.Logging.ILogger, ce qui la rend compatible avec l'écosystème de journalisation .NET. La classe d'enregistreurs comprend :

• Nom de la catégorie : aide à identifier la source des messages du journal
• Filtrage des niveaux de journalisation : Contrôle des niveaux de gravité à capturer
• Sortie flexible : Acheminez les journaux vers n'importe quelle destination (console, fichier, base de données, etc.)
• Gestion des exceptions : Formater et consigner correctement les détails des exceptions
• Gestion des états : Prise en charge de la journalisation structurée avec BeginScope

Pour les scénarios avancés, explorez les options de rendu qui affectent la sortie de la journalisation, notamment lorsqu'il s'agit de conversions HTML complexes ou lorsque vous travaillez avec le moteur de rendu Chrome.

À quoi ressemble une sortie de journalisation personnalisée ?

Dans cet exemple, les messages du journal sont précédés d'informations supplémentaires.

La sortie de la console montre comment la journalisation personnalisée fournit des informations détaillées sur les opérations internes d'IronPDF. Vous pouvez voir :

• Étapes d'initialisation du client Chrome
• Création de candidats au déploiement
• Séquences de chargement de bibliothèques natives
• Confirmations de déploiement de composants réussies

Ce niveau de détail est inestimable pour déboguer les problèmes de génération de PDF ou optimiser les performances. Le format structuré facilite l'analyse programmatique des journaux ou leur intégration dans des outils d'analyse de journaux.