Module: ActiveSupport::TaggedLogging
Relationships & Source Files | |
Defined in: | activesupport/lib/active_support/tagged_logging.rb |
Overview
Wraps any standard Logger
object to provide tagging capabilities.
May be called with a block:
logger = ActiveSupport::TaggedLogging.new(Logger.new(STDOUT))
logger.tagged('BCX') { logger.info 'Stuff' } # Logs "[BCX] Stuff"
logger.tagged('BCX', "Jason") { |tagged_logger| tagged_logger.info 'Stuff' } # Logs "[BCX] [Jason] Stuff"
logger.tagged('BCX') { logger.tagged('Jason') { logger.info 'Stuff' } } # Logs "[BCX] [Jason] Stuff"
If called without a block, a new logger will be returned with applied tags:
logger = ActiveSupport::TaggedLogging.new(Logger.new(STDOUT))
logger.tagged("BCX").info "Stuff" # Logs "[BCX] Stuff"
logger.tagged("BCX", "Jason").info "Stuff" # Logs "[BCX] [Jason] Stuff"
logger.tagged("BCX").tagged("Jason").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.
Class Method Summary
Instance Attribute Summary
- #pop_tags readonly
- #push_tags readonly
Instance Method Summary
Class Method Details
.new(logger)
[ GitHub ]# File 'activesupport/lib/active_support/tagged_logging.rb', line 117
def self.new(logger) logger = logger.clone if logger.formatter logger.formatter = logger.formatter.clone # Workaround for https://bugs.ruby-lang.org/issues/20250 # Can be removed when Ruby 3.4 is the least supported version. logger.formatter.object_id if logger.formatter.is_a?(Proc) else # Ensure we set a default formatter so we aren't extending nil! logger.formatter = ActiveSupport::Logger::SimpleFormatter.new end logger.formatter.extend Formatter logger.extend(self) end
Instance Attribute Details
#pop_tags (readonly)
[ GitHub ]# File 'activesupport/lib/active_support/tagged_logging.rb', line 135
delegate :, :, :, to: :formatter
#push_tags (readonly)
[ GitHub ]# File 'activesupport/lib/active_support/tagged_logging.rb', line 135
delegate :, :, :, to: :formatter
Instance Method Details
#clear_tags!
[ GitHub ]# File 'activesupport/lib/active_support/tagged_logging.rb', line 135
delegate :, :, :, to: :formatter
#flush
[ GitHub ]# File 'activesupport/lib/active_support/tagged_logging.rb', line 148
def flush super if defined?(super) end
#tagged(*tags)
[ GitHub ]# File 'activesupport/lib/active_support/tagged_logging.rb', line 137
def tagged(* ) if block_given? formatter.tagged(* ) { yield self } else logger = ActiveSupport::TaggedLogging.new(self) logger.formatter.extend LocalTagStorage logger. (*formatter., * ) logger end end