newrelic_rpm 2.10.6 → 2.10.8

Sign up to get free protection for your applications and to get access to all the features.

Potentially problematic release.


This version of newrelic_rpm might be problematic. Click here for more details.

Files changed (220) hide show
  1. data/CHANGELOG +14 -0
  2. data/lib/new_relic/agent.rb +5 -4
  3. data/lib/new_relic/agent/agent.rb +81 -101
  4. data/lib/new_relic/agent/error_collector.rb +1 -2
  5. data/lib/new_relic/agent/instrumentation/authlogic.rb +2 -2
  6. data/lib/new_relic/agent/instrumentation/merb/controller.rb +2 -2
  7. data/lib/new_relic/agent/instrumentation/rails3/action_controller.rb +45 -0
  8. data/lib/new_relic/agent/instrumentation/rails3/errors.rb +21 -0
  9. data/lib/new_relic/agent/method_tracer.rb +2 -2
  10. data/lib/new_relic/agent/samplers/delayed_job_lock_sampler.rb +1 -1
  11. data/lib/new_relic/agent/stats_engine/samplers.rb +1 -2
  12. data/lib/new_relic/agent/transaction_sampler.rb +1 -1
  13. data/lib/new_relic/agent/worker_loop.rb +47 -86
  14. data/lib/new_relic/{agent/collection_helper.rb → collection_helper.rb} +2 -4
  15. data/lib/new_relic/control.rb +18 -2
  16. data/lib/new_relic/control/rails3.rb +75 -0
  17. data/lib/new_relic/local_environment.rb +11 -3
  18. data/lib/new_relic/noticed_error.rb +2 -1
  19. data/lib/new_relic/version.rb +10 -9
  20. data/newrelic_rpm.gemspec +195 -3
  21. data/rdoc/classes/NewRelic.html +293 -0
  22. data/rdoc/classes/NewRelic/Agent.html +810 -0
  23. data/rdoc/classes/NewRelic/Agent/Agent.html +742 -0
  24. data/rdoc/classes/NewRelic/Agent/BackgroundLoadingError.html +111 -0
  25. data/rdoc/classes/NewRelic/Agent/BusyCalculator.html +309 -0
  26. data/rdoc/classes/NewRelic/Agent/CollectionHelper.html +196 -0
  27. data/rdoc/classes/NewRelic/Agent/ErrorCollector.html +378 -0
  28. data/rdoc/classes/NewRelic/Agent/ForceDisconnectException.html +118 -0
  29. data/rdoc/classes/NewRelic/Agent/ForceRestartException.html +117 -0
  30. data/rdoc/classes/NewRelic/Agent/IgnoreSilentlyException.html +118 -0
  31. data/rdoc/classes/NewRelic/Agent/Instrumentation.html +174 -0
  32. data/rdoc/classes/NewRelic/Agent/Instrumentation/ActiveRecordInstrumentation.html +221 -0
  33. data/rdoc/classes/NewRelic/Agent/Instrumentation/ControllerInstrumentation.html +349 -0
  34. data/rdoc/classes/NewRelic/Agent/Instrumentation/ControllerInstrumentation/ClassMethods.html +277 -0
  35. data/rdoc/classes/NewRelic/Agent/Instrumentation/DelayedJobInstrumentation.html +112 -0
  36. data/rdoc/classes/NewRelic/Agent/Instrumentation/MetricFrame.html +1007 -0
  37. data/rdoc/classes/NewRelic/Agent/Instrumentation/Rack.html +321 -0
  38. data/rdoc/classes/NewRelic/Agent/Instrumentation/Sinatra.html +176 -0
  39. data/rdoc/classes/NewRelic/Agent/LicenseException.html +117 -0
  40. data/rdoc/classes/NewRelic/Agent/MethodTracer.html +150 -0
  41. data/rdoc/classes/NewRelic/Agent/MethodTracer/ClassMethods.html +295 -0
  42. data/rdoc/classes/NewRelic/Agent/MethodTracer/InstanceMethods.html +284 -0
  43. data/rdoc/classes/NewRelic/Agent/PostTooBigException.html +120 -0
  44. data/rdoc/classes/NewRelic/Agent/Sampler.html +314 -0
  45. data/rdoc/classes/NewRelic/Agent/Sampler/Unsupported.html +117 -0
  46. data/rdoc/classes/NewRelic/Agent/Samplers.html +126 -0
  47. data/rdoc/classes/NewRelic/Agent/Samplers/CpuSampler.html +327 -0
  48. data/rdoc/classes/NewRelic/Agent/Samplers/DelayedJobLockSampler.html +296 -0
  49. data/rdoc/classes/NewRelic/Agent/Samplers/MemorySampler.html +321 -0
  50. data/rdoc/classes/NewRelic/Agent/Samplers/MemorySampler/Base.html +186 -0
  51. data/rdoc/classes/NewRelic/Agent/Samplers/MemorySampler/JavaHeapSampler.html +173 -0
  52. data/rdoc/classes/NewRelic/Agent/Samplers/MemorySampler/ProcStatus.html +216 -0
  53. data/rdoc/classes/NewRelic/Agent/Samplers/MemorySampler/ShellPS.html +207 -0
  54. data/rdoc/classes/NewRelic/Agent/Samplers/ObjectSampler.html +222 -0
  55. data/rdoc/classes/NewRelic/Agent/ServerError.html +117 -0
  56. data/rdoc/classes/NewRelic/Agent/ShimAgent.html +297 -0
  57. data/rdoc/classes/NewRelic/Agent/StatsEngine.html +204 -0
  58. data/rdoc/classes/NewRelic/Agent/StatsEngine/MetricStats.html +441 -0
  59. data/rdoc/classes/NewRelic/Agent/StatsEngine/Samplers.html +237 -0
  60. data/rdoc/classes/NewRelic/Agent/StatsEngine/ScopeStackElement.html +178 -0
  61. data/rdoc/classes/NewRelic/Agent/StatsEngine/Transactions.html +385 -0
  62. data/rdoc/classes/NewRelic/Agent/TransactionSampleBuilder.html +505 -0
  63. data/rdoc/classes/NewRelic/Agent/TransactionSampler.html +690 -0
  64. data/rdoc/classes/NewRelic/Agent/WorkerLoop.html +305 -0
  65. data/rdoc/classes/NewRelic/Agent/WorkerLoop/LoopTask.html +224 -0
  66. data/rdoc/classes/NewRelic/ApdexStats.html +196 -0
  67. data/rdoc/classes/NewRelic/BasicStats.html +113 -0
  68. data/rdoc/classes/NewRelic/ChainedCall.html +180 -0
  69. data/rdoc/classes/NewRelic/Commands.html +112 -0
  70. data/rdoc/classes/NewRelic/Commands/CommandFailure.html +167 -0
  71. data/rdoc/classes/NewRelic/Commands/Deployments.html +285 -0
  72. data/rdoc/classes/NewRelic/Control.html +1760 -0
  73. data/rdoc/classes/NewRelic/Control/External.html +148 -0
  74. data/rdoc/classes/NewRelic/Control/Merb.html +227 -0
  75. data/rdoc/classes/NewRelic/Control/Rails.html +542 -0
  76. data/rdoc/classes/NewRelic/Control/Ruby.html +266 -0
  77. data/rdoc/classes/NewRelic/Control/Sinatra.html +178 -0
  78. data/rdoc/classes/NewRelic/DelayedJobInjection.html +118 -0
  79. data/rdoc/classes/NewRelic/Histogram.html +226 -0
  80. data/rdoc/classes/NewRelic/Histogram/Bucket.html +319 -0
  81. data/rdoc/classes/NewRelic/Histogram/Shim.html +144 -0
  82. data/rdoc/classes/NewRelic/LocalEnvironment.html +572 -0
  83. data/rdoc/classes/NewRelic/MerbBootLoader.html +146 -0
  84. data/rdoc/classes/NewRelic/MethodTraceStats.html +250 -0
  85. data/rdoc/classes/NewRelic/MetricData.html +347 -0
  86. data/rdoc/classes/NewRelic/MetricParser.html +747 -0
  87. data/rdoc/classes/NewRelic/MetricParser/ActionMailer.html +170 -0
  88. data/rdoc/classes/NewRelic/MetricParser/ActiveMerchant.html +267 -0
  89. data/rdoc/classes/NewRelic/MetricParser/ActiveRecord.html +250 -0
  90. data/rdoc/classes/NewRelic/MetricParser/Controller.html +363 -0
  91. data/rdoc/classes/NewRelic/MetricParser/ControllerCPU.html +319 -0
  92. data/rdoc/classes/NewRelic/MetricParser/Errors.html +170 -0
  93. data/rdoc/classes/NewRelic/MetricParser/External.html +339 -0
  94. data/rdoc/classes/NewRelic/MetricParser/MemCache.html +340 -0
  95. data/rdoc/classes/NewRelic/MetricParser/OtherTransaction.html +205 -0
  96. data/rdoc/classes/NewRelic/MetricParser/View.html +381 -0
  97. data/rdoc/classes/NewRelic/MetricParser/WebFrontend.html +182 -0
  98. data/rdoc/classes/NewRelic/MetricParser/WebService.html +172 -0
  99. data/rdoc/classes/NewRelic/MetricSpec.html +406 -0
  100. data/rdoc/classes/NewRelic/Metrics.html +138 -0
  101. data/rdoc/classes/NewRelic/NoticedError.html +200 -0
  102. data/rdoc/classes/NewRelic/Rack.html +112 -0
  103. data/rdoc/classes/NewRelic/Rack/MetricApp.html +193 -0
  104. data/rdoc/classes/NewRelic/Rack/Status.html +165 -0
  105. data/rdoc/classes/NewRelic/ScopedMethodTraceStats.html +225 -0
  106. data/rdoc/classes/NewRelic/Stats.html +917 -0
  107. data/rdoc/classes/NewRelic/StatsBase.html +346 -0
  108. data/rdoc/classes/NewRelic/TransactionAnalysis.html +269 -0
  109. data/rdoc/classes/NewRelic/TransactionAnalysis/SegmentSummary.html +338 -0
  110. data/rdoc/classes/NewRelic/TransactionSample.html +766 -0
  111. data/rdoc/classes/NewRelic/TransactionSample/CompositeSegment.html +195 -0
  112. data/rdoc/classes/NewRelic/TransactionSample/FakeSegment.html +113 -0
  113. data/rdoc/classes/NewRelic/TransactionSample/IDGenerator.html +178 -0
  114. data/rdoc/classes/NewRelic/TransactionSample/Segment.html +920 -0
  115. data/rdoc/classes/NewRelic/TransactionSample/SummarySegment.html +180 -0
  116. data/rdoc/classes/NewRelic/VersionNumber.html +338 -0
  117. data/rdoc/classes/NewRelicApi.html +270 -0
  118. data/rdoc/classes/NewRelicApi/Account.html +178 -0
  119. data/rdoc/classes/NewRelicApi/Account/AccountUsage.html +111 -0
  120. data/rdoc/classes/NewRelicApi/Account/AccountView.html +146 -0
  121. data/rdoc/classes/NewRelicApi/Application.html +139 -0
  122. data/rdoc/classes/NewRelicApi/Application/Agent.html +119 -0
  123. data/rdoc/classes/NewRelicApi/Deployment.html +123 -0
  124. data/rdoc/classes/NewRelicApi/Subscription.html +111 -0
  125. data/rdoc/classes/NewRelicApi/ThresholdValue.html +174 -0
  126. data/rdoc/classes/NewRelicApi/User.html +111 -0
  127. data/rdoc/created.rid +1 -0
  128. data/rdoc/files/CHANGELOG.html +649 -0
  129. data/rdoc/files/LICENSE.html +143 -0
  130. data/rdoc/files/lib/new_relic/agent/agent_rb.html +113 -0
  131. data/rdoc/files/lib/new_relic/agent/busy_calculator_rb.html +115 -0
  132. data/rdoc/files/lib/new_relic/agent/chained_call_rb.html +107 -0
  133. data/rdoc/files/lib/new_relic/agent/collection_helper_rb.html +101 -0
  134. data/rdoc/files/lib/new_relic/agent/error_collector_rb.html +101 -0
  135. data/rdoc/files/lib/new_relic/agent/instrumentation/active_merchant_rb.html +107 -0
  136. data/rdoc/files/lib/new_relic/agent/instrumentation/active_record_instrumentation_rb.html +108 -0
  137. data/rdoc/files/lib/new_relic/agent/instrumentation/authlogic_rb.html +101 -0
  138. data/rdoc/files/lib/new_relic/agent/instrumentation/controller_instrumentation_rb.html +108 -0
  139. data/rdoc/files/lib/new_relic/agent/instrumentation/data_mapper_rb.html +191 -0
  140. data/rdoc/files/lib/new_relic/agent/instrumentation/delayed_job_instrumentation_rb.html +109 -0
  141. data/rdoc/files/lib/new_relic/agent/instrumentation/memcache_rb.html +152 -0
  142. data/rdoc/files/lib/new_relic/agent/instrumentation/merb/controller_rb.html +155 -0
  143. data/rdoc/files/lib/new_relic/agent/instrumentation/merb/errors_rb.html +107 -0
  144. data/rdoc/files/lib/new_relic/agent/instrumentation/metric_frame_rb.html +113 -0
  145. data/rdoc/files/lib/new_relic/agent/instrumentation/net_rb.html +172 -0
  146. data/rdoc/files/lib/new_relic/agent/instrumentation/passenger_instrumentation_rb.html +101 -0
  147. data/rdoc/files/lib/new_relic/agent/instrumentation/rack_rb.html +108 -0
  148. data/rdoc/files/lib/new_relic/agent/instrumentation/rails/action_controller_rb.html +152 -0
  149. data/rdoc/files/lib/new_relic/agent/instrumentation/rails/action_web_service_rb.html +108 -0
  150. data/rdoc/files/lib/new_relic/agent/instrumentation/rails/errors_rb.html +167 -0
  151. data/rdoc/files/lib/new_relic/agent/instrumentation/sinatra_rb.html +108 -0
  152. data/rdoc/files/lib/new_relic/agent/method_tracer_rb.html +108 -0
  153. data/rdoc/files/lib/new_relic/agent/sampler_rb.html +116 -0
  154. data/rdoc/files/lib/new_relic/agent/samplers/cpu_sampler_rb.html +101 -0
  155. data/rdoc/files/lib/new_relic/agent/samplers/delayed_job_lock_sampler_rb.html +101 -0
  156. data/rdoc/files/lib/new_relic/agent/samplers/memory_sampler_rb.html +101 -0
  157. data/rdoc/files/lib/new_relic/agent/samplers/object_sampler_rb.html +101 -0
  158. data/rdoc/files/lib/new_relic/agent/shim_agent_rb.html +108 -0
  159. data/rdoc/files/lib/new_relic/agent/stats_engine/metric_stats_rb.html +101 -0
  160. data/rdoc/files/lib/new_relic/agent/stats_engine/samplers_rb.html +101 -0
  161. data/rdoc/files/lib/new_relic/agent/stats_engine/transactions_rb.html +101 -0
  162. data/rdoc/files/lib/new_relic/agent/stats_engine_rb.html +110 -0
  163. data/rdoc/files/lib/new_relic/agent/transaction_sampler_rb.html +101 -0
  164. data/rdoc/files/lib/new_relic/agent/worker_loop_rb.html +101 -0
  165. data/rdoc/files/lib/new_relic/agent_rb.html +204 -0
  166. data/rdoc/files/lib/new_relic/commands/deployments_rb.html +119 -0
  167. data/rdoc/files/lib/new_relic/commands/new_relic_commands_rb.html +108 -0
  168. data/rdoc/files/lib/new_relic/control/external_rb.html +117 -0
  169. data/rdoc/files/lib/new_relic/control/merb_rb.html +101 -0
  170. data/rdoc/files/lib/new_relic/control/rails_rb.html +108 -0
  171. data/rdoc/files/lib/new_relic/control/ruby_rb.html +110 -0
  172. data/rdoc/files/lib/new_relic/control/sinatra_rb.html +108 -0
  173. data/rdoc/files/lib/new_relic/control_rb.html +116 -0
  174. data/rdoc/files/lib/new_relic/delayed_job_injection_rb.html +180 -0
  175. data/rdoc/files/lib/new_relic/histogram_rb.html +114 -0
  176. data/rdoc/files/lib/new_relic/local_environment_rb.html +111 -0
  177. data/rdoc/files/lib/new_relic/merbtasks_rb.html +101 -0
  178. data/rdoc/files/lib/new_relic/metric_data_rb.html +101 -0
  179. data/rdoc/files/lib/new_relic/metric_parser/action_mailer_rb.html +101 -0
  180. data/rdoc/files/lib/new_relic/metric_parser/active_merchant_rb.html +101 -0
  181. data/rdoc/files/lib/new_relic/metric_parser/active_record_rb.html +101 -0
  182. data/rdoc/files/lib/new_relic/metric_parser/controller_cpu_rb.html +101 -0
  183. data/rdoc/files/lib/new_relic/metric_parser/controller_rb.html +101 -0
  184. data/rdoc/files/lib/new_relic/metric_parser/errors_rb.html +101 -0
  185. data/rdoc/files/lib/new_relic/metric_parser/external_rb.html +101 -0
  186. data/rdoc/files/lib/new_relic/metric_parser/mem_cache_rb.html +101 -0
  187. data/rdoc/files/lib/new_relic/metric_parser/other_transaction_rb.html +108 -0
  188. data/rdoc/files/lib/new_relic/metric_parser/view_rb.html +101 -0
  189. data/rdoc/files/lib/new_relic/metric_parser/web_frontend_rb.html +107 -0
  190. data/rdoc/files/lib/new_relic/metric_parser/web_service_rb.html +101 -0
  191. data/rdoc/files/lib/new_relic/metric_parser_rb.html +101 -0
  192. data/rdoc/files/lib/new_relic/metric_spec_rb.html +108 -0
  193. data/rdoc/files/lib/new_relic/metrics_rb.html +101 -0
  194. data/rdoc/files/lib/new_relic/noticed_error_rb.html +107 -0
  195. data/rdoc/files/lib/new_relic/rack/metric_app_rb.html +108 -0
  196. data/rdoc/files/lib/new_relic/rack_app_rb.html +110 -0
  197. data/rdoc/files/lib/new_relic/recipes_rb.html +128 -0
  198. data/rdoc/files/lib/new_relic/stats_rb.html +101 -0
  199. data/rdoc/files/lib/new_relic/transaction_analysis_rb.html +108 -0
  200. data/rdoc/files/lib/new_relic/transaction_sample_rb.html +101 -0
  201. data/rdoc/files/lib/new_relic/version_rb.html +101 -0
  202. data/rdoc/files/lib/new_relic_api_rb.html +145 -0
  203. data/rdoc/files/lib/newrelic_rpm_rb.html +147 -0
  204. data/rdoc/files/lib/tasks/all_rb.html +107 -0
  205. data/rdoc/fr_class_index.html +134 -0
  206. data/rdoc/fr_file_index.html +103 -0
  207. data/rdoc/fr_method_index.html +568 -0
  208. data/rdoc/index.html +24 -0
  209. data/rdoc/rdoc-style.css +208 -0
  210. data/test/new_relic/agent/active_record_instrumentation_test.rb +16 -5
  211. data/test/new_relic/agent/collection_helper_test.rb +1 -1
  212. data/test/new_relic/agent/error_collector_test.rb +2 -4
  213. data/test/new_relic/agent/rpm_agent_test.rb +1 -1
  214. data/test/new_relic/agent/task_instrumentation_test.rb +1 -1
  215. data/test/new_relic/agent/worker_loop_test.rb +33 -76
  216. data/test/new_relic/control_test.rb +9 -2
  217. data/test/new_relic/stats_test.rb +29 -1
  218. data/test/new_relic/version_number_test.rb +13 -0
  219. data/ui/helpers/newrelic_helper.rb +1 -2
  220. metadata +196 -4
