rubyrun 0.9.5-x86-linux

data/lib/rubyrun/rubyrun_buffer_mgr__.rb

@@ -0,0 +1,49 @@
+#--------------------------------------------------------------------#
+#                                                                    #  
+#  (C) Copyright Rubysophic Inc. 2007-2008                           #
+#  All rights reserved.                                              #
+#                                                                    #  
+#  Use, duplication or disclosure of the code is not permitted       #
+#  unless licensed.                                                  #
+#                                                                    #
+#  Last Updated: 7/09/08                                             #  
+#--------------------------------------------------------------------#
+#                                                               	   #  
+#  RubyRunBufferMgr__ module is responsible for passing the data     #
+#  from the inline execution thread to the monitor thread 		       #
+#                                                                    #
+#  Two buffers (primary and secondary) are used and the buffers are  #
+#  swapped between the inline execution thread and RubyRunMonitor__  #
+#  thread periodically as defined by REPORT_TIMER. The inline        #
+#  execution thread pushes data into the primary buffer, when the    #
+#  REPORT_TIMER expires, RubyRunMonitor__ thread then takes it over  #
+#  and gives the inline execution thread the secondary buffer via    #
+#  a quick swap. The same process keeps repeating as the monitor     #
+#  timer pops and the primary and secondary keep switched between    #
+#  the two threads.								                                   #
+#                                                               	   #  
+#--------------------------------------------------------------------#
+module RubyRunBufferMgr__
+  
+  # Push data into the current buffer
+  # Primary or secondary buffer may be used but it is transparent to the caller
+  def push_current_buffer(metrics)
+    $rubyrun_lock.synchronize {
+      ($rubyrun_current_buffer == 1 ? $rubyrun_prime_buffer : $rubyrun_alt_buffer) << metrics
+    }
+  end
+  
+  # Return the current buffer and swap it with the other one
+  # This method is invoked by the consumer of the data in the buffer
+  def return_and_switch_buffer()
+    $rubyrun_lock.synchronize {
+      if ($rubyrun_current_buffer == 1)
+        $rubyrun_current_buffer == 2
+        $rubyrun_prime_buffer
+      else
+        $rubyrun_current_buffer == 1
+        $rubyrun_alt_buffer
+      end
+    }
+  end
+end

data/lib/rubyrun/rubyrun_commander__.rb

