class SemanticLogger::Appender::Wrapper

Attributes

logger[R]

Public Class Methods

new(logger:, **args, &block) click to toggle source

Forward all logging calls to the supplied logging instance.

Parameters

logger: [Object]
  Instance of an existing logger conforming to the Ruby Logger methods.

level: [:trace | :debug | :info | :warn | :error | :fatal]
  Override the log level for this appender.
  Default: SemanticLogger.default_level

formatter: [Object|Proc]
  An instance of a class that implements #call, or a Proc to be used to format
  the output from this appender
  Default: Use the built-in formatter (See: #call)

filter: [Regexp|Proc]
  RegExp: Only include log messages where the class name matches the supplied.
  regular expression. All other messages will be ignored.
  Proc: Only include log messages where the supplied Proc returns true
        The Proc must return true or false.

Ruby Logger

require 'logger'
require 'semantic_logger'

ruby_logger = Logger.new($stdout)
SemanticLogger.add_appender(logger: ruby_logger)

logger =  SemanticLogger['test']
logger.info('Hello World', some: :payload)

Install the `rails_semantic_logger` gem to replace the Rails logger with Semantic Logger.

Calls superclass method SemanticLogger::Subscriber::new
# File lib/semantic_logger/appender/wrapper.rb, line 42
def initialize(logger:, **args, &block)
  @logger = logger

  # Check if the custom appender responds to all the log levels. For example Ruby ::Logger
  does_not_implement = LEVELS[1..-1].find { |i| !@logger.respond_to?(i) }
  if does_not_implement
    raise(ArgumentError,
          "Supplied logger does not implement:#{does_not_implement}. It must implement all of #{LEVELS[1..-1].inspect}")
  end

  super(**args, &block)
end

Public Instance Methods

flush() click to toggle source

Flush all pending logs to disk.

Waits for all sent documents to be writted to disk
# File lib/semantic_logger/appender/wrapper.rb, line 65
def flush
  @logger.flush if @logger.respond_to?(:flush)
end
log(log) click to toggle source

Pass log calls to the underlying Rails, log4j or Ruby logger

trace entries are mapped to debug since :trace is not supported by the
Ruby or Rails Loggers
# File lib/semantic_logger/appender/wrapper.rb, line 58
def log(log)
  @logger.send(log.level == :trace ? :debug : log.level, formatter.call(log, self))
  true
end