Module: ActiveSupport::Benchmarkable
Relationships & Source Files | |
Extension / Inclusion / Inheritance Descendants | |
Extended In:
| |
Included In:
::ActionController::API ,
::ActionController::Base ,
ActionDispatch::DebugView,
::ActionView::Base ,
::ActionView::Helpers ,
::ActionView::TestCase ,
::ActionView::TestCase::Behavior ,
::ActionView::TestCase::TestController ,
Rails::ApplicationController,
::Rails::HealthController ,
Rails::InfoController,
Rails::MailersController,
Rails::WelcomeController
| |
Defined in: | activesupport/lib/active_support/benchmarkable.rb |
Overview
Benchmarkable
Instance Method Summary
-
#benchmark(message = "Benchmarking", options = {}, &block)
Allows you to measure the execution time of a block in a template and records the result to the log.
Instance Method Details
#benchmark(message = "Benchmarking", options = {}, &block)
Allows you to measure the execution time of a block in a template and records the result to the log. Wrap this block around expensive operations or possible bottlenecks to get a time reading for the operation. For example, let’s say you thought your file processing method was taking too long; you could wrap it in a benchmark block.
<% benchmark 'Process data files' do %>
<%= expensive_files_operation %>
<% end %>
That would add something like “Process data files (345.2ms)” to the log, which you can then use to compare timings when optimizing your code.
You may give an optional logger level (:debug
, :info
, :warn
, :error
) as the :level
option. The default logger level value is :info
.
<% benchmark 'Low-level files', level: :debug do %>
<%= lowlevel_files_operation %>
<% end %>
Finally, you can pass true as the third argument to silence all log activity (other than the timing information) from inside the block. This is great for boiling down a noisy block to just a single statement that produces one log line:
<% benchmark 'Process data files', level: :info, silence: true do %>
<%= expensive_and_chatty_files_operation %>
<% end %>
# File 'activesupport/lib/active_support/benchmarkable.rb', line 38
def benchmark( = "Benchmarking", = {}, &block) if logger .assert_valid_keys(:level, :silence) [:level] ||= :info result = nil ms = Benchmark.ms { result = [:silence] ? logger.silence(&block) : yield } logger.public_send( [:level], "%s (%.1fms)" % [ , ms ]) result else yield end end