@@ -0,0 +1,196 @@
+#-----------------------------------------------------------------#
+#                                                                 #  
+#  (C) Copyright Rubysophic Inc. 2007-2008                        #
+#  All rights reserved.                                           #
+#                                                                 #  
+#  Use, duplication or disclosure of the code is not permitted    #
+#  unless licensed.                                               #
+#                                                                 #            
+#  Last Updated: 7/18/08                                          #  
+#-----------------------------------------------------------------#
+#                                                                 #  
+# RubyRunCommander__ is a module which handles the commands       #
+# cmd_status, cmd_object_map, cmd_soft_kill and cmd_hard_kill     #
+#                                                                 #   
+#-----------------------------------------------------------------#
+module RubyRunCommander__
+  
+  # Use Thread.list to list show thread status, and native code to 
+  # display the last line # and function of the threads
+  def dump_thread_status
+    (unsupport_function; return) unless $rubyrun_native
+    $rubyrun_thread_status_reporter = RubyRunHTMLWriter.new(@rubyrun_report_folder + '/' + File.basename($0, ".*") + '_' + $$.to_s + '_thread_status.html', nil, shift_age = 10, shift_size = 4096000) unless $rubyrun_thread_status_reporter
+    start_time = Time.now
+    th_data_hash = RubyRunNative__.get_all_top_stacks
+    odd_row ||= true
+    table_content = ''
+    Thread.list.each {|th|
+      thread_id = get_thread_id(th)
+      table_content += sprintf("#{odd_row ? THREAD_STATUS_ODD_ROW : THREAD_STATUS_EVEN_ROW}",
+                              thread_id, th.status, get_top_stack(th_data_hash, thread_id))
+      odd_row = !odd_row
+    }
+    html_content = THREAD_STATUS_HTML.sub(/%START_TIMESTAMP%/,start_time.strftime("%H:%M:%S %m/%d/%Y"))
+    html_content.sub!(/%THREAD_STATUS_ROW%/,table_content)
+    $rubyrun_thread_status_reporter.info(html_content)
+  end
+
+  # Dump Controller/Actions response time metrics
+  # metrics structure
+  # metrics[0] Thread ID            metrics[1] Timestamp of the request
+  # metrics[2] URL                  metrics[3] Controller name
+  # metrics[4] Action name          metrics[5] Response time
+  # metrics[6] Action time          metrics[7] Database IO time
+  # metrics[8] View time            metrics[9] Uncaptured time
+  # metrics[10] Dispatch wait time
+  def dump_reports(dump_all_reports = false)
+    buffer = return_and_switch_buffer
+    buffer.each { |metrics|
+      # Last element is 1, representing a request count of 1, used for calculating average response time for this controller/action
+      update_perf_metrics(metrics[3], {metrics[4] => [metrics[5],metrics[6],metrics[7],metrics[8],metrics[9],metrics[10],1]})
+    }
+    @rubyrun_req_count ||= 0
+    @rubyrun_req_count += buffer.length
+    if $rubyrun_config['OUTPUT'].include?(RUBYRUN_OUTPUT_PERF_SUMMARY) && dump_all_reports
+      create_rss_channels if (!$rubyrun_perf_summary_rss && $rubyrun_rails_env)
+      add_perf_summary_rss_item(@rubyrun_req_count)
+      @rubyrun_req_count = 0
+    end
+    if $rubyrun_config['OUTPUT'].include?(RUBYRUN_OUTPUT_TXN_LOG)
+      create_csv_files unless $rubyrun_txn_log_reporter
+      add_txn_log_csv_item(buffer)
+    end
+    buffer.clear # Clear the buffer so that the main thread will push the data into a blank bucket
+  end
+
+  # The way to do soft/hard kill is to performa a thr.raise on the thread 
+  # from the thread monitor. Using the begin/rescue created around the block
+  # in Thread.new by RubyRunInstrumentor__, the raise will be rescued
+  # and $@ is then extracted to a global hash.
+  # Softkill only kills non-main threads. Hardkill kills the main thread also
+  # but as the last step. 
+  def kill_threads(monitor_thr)
+    (unsupport_function; return) unless $rubyrun_native
+    if !$rubyrun_thread_dump_reporter
+      $rubyrun_thread_dump_reporter = Logger.new(@rubyrun_report_folder + '/' + File.basename($0, ".*") + '_' + $$.to_s + '_thread_dump.txt', shift_age = 10, shift_size = 4096000)
+      $rubyrun_thread_dump_reporter.level = Logger::INFO
+      class << $rubyrun_thread_dump_reporter
+        include RubyRunUtils__
+        def format_message (severity, timestamp, progname, msg)
+          "[#{timestamp.strftime("%Y-%m-%d %H:%M:%S")}.#{("%.3f" % timestamp.to_f).split('.')[1]}] #{get_thread_id} #{msg}\n"
+        end
+      end
+    end
+    th_data_hash = RubyRunNative__.get_all_top_stacks 
+    j_th_id = return_joined_thread(th_data_hash)
+    Thread.list.each {|th|
+      th_id = get_thread_id(th)
+      if th.status == 'sleep' && th_id != get_thread_id && th_id != get_thread_id(monitor_thr) &&
+        th_id != get_thread_id(Thread.main) && th_id != j_th_id
+        $rubyrun_thread_dump_reporter.info "*** Raising exception #{RUBYRUN_KILL_3_STRING} to #{get_thread_id(th)} ***"
+        th.raise ThreadError, RUBYRUN_KILL_3_STRING
+      end
+    }
+    sleep 3
+    back_trace_all(th_data_hash)
+    hard_kill = hard_kill?
+    remove_cmd_folder     
+    Thread.main.raise ThreadError, RUBYRUN_KILL_3_STRING if hard_kill    
+  end
+
+  # Show the top 20 Ruby classes which have the largest no. of instances in memory
+  # The snapshot is taken after a gc call is made
+  def dump_object_map
+    start_time = Time.now
+    $rubyrun_obj_map_reporter = RubyRunHTMLWriter.new(@rubyrun_report_folder + '/' + File.basename($0, ".*") + '_' + $$.to_s + '_object_map.html', nil, shift_age = 10, shift_size = 4096000) unless $rubyrun_obj_map_reporter
+    object_map = Hash.new
+    ttl_object = 0
+    ObjectSpace.garbage_collect
+    ObjectSpace.each_object { |obj|
+      ttl_object += 1
+      object_map.has_key?(obj.class) ? object_map[obj.class] += 1 : object_map[obj.class] = 1        
+    }
+    results = object_map.sort{|a,b| a[1]<=>b[1]}.reverse!
+    table_content = ''
+    odd_row ||=true
+    20.times {|i|
+      table_content += sprintf("#{odd_row ? OBJ_MAP_ODD_ROW : OBJ_MAP_EVEN_ROW}",
+                              results[i][0], results[i][1].to_s)
+      odd_row = !odd_row
+    }
+    html_content = OBJ_MAP_HTML.sub(/%START_TIMESTAMP%/,start_time.strftime("%H:%M:%S %m/%d/%Y"))
+    html_content.sub!(/%OBJ_MAP_ROW%/,table_content)
+    $rubyrun_obj_map_reporter.info(html_content)
+  end
+
+  # metrics hash is a global collection point for all metrics (averaged)
+  # for all actions by controller
+  # Use serialization before updating this global hash
+  # Structure of $rubyrun_metrics_hash:
+  # controller_name => {action_name => [response_time, action_time,
+  #                                     db_io_time, view_time,
+  #                                     uncaptured_time, dispatch_wait_time,
+  #                                     request_count]}
+  def update_perf_metrics(controller, action_metrics_hash)
+    $rubyrun_metrics_hash[controller].merge!(action_metrics_hash) {|action, o_metrics, new_metrics|
+      o_metrics.each_index { |x|
+        (o_metrics[x] += new_metrics[x]; break) if x == (o_metrics.length-1) # Calculate the total request count for this controller/action
+        o_metrics[x] = (o_metrics[x] * o_metrics.last + new_metrics[x])/(o_metrics.last + new_metrics.last).to_f
+      }
+      o_metrics
+    }
+  end
+
+  # If a thread is joined this method returns the joining thread ID
+  def return_joined_thread(th_data_hash)
+    th_data_hash.each {|th, top_stack|
+      if th.to_s.include?(get_thread_id(Thread.main))
+        top_stack[0] =~ /\*\*(.+?)\*\*/
+        return $1
+      end
+    }
+  end
+
+  # Remove the cmd_kill-3 folder or file if any
+  def remove_cmd_folder
+    [RUBYRUN_CMD_SOFT_KILL, RUBYRUN_CMD_HARD_KILL].each { |cmd|
+      path = $rubyrun_working_dir + cmd + '_' + Process.pid.to_s
+      next unless File.exist?(path)
+      File.directory?(path) ? Dir.delete(path) : File.delete(path)          
+    }
+  end
+  
+  # If exists, indicate to the monitor thread that a thread
+  # status report is requested
+  def thread_status?
+    File.exists?($rubyrun_working_dir + RUBYRUN_CMD_STATUS)   
+  end
+
+  # If exists, indicate to the monitor thread that a soft kill
+  # (kill all threads except the main thread) command is sent
+  def soft_kill?
+    File.exists?($rubyrun_working_dir + RUBYRUN_CMD_SOFT_KILL + '_' + Process.pid.to_s)   
+  end
+
+  # If exists, indicate to the monitor thread that a hard kill
+  # (kill all threads including the main thread) command is sent
+  def hard_kill?
+    File.exists?($rubyrun_working_dir + RUBYRUN_CMD_HARD_KILL + '_' + Process.pid.to_s)   
+  end  
+  
+  # If exists, indicate to the montior thread that a object map is requested
+  def object_map?
+    File.exists?($rubyrun_working_dir + RUBYRUN_CMD_OBJECT_MAP)   
+  end    
+
+  # If exists, indicate to the monitor thread to exit
+  def exit_monitor?
+    File.exists?($rubyrun_working_dir + RUBYRUN_CMD_EXIT)   
+  end
+
+  # Log if native library can't be loaded or not found
+  def unsupport_function
+    $rubyrun_logger.info "Native library not available. Function not supported."
+  end
+
+end

