rails-pg-extras 2.3.0 → 3.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 67b102fb8ff0b2dc05c7bf14662b8a4359808356f0f36e55ec6ab9012824a936
-  data.tar.gz: 41c9c07be416ccf5a3558d2488a5c242e14e594864935545693940b8cf40875d
+  metadata.gz: 63d21a1cdda5042e1f724d4861a0e89627e5a0aa46ba5576b4ecaecfa18a56d2
+  data.tar.gz: 6981bfec84abc306ba27211a47359fb77ce3bfa18e2dea9182e4f5ba526bcca2
 SHA512:
-  metadata.gz: 8208f2581593a9fff622add53dc6d3e8051abf570ce404f2cc48df9e6b5793635f8679e489b457b319951926a81803304d6a3b464114c989722f6917bf9ff121
-  data.tar.gz: aef18c1ccdcff519549efae8c4dfb379f8ef4eb20662e2948af4b54ad04e46c316c7cc10164415793bfd8364c70785eab7b4f115d20d38f830993441830371d1
+  metadata.gz: 738dbe0b2a66e68af37ca7bf9528fe83a4b0c1731647ca8b6b13e104dcada2d1d03df352c0499e391fded63cdc94cb319c701c9491a33ecb96181e48fbbbb9e9
+  data.tar.gz: 5abfd57dd0afdb089de3422c474c6de798d8f21d6c18875a50f8af367ec88b46c6f04ff72a0cd64f339647f193ab062410f5002e2f78c257e496d4802187725d

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,20 @@ 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
+
+$ rake pg_extras: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 +418,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/index_info.rb

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

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

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module RailsPGExtras
+  class IndexInfoPrint < RubyPGExtras::IndexInfoPrint
+  end
+end

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

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

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

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module RailsPGExtras
+  class TableInfoPrint < RubyPGExtras::TableInfoPrint
+  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.2.3"
 end

data/lib/rails-pg-extras.rb

@@ -2,6 +2,12 @@
 
 require 'terminal-table'
 require 'ruby-pg-extras'
+require 'rails-pg-extras/diagnose_data'
+require 'rails-pg-extras/diagnose_print'
+require 'rails-pg-extras/index_info'
+require 'rails-pg-extras/index_info_print'
+require 'rails-pg-extras/table_info'
+require 'rails-pg-extras/table_info_print'
 
 module RailsPGExtras
   QUERIES = RubyPGExtras::QUERIES
@@ -44,6 +50,46 @@ 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.index_info(args: {}, in_format: :display_table)
+    data = RailsPGExtras::IndexInfo.call(args[:table_name])
+
+    if in_format == :display_table
+      RailsPGExtras::IndexInfoPrint.call(data)
+    elsif in_format == :hash
+      data
+    elsif in_format == :array
+      data.map(&:values)
+    else
+      raise "Invalid 'in_format' argument!"
+    end
+  end
+
+  def self.table_info(args: {}, in_format: :display_table)
+    data = RailsPGExtras::TableInfo.call(args[:table_name])
+
+    if in_format == :display_table
+      RailsPGExtras::TableInfoPrint.call(data)
+    elsif in_format == :hash
+      data
+    elsif in_format == :array
+      data.map(&:values)
+    else
+      raise "Invalid 'in_format' argument!"
+    end
+  end
+
   def self.connection
     ActiveRecord::Base.connection
   end

data/spec/smoke_spec.rb

@@ -3,11 +3,6 @@
 require 'spec_helper'
 
 describe RailsPGExtras do
-  before(:all) do
-    RailsPGExtras.connection.execute("CREATE EXTENSION IF NOT EXISTS pg_buffercache;")
-    RubyPGExtras.connection.exec("CREATE EXTENSION IF NOT EXISTS pg_stat_statements;")
-  end
-
   RailsPGExtras::QUERIES.each do |query_name|
     it "#{query_name} query can be executed" do
       expect do
@@ -18,4 +13,18 @@ describe RailsPGExtras do
       end.not_to raise_error
     end
   end
+
+  it "runs the custom methods" do
+    expect do
+      RailsPGExtras.diagnose(in_format: :hash)
+    end.not_to raise_error
+
+    expect do
+      RailsPGExtras.index_info(in_format: :hash)
+    end.not_to raise_error
+
+    expect do
+      RailsPGExtras.table_info(in_format: :hash)
+    end.not_to raise_error
+  end
 end

data/spec/spec_helper.rb

@@ -24,6 +24,9 @@ RSpec.configure do |config|
     ActiveRecord::Base.establish_connection(
       ENV.fetch("DATABASE_URL")
     )
+    RailsPGExtras.connection.execute("CREATE EXTENSION IF NOT EXISTS pg_stat_statements;")
+    RailsPGExtras.connection.execute("CREATE EXTENSION IF NOT EXISTS pg_buffercache;")
+    RailsPGExtras.connection.execute("CREATE EXTENSION IF NOT EXISTS sslinfo;")
   end
 
   config.after :suite do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rails-pg-extras
 version: !ruby/object:Gem::Version
-  version: 2.3.0
+  version: 3.2.3
 platform: ruby
 authors:
 - pawurb
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-10-27 00:00:00.000000000 Z
+date: 2021-12-18 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.2.3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 2.3.0
+        version: 3.2.3
 - !ruby/object:Gem::Dependency
   name: activerecord
   requirement: !ruby/object:Gem::Requirement
@@ -83,9 +83,16 @@ 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/index_info.rb
+- lib/rails-pg-extras/index_info_print.rb
 - lib/rails-pg-extras/railtie.rb
+- lib/rails-pg-extras/table_info.rb
+- lib/rails-pg-extras/table_info_print.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
@@ -109,7 +116,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
+rubygems_version: 3.0.3
 signing_key:
 specification_version: 4
 summary: Rails PostgreSQL performance database insights