[ANN] logging 1.3.0

Tim_Pease · 21 December 2009 18:15

Logging version 1.3.0
by Tim Pease
http://gemcutter.org/gems/logging

== DESCRIPTION

Logging is a flexible logging library for use in Ruby programs based on the
design of Java's log4j library. It features a hierarchical logging system,
custom level names, multiple output destinations per log event, custom
formatting, and more.

== CHANGES

Minor Enhancements
- Using copy/truncate semantics for a faster RollingFile appender
- Global reopen method for using Logging in forked environments
- RollingFile appender can use date stamps instead of numbers

Of significant note is the change to copy/truncate semantics in the
RollingFile appender. File locks are used to determine when it is safe to
truncate the log file; this prevents loss of log messages when multiple
processes are writing to the same file.

For file locks to work properly when the ruby process is forked, the logging
appenders need to be reopened in the forked children. This allows exclusive
file locks to function correctly. To that end a Logging#reopen method has been
provided that will "do the right thing" for appenders that need to be
reopened.

See the "fork" example in examples diretory for more information.

github.com

TwP/logging/blob/master/examples/fork.rb

# :stopdoc:
#
# Because of the global interpreter lock, Kernel#fork is the best way
# to achieve true concurrency in Ruby scripts. However, there are peculiarities
# when using fork and passing file descriptors between process. These
# peculiarities affect the logging framework.
#
# In short, always reopen file descriptors in the child process after fork has
# been called. The RollingFile appender uses flock to safely coordinate the
# rolling of the log file when multiple processes are writing to the same
# file. If the file descriptor is opened in the parent and multiple children
# are forked, then each child will use the same file descriptor lock; when one
# child locks the file any other child will also have the lock. This creates a
# race condition in the rolling code. The solution is to reopen the file to
# obtain a new file descriptor in each of the children.
#

  require 'logging'

  log = Logging.logger['example']

This file has been truncated. show original

== CONTACT

Please use the GitHub issue tracker if you discover a bug or have a feature
request. Patches are welcome. Questions about logging are welcome - I keep
track of the ruby-talk mailing list, so please post your questions and
discussions there.

Blessings,
TwP

Topic		Replies	Views
[ANN] logging 0.9.6 ruby-talk	0	136	2 February 2009
[ANN] logging (version 1.0.0) ruby-talk	2	166	18 April 2009
[ANN] logging 0.9.5 ruby-talk	7	144	2 February 2009
[ANN] logging 1.5.0 ruby-talk	4	151	25 March 2011
[ANN] Logging 0.8.0 ruby-talk	0	131	3 July 2008

[ANN] logging 1.3.0

Related topics