GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  MOJO::LOG (3)

.ds Aq ’

NAME

Mojo::Log - Simple logger

CONTENTS

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 X 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.

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 X 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.

SEE ALSO

Mojolicious, Mojolicious::Guides, <http://mojolicious.org>.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 MOJO::LOG (3) 2016-03-15

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.