модуль 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 61
def self.new(logger)
  # Ensure we set a default formatter so we aren't extending nil!
  logger.formatter ||= ActiveSupport::Logger::SimpleFormatter.new
  logger.formatter.extend Formatter
  logger.extend(self)
end

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

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

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

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

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

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