Maintenance of Ruby 2.0.0 ended on February 24, 2016. Read more
Object
Application — Add logging support to your application.
Define your application class as a sub-class of this class.
Override the run
method in your class to do many things.
Instantiate it and invoke start.
class FooApp < Application def initialize(foo_app, application_specific, arguments) super('FooApp') # Name of the application. end def run ... log(WARN, 'warning', 'my_method1') ... @log.error('my_method2') { 'Error!' } ... end end status = FooApp.new(....).start
Set the logging threshold, just like Logger#level=
.
# File logger.rb, line 783 def level=(level) @level = level @log.level = @level end
See Logger#add. This
application's appname
is used.
# File logger.rb, line 791 def log(severity, message = nil, &block) @log.add(severity, message, @appname, &block) if @log end
Sets the logger for this application. See the class Logger for an explanation.
# File logger.rb, line 760 def logger=(logger) @log = logger @log.progname = @appname @log.level = @level end
Sets the log device for this application. See Logger.new
for
an explanation of the arguments.
# File logger.rb, line 770 def set_log(logdev, shift_age = 0, shift_size = 1024000) @log = Logger.new(logdev, shift_age, shift_size) @log.progname = @appname @log.level = @level end
Start the application. Return the status code.
# File logger.rb, line 738 def start status = -1 begin log(INFO, "Start of #{ @appname }.") status = run rescue log(FATAL, "Detected an exception. Stopping ... #{$!} (#{$!.class})\n" << $@.join("\n")) ensure log(INFO, "End of #{ @appname }. (status: #{ status.to_s })") end status end