модуль ActiveSupport::TaggedLogging

Оборачивает любой стандартный объект Logger, предоставляя возможности маркировки.

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"

Это используется стандартным Rails.logger, как настроено Railties, чтобы легко ставить отметки на строках логов с поддоменами, идентификаторами запросов и другими данными, что помогает отладке многопользовательских приложений в рабочей среде.

Публичные методы класса

new(logger) Показать исходный код

# File activesupport/lib/active_support/tagged_logging.rb, line 63
def self.new(logger)
  logger = logger.dup

  if logger.formatter
    logger.formatter = logger.formatter.dup
  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

Публичные методы экземпляра

flush() Показать исходный код

# File activesupport/lib/active_support/tagged_logging.rb, line 83
def flush
  clear_tags!
  super if defined?(super)
end

Вызывается метод суперкласса

tagged(*tags) { |self| ... } Показать исходный код

# File activesupport/lib/active_support/tagged_logging.rb, line 79
def tagged(*tags)
  formatter.tagged(*tags) { yield self }
end