pg_insights 0.3.2 → 0.4.0

data/lib/generators/pg_insights/install_generator.rb

@@ -16,6 +16,7 @@ module PgInsights
       def copy_migrations
         copy_queries_migration
         copy_health_check_results_migration
+        copy_query_executions_migration
       end
 
       def create_initializer
@@ -53,7 +54,7 @@ module PgInsights
         puts ""
         puts "Features available:"
         puts "• Health Dashboard: '/pg_insights/health' - Monitor database health"
-        puts "• Query Runner: '/pg_insights' - Run SQL queries with charts"
+        puts "• Query Runner: '/pg_insights' - Run SQL queries with charts & EXPLAIN ANALYZE"
         puts "• Timeline: '/pg_insights/timeline' - Track parameter changes over time"
         puts ""
         puts "Useful commands:"
@@ -98,22 +99,17 @@ module PgInsights
             config.background_job_queue = :pg_insights_health
 
             # === Cache and Timeout Settings ===
-            # How long to cache health check results before considering them stale
-            # Stale results will trigger background refresh when accessed
-            #
-            # Default: 5.minutes
             config.health_cache_expiry = 5.minutes
 
-            # Timeout for individual health check queries to prevent long-running queries
-            # from blocking the application
-            #
-            # Default: 10.seconds
-            config.health_check_timeout = 10.seconds
+            # === Query Execution Timeouts ===
+            config.query_execution_timeout = 30.seconds
+            config.query_analysis_timeout = 60.seconds
+            config.health_check_timeout = 20.seconds
 
-            # Maximum execution time for user queries in the insights interface
-            #
-            # Default: 30.seconds
-            config.max_query_execution_time = 30.seconds
+            # === Heavy Analytics Environment ===
+            # config.query_execution_timeout = 120.seconds
+            # config.query_analysis_timeout = 180.seconds
+            # config.health_check_timeout = 60.seconds
 
             # === Timeline & Snapshot Settings ===
             #
@@ -217,6 +213,16 @@ module PgInsights
         end
       end
 
+      def copy_query_executions_migration
+        if migration_exists?("create_pg_insights_query_executions")
+          say_status("skipped", "Migration 'create_pg_insights_query_executions' already exists", :yellow)
+        else
+          puts "Copying PgInsights query executions migration..."
+          migration_template "db/migrate/create_pg_insights_query_executions.rb",
+                             "db/migrate/create_pg_insights_query_executions.rb"
+        end
+      end
+
       def migration_exists?(migration_name)
         migrate_path = File.join(destination_root, "db", "migrate")
         return false unless File.directory?(migrate_path)

data/lib/generators/pg_insights/templates/db/migrate/create_pg_insights_query_executions.rb

@@ -0,0 +1,45 @@
+class CreatePgInsightsQueryExecutions < ActiveRecord::Migration[7.0]
+  def change
+    create_table :pg_insights_query_executions do |t|
+      t.references :query, null: true, foreign_key: { to_table: :pg_insights_queries }
+      t.text :sql_text, null: false
+      t.string :execution_type, null: false, default: "execute" # 'execute', 'analyze', 'both'
+      t.string :status, null: false, default: "pending" # 'pending', 'running', 'completed', 'failed'
+
+      # Execution Results
+      t.json :result_data, null: true # Query results when execution_type includes 'execute'
+      t.integer :result_rows_count, null: true
+      t.integer :result_columns_count, null: true
+
+      # Analysis Results
+      t.json :execution_plan, null: true # EXPLAIN ANALYZE output
+      t.text :plan_summary, null: true # Human-readable summary
+
+      # Performance Metrics
+      t.decimal :planning_time_ms, precision: 10, scale: 3, null: true
+      t.decimal :execution_time_ms, precision: 10, scale: 3, null: true
+      t.decimal :total_time_ms, precision: 10, scale: 3, null: true
+      t.decimal :query_cost, precision: 15, scale: 3, null: true
+
+      # Analysis Metadata
+      t.json :performance_insights, null: true # Optimization suggestions
+      t.json :execution_stats, null: true # Buffer usage, cache hits, etc.
+
+      # Error handling
+      t.text :error_message, null: true
+      t.text :error_detail, null: true
+
+      # Audit fields
+      t.timestamp :started_at, null: true
+      t.timestamp :completed_at, null: true
+      t.decimal :duration_ms, precision: 10, scale: 3, null: true
+
+      t.timestamps
+    end
+
+    add_index :pg_insights_query_executions, :execution_type
+    add_index :pg_insights_query_executions, :status
+    add_index :pg_insights_query_executions, :created_at
+    add_index :pg_insights_query_executions, [ :query_id, :created_at ]
+  end
+end

data/lib/pg_insights/version.rb

@@ -1,3 +1,3 @@
 module PgInsights
-  VERSION = "0.3.2"
+  VERSION = "0.4.0"
 end

data/lib/pg_insights.rb

@@ -5,8 +5,10 @@ module PgInsights
   mattr_accessor :enable_background_jobs, default: true
   mattr_accessor :health_cache_expiry, default: 5.minutes
   mattr_accessor :background_job_queue, default: :pg_insights_health
-  mattr_accessor :max_query_execution_time, default: 30.seconds
-  mattr_accessor :health_check_timeout, default: 10.seconds
+
+  mattr_accessor :query_execution_timeout, default: 30.seconds
+  mattr_accessor :query_analysis_timeout, default: 60.seconds
+  mattr_accessor :health_check_timeout, default: 20.seconds
 
   mattr_accessor :enable_snapshots, default: true
   mattr_accessor :snapshot_frequency, default: 1.day
