Journalisation pour C# (.NET) : meilleures solutions et bibliothèques

Journalisation pour C# (.NET) : aperçu des meilleures solutions

La journalisation est un aspect critique du développement de toute application sérieuse en C#. Elle permet de suivre l'état du système, de diagnostiquer les erreurs, d'analyser le comportement des utilisateurs et de collecter des métriques de performance. Dans l'écosystème .NET, il existe plusieurs bibliothèques matures de journalisation, chacune avec ses propres points forts. Dans cet article, nous examinerons les trois solutions les plus populaires : Serilog, NLog et log4net, ainsi que l'abstraction standard Microsoft.Extensions.Logging.

Pourquoi une bibliothèque dédiée à la journalisation ?

La classe intégrée System.Diagnostics.Debug ou Console.WriteLine ne convient que pour les scénarios les plus simples. Les bibliothèques professionnelles offrent :

• Niveaux de journalisation (Trace, Debug, Information, Warning, Error, Fatal) — filtrage flexible des messages.
• Journalisation structurée — sauvegarde des données au format JSON avec possibilité d'analyse ultérieure.
• De multiples "récepteurs" (sinks/targets) — écriture dans un fichier, une base de données, la console, la pile ELK, Sentry, Application Insights, etc.
• Configuration dynamique — modification du niveau de journalisation sans redémarrer l'application.
• Performance — écriture asynchrone, mise en mémoire tampon, impact minimal sur la vitesse d'exécution.

1. Serilog — le standard moderne

Serilog est la bibliothèque la plus populaire pour .NET, qui a misé sur la journalisation structurée. Au lieu de formater des chaînes avec string.Format, vous utilisez des espaces réservés nommés :

using Serilog;

Log.Logger = new LoggerConfiguration()    .MinimumLevel.Debug()    .WriteTo.Console()    .WriteTo.File("logs/app-.log", rollingInterval: RollingInterval.Day)    .WriteTo.ApplicationInsights(TelemetryConfiguration.Active, TelemetryConverter.Traces)    .CreateLogger();

// Exemple de journalisation structuréeLog.Information("Utilisateur {UserId} a passé commande {OrderId} pour un montant de {Total:C}",     userId, orderId, total);

Serilog est idéal pour les microservices, les applications cloud et les projets où une analyse approfondie des logs via Kibana ou Grafana est importante.

2. NLog — flexibilité et performance

NLog est une bibliothèque puissante avec de riches capacités de routage. Elle prend en charge à la fois la configuration XML et la configuration programmatique. La particularité de NLog est son mécanisme intégré d'écriture asynchrone et la prise en charge de règles conditionnelles.

using NLog;

private static readonly Logger Logger = LogManager.GetCurrentClassLogger();

public void ProcessOrder(Order order){    Logger.Info("Début du traitement de la commande {OrderId}", order.Id);    try    {        // logique métier        Logger.Debug("Commande {OrderId} traitée avec succès", order.Id);    }    catch (Exception ex)    {        Logger.Error(ex, "Erreur lors du traitement de la commande {OrderId}", order.Id);        throw;    }}

NLog est souvent choisi pour les applications de bureau (WPF, WinForms) et les projets legacy en raison de la simplicité de migration depuis log4net.

3. log4net — un vétéran éprouvé

log4net est un portage de la célèbre bibliothèque Java log4j. C'est la solution la plus "ancienne", encore activement utilisée dans les projets d'entreprise. Son principal atout est le nombre considérable d'adaptateurs et d'"appenders" écrits au fil des décennies.

// Configuration via XML (log4net.config)<log4net>    <appender name="RollingFile" type="log4net.Appender.RollingFileAppender">        <file value="logs/app.log" />        <rollingStyle value="Date" />        <datePattern value="yyyyMMdd" />