openHAB

Class: OpenHAB::Logger

Inherits:
Object
  • Object
show all
Defined in:
lib/openhab/log.rb

Overview

Ruby Logger that forwards messages at appropriate levels to openHAB Logger

Constant Summary collapse

PREFIX =

The base prefix for all loggers from this gem.

"org.openhab.automation.jrubyscripting"
LEVELS =

Returns Supported logging levels.

Returns:

  • (Array<symbol>) —

    Supported logging levels

%i[trace debug warn info error].freeze

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#level ⇒ :error, ...

Note:

When a logger's level is modified, the logging infrastructure has to reload, and logging may be completely unavailable for a short time.

Returns The current log level.

Returns:

  • (:error, :warn, :info, :debug, :trace) —

    The current log level



244
245
246
 
# File 'lib/openhab/log.rb', line 244

def level
  Logger.log_service.get_level(name)[name]&.downcase&.to_sym
end

Class Method Details

.events ⇒ Logger

The events logger (events.log)

Returns:



167
168
169
 
# File 'lib/openhab/log.rb', line 167

def events
  Log.logger("openhab.event")
end

.gem_root ⇒ Logger

The root logger for this gem

Returns:



161
162
163
 
# File 'lib/openhab/log.rb', line 161

def gem_root
  Log.logger(PREFIX)
end

.root ⇒ Logger

The root logger (all of openHAB)

Returns:



155
156
157
 
# File 'lib/openhab/log.rb', line 155

def root
  Log.logger(org.slf4j.Logger::ROOT_LOGGER_NAME)
end

Instance Method Details

#debug(msg = nil) { ... } ⇒ void

This method returns an undefined value.

Log a message at debug level.

Examples:

logger.debug do
  total = Item1.state + Item2.state
  average = total / 2
"Total: #{total}, Average: #{average}"
end

Parameters:

  • msg (Object, nil) (defaults to: nil) —

    The log message

Yields:

  • Pass a block to delay generating the log message until it's confirmed that logging is enabled at debug level.

Yield Returns:

  • (Object, nil) —

    The log message



260
 
# File 'lib/openhab/log.rb', line 260

def_level_method(:debug)

#debug? ⇒ true, false

If the logger is enabled at debug level.

Returns:

  • (true, false) 


261
 
# File 'lib/openhab/log.rb', line 261

def_level_predicate(:debug)

#error(msg = nil) { ... } ⇒ void

This method returns an undefined value.

Log a message at error level.

Examples:

logger.error do
  total = Item1.state + Item2.state
  average = total / 2
"Total: #{total}, Average: #{average}"
end

Parameters:

  • msg (Object, nil) (defaults to: nil) —

    The log message

Yields:

  • Pass a block to delay generating the log message until it's confirmed that logging is enabled at error level.

Yield Returns:

  • (Object, nil) —

    The log message



254
 
# File 'lib/openhab/log.rb', line 254

def_level_method(:error)

#error? ⇒ true, false

If the logger is enabled at error level.

Returns:

  • (true, false) 


255
 
# File 'lib/openhab/log.rb', line 255

def_level_predicate(:error)

#info(msg = nil) { ... } ⇒ void

This method returns an undefined value.

Log a message at info level.

Examples:

logger.info do
  total = Item1.state + Item2.state
  average = total / 2
"Total: #{total}, Average: #{average}"
end

Parameters:

  • msg (Object, nil) (defaults to: nil) —

    The log message

Yields:

  • Pass a block to delay generating the log message until it's confirmed that logging is enabled at info level.

Yield Returns:

  • (Object, nil) —

    The log message



258
 
# File 'lib/openhab/log.rb', line 258

def_level_method(:info)

#info? ⇒ true, false

If the logger is enabled at info level.

Returns:

  • (true, false) 


259
 
# File 'lib/openhab/log.rb', line 259

def_level_predicate(:info)

#inspect ⇒ String Also known as: to_s

Returns:

  • (String) 


232
233
234
 
# File 'lib/openhab/log.rb', line 232

def inspect
  "#<OpenHAB::Logger #{name}>"
end

#log_exception(exception) ⇒ void

This method returns an undefined value.

Print error and stack trace without calls to internal classes

Parameters:

  • exception (Exception) —

    A rescued error



271
272
273
274
275
276
 
# File 'lib/openhab/log.rb', line 271

def log_exception(exception)
  exception = clean_backtrace(exception)
  error do
    "#{exception.message} (#{exception.class})\n#{exception.backtrace&.join("\n")}"
  end
end

#name ⇒ String

The logger name

Returns:

  • (String) 


227
228
229
 
# File 'lib/openhab/log.rb', line 227

def name
  @slf4j_logger.name
end

#trace(msg = nil) { ... } ⇒ void

This method returns an undefined value.

Log a message at trace level.

Examples:

logger.trace do
  total = Item1.state + Item2.state
  average = total / 2
"Total: #{total}, Average: #{average}"
end

Parameters:

  • msg (Object, nil) (defaults to: nil) —

    The log message

Yields:

  • Pass a block to delay generating the log message until it's confirmed that logging is enabled at trace level.

Yield Returns:

  • (Object, nil) —

    The log message



262
 
# File 'lib/openhab/log.rb', line 262

def_level_method(:trace)

#trace? ⇒ true, false

If the logger is enabled at trace level.

Returns:

  • (true, false) 


263
 
# File 'lib/openhab/log.rb', line 263

def_level_predicate(:trace)

#warn(msg = nil) { ... } ⇒ void

This method returns an undefined value.

Log a message at warn level.

Examples:

logger.warn do
  total = Item1.state + Item2.state
  average = total / 2
"Total: #{total}, Average: #{average}"
end

Parameters:

  • msg (Object, nil) (defaults to: nil) —

    The log message

Yields:

  • Pass a block to delay generating the log message until it's confirmed that logging is enabled at warn level.

Yield Returns:

  • (Object, nil) —

    The log message



256
 
# File 'lib/openhab/log.rb', line 256

def_level_method(:warn)

#warn? ⇒ true, false

If the logger is enabled at warn level.

Returns:

  • (true, false) 


257
 
# File 'lib/openhab/log.rb', line 257

def_level_predicate(:warn)