@@ -17,6 +19,32 @@ module PgInsights
     yield self
   end
 
+  def self.query_execution_timeout_ms
+    validate_timeout(query_execution_timeout, "query_execution_timeout")
+    (query_execution_timeout.to_f * 1000).to_i
+  end
+
+  def self.query_analysis_timeout_ms
+    validate_timeout(query_analysis_timeout, "query_analysis_timeout")
+    (query_analysis_timeout.to_f * 1000).to_i
+  end
+
+  def self.health_check_timeout_ms
+    validate_timeout(health_check_timeout, "health_check_timeout")
+    (health_check_timeout.to_f * 1000).to_i
+  end
+
+  private
+
+  def self.validate_timeout(timeout, setting_name)
+    unless timeout.respond_to?(:to_f) && timeout.to_f > 0
+      raise ArgumentError, "#{setting_name} must be a positive number (seconds). Got: #{timeout.inspect}"
+    end
+    if timeout.to_f > 300
+      Rails.logger.warn "PgInsights: #{setting_name} is set to #{timeout.to_f}s, which is very high. Consider optimizing queries instead."
+    end
+  end
+
   def self.background_jobs_available?
     return false unless enable_background_jobs
     return false unless defined?(ActiveJob::Base)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pg_insights
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.4.0
 platform: ruby
 authors:
 - Mezbah Alam
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-07-11 00:00:00.000000000 Z
+date: 2025-08-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -51,10 +51,13 @@ files:
 - Rakefile
 - app/assets/javascripts/pg_insights/application.js
 - app/assets/javascripts/pg_insights/health.js
+- app/assets/javascripts/pg_insights/plan_performance.js
+- app/assets/javascripts/pg_insights/query_comparison.js
 - app/assets/javascripts/pg_insights/results.js
 - app/assets/javascripts/pg_insights/results/chart_renderer.js
 - app/assets/javascripts/pg_insights/results/table_manager.js
 - app/assets/javascripts/pg_insights/results/view_toggles.js
+- app/assets/stylesheets/pg_insights/analysis.css
 - app/assets/stylesheets/pg_insights/application.css
 - app/assets/stylesheets/pg_insights/health.css
 - app/assets/stylesheets/pg_insights/results.css
@@ -69,25 +72,39 @@ files:
 - app/jobs/pg_insights/database_snapshot_job.rb
 - app/jobs/pg_insights/health_check_job.rb
 - app/jobs/pg_insights/health_check_scheduler_job.rb
+- app/jobs/pg_insights/query_analysis_job.rb
 - app/jobs/pg_insights/recurring_health_checks_job.rb
 - app/models/pg_insights/application_record.rb
 - app/models/pg_insights/health_check_result.rb
 - app/models/pg_insights/query.rb
+- app/models/pg_insights/query_execution.rb
 - app/services/pg_insights/health_check_service.rb
 - app/services/pg_insights/insight_query_service.rb
+- app/services/pg_insights/query_analysis_service.rb
 - app/views/layouts/pg_insights/application.html.erb
 - app/views/pg_insights/health/index.html.erb
 - app/views/pg_insights/insights/_chart_view.html.erb
 - app/views/pg_insights/insights/_column_panel.html.erb
+- app/views/pg_insights/insights/_compare_view.html.erb
+- app/views/pg_insights/insights/_empty_state.html.erb
+- app/views/pg_insights/insights/_execution_table_view.html.erb
+- app/views/pg_insights/insights/_history_bar.html.erb
+- app/views/pg_insights/insights/_perf_view.html.erb
+- app/views/pg_insights/insights/_plan_nodes.html.erb
+- app/views/pg_insights/insights/_plan_tree.html.erb
+- app/views/pg_insights/insights/_plan_tree_modern.html.erb
+- app/views/pg_insights/insights/_plan_view.html.erb
 - app/views/pg_insights/insights/_query_examples.html.erb
 - app/views/pg_insights/insights/_query_panel.html.erb
 - app/views/pg_insights/insights/_result.html.erb
 - app/views/pg_insights/insights/_results_info.html.erb
+- app/views/pg_insights/insights/_results_info_empty.html.erb
 - app/views/pg_insights/insights/_results_panel.html.erb
 - app/views/pg_insights/insights/_results_table.html.erb
 - app/views/pg_insights/insights/_stats_view.html.erb
 - app/views/pg_insights/insights/_table_controls.html.erb
 - app/views/pg_insights/insights/_table_view.html.erb
+- app/views/pg_insights/insights/_visual_view.html.erb
 - app/views/pg_insights/insights/index.html.erb
 - app/views/pg_insights/timeline/compare.html.erb
 - app/views/pg_insights/timeline/index.html.erb
@@ -98,6 +115,7 @@ files:
 - lib/generators/pg_insights/install_generator.rb
 - lib/generators/pg_insights/templates/db/migrate/create_pg_insights_health_check_results.rb
 - lib/generators/pg_insights/templates/db/migrate/create_pg_insights_queries.rb
+- lib/generators/pg_insights/templates/db/migrate/create_pg_insights_query_executions.rb
 - lib/pg_insights.rb
 - lib/pg_insights/engine.rb
 - lib/pg_insights/version.rb