class ActiveSupport::TaggedLogging
Wraps any standard Logger class to provide tagging capabilities. Examples:
Logger = ActiveSupport::TaggedLogging.new(Logger.new(STDOUT)) Logger.tagged("BCX") { Logger.info "Stuff" } # Logs "[BCX] Stuff" Logger.tagged("BCX", "Jason") { Logger.info "Stuff" } # Logs "[BCX] [Jason] Stuff" Logger.tagged("BCX") { Logger.tagged("Jason") { Logger.info "Stuff" } } # Logs "[BCX] [Jason] Stuff"
This is used by the default Rails.logger as configured by Railties to make it easy to stamp log lines with subdomains, request ids, and anything else to aid debugging of multi-user production applications.
Public Class Methods
new(logger)
click to toggle source
# File lib/active_support/tagged_logging.rb, line 16 def initialize(logger) @logger = logger end
Public Instance Methods
add(severity, message = nil, progname = nil, &block)
click to toggle source
# File lib/active_support/tagged_logging.rb, line 46 def add(severity, message = nil, progname = nil, &block) if message.nil? if block_given? message = block.call else message = progname progname = nil #No instance variable for this like Logger end end @logger.add(severity, "#{tags_text}#{message}", progname) end
flush()
click to toggle source
# File lib/active_support/tagged_logging.rb, line 66 def flush clear_tags! @logger.flush if @logger.respond_to?(:flush) end
method_missing(method, *args)
click to toggle source
# File lib/active_support/tagged_logging.rb, line 71 def method_missing(method, *args) @logger.send(method, *args) end
respond_to?(*args)
click to toggle source
Calls superclass method
# File lib/active_support/tagged_logging.rb, line 76 def respond_to?(*args) super || @logger.respond_to?(*args) end
respond_to_missing?(*args)
click to toggle source
# File lib/active_support/tagged_logging.rb, line 80 def respond_to_missing?(*args) @logger.respond_to? *args end
silence(temporary_level = Logger::ERROR, &block)
click to toggle source
# File lib/active_support/tagged_logging.rb, line 41 def silence(temporary_level = Logger::ERROR, &block) @logger.silence(temporary_level, &block) end
tagged(*tags) { |self| ... }
click to toggle source
# File lib/active_support/tagged_logging.rb, line 20 def tagged(*tags) new_tags = push_tags(*tags) yield self ensure pop_tags(new_tags.size) end