rails_performance 0.9.8 → 1.0.0.beta4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2fd36bc442cc4c70eb58e007e07df73a44bf7ce745de9d4e50b94d8f41bfa050
-  data.tar.gz: 590694fef0143bf1080ef4eb224f6c6beb657728c53d0a13c825b8012fa7ca04
+  metadata.gz: 38819433ac1ee118a96caab4f7ca4a539b2d995357df0a4bc04333ae55d3beb7
+  data.tar.gz: 207a4b1e375df67b0af5b3f446fe59cb50e608da207510fa64ad28e1f8366039
 SHA512:
-  metadata.gz: b49fda7d3eb4081a963c87417b1033a4a204f52b10bdb544a8984ab7367d77ebe38421e2447c68e45a4110d653ee27dd772a8ec5e6ac5ea80e7954e3210295d6
-  data.tar.gz: a649c5987684c72c3b6ded1847478a3bf4ace015054a4e2cbee293f33aaee3f3a442acefbcc59eeb9e9ae68cfd0ca95032c7d353ec38978bee664c4795c2baae
+  metadata.gz: efa206d30d71c4b5721bbc8fad0df581b56a7ad0642b99f0d91c9e1ff1e5ff394951f68ddcd0ba498d5f60f2de8714bd9163a5f7912abdb548bd0d1bb8b2fce5
+  data.tar.gz: 9f4810ef1db85454e2ffefee36f2cedb43dd1d9495ef7ce993ecf4da364234fe04b0d644db7be9270fc2011f66bad47c6ebcdf73ed561e0711a07f88941c36aa

data/README.md