data/lib/rubyrun/rubyrun_dad__.rb

@@ -0,0 +1,35 @@
+#---------------------------------------------------------------#
+#                                                               #  
+#  (C) Copyright Rubysophic Inc. 2007-2008                      #
+#  All rights reserved.                                         #
+#                                                               #  
+#  Use, duplication or disclosure of the code is not permitted  #
+#  unless licensed.                                             #
+#  Dynamic Application Discovery                                #                        
+#                                                               #            
+#  Last Updated: 7/09/08                                        #  
+#---------------------------------------------------------------#
+#                                                               #            
+#  Dynamic Application Discovery lists out the name of a method #
+#  as it is being added to the ruby process.                    #
+#                                                               #            
+#---------------------------------------------------------------#
+module RubyRunDad__
+
+  # perform dynamic application discovery if requested by printing
+  # out the class and method name of the method being added 
+  def get_dad(type, klass, id)
+    print_method_added(type, klass, id) if $rubyrun_dad  
+  end
+
+  private
+
+  # print the dynamic method added message
+  def print_method_added(type, obj, id)
+    if type == 'i'
+      $rubyrun_logger.info "#{obj.to_s}.#{id.id2name} added as an instance method"
+    else 
+      $rubyrun_logger.info "#{obj.to_s}.#{id.id2name} added as an singleton method"
+    end    
+  end
+end

