rails_performance 0.9.5 → 1.0.0.beta1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 91dc41ef53b796c8c0755afd109fc7b7684ea9a5567828ab0e7f9e6c80cf9e79
-  data.tar.gz: 434e5e19a7abb0fc86b094d591623d626ab4b8a8e2ad28b70d2dfe70583e510b
+  metadata.gz: d488f59068653fd127b680b6d2c067fbc23f85c84526d1259b2fb47dd3e25367
+  data.tar.gz: 6efcf5fb469225f298bf21b2812792acf771aebf27b623d747d4c46e29313dc3
 SHA512:
-  metadata.gz: dffbb9eab0930f214009a8717c97a9fe82b7ea5fea22cd7a18d9a34426811d8467a19600e38e5fbdc1eb4c1aee1308b7819a8b79ff77d721907a644b9f2facea
-  data.tar.gz: 69e08649d416bf680f203ee801534c1c5dbedd5ee956e85cca5439db3eaa8062ca830800454eb37335059732239946f6a39ad0a1d756b7efa40864fc5ebb9dc9
+  metadata.gz: 2513587de28e920769405e717488fe64725e780aa3f33f012e78078c7ece12afe873347c14ec450568066fbe7f2d031a3b04e164836dc3759725416ff5a95406
+  data.tar.gz: 87f823f42bbaf9c1491e49bbd194d8312ea395cb32372eac58fa97660b9a999c1de5106c5ab13d8ed28d63baebe6d2b8d8d05b933aece8ffaf4d5af338058417

data/README.md

@@ -1,6 +1,8 @@
 # Rails Performance
 
