pg_insights 0.1.0

data/app/views/pg_insights/health/index.html.erb

@@ -0,0 +1,324 @@
+<div class="health-overview-section">
+  <div class="page-header">
+    <h1>Database Health Overview</h1>
+    <p>Monitor your PostgreSQL database performance and identify potential issues</p>
+  </div>
+
+  <div class="health-stats-grid">
+    <a href="#parameter-settings" class="stat-card-link">
+      <div class="stat-card">
+        <div class="stat-icon param-icon">⚙️</div>
+        <div class="stat-content">
+          <div class="stat-number"><%= (@parameter_settings.is_a?(Array) ? @parameter_settings.count : 0) %></div>
+          <div class="stat-label">Config Parameters</div>
+        </div>
+      </div>
+    </a>
+    
+    <a href="#unused-indexes" class="stat-card-link">
+      <div class="stat-card">
+        <div class="stat-icon unused-icon">🗑️</div>
+        <div class="stat-content">
+          <div class="stat-number"><%= (@unused_indexes.is_a?(Array) ? @unused_indexes.count : 0) %></div>
+          <div class="stat-label">Unused Indexes</div>
+        </div>
+      </div>
+    </a>
+    
+    <a href="#slow-queries" class="stat-card-link">
+      <div class="stat-card">
+        <div class="stat-icon slow-icon">🐌</div>
+        <div class="stat-content">
+          <div class="stat-number"><%= (@slow_queries.is_a?(Array) ? @slow_queries.count : 0) %></div>
+          <div class="stat-label">Slow Queries</div>
+        </div>
+      </div>
+    </a>
+    
+    <a href="#table-bloat" class="stat-card-link">
+      <div class="stat-card">
+        <div class="stat-icon bloat-icon">💾</div>
+        <div class="stat-content">
+          <div class="stat-number"><%= (@table_bloat.is_a?(Array) ? @table_bloat.count : 0) %></div>
+          <div class="stat-label">Bloated Tables</div>
+        </div>
+      </div>
+    </a>
+  </div>
+</div>
+
+<div class="health-details">
+  
+  <div class="health-section" id="parameter-settings">
+    <div class="section-header">
+      <h2>⚙️ Parameter Settings</h2>
+      <span class="section-description">PostgreSQL configuration parameters and recommendations</span>
+    </div>
+    
+    <div class="section-content">
+      <% if @parameter_settings.is_a?(Hash) && @parameter_settings[:error] %>
+        <div class="error-message">
+          <i class="fas fa-exclamation-triangle"></i>
+          <%= @parameter_settings[:error] %>
+        </div>
+      <% elsif @parameter_settings.nil? || @parameter_settings.empty? %>
+        <div class="info-message">
+          <i class="fas fa-info-circle"></i>
+          No parameter settings to review at this time.
+        </div>
+      <% else %>
+        <div class="items-list">
+          <% @parameter_settings.each do |param| %>
+            <div class="item-row">
+              <div class="item-main">
+                <div class="item-title"><%= param['name'] %></div>
+                <div class="item-subtitle"><%= param['short_desc'] %></div>
+              </div>
+              <div class="item-details">
+                <div class="detail-item">
+                  <span class="detail-label">Current Value:</span>
+                  <span class="detail-value">
+                    <code><%= param['setting'] %><%= param['unit'] %></code>
+                  </span>
+                </div>
+                <% if param['recommendation'] %>
+                  <div class="detail-item recommendation">
+                    <span class="detail-label">Recommendation:</span>
+                    <span class="detail-value"><%= param['recommendation'] %></span>
+                  </div>
+                <% end %>
+              </div>
+            </div>
+          <% end %>
+        </div>
+      <% end %>
+    </div>
+  </div>
+
+  <div class="health-section" id="unused-indexes">
+    <div class="section-header">
+      <h2>🗑️ Unused Indexes</h2>
+      <span class="section-description">Indexes that are rarely or never used and can be removed to save space</span>
+    </div>
+    
+    <div class="section-content">
+      <% if @unused_indexes.is_a?(Hash) && @unused_indexes[:error] %>
+        <div class="error-message">
+          <i class="fas fa-exclamation-triangle"></i>
+          <%= @unused_indexes[:error] %>
+        </div>
+      <% elsif @unused_indexes.nil? || @unused_indexes.empty? %>
+        <div class="success-message">
+          <i class="fas fa-check-circle"></i>
+          No unused indexes found - excellent database maintenance!
+        </div>
+      <% else %>
+        <div class="items-list">
+          <% @unused_indexes.each do |index| %>
+            <div class="item-row">
+              <div class="item-main">
+                <div class="item-title"><%= index['index'] %></div>
+                <div class="item-subtitle">Table: <%= index['table'] %></div>
+              </div>
+              <div class="item-details">
+                <div class="detail-item">
+                  <span class="detail-label">Size:</span>
+                  <span class="detail-value"><%= index['index_size'] %></span>
+                </div>
+                <div class="detail-item">
+                  <span class="detail-label">Scans:</span>
+                  <span class="detail-value"><%= index['index_scans'] %></span>
+                </div>
+              </div>
+            </div>
+          <% end %>
+        </div>
+      <% end %>
+    </div>
+  </div>
+
+  <div class="health-section" id="missing-indexes">
+    <div class="section-header">
+      <h2>⚠️ Potentially Missing Indexes</h2>
+      <span class="section-description">Tables with high sequential scan ratios that might benefit from indexes</span>
+    </div>
+    
+    <div class="section-content">
+      <% if @missing_indexes.is_a?(Hash) && @missing_indexes[:error] %>
+        <div class="error-message">
+          <i class="fas fa-exclamation-triangle"></i>
+          <%= @missing_indexes[:error] %>
+        </div>
+      <% elsif @missing_indexes.nil? || @missing_indexes.empty? %>
+        <div class="success-message">
+          <i class="fas fa-check-circle"></i>
+          No tables with excessive sequential scans found - good indexing strategy!
+        </div>
+      <% else %>
+        <div class="items-list">
+          <% @missing_indexes.each do |table| %>
+            <div class="item-row">
+              <div class="item-main">
+                <div class="item-title"><%= table['table'] %></div>
+                <div class="item-subtitle">Size: <%= table['table_size'] %></div>
+              </div>
+              <div class="item-details">
+                <div class="detail-item">
+                  <span class="detail-label">Sequential Scans:</span>
+                  <span class="detail-value warning"><%= table['seq_scan'] %></span>
+                </div>
+                <div class="detail-item">
+                  <span class="detail-label">Index Scans:</span>
+                  <span class="detail-value"><%= table['idx_scan'] %></span>
+                </div>
+              </div>
+            </div>
+          <% end %>
+        </div>
+      <% end %>
+    </div>
+  </div>
+
+  <div class="health-section" id="slow-queries">
+    <div class="section-header">
+      <h2>🐌 Slow Queries</h2>
+      <span class="section-description">Queries with the highest execution times that need optimization</span>
+    </div>
+    
+    <div class="section-content">
+      <% if @slow_queries.is_a?(Hash) && @slow_queries[:error] %>
+        <div class="error-message">
+          <i class="fas fa-exclamation-triangle"></i>
+          <strong>Note:</strong> This feature requires the <code>pg_stat_statements</code> extension.
+          <br><%= @slow_queries[:error] %>
+        </div>
+      <% elsif @slow_queries.nil? || @slow_queries.empty? %>
+        <div class="success-message">
+          <i class="fas fa-check-circle"></i>
+          No slow queries detected - excellent query performance!
+        </div>
+      <% else %>
+        <div class="items-list">
+          <% @slow_queries.each do |query| %>
+            <div class="item-row query-item">
+              <div class="item-main">
+                <div class="item-title">
+                  <code class="query-text"><%= truncate(query['query'], length: 80) %></code>
+                </div>
+              </div>
+              <div class="item-details">
+                <div class="detail-item">
+                  <span class="detail-label">Avg Time:</span>
+                  <span class="detail-value warning"><%= number_with_precision(query['mean_exec_time'], precision: 2) %>ms</span>
+                </div>
+                <div class="detail-item">
+                  <span class="detail-label">Total Time:</span>
+                  <span class="detail-value"><%= number_with_precision(query['total_exec_time'], precision: 2) %>ms</span>
+                </div>
+                <div class="detail-item">
+                  <span class="detail-label">Calls:</span>
+                  <span class="detail-value"><%= number_with_delimiter(query['calls']) %></span>
+                </div>
+                <div class="detail-item">
+                  <span class="detail-label">Rows:</span>
+                  <span class="detail-value"><%= number_with_delimiter(query['rows']) %></span>
+                </div>
+              </div>
+            </div>
+          <% end %>
+        </div>
+      <% end %>
+    </div>
+  </div>
+
+  <div class="health-section" id="sequential-scans">
+    <div class="section-header">
+      <h2>🔍 High Sequential Scans</h2>
+      <span class="section-description">Tables with high sequential scan activity</span>
+    </div>
+    
+    <div class="section-content">
+      <% if @sequential_scans.is_a?(Hash) && @sequential_scans[:error] %>
+        <div class="error-message">
+          <i class="fas fa-exclamation-triangle"></i>
+          <%= @sequential_scans[:error] %>
+        </div>
+      <% elsif @sequential_scans.nil? || @sequential_scans.empty? %>
+        <div class="success-message">
+          <i class="fas fa-check-circle"></i>
+          No tables with excessive sequential scans found.
+        </div>
+      <% else %>
+        <div class="items-list">
+          <% @sequential_scans.each do |scan| %>
+            <div class="item-row">
+              <div class="item-main">
+                <div class="item-title"><%= scan['table'] %></div>
+                <div class="item-subtitle">Size: <%= scan['table_size'] %></div>
+              </div>
+              <div class="item-details">
+                <div class="detail-item">
+                  <span class="detail-label">Sequential Scans:</span>
+                  <span class="detail-value warning"><%= scan['seq_scan'] %></span>
+                </div>
+                <div class="detail-item">
+                  <span class="detail-label">Rows Read:</span>
+                  <span class="detail-value"><%= number_with_delimiter(scan['seq_tup_read']) %></span>
+                </div>
+              </div>
+            </div>
+          <% end %>
+        </div>
+      <% end %>
+    </div>
+  </div>
+
+  <div class="health-section" id="table-bloat">
+    <div class="section-header">
+      <h2>💾 Table Bloat</h2>
+      <span class="section-description">Tables with significant bloat that may need maintenance</span>
+    </div>
+    
+    <div class="section-content">
+      <% if @table_bloat.is_a?(Hash) && @table_bloat[:error] %>
+        <div class="error-message">
+          <i class="fas fa-exclamation-triangle"></i>
+          <%= @table_bloat[:error] %>
+        </div>
+      <% elsif @table_bloat.nil? || @table_bloat.empty? %>
+        <div class="success-message">
+          <i class="fas fa-check-circle"></i>
+          No significant table bloat detected.
+        </div>
+      <% else %>
+        <div class="items-list">
+          <% @table_bloat.each do |bloat| %>
+            <div class="item-row">
+              <div class="item-main">
+                <div class="item-title"><%= bloat['table_name'] %></div>
+                <div class="item-subtitle">Size: <%= bloat['table_mb'] %> MB</div>
+              </div>
+              <div class="item-details">
+                <div class="detail-item">
+                  <span class="detail-label">Bloat Percentage:</span>
+                  <span class="detail-value <%= bloat['bloat_pct'].to_f > 50 ? 'danger' : 'warning' %>">
+                    <%= bloat['bloat_pct'] %>%
+                  </span>
+                </div>
+              </div>
+            </div>
+          <% end %>
+        </div>
+      <% end %>
+    </div>
+  </div>
+
+</div>
+
+<div class="health-footer">
+  <div class="footer-text">
+    <i class="fas fa-clock"></i>
+    Last updated: <%= Time.current.strftime("%B %d, %Y at %H:%M:%S %Z") %>
+  </div>
+</div>
+