data/lib/rubyrun/rubyrun_globals.rb

@@ -0,0 +1,52 @@
+#---------------------------------------------------------------#
+#                                                               #  
+#  (C) Copyright Rubysophic Inc. 2007-2008                      #
+#  All rights reserved.                                         #
+#                                                               #  
+#  Use, duplication or disclosure of the code is not permitted  #
+#  unless licensed.                                             #
+#                                                               #            
+#  Last Updated: 7/09/08                                        #  
+#---------------------------------------------------------------#
+#                                                               #  
+#  Provide CONSTANTS for RubyRun modules                        #
+#                                                               #  
+#---------------------------------------------------------------#
+module RubyRunGlobals
+
+  RUBYRUN_PREFIX = 'rubyrunX'
+  RUBYRUN_PREFIX_LENGTH = RUBYRUN_PREFIX.length
+  RUBYRUN_HIGHLIGHT_THRESHOLD = 1 
+  RUBYRUN_FIREWALL_HASH = {"Gem" => [], "gem" => [], "FileUtils::Verbose" => [], "FileUtils" => [], 
+    "Module" => [], "Object" => [], "Time" => [], "Logger" => [], "Thread" => [],
+    "*" => ['method_added', 'initialize', 'singleton_method_added', 'send', 'caller']}
+  RUBYRUN_WORKING_DIR_NAME = 'rubyrun'
+  RUBYRUN_ETC_DIR = 'etc'
+  RUBYRUN_LOG = '/log'
+  RUBYRUN_REPORT = '/report'
+  RUBYRUN_SIGNATURE = '/signatures'
+  RUBYRUN_INCLUDE_HASH_FILE = '/include_hash_file'
+  RUBYRUN_EXCLUDE_HASH_FILE = '/exclude_hash_file'
+  RUBYRUN_DIR_HASH_FILE = '/dir_hash_file'
+  RUBYRUN_CMD_SOFT_KILL = '/cmd_soft_kill'
+  RUBYRUN_CMD_HARD_KILL = '/cmd_hard_kill'
+  RUBYRUN_CMD_STATUS = '/cmd_status'
+  RUBYRUN_CMD_EXIT = '/cmd_exit'
+  RUBYRUN_CMD_OBJECT_MAP = '/cmd_object_map'
+  RUBYRUN_MONITOR_TIMER = 10
+  RUBYRUN_OUTPUT_PERF_SUMMARY = 'perf_summary'
+  RUBYRUN_OUTPUT_TXN_LOG = 'txn_log'
+  RUBYRUN_KILL_3_STRING = 'RUBYRUN kill -3'
+  RUBYRUN_OPTS_FILE = '/rubyrun_opts.yml'
+  RUBYRUN_PROP_DEFAULTS = {"APP_PATHS"=>[], "EXCLUDE_HASH"=>{}, "INCLUDE_HASH"=>{},
+                           "DEBUG_ARGS"=>false, "DEBUG_OBJ"=>false, "DAD"=>false,
+                           "REPORT_TIMER"=>60, "REPORT_SHIFT_AGE"=>60,
+                           "OUTPUT" => ["#{RUBYRUN_OUTPUT_PERF_SUMMARY}","#{RUBYRUN_OUTPUT_TXN_LOG}","#{RUBYRUN_OUTPUT_PERF_SUMMARY}"],
+                           "RSS_PATH" => nil, "TRACE_HASH"=>{}, "DB_ADAPTER_HASH"=>{}}
+  RUBYRUN_ACTIVERECORD = 'ActiveRecord::Base'
+  RUBYRUN_VIEW_HASH = {'ActionView::Base' => ['pick_template_extension','render_file']}
+  RUBYRUN_THREAD_END_HASH = {'WEBrick::HTTPServer' => ['run'], 'Mongrel::HttpServer' => ['process_client']}
+  RUBYRUN_OUTER_DISPATCH_HASH = {'Mongrel::Rails::RailsHandler' => ['process'], 'DispatchServlet' => ['service']}
+  RUBYRUN_INNER_DISPATCH_HASH = { 'Dispatcher' => ['dispatch'], 'ActionController::Dispatcher' => ['dispatch']}
+
+end

