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: wiki.github.com/calavera/trinidad/extensions

# Copyright

Copyright © 2010 David Calavera. See LICENSE for details. Copyright © 2011 Michael Leinartas. See LICENSE for details.