data/app/views/pg_insights/insights/_chart_view.html.erb

@@ -0,0 +1,25 @@
+<% if should_show_chart?(@result) %>
+  <div class="chart-container" id="chart-view" style="display: none;" data-chart-data="<%= prepare_chart_data(@result).to_json %>">
+    <div class="chart-controls">
+      <label class="chart-label">Chart Type:</label>
+      <select id="chartType" class="chart-select">
+        <option value="bar">Bar Chart</option>
+        <option value="line">Line Chart</option>
+        <option value="pie">Pie Chart</option>
+        <option value="area">Area Chart</option>
+      </select>
+    </div>
+
+    <div id="dynamicChart" class="chart-display">
+      <%= render_chart(@result) %>
+    </div>
+  </div>
+<% else %>
+  <div class="chart-container" id="chart-view" style="display: none;">
+    <div class="no-chart-message">
+      <span class="chart-icon">📊</span>
+      <h3>Charts not available</h3>
+      <p>Charts work best with 2-3 columns containing numeric data</p>
+    </div>
+  </div>
+<% end %>

data/app/views/pg_insights/insights/_column_panel.html.erb

@@ -0,0 +1,18 @@
+<div id="columnPanel" class="column-panel" style="display: none;">
+  <div class="column-panel-header">
+    <h4>Show/Hide Columns</h4>
+    <div class="column-panel-actions">
+      <button type="button" id="showAllColumns" class="panel-btn">Show All</button>
+      <button type="button" id="hideAllColumns" class="panel-btn">Hide All</button>
+    </div>
+  </div>
+
+  <div class="column-checkboxes">
+    <% @result.columns.each_with_index do |column, index| %>
+      <div class="column-checkbox">
+        <input type="checkbox" id="col-<%= index + 1 %>" class="column-toggle" data-column="<%= index + 1 %>" checked>
+        <label for="col-<%= index + 1 %>" class="checkbox-label"><%= column %></label>
+      </div>
+    <% end %>
+  </div>
+</div>