data/lib/rubyrun/rubyrun_html__.rb

@@ -0,0 +1,136 @@
+#-----------------------------------------------------------------#
+#                                                                 #  
+#  (C) Copyright Rubysophic Inc. 2007-2008                        #
+#  All rights reserved.                                           #
+#                                                                 #  
+#  Use, duplication or disclosure of the code is not permitted    #
+#  unless licensed.                                               #
+#                                                                 #            
+#  Last Updated: 7/08/08                                          #  
+#-----------------------------------------------------------------#
+#                                                                 #  
+# RubyRunHTML__ defines HTML templates and assigns them to        #
+# various constants to be used by other reporter modules.         #
+# The templates include thread status, method trace and RSS       #
+# content.                                                        #
+#                                                                 #  
+#-----------------------------------------------------------------#
+module RubyRunHTML__
+  OBJ_MAP_HTML = "<table cellspacing='2' width='55%'>
+                        <tr align='middle' bgcolor='#43bfc7'>
+                        <th colspan='2'><font face='Helvetica' size='2' color='white'>Top 20 Ruby classes with the largest number of objects (%START_TIMESTAMP%)</font></th></tr>       
+                        <tr align='middle' bgcolor='#43bfc7'>    
+                        <th><font face='Helvetica' size='2' color='white'>Class name</font></th>       
+                        <th><font face='Helvetica' size='2' color='white'>Number of objects</font></th>
+                        %OBJ_MAP_ROW%
+                        </table><br></br>"
+  OBJ_MAP_ODD_ROW = "<tr align='middle'>
+                <td align='left' bgcolor='#afdcec'><font face='Tahoma' size='2' color='black'>%s</font></td>
+                <td align='left' bgcolor='#afdcec'><font face='Tahoma' size='2' color='black'>%s</font></td>"
+  OBJ_MAP_EVEN_ROW = "<tr align='middle'>
+                <td align='left'><font face='Tahoma' size='2' color='black'>%s</font></td>
+                <td align='left'><font face='Tahoma' size='2' color='black'>%s</font></td>"
+  THREAD_STATUS_HTML = "<table cellspacing='2' width='100%'>
+                        <tr align='middle' bgcolor='#43bfc7'>
+                        <th colspan='3'><font face='Helvetica' size='2' color='white'>RubyRun Thread Status Starts (%START_TIMESTAMP%)</font></th>       
+                        <tr align='middle' bgcolor='#43bfc7'>    
+                        <th><font face='Helvetica' size='2' color='white'>Thread ID</font></th>       
+                        <th><font face='Helvetica' size='2' color='white'>Status</font></th>
+                        <th><font face='Helvetica' size='2' color='white'>Top of the stack</font></th>
+                        %THREAD_STATUS_ROW%
+                        </table><br></br>"
+  THREAD_STATUS_ODD_ROW = "<tr align='middle'>
+                <td bgcolor='#afdcec'><font face='Tahoma' size='2' color='black'>%s</font></td>
+                <td bgcolor='#afdcec'><font face='Tahoma' size='2' color='black'>%s</font></td>
+                <td align='left' bgcolor='#afdcec'><font face='Tahoma' size='2' color='black'>%s</font></td>"
+  THREAD_STATUS_EVEN_ROW = "<tr align='middle'>
+                <td><font face='Tahoma' size='2' color='black'>%s</font></td>
+                <td><font face='Tahoma' size='2' color='black'>%s</font></td>        
+                <td align='left'><font face='Tahoma' size='2' color='black'>%s</font></td></tr>"
+                
+  METHOD_TRACE_HEADER = "<table cellspacing=2 width=100%>
+                <tr align=center bgcolor=#43BFC7>
+                <th><font face=Helvetica size=2 color=white>Time</font></th>       
+                <th><font face=Helvetica size=2 color=white>Thread ID</font></th>       
+                <th><font face=Helvetica size=2 color=white>Method Entry/Exit</font></th>
+                <th><font face=Helvetica size=2 color=white>Time Taken</font></th>
+                <th><font face=Helvetica size=2 color=white>Class</font></th>
+                <th><font face=Helvetica size=2 color=white>Method</font></th>
+                <th><font face=Helvetica size=2 color=white>Parameter Value(s)</font></th>
+                <th><font face=Helvetica size=2 color=white>Caller Object Class</font></th>
+                <th><font face=Helvetica size=2 color=white>Caller Method</font></th></tr>"
+  METHOD_TRACE_ODD_ROW = "<tr align=center>
+                <td bgcolor=#AFDCEC><font face='Tahoma' size=2 color=black>%s</font></td>
+                <td bgcolor=#AFDCEC><font face='Tahoma' size=2 color=black>%s</font></td>
+                <td bgcolor=#AFDCEC><font face='Tahoma' size=2 color=black>%s</font></td>
+                <td bgcolor=%s><font face='Tahoma' size=2 color=black>%s</font></td>
+                <td align=left bgcolor=#AFDCEC><font face='Tahoma' size=2 color=black>%s</font></td>
+                <td align=left bgcolor=#AFDCEC><font face='Tahoma' size=2 color=black>%s</font></td>                 
+                <td align=left bgcolor=#AFDCEC><font face='Tahoma' size=2 color=black>%s</font></td>
+                <td align=left bgcolor=#AFDCEC><font face='Tahoma' size=2 color=black>%s</font></td>
+                <td align=left bgcolor=#AFDCEC><font face='Tahoma' size=2 color=black>%s</font></td></tr>"
+  METHOD_TRACE_EVEN_ROW = "<tr align=center>
+                <td><font face='Tahoma' size=2 color=black>%s</font></td>
+                <td><font face='Tahoma' size=2 color=black>%s</font></td>
+                <td><font face='Tahoma' size=2 color=black>%s</font></td>        
+                <td bgcolor=%s><font face='Tahoma' size=2 color=black>%s</font></td>        
+                <td align=left><font face='Tahoma' size=2 color=black>%s</font></td>
+                <td align=left><font face='Tahoma' size=2 color=black>%s</font></td>
+                <td align=left><font face='Tahoma' size=2 color=black>%s</font></td>
+                <td align=left><font face='Tahoma' size=2 color=black>%s</font></td>
+                <td align=left><font face='Tahoma' size=2 color=black>%s</font></td></tr>"
+
+  THROUGHPUT_HTML = "<p align=center><font size='3' face='Verdana'>Performance summary of %APPS_NAME% as of %TIMESTAMP%</font></p>
+                     <table id=tblgraph align=center width=80 cellpadding=2 cellspacing=0 border=0>
+                     <tr><td bgcolor=WHITE align=center valign=middle width=22 style='writing-mode:tb-rl'><font face=arial size='-1'>Average throughput per min</font></td>%THROUGHPUT_BAR_TABLE%</tr>
+                     <tr bgcolor=#505050>
+                     <td align=center bordor=1 bgcolor=#FFFFFF>&nbsp;</td>%THROUGHPUT_LABEL_TABLE%
+                     <td bgcolor=white align=center><font face=arial size='-2' color=black>Time</font></td>
+                     </tr></table>"                
+  THROUGHPUT_BAR_TABLE = "<td align=center valign=bottom width=22>
+                          <font face=arial size='-2'>%s</font><br>
+                          <div style='writing-mode:tb-rl; background-color:firebrick; width:30; height:%d;' />
+                          </td>"
+  THROUGHPUT_LABEL_TABLE = "<td align=center><font face=arial size='-2' color=white>%s</font></td>"
+  TOP_SLOWEST_REQUESTS_HTML ="<p><font size='2' face='Verdana'>Top 10 Slowest Requests</font></p>
+                         <table cellspacing=0 width=50%%><tr bgcolor=FF6633>
+                         <th><font face=Helvetica size=2 color=#FFFFFF>Controller/Action<font></th>
+                         <th><font face=Helvetica size=2 color=#FFFFFF>Response Time<font></th></tr>
+                         %TOP_SLOWEST_REQUESTS_TABLE%
+                         </table>"                       
+  TOP_SLOWEST_REQUESTS_TABLE="<tr><td align=left bgcolor=585858><font face=Helvetica size=2 color=white>%s</font></td>
+                             <td><table><tr><td bgcolor=firebrick><div style='writing-mode:tb-rl; background-color:firebrick; width:%d; height:5;' /></td><td><font face=Helvetica SIZE=1>%0.3fs</font></td></tr></table></td></tr>"
+  REQ_PERF_BREAKDOWN_HTML ="<p><font size='2' face='Verdana'>Request Performance Breakdown</font></p>
+                <table cellspacing=0 width=100%>
+                <tr bgcolor=FF6633>
+                <th><font face=Helvetica size=2 color=#FFFFFF>Controller/Action</font></th>
+                <th><font face=Helvetica size=2 color=#FFFFFF>Request Count</font></th>
+                <th><font face=Helvetica size=2 color=#FFFFFF>Response Time</font></th>
+                <th><font face=Helvetica size=2 color=#FFFFFF>Action Time</font></th>
+                <th><font face=Helvetica size=2 color=#FFFFFF>Database IO Time</font></th>
+                <th><font face=Helvetica size=2 color=#FFFFFF>View Time</font></th>
+                <th><font face=Helvetica size=2 color=#FFFFFF>Dispatch Delay Time</font></th>
+                <th><font face=Helvetica size=2 color=#FFFFFF>Uncaptured Time</font></th>
+                </tr>%REQ_PERF_BREAKDOWN_TABLE%</table>
+                <font size='1' face='Verdana'>Note: Process components are results of functional decomposition which overlap each other. As a result, times do not add up to 100%. The hotspots of performance slowdowns, however, are easily accountable from functional standpoint.</font><br></br>"
+  REQ_PERF_BREAKDOWN_TABLE_ODD='<tr align=center>
+                 <td align=left bgcolor=585858><font face=Helvetica size=2 color=white>%s</font></td>
+                 <td bgcolor=C0C0C0><font face=Helvetica size=2 color=black>%d</font></td>
+                 <td bgcolor=C0C0C0><font face=Helvetica size=2 color=black>%0.3fs</font></td>
+                 <td bgcolor=C0C0C0><font face=Helvetica size=2 color=black>%0.3fs (%d%%)</font></td>                 
+                 <td bgcolor=C0C0C0><font face=Helvetica size=2 color=black>%0.3fs (%d%%)</font></td>
+                 <td bgcolor=C0C0C0><font face=Helvetica size=2 color=black>%0.3fs (%d%%)</font></td>
+                 <td bgcolor=C0C0C0><font face=Helvetica size=2 color=black>%0.3fs (%d%%)</font></td>
+                 <td bgcolor=C0C0C0><font face=Helvetica size=2 color=black>%0.3fs</font></td>
+                 </tr>'
+  REQ_PERF_BREAKDOWN_TABLE_EVEN='<tr align=center>
+                  <td align=left bgcolor=585858><font face=Helvetica size=2 color=white>%s</font></td>
+                  <td><font face=Helvetica size=2 color=black>%d</font></td>
+                  <td><font face=Helvetica size=2 color=black>%0.3fs </font></td>
+                  <td><font face=Helvetica size=2 color=black>%0.3fs (%d%%)</font></td>
+                  <td><font face=Helvetica size=2 color=black>%0.3fs (%d%%)</font></td>
+                  <td><font face=Helvetica size=2 color=black>%0.3fs (%d%%)</font></td>
+                  <td><font face=Helvetica size=2 color=black>%0.3fs (%d%%)</font></td>
+                  <td><font face=Helvetica size=2 color=black>%0.3fs</font></td>
+                  </tr>'                
+end