-[![Build Status](https://travis-ci.org/igorkasyanchuk/rails_performance.svg?branch=master)](https://travis-ci.org/igorkasyanchuk/rails_performance)
+[![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.
 
@@ -16,14 +18,18 @@ 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
-- works with Rails 4.2+ (and probably 4.1, 4.0 too)
+- 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.
 
 ## Production
 
-Gem is production-ready. At least on my 2 applications with ~800 unique users per day it works perfectly. 
+Gem is production-ready. At least on my 2 applications with ~800 unique users per day it works perfectly.
 
 Just don't forget to protect performance dashboard with http basic auth or check of current_user.
 
@@ -49,6 +55,10 @@ RailsPerformance.setup do |config|
   config.debug    = false # currently not used>
   config.enabled  = true
 
+  # 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
   config.http_basic_authentication_enabled   = false
   config.http_basic_authentication_user_name = 'rails_performance'
@@ -62,12 +72,13 @@ end if defined?(RailsPerformance)
 ```
 
 ## Installation
+
 Add this line to your application's Gemfile:
 
 ```ruby
 gem 'rails_performance'
 
-# or 
+# or
 
 group :development, :production do
   gem 'rails_performance'
@@ -75,18 +86,47 @@ end
 ```
 
 And then execute:
+
 ```bash
 $ bundle
 ```
 
+Create default configuration file:
+
+```bash
+$ rails generate rails_performance:install
+```
+
+Have a look at `config/initializers/rails_performance.rb` and adjust the configuration to your needs.
+
 You must also have installed Redis server, because this gem is storing data into it.
 
 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
@@ -121,10 +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
-- generator for initial config
-- CI for tests
 - time/zone config?
 - connected charts on dashboard, when zoom, when hover?
 - ability to zoom to see requests withing specific datetime range
@@ -133,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
@@ -141,6 +179,10 @@ 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
 
@@ -149,7 +191,15 @@ You are welcome to contribute. I've a big list of TODO.
 ## Big thanks to contributors
 
 - https://github.com/synth
+- https://github.com/alagos
+- https://github.com/klondaiker
+- https://github.com/jules2689
+- https://github.com/PedroAugustoRamalhoDuarte
+- https://github.com/haffla
 
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+[<img src="https://github.com/igorkasyanchuk/rails_time_travel/blob/main/docs/more_gems.png?raw=true"
+/>](https://www.railsjazz.com/)

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                = RP::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    = RP::Reports::ThroughputReport.new(db).data
+        @response_time_report_data = RP::Reports::ResponseTimeReport.new(db).data
       end
 
       def summary
-        @datasource                = RP::DataSource.new(**prepare_query, type: :requests, klass: RP::Models::Record)
+        @datasource                = RP::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    = RP::Reports::ThroughputReport.new(db).data
+        @response_time_report_data = RP::Reports::ResponseTimeReport.new(db).data
+        @data                      = RP::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 = RP::Models::RequestRecord.find_by(request_id: params[:id])
+        @data   = RP::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,38 +37,59 @@ module RailsPerformance
       end
 
       def crashes
-        @datasource   = RP::DataSource.new(**prepare_query({status_eq: 500}), type: :requests, klass: RP::Models::Record)
+        @datasource   = RP::DataSource.new(**prepare_query({status_eq: 500}), type: :requests)
         db            = @datasource.db
-        @report       = RP::Reports::CrashReport.new(db)
-        @data         = @report.data
+        @data         = RP::Reports::CrashReport.new(db).data
       end
 
       def requests
-        @datasource = RP::DataSource.new(**prepare_query, type: :requests, klass: RP::Models::Record)
+        @datasource = RP::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       = RP::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 = RP::DataSource.new(**prepare_query, type: :requests)
         db          = @datasource.db
-        @report     = RP::Reports::RecentRequestsReport.new(db)
-        @data       = @report.data
+        @data       = RP::Reports::RecentRequestsReport.new(db).data
+      end
+
+      def sidekiq
+        @datasource                = RP::DataSource.new(**prepare_query, type: :sidekiq)
+        db                         = @datasource.db
+        @throughput_report_data    = RP::Reports::ThroughputReport.new(db).data
+        @response_time_report_data = RP::Reports::ResponseTimeReport.new(db).data
+        @recent_report_data        = RP::Reports::RecentRequestsReport.new(db).data
       end
 
-      def jobs
-        @datasource                = RP::DataSource.new(**prepare_query, type: :jobs, klass: RP::Models::JobRecord)
+      def delayed_job
+        @datasource                = RP::DataSource.new(**prepare_query, type: :delayed_job)
         db                         = @datasource.db
+        @throughput_report_data    = RP::Reports::ThroughputReport.new(db).data
+        @response_time_report_data = RP::Reports::ResponseTimeReport.new(db).data
+        @recent_report_data        = RP::Reports::RecentRequestsReport.new(db).data
+      end
 
-        @throughput_report         = RP::Reports::ThroughputReport.new(db)
-        @throughput_report_data    = @throughput_report.data
+      def custom
+        @datasource                = RP::DataSource.new(**prepare_query, type: :custom)
+        db                         = @datasource.db
+        @throughput_report_data    = RP::Reports::ThroughputReport.new(db).data
+        @response_time_report_data = RP::Reports::ResponseTimeReport.new(db).data
+        @recent_report_data        = RP::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                = RP::DataSource.new(**prepare_query, type: :grape)
+        db                         = @datasource.db
+        @throughput_report_data    = RP::Reports::ThroughputReport.new(db).data
+        @recent_report_data        = RP::Reports::RecentRequestsReport.new(db).data
+      end
 
-        @recent_report             = RP::Reports::RecentRequestsReport.new(db)
-        @recent_report_data        = @recent_report.data(:jobs)
+      def rake
+        @datasource                = RP::DataSource.new(**prepare_query, type: :rake)
+        db                         = @datasource.db
+        @throughput_report_data    = RP::Reports::ThroughputReport.new(db).data
+        @recent_report_data        = RP::Reports::RecentRequestsReport.new(db).data
       end
 
       private

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

@@ -5,7 +5,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1">
     <title>Rails Performance</title>
     <%= csrf_meta_tags %>
-    <%= csp_meta_tag if ::Rails::VERSION::MAJOR.to_i >= 5 %>
+    <%= csp_meta_tag if ::Rails::VERSION::STRING.to_f >= 5.2 %>
     <%= render '/rails_performance/stylesheets/stylesheets' %>
     <link rel="shortcut icon" href="/favicon.ico">
   </head>
@@ -29,4 +29,4 @@
     <%= yield :on_load %>
 
   </body>
-</html>
+</html>

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/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 %>