This tool isn't used or maintained anymore. Please fork if you want to make your own improvements.

log2sock allows you to send logs to a UNIX domain socket. Its usage is similar to the Ruby 'logger' class, except with slightly less features.

gem install log2sock

A small tool is included in this gem to help you read log messages on a UNIX domain socket.

It's called log2read. It takes 1 argument which is the path/filename of the socket you want to create and listen on.

Example:

# Let's assume you're using RBENV
~/.rbenv/shims/log2read /tmp/mylogs.sock

Add this to your app and start logging stuff to a UNIX domain socket.

Example:

require 'log2sock'

logger = Log2sock.new("/tmp/mylogs.sock")
logger.level(Log2sock::INFO)
logger.debug("This is a debug message")                   # This won't be displayed
logger.info("This is an info message")                    # This will be displayed
logger.debug { "This is something really stupid #{5/0}" } # This won't be evaluated
logger.level(Log2sock::DEBUG)
logger.debug { "This is something really stupid #{5/0}" } # lulz

• If the socket can't be used (ex: if it doesn't exist), the logs will be sent to STDOUT.
• The default socket is: /tmp/log2.sock which also exists in the CONSTANT Log2sock::DEFAULT_SOCKET
• There are 6 log levels: DEBUG < INFO < WARN < ERROR < FATAL < UNKNOWN
• Each log level is a constant (ex: Log2sock::INFO)
• The default log level is: Log2sock::DEBUG
• The log2read tool creates a socket with file permissions 750
• Press Ctrl+C to exit the log2read tool

• Ruby 1.9.x or greater

MIT License, see the LICENSE file