@@ -2,6 +2,7 @@
 
 [![Tests](https://github.com/igorkasyanchuk/rails_performance/actions/workflows/ruby.yml/badge.svg)](https://github.com/igorkasyanchuk/rails_performance/actions/workflows/ruby.yml)
 [![RailsJazz](https://github.com/igorkasyanchuk/rails_time_travel/blob/main/docs/my_other.svg?raw=true)](https://www.railsjazz.com)
+[![https://www.patreon.com/igorkasyanchuk](https://github.com/igorkasyanchuk/rails_time_travel/blob/main/docs/patron.svg?raw=true)](https://www.patreon.com/igorkasyanchuk)
 
 A self-hosted tool to monitor the performance of your Ruby on Rails application.
 
@@ -17,7 +18,11 @@ It allows you to track:
 - total duration of time spent per request, views rendering, DB
 - SQL queries, rendering logs in "Recent Requests" section
 - simple 500-crashes reports
-- track Sidekiq jobs performance
+- Sidekiq jobs
+- Delayed Job jobs
+- Grape API inside Rails app
+- Rake tasks performance
+- Custom events wrapped with `RailsPerformance.measure do .. end` block
 - works with Rails 4.2+ (and probably 4.1, 4.0 too) and Ruby 2.2+
 
 All data are stored in `local` Redis and not sent to any 3rd party servers.
@@ -50,7 +55,8 @@ RailsPerformance.setup do |config|
   config.debug    = false # currently not used>
   config.enabled  = true
 
-  # default path where to mount gem
+  # default path where to mount gem,
+  # alternatively you can mount the RailsPerformance::Engine in your routes.rb
   config.mount_at = '/rails/performance'
 
   # protect your Performance Dashboard with HTTP BASIC password
@@ -97,10 +103,30 @@ You must also have installed Redis server, because this gem is storing data into
 
 After installation and configuration, start your Rails application, make a few requests, and open `https://localhost:3000/rails/performance` URL.
 
+### Alternative: Mounting the engine yourself
+
+If you, for whatever reason (company policy, devise, ...) need to mount RailsPerformance yourself, feel free to do so by using the following snippet as inspiration.
+You can skip the `mount_at` and `http_basic_authentication_*` configurations then, if you like.
+
+```ruby
+# config/routes.rb
+Rails.application.routes.draw do
+  ...
+  # example for usage with Devise
+  authenticate :user, -> (user) { user.admin? } do
+    mount RailsPerformance::Engine, at: 'rails/performance'
+  end
+end
+```
+
+
+
 ## How it works
 
 ![Schema](docs/rails_performance.png)
 
+In addition it's wrapping gems internal methods and collecting performance information. See `./lib/rails_performance/gems/*` for more information.
+
 ## Limitations
 
 - it doesn't track params of POST/PUT requests
@@ -135,9 +161,8 @@ The idea of this gem grew from curriosity how many RPM my app receiving per day.
 
 ## TODO
 
-- documentation in Readme
+- documentation in Readme?
 - capture stacktrace of 500 errors and show in side panel
-- CI for tests
 - time/zone config?
 - connected charts on dashboard, when zoom, when hover?
 - ability to zoom to see requests withing specific datetime range
@@ -146,7 +171,7 @@ The idea of this gem grew from curriosity how many RPM my app receiving per day.
 - better stats tooltip, do not show if nothing to show
 - dark mode toggle? save to the cookies?
 - integration with elastic search? or other?
-- monitor active job (sidekiq)?
+- monitor active job?
 - better logo?
 - number of requests last 24 hours, hour, etc.
 - collect deprecation.rails
@@ -154,11 +179,17 @@ The idea of this gem grew from curriosity how many RPM my app receiving per day.
 - show "loading banner" until jquery is loaded?
 - better UI on smaller screens? Recent requests when URL's are long? Truncate with CSS?
 - rules for highlighting durations? how many ms to show warning, alert
+- elastic search
+- searchkiq
+- sinatra?
+- tests to check what is actually stored in redis db after request
 
 ## Contributing
 
 You are welcome to contribute. I've a big list of TODO.
 
+If "schema" how records are stored i Redis is changed, and this is a breacking change, update: `RailsPerformance::SCHEMA` to a newer value.
+
 ## Big thanks to contributors
 
 - https://github.com/synth

data/app/controllers/rails_performance/rails_performance_controller.rb

@@ -6,28 +6,20 @@ module RailsPerformance
 
     if RailsPerformance.enabled
       def index
-        @datasource                = RP::DataSource.new(**prepare_query, type: :requests, klass: RP::Models::Record)
+        @datasource                = RailsPerformance::DataSource.new(**prepare_query, type: :requests)
         db                         = @datasource.db
 
-        @throughput_report         = RP::Reports::ThroughputReport.new(db)
-        @throughput_report_data    = @throughput_report.data
-
-        @response_time_report      = RP::Reports::ResponseTimeReport.new(db)
-        @response_time_report_data = @response_time_report.data
+        @throughput_report_data    = RailsPerformance::Reports::ThroughputReport.new(db).data
+        @response_time_report_data = RailsPerformance::Reports::ResponseTimeReport.new(db).data
       end
 
       def summary
-        @datasource                = RP::DataSource.new(**prepare_query, type: :requests, klass: RP::Models::Record)
+        @datasource                = RailsPerformance::DataSource.new(**prepare_query, type: :requests)
         db                         = @datasource.db
 
-        @throughput_report         = RP::Reports::ThroughputReport.new(db)
-        @throughput_report_data    = @throughput_report.data
-
-        @response_time_report      = RP::Reports::ResponseTimeReport.new(db)
-        @response_time_report_data = @response_time_report.data
-
-        @report                    = RP::Reports::BreakdownReport.new(db, title: "Requests")
-        @data                      = @report.data
+        @throughput_report_data    = RailsPerformance::Reports::ThroughputReport.new(db).data
+        @response_time_report_data = RailsPerformance::Reports::ResponseTimeReport.new(db).data
+        @data                      = RailsPerformance::Reports::BreakdownReport.new(db, title: "Requests").data
 
         respond_to do |format|
           format.js {}
@@ -36,9 +28,8 @@ module RailsPerformance
       end
 
       def trace
-        @record = RP::Models::Record.find_by(request_id: params[:id])
-        @report = RP::Reports::TraceReport.new(request_id: params[:id])
-        @data   = @report.data
+        @record = RailsPerformance::Models::RequestRecord.find_by(request_id: params[:id])
+        @data   = RailsPerformance::Reports::TraceReport.new(request_id: params[:id]).data
         respond_to do |format|
           format.js {}
           format.any { render plain: "Doesn't open in new window. Wait until full page load." }
@@ -46,44 +37,65 @@ module RailsPerformance
       end
 
       def crashes
-        @datasource   = RP::DataSource.new(**prepare_query({status_eq: 500}), type: :requests, klass: RP::Models::Record)
+        @datasource   = RailsPerformance::DataSource.new(**prepare_query({status_eq: 500}), type: :requests)
         db            = @datasource.db
-        @report       = RP::Reports::CrashReport.new(db)
-        @data         = @report.data
+        @data         = RailsPerformance::Reports::CrashReport.new(db).data
       end
 
       def requests
-        @datasource = RP::DataSource.new(**prepare_query, type: :requests, klass: RP::Models::Record)
+        @datasource = RailsPerformance::DataSource.new(**prepare_query, type: :requests)
         db          = @datasource.db
-        @report     = RP::Reports::RequestsReport.new(db, group: :controller_action_format, sort: :count)
-        @data       = @report.data
+        @data       = RailsPerformance::Reports::RequestsReport.new(db, group: :controller_action_format, sort: :count).data
       end
 
       def recent
-        @datasource = RP::DataSource.new(**prepare_query, type: :requests, klass: RP::Models::Record)
+        @datasource = RailsPerformance::DataSource.new(**prepare_query, type: :requests)
         db          = @datasource.db
-        @report     = RP::Reports::RecentRequestsReport.new(db)
-        @data       = @report.data
+        @data       = RailsPerformance::Reports::RecentRequestsReport.new(db).data
+      end
+
+      def sidekiq
+        @datasource                = RailsPerformance::DataSource.new(**prepare_query, type: :sidekiq)
+        db                         = @datasource.db
+        @throughput_report_data    = RailsPerformance::Reports::ThroughputReport.new(db).data
+        @response_time_report_data = RailsPerformance::Reports::ResponseTimeReport.new(db).data
+        @recent_report_data        = RailsPerformance::Reports::RecentRequestsReport.new(db).data
       end
 
-      def jobs
-        @datasource                = RP::DataSource.new(**prepare_query, type: :jobs, klass: RP::Models::JobRecord)
+      def delayed_job
+        @datasource                = RailsPerformance::DataSource.new(**prepare_query, type: :delayed_job)
         db                         = @datasource.db
+        @throughput_report_data    = RailsPerformance::Reports::ThroughputReport.new(db).data
+        @response_time_report_data = RailsPerformance::Reports::ResponseTimeReport.new(db).data
+        @recent_report_data        = RailsPerformance::Reports::RecentRequestsReport.new(db).data
+      end
 
-        @throughput_report         = RP::Reports::ThroughputReport.new(db)
-        @throughput_report_data    = @throughput_report.data
+      def custom
+        @datasource                = RailsPerformance::DataSource.new(**prepare_query, type: :custom)
+        db                         = @datasource.db
+        @throughput_report_data    = RailsPerformance::Reports::ThroughputReport.new(db).data
+        @response_time_report_data = RailsPerformance::Reports::ResponseTimeReport.new(db).data
+        @recent_report_data        = RailsPerformance::Reports::RecentRequestsReport.new(db).data
+      end
 
-        @response_time_report      = RP::Reports::ResponseTimeReport.new(db)
-        @response_time_report_data = @response_time_report.data
+      def grape
+        @datasource                = RailsPerformance::DataSource.new(**prepare_query, type: :grape)
+        db                         = @datasource.db
+        @throughput_report_data    = RailsPerformance::Reports::ThroughputReport.new(db).data
+        @recent_report_data        = RailsPerformance::Reports::RecentRequestsReport.new(db).data
+      end
 
-        @recent_report             = RP::Reports::RecentRequestsReport.new(db)
-        @recent_report_data        = @recent_report.data(:jobs)
+      def rake
+        @datasource                = RailsPerformance::DataSource.new(**prepare_query, type: :rake)
+        db                         = @datasource.db
+        @throughput_report_data    = RailsPerformance::Reports::ThroughputReport.new(db).data
+        @recent_report_data        = RailsPerformance::Reports::RecentRequestsReport.new(db).data
       end
 
       private
 
       def prepare_query(query = params)
-        RP::Rails::QueryBuilder.compose_from(query)
+        RailsPerformance::Rails::QueryBuilder.compose_from(query)
       end
     end
 

data/app/helpers/rails_performance/application_helper.rb

@@ -1,10 +1,10 @@
 module RailsPerformance
   module ApplicationHelper
-    def round_it(value)
+    def round_it(value, limit = 1)
       return nil unless value
       return value if value.is_a?(Integer)
 
-      value.nan? ? nil : value.round(1)
+      value.nan? ? nil : value.round(limit)
     end
 
     def duraction_alert_class(duration_str)
@@ -30,9 +30,15 @@ module RailsPerformance
       end
     end
 
-    def ms(value)
-      result = round_it(value)
-      result && result != 0 ? "#{result} ms" : '-'
+    def mss(value, limit = 1)
+      ms(value.to_f * 1000, limit)
+    end
+
+    def ms(value, limit = 1)
+      result = round_it(value, limit)
+      return '-' if result.nil?
+
+      result && result != 0 ? "#{result} ms" : '< 0 ms'
     end
 
     def short_path(path, length: 60)
@@ -65,6 +71,8 @@ module RailsPerformance
 
     def status_tag(status)
       klass = case status.to_s
+      when /error/
+        "tag is-danger"
       when /^5/
         "tag is-danger"
       when /^4/
@@ -73,6 +81,8 @@ module RailsPerformance
         "tag is-info"
       when /^2/
         "tag is-success"
+      when /success/
+        "tag is-success"
       else
         nil
       end
@@ -108,8 +118,16 @@ module RailsPerformance
         "is-active" if controller_name == "rails_performance" && action_name == "requests"
       when :recent
         "is-active" if controller_name == "rails_performance" && action_name == "recent"
-      when :jobs
-        "is-active" if controller_name == "rails_performance" && action_name == "jobs"
+      when :sidekiq
+        "is-active" if controller_name == "rails_performance" && action_name == "sidekiq"
+      when :delayed_job
+        "is-active" if controller_name == "rails_performance" && action_name == "delayed_job"
+      when :grape
+        "is-active" if controller_name == "rails_performance" && action_name == "grape"
+      when :rake
+        "is-active" if controller_name == "rails_performance" && action_name == "rake"
+      when :custom
+        "is-active" if controller_name == "rails_performance" && action_name == "custom"
       end
     end
   end

data/app/views/rails_performance/javascripts/app.js

@@ -22,7 +22,7 @@ function showTIRChart(div, data, addon, name) {
           },
           formatter: function() {
               if (this.y == 0) {
-                return '';
+                return 'n/a';
               }
             return this.y + addon;
           }
@@ -107,7 +107,7 @@ function showRTChart(div, data) {
           },
           formatter: function() {
               if (this.y == 0) {
-                return "";
+                return 'n/a';
               }
               return this.y + ' ms';
           }

data/app/views/rails_performance/layouts/rails_performance.html.erb

@@ -19,7 +19,7 @@
         <%= yield %>
         <div class="footer-box">
           © Rails Performance <span class='red'><i class="fas fa-heart"></i></span> <%= link_to 'https://github.com/igorkasyanchuk/rails_performance', 'https://github.com/igorkasyanchuk/rails_performance', target: '_blank' %>
-          <div class="is-pulled-right">v.<%= RP::VERSION %></div>
+          <div class="is-pulled-right">v.<%= RailsPerformance::VERSION %></div>
         </div>
       </div>
     </section>

data/app/views/rails_performance/rails_performance/_summary.html.erb

@@ -4,7 +4,7 @@
 <h2 class="subtitle">Average Response Time</h2>
 <div id="response_time_report_chart_mini" class="chart_mini"></div>
 
-<h2 class="subtitle"><%= @report.title %></h2>
+<h2 class="subtitle"><%= title %></h2>
 <table class="table is-fullwidth is-hoverable is-narrow is-size-7">
   <thead>
     <tr>

data/app/views/rails_performance/rails_performance/crashes.html.erb

@@ -9,6 +9,8 @@
           <th data-sort="string">Method</th>
           <th data-sort="string">Format</th>
           <th data-sort="string">Path</th>
+          <th data-sort="string">Exception</th>
+          <th data-sort="string">Backtrace</th>
           <th data-sort="string">Status</th>
           <th data-sort="float">Duration</th>
           <th data-sort="float">Views</th>
@@ -29,6 +31,10 @@
             <td><%= e[:method] %></td>
             <td><%= e[:format] %></td>
             <td><%= link_to_path(e) %></td>
+            <td><%= e[:exception] %></td>
+            <td class="very-small-text">
+              <%= raw e[:backtrace]&.join("<br/>") %>
+            </td>
             <td><%= status_tag e[:status] %></td>
             <td class="nowrap"><%= ms e[:duration] %></td>
             <td class="nowrap"><%= ms e[:view_runtime] %></td>

data/app/views/rails_performance/rails_performance/custom.html.erb

@@ -0,0 +1,83 @@
+<title>Custom Events</title>
+
+<% unless @datasource.default? %>
+  <%#= link_to raw("&larr; Back"), rails_performance_path, class: "back_link" %>
+<% end %>
+
+<div class="card">
+  <div class="card-content">
+    <h2 class="subtitle">Recent Events (last <%= RailsPerformance::Reports::RecentRequestsReport::TIME_WINDOW / 60 %> minutes)<h2>
+
+    <table class="table is-fullwidth is-hoverable is-narrow">
+      <thead>
+        <tr>
+          <th data-sort="string">Datetime</th>
+          <th data-sort="string">Tag</th>
+          <th data-sort="string">Namespace</th>
+          <th data-sort="string">Status</th>
+          <th data-sort="float">Duration</th>
+        </tr>
+      </thead>
+      <tbody>
+        <% if @recent_report_data.empty? %>
+          <tr>
+            <td colspan="5">
+              Nothing to show here. Try to make a few requests in the main app.
+
+              <pre>
+                <code>
+                  # in controller for example
+                  def index
+                    RailsPerformance.measure("stats calculation", "reports#index") do
+                      stats = User.calculate_stats
+                    end
+                  end
+                </code>
+              </pre>
+            </td>
+          </tr>
+        <% end %>
+        <% @recent_report_data.each do |e| %>
+          <tr>
+            <td><%= format_datetime e[:datetime] %></td>
+            <td><%= e[:tag_name] %></td>
+            <td><%= e[:namespace_name] %></td>
+            <td><%= status_tag e[:status] %></td>
+            <td class="nowrap"><%= ms e[:duration] %></td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  </div>
+</div>
+
+<br/>
+
+<div class="card">
+  <div class="card-content">
+    <h2 class="subtitle">Custom Events Throughput Report</h2>
+    <div id="throughput_report_chart" class="chart"></div>
+    <p class="content is-small">All custom events in the application</p>
+  </div>
+</div>
+
+<br/>
+
+<div class="card">
+  <div class="card-content">
+    <h2 class="subtitle">Average Execution Time</h2>
+    <div id="response_time_report_chart" class="chart"></div>
+    <p class="content is-small">All custom events in the application</p>
+  </div>
+</div>
+
+
+<% content_for :on_load do %>
+  <script>
+    var data1 = <%= raw @throughput_report_data.to_json %>;
+    showTIRChart('throughput_report_chart', data1, ' events / minute', 'Events');
+
+    var data2 = <%= raw @response_time_report_data.to_json %>;
+    showRTChart('response_time_report_chart', data2);
+  </script>
+<% end %>