Class: ActiveSupport::Notifications::Event

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

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(name, start, ending, transaction_id, payload) ⇒ Event

Returns a new instance of Event.



110
111
112
113
114
115
116
117
118
119
120
# File 'activesupport/lib/active_support/notifications/instrumenter.rb', line 110

def initialize(name, start, ending, transaction_id, payload)
  @name           = name
  @payload        = payload.dup
  @time           = start ? start.to_f * 1_000.0 : start
  @transaction_id = transaction_id
  @end            = ending ? ending.to_f * 1_000.0 : ending
  @cpu_time_start = 0.0
  @cpu_time_finish = 0.0
  @allocation_count_start = 0
  @allocation_count_finish = 0
end

Instance Attribute Details

#endObject (readonly)

Returns the value of attribute end



107
108
109
# File 'activesupport/lib/active_support/notifications/instrumenter.rb', line 107

def end
  @end
end

#nameObject (readonly)

Returns the value of attribute name



107
108
109
# File 'activesupport/lib/active_support/notifications/instrumenter.rb', line 107

def name
  @name
end

#payloadObject

Returns the value of attribute payload



108
109
110
# File 'activesupport/lib/active_support/notifications/instrumenter.rb', line 108

def payload
  @payload
end

#timeObject (readonly)

Returns the value of attribute time



107
108
109
# File 'activesupport/lib/active_support/notifications/instrumenter.rb', line 107

def time
  @time
end

#transaction_idObject (readonly)

Returns the value of attribute transaction_id



107
108
109
# File 'activesupport/lib/active_support/notifications/instrumenter.rb', line 107

def transaction_id
  @transaction_id
end

Instance Method Details

#allocationsObject

Returns the number of allocations made since the call to start! and the call to finish!



164
165
166
# File 'activesupport/lib/active_support/notifications/instrumenter.rb', line 164

def allocations
  @allocation_count_finish - @allocation_count_start
end

#childrenObject

:nodoc:



168
169
170
171
172
173
174
# File 'activesupport/lib/active_support/notifications/instrumenter.rb', line 168

def children # :nodoc:
  ActiveSupport.deprecator.warn <<~EOM
    ActiveSupport::Notifications::Event#children is deprecated and will
    be removed in Rails 7.2.
  EOM
  []
end

#cpu_timeObject

Returns the CPU time (in milliseconds) passed since the call to start! and the call to finish!



151
152
153
# File 'activesupport/lib/active_support/notifications/instrumenter.rb', line 151

def cpu_time
  @cpu_time_finish - @cpu_time_start
end

#durationObject

Returns the difference in milliseconds between when the execution of the event started and when it ended.

ActiveSupport::Notifications.subscribe('wait') do |*args|
  @event = ActiveSupport::Notifications::Event.new(*args)
end

ActiveSupport::Notifications.instrument('wait') do
  sleep 1
end

@event.duration # => 1000.138


197
198
199
# File 'activesupport/lib/active_support/notifications/instrumenter.rb', line 197

def duration
  self.end - time
end

#finish!Object

Record information at the time this event finishes



143
144
145
146
147
# File 'activesupport/lib/active_support/notifications/instrumenter.rb', line 143

def finish!
  @cpu_time_finish = now_cpu
  @end = now
  @allocation_count_finish = now_allocations
end

#idle_timeObject

Returns the idle time time (in milliseconds) passed since the call to start! and the call to finish!



157
158
159
160
# File 'activesupport/lib/active_support/notifications/instrumenter.rb', line 157

def idle_time
  diff = duration - cpu_time
  diff > 0.0 ? diff : 0.0
end

#parent_of?(event) ⇒ Boolean

:nodoc:

Returns:

  • (Boolean)


176
177
178
179
180
181
182
183
# File 'activesupport/lib/active_support/notifications/instrumenter.rb', line 176

def parent_of?(event) # :nodoc:
  ActiveSupport.deprecator.warn <<~EOM
    ActiveSupport::Notifications::Event#parent_of? is deprecated and will
    be removed in Rails 7.2.
  EOM
  start = (time - event.time) * 1000
  start <= 0 && (start + duration >= event.duration)
end

#recordObject



122
123
124
125
126
127
128
129
130
131
132
133
# File 'activesupport/lib/active_support/notifications/instrumenter.rb', line 122

def record
  start!
  begin
    yield payload if block_given?
  rescue Exception => e
    payload[:exception] = [e.class.name, e.message]
    payload[:exception_object] = e
    raise e
  ensure
    finish!
  end
end

#start!Object

Record information at the time this event starts



136
137
138
139
140
# File 'activesupport/lib/active_support/notifications/instrumenter.rb', line 136

def start!
  @time = now
  @cpu_time_start = now_cpu
  @allocation_count_start = now_allocations
end