data/app/views/pg_insights/insights/_query_examples.html.erb

@@ -0,0 +1,32 @@
+<div class="query-examples-section">
+  <div class="examples-header">
+    <span class="examples-label">Query Examples</span>
+    <div class="category-filters">
+      <% filter_buttons_data.each do |filter| %>
+        <button type="button" 
+                class="filter-btn <%= 'active' if filter[:active] %>" 
+                data-category="<%= filter[:category] %>">
+          <%= filter[:label] %>
+        </button>
+      <% end %>
+    </div>
+  </div>
+
+  <div class="query-examples-grid">
+    <% @insight_queries.each do |query| %>
+      <button type="button"
+              class="query-example-btn"
+              data-query-id="<%= query[:id] %>"
+              data-category="<%= query[:category] %>"
+              title="<%= query[:description] %>">
+        <div class="query-btn-content">
+          <span class="query-name"><%= query[:name] %></span>
+          <span class="query-desc"><%= query[:description] %></span>
+          <span class="<%= query_category_badge_class(query[:category]) %>">
+            <%= query[:category].to_s.titleize %>
+          </span>
+        </div>
+      </button>
+    <% end %>
+  </div>
+</div>

data/app/views/pg_insights/insights/_query_panel.html.erb

@@ -0,0 +1,36 @@
+<div class="query-panel">
+  <div class="query-section">
+    <%= form_with url: pg_insights.root_path, method: :post, local: true, class: "query-form" do |f| %>
+      <div class="form-header">
+        <div class="preview-tables-dropdown">
+          <select id="table-preview-select" class="table-select">
+            <option value="">📊 Preview Tables</option>
+          </select>
+        </div>
+        <div class="header-actions">
+          <button type="button" class="btn-icon btn-copy" onclick="copyCurrentQuery()" title="Copy query to clipboard">📋</button>
+          <button type="button" class="btn-icon btn-save" onclick="saveCurrentQuery()" title="Save query">💾</button>
+        </div>
+      </div>
+
+      <div class="form-content">
+        <%= f.text_area :sql,
+                        rows: 12,
+                        class: "sql-editor",
+                        placeholder: sql_placeholder_text,
+                        value: params[:sql] %>
+      </div>
+
+      <div class="form-actions">
+        <%= f.submit "Execute", class: "btn btn-primary", id: "execute-btn" %>
+        <button type="button" class="btn btn-secondary" onclick="clearQuery()">Clear</button>
+      </div>
+
+      <%= render "query_examples" %>
+
+      <div class="query-info">
+        <small>SELECT only • 5s timeout • 1k row limit</small>
+      </div>
+    <% end %>
+  </div>
+</div>