data/lib/rubyrun/rubyrun_html_writer__.rb

@@ -0,0 +1,64 @@
+#----------------------------------------------------------------#
+#                                                                #  
+#  (C) Copyright Rubysophic Inc. 2007-2008                       #
+#  All rights reserved.                                          #
+#                                                                #  
+#  Use, duplication or disclosure of the code is not permitted   #
+#  unless licensed.                                              #  
+#                                                                #  
+#  Last Updated: 7/8/08                                          #  
+#----------------------------------------------------------------#
+#                                                                #  
+# RubyRunHTMLWriter extends Ruby Logger. It makes use of the     #
+# rotating mechanism in Logger and it is used for writing the    #
+# reports in HTML format. The add_log_header method is overidden #
+# because by default, Ruby Logger writes a header at the         #
+# beginning of each file it creates and such a header is not     #
+# required in the RubyRun reports.                               # 
+#                                                                #  
+#----------------------------------------------------------------#
+require 'logger'
+
+class RubyRunHTMLWriter < Logger
+  
+  def initialize(logdev, header, shift_age = 0, shift_size = 1048576)
+    @progname = nil
+    @level = DEBUG
+    @default_formatter = Formatter.new
+    @formatter = nil
+    @logdev = nil
+    if logdev
+      @logdev = RubyRunHTMLDevice.new(logdev, header, :shift_age => shift_age,
+        :shift_size => shift_size)
+    end
+  end
+  
+  def format_message (severity, timestamp, progname, msg)
+    msg
+  end  
+  
+  class RubyRunHTMLDevice < Logger::LogDevice
+    
+    def initialize(log = nil, header = nil, opt = {})
+      @header = header
+      @dev = @filename = @shift_age = @shift_size = nil
+      @mutex = LogDeviceMutex.new
+      if log.respond_to?(:write) and log.respond_to?(:close)
+        @dev = log
+      else
+        @dev = open_logfile(log)
+        @dev.sync = true
+        @filename = log
+        @shift_age = opt[:shift_age] || 7
+        @shift_size = opt[:shift_size] || 1048576
+      end
+    end
+    
+    private
+    
+    def add_log_header(file)
+      file.write(@header) if @header
+    end
+  end
+
+end