Class: Hedgelog

Inherits:
Object
  • Object
show all
Defined in:
lib/hedgelog.rb,
lib/hedgelog/context.rb,
lib/hedgelog/version.rb,
lib/hedgelog/scrubber.rb,
lib/hedgelog/normalizer.rb,
lib/hedgelog/scrub_replacement.rb

Defined Under Namespace

Classes: Context, Normalizer, ScrubReplacement, Scrubber

Constant Summary collapse

LEVELS = 
%w(DEBUG INFO WARN ERROR FATAL UNKNOWN).each_with_object({}).with_index do |(v, h), i|
  h[v] = i
  h[v.downcase] = i
  h[v.to_sym] = i
  h[v.downcase.to_sym] = i
  h[i] = v.downcase.to_sym
end.freeze
TOP_LEVEL_KEYS = 
[:app, :channel, :level, :level_name, :message, :request_id, :timestamp].freeze
RESERVED_KEYS = 
[:app, :level, :level_name, :timestamp, :context, :caller].freeze
TIMESTAMP_FORMAT = 
'%Y-%m-%dT%H:%M:%S.%6N%z'.freeze
BACKTRACE_RE = 
/([^:]+):([0-9]+)(?::in `(.*)')?/
VERSION = 
'0.1.9'.freeze

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(logdev = STDOUT, shift_age = nil, shift_size = nil) ⇒ Hedgelog

Returns a new instance of Hedgelog.



27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
 
# File 'lib/hedgelog.rb', line 27

def initialize(logdev = STDOUT, shift_age = nil, shift_size = nil)
  @level = LEVELS[:debug]
  @channel = nil
  @logdev = nil
  @app = nil
  @scrubber = Hedgelog::Scrubber.new
  @normalizer = Hedgelog::Normalizer.new
  @channel_context = Hedgelog::Context.new(@scrubber, @normalizer)

  if logdev.is_a?(self.class)
    @channel = logdev
  else
    @logdev = Logger::LogDevice.new(logdev, shift_age: shift_age, shift_size: shift_size)
  end
end

Instance Attribute Details

#app=(value) ⇒ Object (writeonly)

Sets the attribute app

Parameters:

  • value —

    the value to set the attribute app to.



25
26
27
 
# File 'lib/hedgelog.rb', line 25

def app=(value)
  @app = value
end

#level ⇒ Object

Returns the value of attribute level.



24
25
26
 
# File 'lib/hedgelog.rb', line 24

def level
  @level
end

Instance Method Details

#[](key) ⇒ Object 



68
69
70
 
# File 'lib/hedgelog.rb', line 68

def [](key)
  @channel_context[key]
end

#[]=(key, val) ⇒ Object 



64
65
66
 
# File 'lib/hedgelog.rb', line 64

def []=(key, val)
  @channel_context[key] = val
end

#add(severity = , message = nil, progname = nil, context = {}, &block) ⇒ Object 



49
50
51
52
53
54
55
56
57
58
59
60
61
62
 
# File 'lib/hedgelog.rb', line 49

def add(severity = LEVELS[:unknown], message = nil, progname = nil, context = {}, &block)
  return true if (@logdev.nil? && @channel.nil?) || severity < @level

  message, context = *yield if block
  context ||= {}

  context = Hedgelog::Context.new(@scrubber, @normalizer, context) unless context.is_a? Hedgelog::Context
  context.merge!(@channel_context)
  context[:message] ||= message

  return write(severity, context) if @logdev

  @channel.add(severity, nil, progname, context) if @channel
end

#channel(name) ⇒ Object 



80
81
82
83
84
85
86
87
 
# File 'lib/hedgelog.rb', line 80

def channel(name)
  sc = self.class.new(self)
  sc.level = @level
  channel_name = name
  channel_name = "#{self[:channel]} => #{name}" if self[:channel]
  sc[:channel] = channel_name
  sc
end

#clear_channel_context ⇒ Object 



76
77
78
 
# File 'lib/hedgelog.rb', line 76

def clear_channel_context
  @channel_context = {}
end

#delete(key) ⇒ Object 



72
73
74
 
# File 'lib/hedgelog.rb', line 72

def delete(key)
  @channel_context.delete(key)
end

#formatter ⇒ Object 



117
118
119
 
# File 'lib/hedgelog.rb', line 117

def formatter
  ::Logger::Formatter.new
end

#formatter=(_) ⇒ Object 



121
122
123
 
# File 'lib/hedgelog.rb', line 121

def formatter=(_)
  formatter
end

#silence(temporary_level = ) ⇒ Object 



108
109
110
111
112
113
114
115
 
# File 'lib/hedgelog.rb', line 108

def silence(temporary_level = LEVELS[:error])
  old_level = level
  self.level = temporary_level

  yield self
ensure
  self.level = old_level
end