data/app/views/pg_insights/insights/_result.html.erb

@@ -0,0 +1,15 @@
+<% if @result.present? %>
+  <div class="results-section">
+    <%= render "results_info" %>
+    <%= render "chart_view" %>
+    <%= render "stats_view" %>
+    <%= render "table_view" %>
+  </div>
+<% elsif flash.now[:alert] %>
+  <div class="results-section">
+    <div class="error-message">
+      <span class="error-icon">⚠️</span>
+      <strong>Error:</strong> <%= flash.now[:alert] %>
+    </div>
+  </div>
+<% end %>

data/app/views/pg_insights/insights/_results_info.html.erb

@@ -0,0 +1,19 @@
+<div class="results-info">
+  <div class="results-meta">
+    <%= "#{@result.rows.size} records • #{@result.columns.size} columns" if @result %>
+  </div>
+
+  <div class="view-toggle">
+    <button type="button" class="toggle-btn active" data-view="table">
+      <span class="toggle-icon">📊</span> Table
+    </button>
+    <% if should_show_chart?(@result) %>
+      <button type="button" class="toggle-btn" data-view="chart">
+        <span class="toggle-icon">📈</span> Chart
+      </button>
+    <% end %>
+    <button type="button" class="toggle-btn" data-view="stats">
+      <span class="toggle-icon">📋</span> Stats
+    </button>
+  </div>
+</div>

