NAME

Net::SolarWinds::Log - Simple file logging module

SYNOPSIS

  use Net::SolarWinds::Log;
  
  my $log=new Net::SolarWinds::Log('/some/log/file.log');
  
  $log->log_info("This will not be logged");
  $log->log_error("This will be logged");
  
  $log->set_loglevel(Net::SolarWinds::Log->LOG_INFO);
  
  $log->log_info("This will now be logged");
  $log->log_error("This will still be logged");
  
  

DESCRIPTION

This package provides a very simple somewhat standardized logging interface. The module itself extends Net::SolarWinds::FileRotationBase and inherits all of its features.

Exports

The following constants can be exported using the standard exporter syntax

  use Net::SolarWinds::Log (qw(LOG_NONE LOG_ERROR LOG_WARN LOG_INFO LOG_DEBUG));

Default Log level

The default log level is LOG_ERROR or 1. In the default state only errors are logged.

OO Methods

• Object constructor

  The object constructor takes key=>'value' argument pairs example:

    my $log=new Net::SolarWinds::Log(
        filename=>'/full/path/to/file.log',
        loglevel=>4,
        
        # optional, if not set the system hostname will be used
        hostname=>'somehost'
        
        # ignored when filename is set
        basefilename=>'myapp',
        folder=>'/var/myappfolder',
  
    );
    

  When the constructor is called with a single argument it is assumed to be the fully quallified name of the log file to manage and rotate.

    my $log=new Net::SolarWinds::Log('/some/log/file.log');

• my $hash=$self->lookback(stack_level);

  This method returns a hash that provides information about who called this function relative to the stack_level argument. The class default value is 4.

  Example result

    {
          # the fully qualified package that this method ran under
          package=>'main',
          
          # the package and subrouteen this was called under
          sub=>'main::some_method',
          
          # the source file ( may be eval or undef )
          filename=>'/path/to/my/Script',
          
          # the line in wich the function was called
          # if the internals are unsure the value is undef
          line=>11
    }

• my $string=$log->format_log('LEVEL=ERROR|WARN|INFO|DEBUG',"some log");

  Formats your log entry as:

    HOSTNAME PID TIMESTAMP LEVEL STACK_TRACE DATA \n

  Special notes: any undef value will be converted to a string value of 'undef'.

• $log->log_info("message");

  Logs to a file if the log level is LOG_INFO or greater.

• $log->log_error("message");

  Logs to a file if the log level is LOG_error or greater.

• $log->log_die("Some message");

  Logs the message then dies.

• $log->log_warn("message");

  Logs to a file if the log level is LOG_WARN or greater.

• $log->log_always("message");

  Logs to a file if the log level is LOG_ALWAYS or greater.

• $log->log_debug("message");

  Logs to a file if the log level is LOG_DEBUG or greater.

• $log->write_to_log('LEVEL=ERROR|WARN|INFO|DEBUG','message');

  Writes 'message' to the log file with formatting representing 2 levels aboive itself in the stack.

• my $loglevel=$log->get_loglevel;

  Returns the current runtime loglevel.

• $log->set_loglevel(level);

  Used to set the current loglevel to the level.

Author

Michael Shipper