class Atatus::Span
@api private
Constants
- DEFAULT_SUBTYPE
- DEFAULT_TYPE
Attributes
action[RW]
context[R]
duration[R]
name[RW]
original_backtrace[RW]
parent[R]
sample_rate[R]
self_time[R]
stacktrace[R]
subtype[RW]
timestamp[R]
trace_context[RW]
transaction[R]
transaction_id[R]
type[RW]
Public Class Methods
new( name:, transaction:, trace_context:, parent:, type: nil, subtype: nil, action: nil, context: nil, stacktrace_builder: nil, sync: nil, sample_rate: nil )
click to toggle source
rubocop:disable Metrics/ParameterLists
# File lib/atatus/span.rb, line 32 def initialize( name:, transaction:, trace_context:, parent:, type: nil, subtype: nil, action: nil, context: nil, stacktrace_builder: nil, sync: nil, sample_rate: nil ) @name = name if subtype.nil? && type&.include?('.') @type, @subtype, @action = type.split('.') else @type = type || DEFAULT_TYPE @subtype = subtype || DEFAULT_SUBTYPE @action = action end @transaction = transaction @transaction_id = transaction.id @parent = parent @trace_context = trace_context || parent.trace_context.child @sample_rate = transaction.sample_rate @context = context || Span::Context.new(sync: sync) @stacktrace_builder = stacktrace_builder end
Public Instance Methods
done(clock_end: Util.monotonic_micros)
click to toggle source
# File lib/atatus/span.rb, line 104 def done(clock_end: Util.monotonic_micros) stop clock_end self end
inspect()
click to toggle source
relations
# File lib/atatus/span.rb, line 128 def inspect "<Atatus::Span id:#{trace_context&.id}" \ " name:#{name.inspect}" \ " type:#{type.inspect}" \ '>' end
prepare_for_serialization!()
click to toggle source
# File lib/atatus/span.rb, line 109 def prepare_for_serialization! # build_stacktrace! if should_build_stacktrace? self.original_backtrace = nil # release original end
running?()
click to toggle source
# File lib/atatus/span.rb, line 122 def running? started? && !stopped? end
start(clock_start = Util.monotonic_micros)
click to toggle source
life cycle
# File lib/atatus/span.rb, line 90 def start(clock_start = Util.monotonic_micros) @timestamp = Util.micros @clock_start = clock_start @parent.child_started self end
started?()
click to toggle source
# File lib/atatus/span.rb, line 118 def started? !!timestamp end
stop(clock_end = Util.monotonic_micros)
click to toggle source
# File lib/atatus/span.rb, line 97 def stop(clock_end = Util.monotonic_micros) @duration ||= (clock_end - @clock_start) @parent.child_stopped @self_time = @duration - child_durations.duration self end
stopped?()
click to toggle source
# File lib/atatus/span.rb, line 114 def stopped? !!duration end
Private Instance Methods
build_stacktrace!()
click to toggle source
# File lib/atatus/span.rb, line 137 def build_stacktrace! @stacktrace = @stacktrace_builder.build(original_backtrace, type: :span) end
long_enough_for_stacktrace?()
click to toggle source
# File lib/atatus/span.rb, line 145 def long_enough_for_stacktrace? min_duration = @stacktrace_builder.config.span_frames_min_duration_us return true if min_duration < 0 return false if min_duration == 0 duration >= min_duration end
should_build_stacktrace?()
click to toggle source
# File lib/atatus/span.rb, line 141 def should_build_stacktrace? @stacktrace_builder && original_backtrace && long_enough_for_stacktrace? end