Quick Setup de Log4Net en C#

Bonjour, un petit tuto’ sur comment utiliser basiquement log4net dans vos applications suite à une demande par mail.

Tout d’abord un petit exemple de Log4Net :

        static void Main(string[] args)
        {
            log4net.ILog log = LogManager.GetLogger(typeof(Program));
            log4net.Config.BasicConfigurator.Configure();
            log.Debug("I'm debuging this app");
            log.Info("Cause i need more information");
            log.Warn("About the compilation warning");
            log.Error("Due to a developper error");
            log.Fatal("And create fatal exceptions :)");
            Console.ReadLine(); 
        }

La sortie :

DEBUG2011-12-13 09:12:09 – I'm debuging this app
INFO 2011-12-13 09:12:09 – Cause i need more information
WARN 2011-12-13 09:12:09 – About the compilation warning
ERROR2011-12-13 09:12:09 – Due to a developper error
FATAL2011-12-13 09:12:09 – And create fatal exceptions 🙂

Le code parle de lui même.
Téléchargez les bin’s a l’adresse : http://logging.apache.org/log4net/download.html
Décompressé ça peut paraitre gros pour du log (30Mo) mais c’est parce qu’il y a les DLL pour tous les framework et subset de dotnet + la documentation XML. Pour une DLL de 300Ko, 1.5Mo de docs xml. La librairie finale ne fait que 250/300Ko.
Une autre solution consiste aussi à utiliser NuGet pour les paquets. C’est à vous de voir.
Ensuite, comme d’habitude, on rajoute une référence.
Ceci fait on vas éditer (ou créer) un fichier .config (Web.config ou App.config, selon le scénario) et y rajouter les nodes suivants :

<?xml version="1.0"?>
<configuration>
  <configSections>
    <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler,Log4net"/>
  </configSections>
  <log4net>
    <root>
      <level value="DEBUG"/>
      <appender-ref ref="LogFileAppender"/>
    </root>
    <appender name="LogFileAppender" type="log4net.Appender.RollingFileAppender">
      <param name="File" value="C:\log.txt"/>
      <param name="AppendToFile" value="true"/>
      <rollingStyle value="Size"/>
      <maxSizeRollBackups value="10"/>
      <maximumFileSize value="10MB"/>
      <staticLogFileName value="true"/>
      <layout type="log4net.Layout.PatternLayout">
        <param name="ConversionPattern" value="%-5p%d{yyyy-MM-dd hh:mm:ss} – %m%n"/>
      </layout>
    </appender>
  </log4net>
<startup>
</configuration>

Pour le moment il log dans la console a cause du basic configurator. Pour lui dire d’aller jeter un œil dans les .config il suffit de rajouter :

[assembly: log4net.Config.XmlConfigurator(Watch = true)]

Ensuite, on supprime la ligne 4 de l’exemple (le basic configurator) et on obtiens une instance de ILog que nous utiliserons dans notre application.

Quelques issues rencontrés
– Si il gueule pour System.Web, passez le target de dotnet 4 client profile à dotnet 4 dans la configuration du projet.
– Si vous n’arrivez pas a écrire, vérifiez les permissions sur le filesystem.
– Pour le reste, RTFM 😉 Apache Log4net manual

Et au passage…