123456789_123456789_123456789_123456789_123456789_

Module: ActiveSupport::TaggedLogging

Relationships & Source Files
Namespace Children
Modules:
Formatter, LocalTagStorage
Classes:
TagStack
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

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 :push_tags, :pop_tags, :clear_tags!, to: :formatter


  








  

    #push_tags   (readonly)
  

  [ GitHub ]


  

  


# File 'activesupport/lib/active_support/tagged_logging.rb', line 135



delegate :push_tags, :pop_tags, :clear_tags!, to: :formatter


  







Instance Method Details



  

    #clear_tags!  
  

  [ GitHub ]


  

  


# File 'activesupport/lib/active_support/tagged_logging.rb', line 135



delegate :push_tags, :pop_tags, :clear_tags!, to: :formatter


  








  

    #flush  
  

  [ GitHub ]


  

  


# File 'activesupport/lib/active_support/tagged_logging.rb', line 148



def flush
  clear_tags!
  super if defined?(super)
end


  








  

    #tagged(*tags)  
  

  [ GitHub ]


  

  


# File 'activesupport/lib/active_support/tagged_logging.rb', line 137



def tagged(*tags)
  if block_given?
    formatter.tagged(*tags) { yield self }
  else
    logger = ActiveSupport::TaggedLogging.new(self)
    logger.formatter.extend LocalTagStorage
    logger.push_tags(*formatter.current_tags, *tags)
    logger
  end
end