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.
# File lib/active_support/tagged_logging.rb, line 16 def initialize(logger) @logger = logger end
# File lib/active_support/tagged_logging.rb, line 46 def add(severity, message = nil, progname = nil, &block) message = (block_given? ? block.call : progname) if message.nil? @logger.add(severity, "#{tags_text}#{message}", progname) end
# File lib/active_support/tagged_logging.rb, line 59 def flush clear_tags! @logger.flush if @logger.respond_to?(:flush) end
# File lib/active_support/tagged_logging.rb, line 64 def method_missing(method, *args) @logger.send(method, *args) end
# File lib/active_support/tagged_logging.rb, line 41 def silence(temporary_level = Logger::ERROR, &block) @logger.silence(temporary_level, &block) end
# 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