data/app/views/pg_insights/insights/_results_panel.html.erb

@@ -0,0 +1,13 @@
+<div class="results-panel">
+  <% if @result.nil? %>
+    <div class="empty-results">
+      <div class="empty-content">
+        <div class="empty-icon">📊</div>
+        <h3>Ready to Query</h3>
+        <p>Enter a SELECT query on the left and click Execute to see results here.</p>
+      </div>
+    </div>
+  <% else %>
+    <%= render "result" %>
+  <% end %>
+</div>

data/app/views/pg_insights/insights/_results_table.html.erb

@@ -0,0 +1,45 @@
+<div class="table-wrapper">
+  <div id="tableScroll" class="table-scroll" tabindex="0">
+    <table id="resultsTable" class="results-table">
+      <!-- Sticky Header -->
+      <thead class="sticky-header">
+        <tr>
+          <th class="row-num">#</th>
+          <% @result.columns.each_with_index do |column, index| %>
+            <th data-column="<%= index + 1 %>">
+              <div class="table-header-content">
+                <span class="header-text"><%= column %></span>
+                <span class="header-type">text</span>
+              </div>
+            </th>
+          <% end %>
+        </tr>
+      </thead>
+
+      <!-- Table Body -->
+      <tbody>
+        <% @result.rows.each_with_index do |row, row_index| %>
+          <tr class="<%= 'even-row' if row_index.even? %>">
+            <td class="row-num"><%= row_index + 1 %></td>
+            <% row.each_with_index do |cell, col_index| %>
+              <td data-column="<%= col_index + 1 %>">
+                <span class="cell-content <%= cell_value_class(cell) %>">
+                  <%= format_cell_value(cell) %>
+                </span>
+              </td>
+            <% end %>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  </div>
+
+  <!-- Scroll Indicators -->
+  <div id="scrollIndicatorH" class="scroll-indicator scroll-indicator-horizontal">
+    <div id="scrollThumbH" class="scroll-thumb"></div>
+  </div>
+
+  <div id="scrollIndicatorV" class="scroll-indicator scroll-indicator-vertical">
+    <div id="scrollThumbV" class="scroll-thumb"></div>
+  </div>
+</div>

data/app/views/pg_insights/insights/_stats_view.html.erb

@@ -0,0 +1,3 @@
+<div class="stats-container" id="stats-view" style="display: none;">
+  <%= render_stats(@result) %>
+</div>

data/app/views/pg_insights/insights/_table_controls.html.erb

