Широковещательный логгер Active Support Logger

Широковещательный логгер используется для записи сообщений в несколько IO. Обычно он применяется в режиме разработки, чтобы выводить сообщения в STDOUT и одновременно записывать их в файл (development.log). С помощью широковещательного логгера можно направлять журналы в неограниченное количество приемников.

BroadcastLogger работает как стандартный логгер и предоставляет все привычные вам методы. Однако все методы этого логгера распространяются на другие логгеры, участвующие в трансляции, и делегируются им.

Трансляция журналов.

stdout_logger = Logger.new(STDOUT)
file_logger   = Logger.new("development.log")
broadcast = BroadcastLogger.new(stdout_logger, file_logger)

broadcast.info("Hello world!") # Writes the log to STDOUT and the development.log file.

Добавление логгера в трансляцию.

stdout_logger = Logger.new(STDOUT)
broadcast = BroadcastLogger.new(stdout_logger)
file_logger   = Logger.new("development.log")
broadcast.broadcast_to(file_logger)

broadcast.info("Hello world!") # Writes the log to STDOUT and the development.log file.

Изменение уровня журналирования для всех логгеров, участвующих в трансляции.

stdout_logger = Logger.new(STDOUT)
file_logger   = Logger.new("development.log")
broadcast = BroadcastLogger.new(stdout_logger, file_logger)

broadcast.level = Logger::FATAL # Modify the log level for the whole broadcast.

Прекращение трансляции журналов в приемник.

stdout_logger = Logger.new(STDOUT)
file_logger   = Logger.new("development.log")
broadcast = BroadcastLogger.new(stdout_logger, file_logger)
broadcast.info("Hello world!") # Writes the log to STDOUT and the development.log file.

broadcast.stop_broadcasting_to(file_logger)
broadcast.info("Hello world!") # Writes the log *only* to STDOUT.

В трансляции должен участвовать хотя бы один приемник. Иначе ваши журналы не будут записаны нигде. Например:

broadcast = BroadcastLogger.new
broadcast.info("Hello world") # The log message will appear nowhere.

Если вы добавите в трансляцию пользовательский логгер с пользовательскими методами, `BroadcastLogger` будет проксировать их и возвращать исходное значение либо массив исходных значений — в зависимости от количества логгеров в трансляции, которые ответили на вызов метода:

class MyLogger < ::Logger
  def loggable?
    true
  end
end

logger = BroadcastLogger.new
logger.loggable? # => A NoMethodError exception is raised because no loggers in the broadcasts could respond.

logger.broadcast_to(MyLogger.new(STDOUT))
logger.loggable? # => true
logger.broadcast_to(MyLogger.new(STDOUT))
puts logger.broadcasts # => [MyLogger, MyLogger]
logger.loggable? # [true, true]