воскресенье, 9 августа 2009 г.

Ежедневные логи на log4net

Недавно поступил вопрос:

A есть возможность писать лог каждый день в новый файл? Чтобы частью имени файла была дата?

Сделать такое можно. Нужно только в конфигурации appender-а написать следующее:

<appender name="DebugFileAppender" type="log4net.Appender.RollingFileAppender">
     <lockingModel type="log4net.Appender.FileAppender+MinimalLock" />
     <file value="debug" />
     <appendToFile value="true" />     
  <rollingStyle value="Date" />   <datePattern value="yyyyMMdd" />   <staticLogFileName value="false" />
  <maxSizeRollBackups value="10" />   <layout type="log4net.Layout.PatternLayout">   <conversionPattern value="%-5p [%d] [%C.%M] %m%n" />   </layout> </appender>

Что же мы тут сделали? У класса RollingFileAppender, который пишет лог в файл, есть такое свойство RollingStyle, которое определяет, когда логгер будет начинать новый файл лога. Допустимы следующие значения:

  • Size — новый файл создается, как только лог достигает определенного размера (этот размер задается в свойстве maximumFileSize).
  • Date — новый файл создается каждый день, и к названию файла, определенному в свойстве file, добавляется дата в формате, заданном в свойстве datePattern.
  • Composite — комбинирует свойства Date и Size, т.е. учитываются и размер файла, и дата. Кроме того, данное значение является дефолтным для свойства RollingStyle.
  • Once — лог создается один раз при запуске программы.

Итак, в нашем примере мы задали RollingStyle = Date (можно было бы и Composite) и указали формат даты. Но, пока staticLogFileName = true, все это будет игнорироваться, так что надо задать false (эта часть мне несколько непонятна, в документации для staticLogFileName написано другое, но на деле получается именно так). И теперь к имени файла с логом добавляется дата.

NB

Если в datePattern мы напишем что-нибудь вроде yyyyMMdd.log, то файлы, которые будут создаваться, будут называться debug20090808.loA.D.. Это происходит из-за того, что g также является возможным форматом даты. Логгер добросовестно применил этот формат и сообщил, что дата относится к нашей эре (кстати, тоже интересный вопрос: в MSDN написано, что формат эры — gg, а g — это general). Чтобы избежать таких ситуаций, символы, которые являются корректными форматами для дат, надо квотить:

     <datePattern value="yyyyMMdd.lo\g" />

Кстати, txt это тоже касается.