@@ -0,0 +1,21 @@
+<div class="table-controls">
+  <div class="table-info">
+    <%= "#{@result.rows.size} rows × #{@result.columns.size} columns" if @result %>
+  </div>
+
+  <div class="table-actions">
+    <% if @result && @result.columns.size > 10 %>
+      <button type="button" id="toggleColumns" class="table-btn">
+        <span class="btn-icon">👁️</span> Show/Hide Columns
+      </button>
+    <% end %>
+    
+    <button type="button" id="fitColumns" class="table-btn">
+      <span class="btn-icon">📏</span> Fit Columns
+    </button>
+    
+    <button type="button" id="resetTable" class="table-btn">
+      <span class="btn-icon">🔄</span> Reset
+    </button>
+  </div>
+</div>

data/app/views/pg_insights/insights/_table_view.html.erb

@@ -0,0 +1,5 @@
+<div class="table-container" id="table-view">
+  <%= render "table_controls" %>
+  <%= render "column_panel" if @result && @result.columns.size > 10 %>
+  <%= render "results_table" %>
+</div>

data/app/views/pg_insights/insights/index.html.erb

@@ -0,0 +1,5 @@
+
+<div class="insights-container" data-queries="<%= @insight_queries.to_json %>">
+  <%= render "query_panel" %>
+  <%= render "results_panel" %>
+</div>

data/config/default_queries.yml

@@ -0,0 +1,85 @@
+- id: 'table_sizes'
+  name: 'Table Sizes'
+  description: 'Database table sizes (great for charts!)'
+  category: 'database'
+  sql: >
+    SELECT
+      tablename as "Table Name",
+      pg_total_relation_size(schemaname||'.'||tablename) as "Size (Bytes)"
+    FROM pg_tables
+    WHERE schemaname = 'public'
+    ORDER BY pg_total_relation_size(schemaname||'.'||tablename) DESC
+    LIMIT 10
+
+- id: 'table_activity'
+  name: 'Table Activity'
+  description: 'Table insert/update/delete statistics'
+  category: 'database'
+  sql: >
+    SELECT
+      schemaname || '.' || relname as "Table",
+      n_tup_ins as "Inserts",
+      n_tup_upd as "Updates",
+      n_tup_del as "Deletes"
+    FROM pg_stat_user_tables
+    WHERE schemaname = 'public'
+    ORDER BY (n_tup_ins + n_tup_upd + n_tup_del) DESC
+    LIMIT 8
+
+- id: 'index_usage'
+  name: 'Index Usage'
+  description: 'Index usage statistics'
+  category: 'database'
+  sql: >
+    SELECT
+      schemaname || '.' || indexrelname as "Index",
+      idx_scan as "Scans",
+      idx_tup_read as "Tuples Read"
+    FROM pg_stat_user_indexes
+    WHERE schemaname = 'public'
+      AND idx_scan > 0
+    ORDER BY idx_scan DESC
+    LIMIT 10
+
+- id: 'unused_indexes'
+  name: 'Unused Indexes'
+  description: 'Indexes that have never been scanned (possible cleanup candidates).'
+  category: 'database'
+  sql: >
+    SELECT
+      schemaname || '.' || indexrelname as "Index",
+      idx_scan as "Scans",
+      pg_size_pretty(pg_relation_size(indexrelid)) as "Index Size"
+    FROM pg_stat_user_indexes
+    WHERE schemaname = 'public' AND idx_scan = 0
+    ORDER BY pg_relation_size(indexrelid) DESC
+    LIMIT 12
+
+- id: 'slowest_queries'
+  name: 'Slowest Queries'
+  description: 'Top slowest queries by mean execution time.'
+  category: 'database'
+  sql: >
+    SELECT
+      query,
+      calls,
+      ROUND(mean_exec_time::numeric,2) as "Mean Time (ms)",
+      ROUND(total_exec_time::numeric,2) as "Total Time (ms)"
+    FROM pg_stat_statements
+    ORDER BY mean_exec_time DESC
+    LIMIT 10
+
+- id: 'table_bloat'
+  name: 'Table Bloat Estimate'
+  description: 'Estimate of wasted space in tables due to bloat.'
+  category: 'database'
+  sql: >
+    SELECT
+      relname as "Table",
+      n_live_tup as "Live Rows",
+      n_dead_tup as "Dead Rows",
+      pg_size_pretty(pg_table_size(relid)) as "Table Size"
+    FROM pg_stat_user_tables
+    WHERE n_dead_tup > 0 AND schemaname = 'public'
+    ORDER BY n_dead_tup DESC
+    LIMIT 10