rails-pg-extras 2.3.0 → 3.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 67b102fb8ff0b2dc05c7bf14662b8a4359808356f0f36e55ec6ab9012824a936
-  data.tar.gz: 41c9c07be416ccf5a3558d2488a5c242e14e594864935545693940b8cf40875d
+  metadata.gz: 7e964bd79450c28fff1d34129197b25e09b5dad8a3a6a355a1370ba7de725a2e
+  data.tar.gz: bf67d3b1929cd8495fce8cc9b4f867e8367564b26c118d9147af7dfb32e58115
 SHA512:
-  metadata.gz: 8208f2581593a9fff622add53dc6d3e8051abf570ce404f2cc48df9e6b5793635f8679e489b457b319951926a81803304d6a3b464114c989722f6917bf9ff121
-  data.tar.gz: aef18c1ccdcff519549efae8c4dfb379f8ef4eb20662e2948af4b54ad04e46c316c7cc10164415793bfd8364c70785eab7b4f115d20d38f830993441830371d1
+  metadata.gz: d82267114ee40e3ed8d39b2d12427f101a98a9c98f0505ca6ae84a60637e98e676193ba9e21727f1989bb32b95e41ac8414ab6dd6b7084d0f3bba381a4889901
+  data.tar.gz: 32a5bdee701af1f3407a092016a36360000d459ac447e770507c6ec723de072574f52270862f22c8d129bcb055402631121b83c55b54058347e05b098080ee84

data/.circleci/config.yml

@@ -31,7 +31,8 @@ jobs:
       - checkout
       - run: gem update --system
       - run: gem install bundler
-      - run: bundle install --path vendor/bundle
+      - run: bundle config set --local path 'vendor/bundle'
+      - run: bundle install
       - run: sudo apt-get update --allow-releaseinfo-change
       - run: sudo apt install postgresql-client
       - run: dockerize -wait tcp://postgres11:5432 -timeout 1m

data/README.md

@@ -32,7 +32,7 @@ In your Gemfile
 gem "rails-pg-extras"
 ```
 
-Some of the queries (e.g., `calls` and `outliers`) require [pg_stat_statements](https://www.postgresql.org/docs/current/pgstatstatements.html) extension enabled.
+`calls` and `outliers` queries require [pg_stat_statements](https://www.postgresql.org/docs/current/pgstatstatements.html) extension.
 
 You can check if it is enabled in your database by running:
 
@@ -45,6 +45,12 @@ You should see the similar line in the output:
 | pg_stat_statements  | 1.7  | 1.7 | track execution statistics of all SQL statements executed |
 ```
 
+`ssl_used` requires `sslinfo` extension, and `buffercache_usage`/`buffercache_usage` queries need `pg_buffercache`. You can enable them all by running:
+
+```ruby
+RailsPGExtras.add_extensions
+```
+
 ## Usage
 
 Each command can be used as a rake task, or a directly from the Ruby code.
@@ -91,6 +97,18 @@ RailsPGExtras.long_running_queries(args: { threshold: "200 milliseconds" })
 
 ```
 
+## Diagnose report
+
+The simplest way to start using pg-extras is to execute a `diagnose` method. It runs a set of checks and prints out a report highlighting areas that may require additional investigation:
+
+```ruby
+RailsPGExtras.diagnose
+```
+
+![Diagnose report](https://github.com/pawurb/rails-pg-extras/raw/master/rails-pg-extras-diagnose.png)
+
+Keep reading to learn about methods that `diagnose` uses under the hood.
+
 ## Available methods
 
 ### `cache_hit`
@@ -398,7 +416,7 @@ This command displays the total size of each table and materialized view in the
 ### `unused_indexes`
 
 ```ruby
-RailsPGExtras.unused_indexes(args: { min_scans: 20 })
+RailsPGExtras.unused_indexes(args: { max_scans: 20 })
 
 $ rake pg_extras:unused_indexes
 

data/lib/rails-pg-extras/diagnose_data.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module RailsPGExtras
+  class DiagnoseData < RubyPGExtras::DiagnoseData
+
+    private
+
+    def query_module
+      RailsPGExtras
+    end
+  end
+end

data/lib/rails-pg-extras/diagnose_print.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module RailsPGExtras
+  class DiagnosePrint < RubyPGExtras::DiagnosePrint
+
+    private
+
+    def title
+      "rails-pg-extras - diagnose report"
+    end
+  end
+end

data/lib/rails-pg-extras/tasks/all.rake

@@ -19,4 +19,9 @@ namespace :pg_extras do
       RailsPGExtras.public_send(query_name)
     end
   end
+
+  desc "Generate a PostgreSQL healthcheck report"
+  task diagnose: :establish_connection do
+    RailsPGExtras.diagnose
+  end
 end

data/lib/rails-pg-extras/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RailsPGExtras
-  VERSION = "2.3.0"
+  VERSION = "3.0.6"
 end

data/lib/rails-pg-extras.rb

@@ -2,6 +2,8 @@
 
 require 'terminal-table'
 require 'ruby-pg-extras'
+require 'rails-pg-extras/diagnose_data'
+require 'rails-pg-extras/diagnose_print'
 
 module RailsPGExtras
   QUERIES = RubyPGExtras::QUERIES
@@ -44,6 +46,18 @@ module RailsPGExtras
     )
   end
 
+  def self.diagnose(in_format: :display_table)
+    data = RailsPGExtras::DiagnoseData.call
+
+    if in_format == :display_table
+      RailsPGExtras::DiagnosePrint.call(data)
+    elsif in_format == :hash
+      data
+    else
+      raise "Invalid 'in_format' argument!"
+    end
+  end
+
   def self.connection
     ActiveRecord::Base.connection
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rails-pg-extras
 version: !ruby/object:Gem::Version
-  version: 2.3.0
+  version: 3.0.6
 platform: ruby
 authors:
 - pawurb
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-10-27 00:00:00.000000000 Z
+date: 2021-10-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ruby-pg-extras
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 2.3.0
+        version: 3.0.6
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 2.3.0
+        version: 3.0.6
 - !ruby/object:Gem::Dependency
   name: activerecord
   requirement: !ruby/object:Gem::Requirement
@@ -83,9 +83,12 @@ files:
 - Rakefile
 - docker-compose.yml.sample
 - lib/rails-pg-extras.rb
+- lib/rails-pg-extras/diagnose_data.rb
+- lib/rails-pg-extras/diagnose_print.rb
 - lib/rails-pg-extras/railtie.rb
 - lib/rails-pg-extras/tasks/all.rake
 - lib/rails-pg-extras/version.rb
+- rails-pg-extras-diagnose.png
 - rails-pg-extras-web.png
 - rails-pg-extras.gemspec
 - spec/smoke_spec.rb