Class: Sapience::Base

Inherits:
Object
  • Object
show all
Includes:
LogMethods
Defined in:
lib/sapience/base.rb

Overview

rubocop:disable ClassLength

Direct Known Subclasses

Formatters::Raw, Logger, Subscriber

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from LogMethods

#debug, #debug?, #error, #error!, #error?, #fatal, #fatal!, #fatal?, #info, #info?, #level_to_index, #log_with_exception, #log_with_level, #measure, #measure_debug, #measure_error, #measure_fatal, #measure_info, #measure_trace, #measure_warn, #trace, #trace?, #warn, #warn?

Instance Attribute Details

#filter ⇒ Object

Class name to be logged



5
6
7
 
# File 'lib/sapience/base.rb', line 5

def filter
  @filter
end

#name ⇒ Object

Class name to be logged



5
6
7
 
# File 'lib/sapience/base.rb', line 5

def name
  @name
end

Instance Method Details

#app_name ⇒ Object 



111
112
113
 
# File 'lib/sapience/base.rb', line 111

def app_name
  Sapience.app_name
end

#default_formatter ⇒ Object

Returns [Sapience::Formatters::Default] formatter default for this subscriber



107
108
109
 
# File 'lib/sapience/base.rb', line 107

def default_formatter
  Sapience::Formatters::Default.new
end

#fast_tag(tag, &block) ⇒ Object

:nodoc:



102
103
104
 
# File 'lib/sapience/base.rb', line 102

def fast_tag(tag, &block)
  Sapience.fast_tag(tag, &block)
end

#host ⇒ Object

Allow host name to be set globally or per subscriber



116
117
118
 
# File 'lib/sapience/base.rb', line 116

def host
  Sapience.config.host
end

#level ⇒ Object

Returns the current log level if set, otherwise it returns the global default log level



23
24
25
 
# File 'lib/sapience/base.rb', line 23

def level
  @level || Sapience.config.default_level
end

#level=(level) ⇒ Object

Set the logging level for this logger

Note: This level is only for this particular instance. It does not override

the log level in any logging instance or the default log level
Sapience.config.default_level

Must be one of the values in Sapience::LEVELS, or nil if this logger instance should use the global default level



16
17
18
19
 
# File 'lib/sapience/base.rb', line 16

def level=(level)
  @level_index = Sapience.config.level_to_index(level)
  @level       = Sapience.config.index_to_level(@level_index)
end

#payload ⇒ Object

Returns [Hash] payload to be added to every log entry in the current scope on this thread. Returns nil if no payload is currently set



145
146
147
 
# File 'lib/sapience/base.rb', line 145

def payload
  Thread.current[:sapience_payload]
end

#pop_tags(quantity = 1) ⇒ Object

:nodoc:



92
93
94
 
# File 'lib/sapience/base.rb', line 92

def pop_tags(quantity = 1)
  Sapience.pop_tags(quantity)
end

#push_tags(*tags) ⇒ Object Also known as: tags=

:nodoc:



86
87
88
 
# File 'lib/sapience/base.rb', line 86

def push_tags(*tags)
  Sapience.push_tags(*tags)
end

#silence(new_level = :error, &block) ⇒ Object

:nodoc:



97
98
99
 
# File 'lib/sapience/base.rb', line 97

def silence(new_level = :error, &block)
  Sapience.silence(new_level, &block)
end

#tagged(*tags, &block) ⇒ Object Also known as: with_tags

:nodoc:



73
74
75
 
# File 'lib/sapience/base.rb', line 73

def tagged(*tags, &block)
  Sapience.tagged(*tags, &block)
end

#tags ⇒ Object

:nodoc:



81
82
83
 
# File 'lib/sapience/base.rb', line 81

def tags
  Sapience.tags
end

#with_payload(payload) ⇒ Object

Thread specific context information to be logged with every log entry

Add a payload to all log calls on This Thread within the supplied block

logger.with_payload(tracking_number: 12345) do
  logger.debug('Hello World')
end

If a log call already includes a pyload, this payload will be merged with the supplied payload, with the supplied payload taking precedence

logger.with_payload(tracking_number: 12345) do
  logger.debug('Hello World', result: 'blah')
end



134
135
136
137
138
139
140
 
# File 'lib/sapience/base.rb', line 134

def with_payload(payload)
  current_payload                   = self.payload
  Thread.current[:sapience_payload] = current_payload ? current_payload.merge(payload) : payload
  yield
ensure
  Thread.current[:sapience_payload] = current_payload
end