Trinidad Logging Extension
==========================

# DESCRIPTION

Extension to enhance the Trinidad's logging by routing it through one of:
 - Log4j (http://logging.apache.org/log4j/index.html)
 - Logback (http://logback.qos.ch/)
 - java.util.logging

SLF4J and the jruby-rack slf4j RackLogger are used to abstract the different implementations

# INSTALLATION

jruby -S gem install trinidad_logging_extension

# CONFIGURATION

The extension needs a configuration file for the chosen logging system. This file can be overridden in config
 - Log4j (Default)
   Default configuration file: 'config/trinidad-logging.properties'
 - Logback
   Default configuration file: 'config/trinidad-logging.xml'
 - java.util.logging
   Default configuration file: 'config/trinidad-logging.properties'


To enable the extension add this to your trinidad.yml:

---
  extensions:
    logging:
      config: other_properties.properties # This field is optional
    logging_system: log4j # This field is optional defaulting to 'log4j'. 'logback', and 'jul' are also valid choices

This is an example of configuration file extracted from the Tomcat's documentation:

  log4j.rootLogger=INFO, R 
  log4j.appender.R=org.apache.log4j.RollingFileAppender 
  log4j.appender.R.File=log/trinidad.log
  log4j.appender.R.MaxFileSize=10MB 
  log4j.appender.R.MaxBackupIndex=10 
  log4j.appender.R.layout=org.apache.log4j.PatternLayout 
  log4j.appender.R.layout.ConversionPattern=%p %t %c - %m%n

You can find further information on how to write your own extension in the wiki: http://wiki.github.com/calavera/trinidad/extensions

# Copyright

Copyright (c) 2010 David Calavera. See LICENSE for details.
Copyright (c) 2011 Michael Leinartas. See LICENSE for details.