Class: NewRelic::TransactionSample
- Inherits:
-
Object
- Object
- NewRelic::TransactionSample
- Includes:
- TransactionAnalysis
- Defined in:
- lib/new_relic/transaction_sample.rb,
lib/new_relic/transaction_sample/segment.rb,
lib/new_relic/transaction_sample/fake_segment.rb,
lib/new_relic/transaction_sample/summary_segment.rb,
lib/new_relic/transaction_sample/composite_segment.rb
Defined Under Namespace
Classes: CompositeSegment, FakeSegment, Segment, SummarySegment
Constant Summary collapse
- @@start_time =
Time.now
Instance Attribute Summary collapse
-
#force_persist ⇒ Object
Returns the value of attribute force_persist.
-
#guid ⇒ Object
Returns the value of attribute guid.
-
#params ⇒ Object
Returns the value of attribute params.
-
#profile ⇒ Object
Returns the value of attribute profile.
-
#root_segment ⇒ Object
Returns the value of attribute root_segment.
-
#sample_id ⇒ Object
readonly
Returns the value of attribute sample_id.
Instance Method Summary collapse
- #count_segments ⇒ Object
- #create_segment(relative_timestamp, metric_name, segment_id = nil) ⇒ Object
- #duration ⇒ Object
-
#each_segment(&block) ⇒ Object
Iterates recursively over each segment in the entire transaction sample tree.
-
#each_segment_with_nest_tracking(&block) ⇒ Object
Iterates recursively over each segment in the entire transaction sample tree while keeping track of nested segments.
-
#ensure_segment_count_set(count) ⇒ Object
makes sure that the parameter cache for segment count is set to the correct value.
-
#find_segment(id) ⇒ Object
Searches the tree recursively for the segment with the given id.
-
#initialize(time = Time.now.to_f, sample_id = nil) ⇒ TransactionSample
constructor
A new instance of TransactionSample.
-
#omit_segments_with(regex) ⇒ Object
return a new transaction sample that treats segments with the given regular expression in their name as if they were never called at all.
- #path_string ⇒ Object
-
#prepare_to_send(options = {}) ⇒ Object
Return a new transaction sample that can be sent to the New Relic service.
- #start_time ⇒ Object
-
#timestamp ⇒ Object
offset from start of app.
- #to_array ⇒ Object
- #to_collector_array(marshaller) ⇒ Object
- #to_json ⇒ Object
- #to_s ⇒ Object
- #to_s_compact ⇒ Object
-
#truncate(max) ⇒ Object
Truncates the transaction sample to a maximum length determined by the passed-in parameter.
Methods included from TransactionAnalysis
#breakdown_data, #database_time, #render_time, #sql_segments
Constructor Details
#initialize(time = Time.now.to_f, sample_id = nil) ⇒ TransactionSample
Returns a new instance of TransactionSample.
21 22 23 24 25 26 27 28 29 30 |
# File 'lib/new_relic/transaction_sample.rb', line 21 def initialize(time = Time.now.to_f, sample_id = nil) @sample_id = sample_id || object_id @start_time = time @params = { :segment_count => -1, :request_params => {} } @segment_count = -1 @root_segment = create_segment 0.0, "ROOT" @guid = generate_guid NewRelic::Agent::TransactionInfo.get.guid = @guid end |
Instance Attribute Details
#force_persist ⇒ Object
Returns the value of attribute force_persist.
14 15 16 |
# File 'lib/new_relic/transaction_sample.rb', line 14 def force_persist @force_persist end |
#guid ⇒ Object
Returns the value of attribute guid.
14 15 16 |
# File 'lib/new_relic/transaction_sample.rb', line 14 def guid @guid end |
#params ⇒ Object
Returns the value of attribute params.
14 15 16 |
# File 'lib/new_relic/transaction_sample.rb', line 14 def params @params end |
#profile ⇒ Object
Returns the value of attribute profile.
14 15 16 |
# File 'lib/new_relic/transaction_sample.rb', line 14 def profile @profile end |
#root_segment ⇒ Object
Returns the value of attribute root_segment.
14 15 16 |
# File 'lib/new_relic/transaction_sample.rb', line 14 def root_segment @root_segment end |
#sample_id ⇒ Object (readonly)
Returns the value of attribute sample_id.
15 16 17 |
# File 'lib/new_relic/transaction_sample.rb', line 15 def sample_id @sample_id end |
Instance Method Details
#count_segments ⇒ Object
32 33 34 |
# File 'lib/new_relic/transaction_sample.rb', line 32 def count_segments @segment_count end |
#create_segment(relative_timestamp, metric_name, segment_id = nil) ⇒ Object
85 86 87 88 89 90 |
# File 'lib/new_relic/transaction_sample.rb', line 85 def create_segment(, metric_name, segment_id = nil) raise TypeError.new("Frozen Transaction Sample") if frozen? @params[:segment_count] += 1 @segment_count += 1 NewRelic::TransactionSample::Segment.new(, metric_name, segment_id) end |
#duration ⇒ Object
92 93 94 |
# File 'lib/new_relic/transaction_sample.rb', line 92 def duration root_segment.duration end |
#each_segment(&block) ⇒ Object
Iterates recursively over each segment in the entire transaction sample tree
98 99 100 |
# File 'lib/new_relic/transaction_sample.rb', line 98 def each_segment(&block) @root_segment.each_segment(&block) end |
#each_segment_with_nest_tracking(&block) ⇒ Object
Iterates recursively over each segment in the entire transaction sample tree while keeping track of nested segments
104 105 106 |
# File 'lib/new_relic/transaction_sample.rb', line 104 def each_segment_with_nest_tracking(&block) @root_segment.each_segment_with_nest_tracking(&block) end |
#ensure_segment_count_set(count) ⇒ Object
makes sure that the parameter cache for segment count is set to the correct value
47 48 49 |
# File 'lib/new_relic/transaction_sample.rb', line 47 def ensure_segment_count_set(count) params[:segment_count] ||= count end |
#find_segment(id) ⇒ Object
Searches the tree recursively for the segment with the given id. note that this is an internal id, not an ActiveRecord id
114 115 116 |
# File 'lib/new_relic/transaction_sample.rb', line 114 def find_segment(id) @root_segment.find_segment(id) end |
#omit_segments_with(regex) ⇒ Object
return a new transaction sample that treats segments with the given regular expression in their name as if they were never called at all. This allows us to strip out segments from traces captured in development environment that would not normally show up in production (like Rails/Application Code Loading)
145 146 147 148 149 150 151 152 153 154 155 156 157 |
# File 'lib/new_relic/transaction_sample.rb', line 145 def omit_segments_with(regex) regex = Regexp.new(regex) sample = TransactionSample.new(@start_time, sample_id) sample.params = params.dup sample.params[:segment_count] = 0 delta = build_segment_with_omissions(sample, 0.0, @root_segment, sample.root_segment, regex) sample.root_segment.end_trace(@root_segment. - delta) sample.profile = self.profile sample end |
#path_string ⇒ Object
81 82 83 |
# File 'lib/new_relic/transaction_sample.rb', line 81 def path_string @root_segment.path_string end |
#prepare_to_send(options = {}) ⇒ Object
Return a new transaction sample that can be sent to the New Relic service. This involves potentially one or more of the following options
:explain_sql : run EXPLAIN on all queries whose response times equal the value for this key
(for example :explain_sql => 2.0 would explain everything over 2 seconds. 0.0 would explain everything.)
:keep_backtraces : keep backtraces, significantly increasing size of trace (off by default)
:record_sql => [ :raw | :obfuscated] : copy over the sql, obfuscating if necessary
167 168 169 170 171 172 173 174 175 176 177 178 |
# File 'lib/new_relic/transaction_sample.rb', line 167 def prepare_to_send(={}) sample = TransactionSample.new(@start_time, sample_id) sample.params.merge! self.params sample.guid = self.guid sample.force_persist = self.force_persist if self.force_persist build_segment_for_transfer(sample, @root_segment, sample.root_segment, ) sample.root_segment.end_trace(@root_segment.) sample end |
#start_time ⇒ Object
77 78 79 |
# File 'lib/new_relic/transaction_sample.rb', line 77 def start_time Time.at(@start_time) end |
#timestamp ⇒ Object
offset from start of app
52 53 54 |
# File 'lib/new_relic/transaction_sample.rb', line 52 def @start_time - @@start_time.to_f end |
#to_array ⇒ Object
60 61 62 63 |
# File 'lib/new_relic/transaction_sample.rb', line 60 def to_array [ @start_time.to_f, @params[:request_params], @params[:custom_params], @root_segment.to_array ] end |
#to_collector_array(marshaller) ⇒ Object
65 66 67 68 69 70 71 72 73 74 75 |
# File 'lib/new_relic/transaction_sample.rb', line 65 def to_collector_array(marshaller) trace_tree = if marshaller.respond_to?(:encode_compress) marshaller.encode_compress(self.to_array) else self.to_array end [ Helper.time_to_millis(@start_time), Helper.time_to_millis(duration), @params[:path], @params[:uri], trace_tree, @guid, nil, !!@force_persist ] end |
#to_json ⇒ Object
56 57 58 |
# File 'lib/new_relic/transaction_sample.rb', line 56 def to_json JSON.dump(self.to_array) end |
#to_s ⇒ Object
118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 |
# File 'lib/new_relic/transaction_sample.rb', line 118 def to_s s = "Transaction Sample collected at #{start_time}\n" s << " {\n" s << " Path: #{params[:path]} \n" params.each do |k,v| next if k == :path s << " #{k}: " << case v when Enumerable then v.map(&:to_s).sort.join("; ") when String then v when Float then '%6.3s' % v when Fixnum then v.to_s when nil then '' else raise "unexpected value type for #{k}: '#{v}' (#{v.class})" end << "\n" end s << " }\n\n" s << @root_segment.to_debug_str(0) end |
#to_s_compact ⇒ Object
108 109 110 |
# File 'lib/new_relic/transaction_sample.rb', line 108 def to_s_compact @root_segment.to_s_compact end |
#truncate(max) ⇒ Object
Truncates the transaction sample to a maximum length determined by the passed-in parameter. Operates recursively on the entire tree of transaction segments in a depth-first manner
39 40 41 42 43 |
# File 'lib/new_relic/transaction_sample.rb', line 39 def truncate(max) return if @segment_count < max @root_segment.truncate(max + 1) @segment_count = max end |