Class: ActiveSupport::Notifications::Instrumenter

Inherits:
Object
  • Object
show all
Defined in:
lib/active_support/notifications/instrumenter.rb

Overview

Instrumenters are stored in a thread local.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(notifier) ⇒ Instrumenter

Returns a new instance of Instrumenter.



11
12
13
14
 
# File 'lib/active_support/notifications/instrumenter.rb', line 11

def initialize(notifier)
  @id       = unique_id
  @notifier = notifier
end

Instance Attribute Details

#id ⇒ Object (readonly)

Returns the value of attribute id.



9
10
11
 
# File 'lib/active_support/notifications/instrumenter.rb', line 9

def id
  @id
end

Instance Method Details

#finish(name, payload) ⇒ Object

Send a finish notification with name and payload.



39
40
41
 
# File 'lib/active_support/notifications/instrumenter.rb', line 39

def finish(name, payload)
  @notifier.finish name, @id, payload
end

#finish_with_state(listeners_state, name, payload) ⇒ Object 



43
44
45
 
# File 'lib/active_support/notifications/instrumenter.rb', line 43

def finish_with_state(listeners_state, name, payload)
  @notifier.finish name, @id, payload, listeners_state
end

#instrument(name, payload = {}) ⇒ Object

Instrument the given block by measuring the time taken to execute it and publish it. Notice that events get sent even if an error occurs in the passed-in block.



19
20
21
22
23
24
25
26
27
28
29
30
31
 
# File 'lib/active_support/notifications/instrumenter.rb', line 19

def instrument(name, payload = {})
  # some of the listeners might have state
  listeners_state = start name, payload
  begin
    yield payload
  rescue Exception => e
    payload[:exception] = [e.class.name, e.message]
    payload[:exception_object] = e
    raise e
  ensure
    finish_with_state listeners_state, name, payload
  end
end

#start(name, payload) ⇒ Object

Send a start notification with name and payload.



34
35
36
 
# File 'lib/active_support/notifications/instrumenter.rb', line 34

def start(name, payload)
  @notifier.start name, @id, payload
end