NAME
Mojo::Log - Simple logger
SYNOPSIS
use Mojo::Log;
# Log to STDERR
my $log = Mojo::Log->new;
# Customize log file location and minimum log level
my $log = Mojo::Log->new(path => '/var/log/mojo.log', level => 'warn');
# Log messages
$log->debug('Not sure what is happening here');
$log->info('FYI: it happened again');
$log->warn('This might be a problem');
$log->error('Garden variety error');
$log->fatal('Boom');DESCRIPTION
Mojo::Log is a simple logger for Mojo projects.
EVENTS
Mojo::Log inherits all events from Mojo::EventEmitter and can emit the following new ones.
message
$log->on(message => sub {
my ($log, $level, @lines) = @_;
...
});Emitted when a new message gets logged.
$log->unsubscribe('message')->on(message => sub {
my ($log, $level, @lines) = @_;
say "$level: ", @lines;
});ATTRIBUTES
Mojo::Log implements the following attributes.
format
my $cb = $log->format;
$log = $log->format(sub {...});A callback for formatting log messages.
$log->format(sub {
my ($time, $level, @lines) = @_;
return "[Thu May 15 17:47:04 2014] [info] I ♥ Mojolicious\n";
});handle
my $handle = $log->handle;
$log = $log->handle(IO::Handle->new);Log filehandle used by default "message" event, defaults to opening "path" or STDERR.
history
my $history = $log->history;
$log = $log->history([[time, 'debug', 'That went wrong']]);The last few logged messages.
level
my $level = $log->level;
$log = $log->level('debug');Active log level, defaults to debug. Available log levels are debug, info, warn, error and fatal, in that order. Note that the MOJO_LOG_LEVEL environment variable can override this value.
max_history_size
my $size = $log->max_history_size;
$log = $log->max_history_size(5);Maximum number of logged messages to store in "history", defaults to 10.
path
my $path = $log->path
$log = $log->path('/var/log/mojo.log');Log file path used by "handle".
short
my $bool = $log->short;
$log = $log->short($bool);Generate short log messages without a timestamp, suitable for systemd, defaults to auto-detection based on the presence of a "path" and the JOURNAL_STREAM environment variable.
METHODS
Mojo::Log inherits all methods from Mojo::EventEmitter and implements the following new ones.
append
$log->append("[Thu May 15 17:47:04 2014] [info] I ♥ Mojolicious\n");Append message to "handle".
debug
$log = $log->debug('You screwed up, but that is ok');
$log = $log->debug('All', 'cool');Emit "message" event and log debug message.
error
$log = $log->error('You really screwed up this time');
$log = $log->error('Wow', 'seriously');Emit "message" event and log error message.
fatal
$log = $log->fatal('Its over...');
$log = $log->fatal('Bye', 'bye');Emit "message" event and log fatal message.
info
$log = $log->info('You are bad, but you prolly know already');
$log = $log->info('Ok', 'then');Emit "message" event and log info message.
is_level
my $bool = $log->is_level('debug');Check active log "level".
# True
$log->level('debug')->is_level('debug');
$log->level('debug')->is_level('info');
# False
$log->level('info')->is_level('debug');
$log->level('fatal')->is_level('warn');new
my $log = Mojo::Log->new;Construct a new Mojo::Log object and subscribe to "message" event with default logger.
warn
$log = $log->warn('Dont do that Dave...');
$log = $log->warn('No', 'really');Emit "message" event and log warn message.