@@ -0,0 +1,505 @@
1
+ <?xml version="1.0" encoding="iso-8859-1"?>
2
+ <!DOCTYPE html
3
+ PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5
+
6
+ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
7
+ <head>
8
+ <title>Class: NewRelic::Agent::TransactionSampleBuilder</title>
9
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
10
+ <meta http-equiv="Content-Script-Type" content="text/javascript" />
11
+ <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
12
+ <script type="text/javascript">
13
+ // <![CDATA[
14
+
15
+ function popupCode( url ) {
16
+ window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
17
+ }
18
+
19
+ function toggleCode( id ) {
20
+ if ( document.getElementById )
21
+ elem = document.getElementById( id );
22
+ else if ( document.all )
23
+ elem = eval( "document.all." + id );
24
+ else
25
+ return false;
26
+
27
+ elemStyle = elem.style;
28
+
29
+ if ( elemStyle.display != "block" ) {
30
+ elemStyle.display = "block"
31
+ } else {
32
+ elemStyle.display = "none"
33
+ }
34
+
35
+ return true;
36
+ }
37
+
38
+ // Make codeblocks hidden by default
39
+ document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
40
+
41
+ // ]]>
42
+ </script>
43
+
44
+ </head>
45
+ <body>
46
+
47
+
48
+
49
+ <div id="classHeader">
50
+ <table class="header-table">
51
+ <tr class="top-aligned-row">
52
+ <td><strong>Class</strong></td>
53
+ <td class="class-name-in-header">NewRelic::Agent::TransactionSampleBuilder</td>
54
+ </tr>
55
+ <tr class="top-aligned-row">
56
+ <td><strong>In:</strong></td>
57
+ <td>
58
+ <a href="../../../files/lib/new_relic/agent/transaction_sampler_rb.html">
59
+ lib/new_relic/agent/transaction_sampler.rb
60
+ </a>
61
+ <br />
62
+ </td>
63
+ </tr>
64
+
65
+ <tr class="top-aligned-row">
66
+ <td><strong>Parent:</strong></td>
67
+ <td>
68
+ Object
69
+ </td>
70
+ </tr>
71
+ </table>
72
+ </div>
73
+ <!-- banner header -->
74
+
75
+ <div id="bodyContent">
76
+
77
+
78
+
79
+ <div id="contextContent">
80
+
81
+ <div id="description">
82
+ <p>
83
+ a builder is created with every sampled transaction, to dynamically
84
+ generate the sampled data. It is a thread-local object, and is not accessed
85
+ by any other thread so no need for synchronization.
86
+ </p>
87
+
88
+ </div>
89
+
90
+
91
+ </div>
92
+
93
+ <div id="method-list">
94
+ <h3 class="section-bar">Methods</h3>
95
+
96
+ <div class="name-list">
97
+ <a href="#M000277">finish_trace</a>&nbsp;&nbsp;
98
+ <a href="#M000279">freeze</a>&nbsp;&nbsp;
99
+ <a href="#M000274">ignore_transaction</a>&nbsp;&nbsp;
100
+ <a href="#M000273">ignored?</a>&nbsp;&nbsp;
101
+ <a href="#M000271">new</a>&nbsp;&nbsp;
102
+ <a href="#M000283">sample</a>&nbsp;&nbsp;
103
+ <a href="#M000272">sample_id</a>&nbsp;&nbsp;
104
+ <a href="#M000278">scope_depth</a>&nbsp;&nbsp;
105
+ <a href="#M000280">set_profile</a>&nbsp;&nbsp;
106
+ <a href="#M000282">set_transaction_cpu_time</a>&nbsp;&nbsp;
107
+ <a href="#M000281">set_transaction_info</a>&nbsp;&nbsp;
108
+ <a href="#M000275">trace_entry</a>&nbsp;&nbsp;
109
+ <a href="#M000276">trace_exit</a>&nbsp;&nbsp;
110
+ </div>
111
+ </div>
112
+
113
+ </div>
114
+
115
+
116
+ <!-- if includes -->
117
+ <div id="includes">
118
+ <h3 class="section-bar">Included Modules</h3>
119
+
120
+ <div id="includes-list">
121
+ <span class="include-name"><a href="CollectionHelper.html">CollectionHelper</a></span>
122
+ </div>
123
+ </div>
124
+
125
+ <div id="section">
126
+
127
+
128
+
129
+
130
+
131
+ <div id="attribute-list">
132
+ <h3 class="section-bar">Attributes</h3>
133
+
134
+ <div class="name-list">
135
+ <table>
136
+ <tr class="top-aligned-row context-row">
137
+ <td class="context-item-name">current_segment</td>
138
+ <td class="context-item-value">&nbsp;[R]&nbsp;</td>
139
+ <td class="context-item-desc"></td>
140
+ </tr>
141
+ <tr class="top-aligned-row context-row">
142
+ <td class="context-item-name">sample</td>
143
+ <td class="context-item-value">&nbsp;[R]&nbsp;</td>
144
+ <td class="context-item-desc"></td>
145
+ </tr>
146
+ </table>
147
+ </div>
148
+ </div>
149
+
150
+
151
+
152
+ <!-- if method_list -->
153
+ <div id="methods">
154
+ <h3 class="section-bar">Public Class methods</h3>
155
+
156
+ <div id="method-M000271" class="method-detail">
157
+ <a name="M000271"></a>
158
+
159
+ <div class="method-heading">
160
+ <a href="#M000271" class="method-signature">
161
+ <span class="method-name">new</span><span class="method-args">(time=nil)</span>
162
+ </a>
163
+ </div>
164
+
165
+ <div class="method-description">
166
+ <p><a class="source-toggle" href="#"
167
+ onclick="toggleCode('M000271-source');return false;">[Source]</a></p>
168
+ <div class="method-source-code" id="M000271-source">
169
+ <pre>
170
+ <span class="ruby-comment cmt"># File lib/new_relic/agent/transaction_sampler.rb, line 228</span>
171
+ <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">time</span>=<span class="ruby-keyword kw">nil</span>)
172
+ <span class="ruby-identifier">time</span> <span class="ruby-operator">||=</span> <span class="ruby-constant">Time</span>.<span class="ruby-identifier">now</span>.<span class="ruby-identifier">to_f</span>
173
+ <span class="ruby-ivar">@sample</span> = <span class="ruby-constant">NewRelic</span><span class="ruby-operator">::</span><span class="ruby-constant">TransactionSample</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">time</span>)
174
+ <span class="ruby-ivar">@sample_start</span> = <span class="ruby-identifier">time</span>
175
+ <span class="ruby-ivar">@current_segment</span> = <span class="ruby-ivar">@sample</span>.<span class="ruby-identifier">root_segment</span>
176
+ <span class="ruby-keyword kw">end</span>
177
+ </pre>
178
+ </div>
179
+ </div>
180
+ </div>
181
+
182
+ <h3 class="section-bar">Public Instance methods</h3>
183
+
184
+ <div id="method-M000277" class="method-detail">
185
+ <a name="M000277"></a>
186
+
187
+ <div class="method-heading">
188
+ <a href="#M000277" class="method-signature">
189
+ <span class="method-name">finish_trace</span><span class="method-args">(time)</span>
190
+ </a>
191
+ </div>
192
+
193
+ <div class="method-description">
194
+ <p><a class="source-toggle" href="#"
195
+ onclick="toggleCode('M000277-source');return false;">[Source]</a></p>
196
+ <div class="method-source-code" id="M000277-source">
197
+ <pre>
198
+ <span class="ruby-comment cmt"># File lib/new_relic/agent/transaction_sampler.rb, line 258</span>
199
+ <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">finish_trace</span>(<span class="ruby-identifier">time</span>)
200
+ <span class="ruby-comment cmt"># This should never get called twice, but in a rare case that we can't reproduce in house it does.</span>
201
+ <span class="ruby-comment cmt"># log forensics and return gracefully</span>
202
+ <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@sample</span>.<span class="ruby-identifier">frozen?</span>
203
+ <span class="ruby-identifier">log</span> = <span class="ruby-constant">NewRelic</span><span class="ruby-operator">::</span><span class="ruby-constant">Control</span>.<span class="ruby-identifier">instance</span>.<span class="ruby-identifier">log</span>
204
+ <span class="ruby-identifier">log</span>.<span class="ruby-identifier">error</span> <span class="ruby-node">&quot;Unexpected double-freeze of Transaction Trace Object: \n#{@sample.to_s}&quot;</span>
205
+ <span class="ruby-keyword kw">return</span>
206
+ <span class="ruby-keyword kw">end</span>
207
+ <span class="ruby-ivar">@sample</span>.<span class="ruby-identifier">root_segment</span>.<span class="ruby-identifier">end_trace</span>(<span class="ruby-identifier">time</span> <span class="ruby-operator">-</span> <span class="ruby-ivar">@sample_start</span>)
208
+ <span class="ruby-ivar">@sample</span>.<span class="ruby-identifier">params</span>[<span class="ruby-identifier">:custom_params</span>] = <span class="ruby-identifier">normalize_params</span>(<span class="ruby-constant">NewRelic</span><span class="ruby-operator">::</span><span class="ruby-constant">Agent</span><span class="ruby-operator">::</span><span class="ruby-constant">Instrumentation</span><span class="ruby-operator">::</span><span class="ruby-constant">MetricFrame</span>.<span class="ruby-identifier">custom_parameters</span>)
209
+ <span class="ruby-ivar">@sample</span>.<span class="ruby-identifier">freeze</span>
210
+ <span class="ruby-ivar">@current_segment</span> = <span class="ruby-keyword kw">nil</span>
211
+ <span class="ruby-keyword kw">end</span>
212
+ </pre>
213
+ </div>
214
+ </div>
215
+ </div>
216
+
217
+ <div id="method-M000279" class="method-detail">
218
+ <a name="M000279"></a>
219
+
220
+ <div class="method-heading">
221
+ <a href="#M000279" class="method-signature">
222
+ <span class="method-name">freeze</span><span class="method-args">()</span>
223
+ </a>
224
+ </div>
225
+
226
+ <div class="method-description">
227
+ <p><a class="source-toggle" href="#"
228
+ onclick="toggleCode('M000279-source');return false;">[Source]</a></p>
229
+ <div class="method-source-code" id="M000279-source">
230
+ <pre>
231
+ <span class="ruby-comment cmt"># File lib/new_relic/agent/transaction_sampler.rb, line 284</span>
232
+ <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">freeze</span>
233
+ <span class="ruby-ivar">@sample</span>.<span class="ruby-identifier">freeze</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">sample</span>.<span class="ruby-identifier">frozen?</span>
234
+ <span class="ruby-keyword kw">end</span>
235
+ </pre>
236
+ </div>
237
+ </div>
238
+ </div>
239
+
240
+ <div id="method-M000274" class="method-detail">
241
+ <a name="M000274"></a>
242
+
243
+ <div class="method-heading">
244
+ <a href="#M000274" class="method-signature">
245
+ <span class="method-name">ignore_transaction</span><span class="method-args">()</span>
246
+ </a>
247
+ </div>
248
+
249
+ <div class="method-description">
250
+ <p><a class="source-toggle" href="#"
251
+ onclick="toggleCode('M000274-source');return false;">[Source]</a></p>
252
+ <div class="method-source-code" id="M000274-source">
253
+ <pre>
254
+ <span class="ruby-comment cmt"># File lib/new_relic/agent/transaction_sampler.rb, line 241</span>
255
+ <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">ignore_transaction</span>
256
+ <span class="ruby-ivar">@ignore</span> = <span class="ruby-keyword kw">true</span>
257
+ <span class="ruby-keyword kw">end</span>
258
+ </pre>
259
+ </div>
260
+ </div>
261
+ </div>
262
+
263
+ <div id="method-M000273" class="method-detail">
264
+ <a name="M000273"></a>
265
+
266
+ <div class="method-heading">
267
+ <a href="#M000273" class="method-signature">
268
+ <span class="method-name">ignored?</span><span class="method-args">()</span>
269
+ </a>
270
+ </div>
271
+
272
+ <div class="method-description">
273
+ <p><a class="source-toggle" href="#"
274
+ onclick="toggleCode('M000273-source');return false;">[Source]</a></p>
275
+ <div class="method-source-code" id="M000273-source">
276
+ <pre>
277
+ <span class="ruby-comment cmt"># File lib/new_relic/agent/transaction_sampler.rb, line 238</span>
278
+ <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">ignored?</span>
279
+ <span class="ruby-ivar">@ignore</span> <span class="ruby-operator">||</span> <span class="ruby-ivar">@sample</span>.<span class="ruby-identifier">params</span>[<span class="ruby-identifier">:path</span>].<span class="ruby-identifier">nil?</span>
280
+ <span class="ruby-keyword kw">end</span>
281
+ </pre>
282
+ </div>
283
+ </div>
284
+ </div>
285
+
286
+ <div id="method-M000283" class="method-detail">
287
+ <a name="M000283"></a>
288
+
289
+ <div class="method-heading">
290
+ <a href="#M000283" class="method-signature">
291
+ <span class="method-name">sample</span><span class="method-args">()</span>
292
+ </a>
293
+ </div>
294
+
295
+ <div class="method-description">
296
+ <p><a class="source-toggle" href="#"
297
+ onclick="toggleCode('M000283-source');return false;">[Source]</a></p>
298
+ <div class="method-source-code" id="M000283-source">
299
+ <pre>
300
+ <span class="ruby-comment cmt"># File lib/new_relic/agent/transaction_sampler.rb, line 309</span>
301
+ <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">sample</span>
302
+ <span class="ruby-ivar">@sample</span>
303
+ <span class="ruby-keyword kw">end</span>
304
+ </pre>
305
+ </div>
306
+ </div>
307
+ </div>
308
+
309
+ <div id="method-M000272" class="method-detail">
310
+ <a name="M000272"></a>
311
+
312
+ <div class="method-heading">
313
+ <a href="#M000272" class="method-signature">
314
+ <span class="method-name">sample_id</span><span class="method-args">()</span>
315
+ </a>
316
+ </div>
317
+
318
+ <div class="method-description">
319
+ <p><a class="source-toggle" href="#"
320
+ onclick="toggleCode('M000272-source');return false;">[Source]</a></p>
321
+ <div class="method-source-code" id="M000272-source">
322
+ <pre>
323
+ <span class="ruby-comment cmt"># File lib/new_relic/agent/transaction_sampler.rb, line 235</span>
324
+ <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">sample_id</span>
325
+ <span class="ruby-ivar">@sample</span>.<span class="ruby-identifier">sample_id</span>
326
+ <span class="ruby-keyword kw">end</span>
327
+ </pre>
328
+ </div>
329
+ </div>
330
+ </div>
331
+
332
+ <div id="method-M000278" class="method-detail">
333
+ <a name="M000278"></a>
334
+
335
+ <div class="method-heading">
336
+ <a href="#M000278" class="method-signature">
337
+ <span class="method-name">scope_depth</span><span class="method-args">()</span>
338
+ </a>
339
+ </div>
340
+
341
+ <div class="method-description">
342
+ <p><a class="source-toggle" href="#"
343
+ onclick="toggleCode('M000278-source');return false;">[Source]</a></p>
344
+ <div class="method-source-code" id="M000278-source">
345
+ <pre>
346
+ <span class="ruby-comment cmt"># File lib/new_relic/agent/transaction_sampler.rb, line 272</span>
347
+ <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">scope_depth</span>
348
+ <span class="ruby-identifier">depth</span> = <span class="ruby-value">-1</span> <span class="ruby-comment cmt"># have to account for the root</span>
349
+ <span class="ruby-identifier">current</span> = <span class="ruby-ivar">@current_segment</span>
350
+
351
+ <span class="ruby-keyword kw">while</span>(<span class="ruby-identifier">current</span>)
352
+ <span class="ruby-identifier">depth</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
353
+ <span class="ruby-identifier">current</span> = <span class="ruby-identifier">current</span>.<span class="ruby-identifier">parent_segment</span>
354
+ <span class="ruby-keyword kw">end</span>
355
+
356
+ <span class="ruby-identifier">depth</span>
357
+ <span class="ruby-keyword kw">end</span>
358
+ </pre>
359
+ </div>
360
+ </div>
361
+ </div>
362
+
363
+ <div id="method-M000280" class="method-detail">
364
+ <a name="M000280"></a>
365
+
366
+ <div class="method-heading">
367
+ <a href="#M000280" class="method-signature">
368
+ <span class="method-name">set_profile</span><span class="method-args">(profile)</span>
369
+ </a>
370
+ </div>
371
+
372
+ <div class="method-description">
373
+ <p><a class="source-toggle" href="#"
374
+ onclick="toggleCode('M000280-source');return false;">[Source]</a></p>
375
+ <div class="method-source-code" id="M000280-source">
376
+ <pre>
377
+ <span class="ruby-comment cmt"># File lib/new_relic/agent/transaction_sampler.rb, line 288</span>
378
+ <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">set_profile</span>(<span class="ruby-identifier">profile</span>)
379
+ <span class="ruby-ivar">@sample</span>.<span class="ruby-identifier">profile</span> = <span class="ruby-identifier">profile</span>
380
+ <span class="ruby-keyword kw">end</span>
381
+ </pre>
382
+ </div>
383
+ </div>
384
+ </div>
385
+
386
+ <div id="method-M000282" class="method-detail">
387
+ <a name="M000282"></a>
388
+
389
+ <div class="method-heading">
390
+ <a href="#M000282" class="method-signature">
391
+ <span class="method-name">set_transaction_cpu_time</span><span class="method-args">(cpu_time)</span>
392
+ </a>
393
+ </div>
394
+
395
+ <div class="method-description">
396
+ <p><a class="source-toggle" href="#"
397
+ onclick="toggleCode('M000282-source');return false;">[Source]</a></p>
398
+ <div class="method-source-code" id="M000282-source">
399
+ <pre>
400
+ <span class="ruby-comment cmt"># File lib/new_relic/agent/transaction_sampler.rb, line 305</span>
401
+ <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">set_transaction_cpu_time</span>(<span class="ruby-identifier">cpu_time</span>)
402
+ <span class="ruby-ivar">@sample</span>.<span class="ruby-identifier">params</span>[<span class="ruby-identifier">:cpu_time</span>] = <span class="ruby-identifier">cpu_time</span>
403
+ <span class="ruby-keyword kw">end</span>
404
+ </pre>
405
+ </div>
406
+ </div>
407
+ </div>
408
+
409
+ <div id="method-M000281" class="method-detail">
410
+ <a name="M000281"></a>
411
+
412
+ <div class="method-heading">
413
+ <a href="#M000281" class="method-signature">
414
+ <span class="method-name">set_transaction_info</span><span class="method-args">(path, uri, params)</span>
415
+ </a>
416
+ </div>
417
+
418
+ <div class="method-description">
419
+ <p><a class="source-toggle" href="#"
420
+ onclick="toggleCode('M000281-source');return false;">[Source]</a></p>
421
+ <div class="method-source-code" id="M000281-source">
422
+ <pre>
423
+ <span class="ruby-comment cmt"># File lib/new_relic/agent/transaction_sampler.rb, line 292</span>
424
+ <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">set_transaction_info</span>(<span class="ruby-identifier">path</span>, <span class="ruby-identifier">uri</span>, <span class="ruby-identifier">params</span>)
425
+ <span class="ruby-ivar">@sample</span>.<span class="ruby-identifier">params</span>[<span class="ruby-identifier">:path</span>] = <span class="ruby-identifier">path</span>
426
+
427
+ <span class="ruby-keyword kw">if</span> <span class="ruby-constant">NewRelic</span><span class="ruby-operator">::</span><span class="ruby-constant">Control</span>.<span class="ruby-identifier">instance</span>.<span class="ruby-identifier">capture_params</span>
428
+ <span class="ruby-identifier">params</span> = <span class="ruby-identifier">normalize_params</span> <span class="ruby-identifier">params</span>
429
+
430
+ <span class="ruby-ivar">@sample</span>.<span class="ruby-identifier">params</span>[<span class="ruby-identifier">:request_params</span>].<span class="ruby-identifier">merge!</span>(<span class="ruby-identifier">params</span>)
431
+ <span class="ruby-ivar">@sample</span>.<span class="ruby-identifier">params</span>[<span class="ruby-identifier">:request_params</span>].<span class="ruby-identifier">delete</span> <span class="ruby-identifier">:controller</span>
432
+ <span class="ruby-ivar">@sample</span>.<span class="ruby-identifier">params</span>[<span class="ruby-identifier">:request_params</span>].<span class="ruby-identifier">delete</span> <span class="ruby-identifier">:action</span>
433
+ <span class="ruby-keyword kw">end</span>
434
+ <span class="ruby-ivar">@sample</span>.<span class="ruby-identifier">params</span>[<span class="ruby-identifier">:uri</span>] <span class="ruby-operator">||=</span> <span class="ruby-identifier">uri</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">params</span>[<span class="ruby-identifier">:uri</span>]
435
+ <span class="ruby-keyword kw">end</span>
436
+ </pre>
437
+ </div>
438
+ </div>
439
+ </div>
440
+
441
+ <div id="method-M000275" class="method-detail">
442
+ <a name="M000275"></a>
443
+
444
+ <div class="method-heading">
445
+ <a href="#M000275" class="method-signature">
446
+ <span class="method-name">trace_entry</span><span class="method-args">(metric_name, time)</span>
447
+ </a>
448
+ </div>
449
+
450
+ <div class="method-description">
451
+ <p><a class="source-toggle" href="#"
452
+ onclick="toggleCode('M000275-source');return false;">[Source]</a></p>
453
+ <div class="method-source-code" id="M000275-source">
454
+ <pre>
455
+ <span class="ruby-comment cmt"># File lib/new_relic/agent/transaction_sampler.rb, line 244</span>
456
+ <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">trace_entry</span>(<span class="ruby-identifier">metric_name</span>, <span class="ruby-identifier">time</span>)
457
+ <span class="ruby-identifier">segment</span> = <span class="ruby-ivar">@sample</span>.<span class="ruby-identifier">create_segment</span>(<span class="ruby-identifier">time</span> <span class="ruby-operator">-</span> <span class="ruby-ivar">@sample_start</span>, <span class="ruby-identifier">metric_name</span>)
458
+ <span class="ruby-ivar">@current_segment</span>.<span class="ruby-identifier">add_called_segment</span>(<span class="ruby-identifier">segment</span>)
459
+ <span class="ruby-ivar">@current_segment</span> = <span class="ruby-identifier">segment</span>
460
+ <span class="ruby-keyword kw">end</span>
461
+ </pre>
462
+ </div>
463
+ </div>
464
+ </div>
465
+
466
+ <div id="method-M000276" class="method-detail">
467
+ <a name="M000276"></a>
468
+
469
+ <div class="method-heading">
470
+ <a href="#M000276" class="method-signature">
471
+ <span class="method-name">trace_exit</span><span class="method-args">(metric_name, time)</span>
472
+ </a>
473
+ </div>
474
+
475
+ <div class="method-description">
476
+ <p><a class="source-toggle" href="#"
477
+ onclick="toggleCode('M000276-source');return false;">[Source]</a></p>
478
+ <div class="method-source-code" id="M000276-source">
479
+ <pre>
480
+ <span class="ruby-comment cmt"># File lib/new_relic/agent/transaction_sampler.rb, line 250</span>
481
+ <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">trace_exit</span>(<span class="ruby-identifier">metric_name</span>, <span class="ruby-identifier">time</span>)
482
+ <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">metric_name</span> <span class="ruby-operator">!=</span> <span class="ruby-ivar">@current_segment</span>.<span class="ruby-identifier">metric_name</span>
483
+ <span class="ruby-identifier">fail</span> <span class="ruby-node">&quot;unbalanced entry/exit: #{metric_name} != #{@current_segment.metric_name}&quot;</span>
484
+ <span class="ruby-keyword kw">end</span>
485
+ <span class="ruby-ivar">@current_segment</span>.<span class="ruby-identifier">end_trace</span>(<span class="ruby-identifier">time</span> <span class="ruby-operator">-</span> <span class="ruby-ivar">@sample_start</span>)
486
+ <span class="ruby-ivar">@current_segment</span> = <span class="ruby-ivar">@current_segment</span>.<span class="ruby-identifier">parent_segment</span>
487
+ <span class="ruby-keyword kw">end</span>
488
+ </pre>
489
+ </div>
490
+ </div>
491
+ </div>
492
+
493
+
494
+ </div>
495
+
496
+
497
+ </div>
498
+
499
+
500
+ <div id="validator-badges">
501
+ <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
502
+ </div>
503
+
504
+ </body>
505
+ </html>