pg_reports 0.8.2 → 0.9.0

data/config/locales/uk.yml

@@ -556,7 +556,7 @@ uk:
         page_title: "PgReports — Дашборд"
       navigation:
         dashboard: "Дашборд"
-        back: "← Назад"
+        back: "Назад"
       database_selector:
         label: "База даних"
       target_selector:
@@ -564,40 +564,41 @@ uk:
       actions:
         cancel: "Скасувати"
         retry: "Повторити"
-        copy: "📋 Копіювати"
-        copy_query: "📋 Копіювати запит"
-        copy_code: "📋 Копіювати код"
+        copy: "Копіювати"
+        copy_query: "Копіювати запит"
+        copy_code: "Копіювати код"
         copy_to_clipboard_title: "Скопіювати в буфер обміну"
-        copied_feedback: "✓ Скопійовано!"
+        copied_feedback: "Скопійовано!"
         clear_all: "Очистити все"
-        run_report: "▶ Запустити звіт"
-        export: "⬇ Експорт"
-        download_text: "📄 Текст (.txt)"
-        download_csv: "📊 CSV (.csv)"
-        download_json: "📋 JSON (.json)"
-        download: "📥 Завантажити"
+        run_report: "Запустити звіт"
+        export: "Експорт"
+        download_text: "Текст (.txt)"
+        download_csv: "CSV (.csv)"
+        download_json: "JSON (.json)"
+        download: "Завантажити"
         copy_ai_prompt: "Копіювати промпт"
-        send_telegram: "📨 Telegram"
+        send_telegram: "Telegram"
         sending: "Надсилання..."
-        reset_statistics: "🗑️ Скинути статистику"
+        reset_statistics: "Скинути статистику"
         resetting: "Скидання..."
         confirm_reset: "Так, скинути"
-        create_extension: "⚡ Створити розширення"
+        create_extension: "Створити розширення"
         creating: "Створення..."
         ide_settings_button_title: "Налаштування IDE"
-        explain_analyze: "📊 EXPLAIN ANALYZE"
-        execute_query: "▶ Виконати запит"
+        explain_analyze: "EXPLAIN ANALYZE"
+        execute_query: "Виконати запит"
         run_query: "SQL-консоль"
-        create_migration_file: "📁 Створити файл і відкрити в IDE"
-        start_monitoring: "▶ Запустити моніторинг"
-        stop_monitoring: "⏹ Зупинити моніторинг"
+        create_migration_file: "Створити файл і відкрити в IDE"
+        start_monitoring: "Запустити моніторинг"
+        stop_monitoring: "Зупинити моніторинг"
         starting: "Запуск..."
         stopping: "Зупинка..."
-        load_history: "📜 Завантажити історію (50)"
+        load_history: "Завантажити історію"
+        load_history_unavailable_title: "Збереженої історії немає — задайте config.query_monitor_log_file, щоб запити зберігалися між перезапусками"
         loading: "Завантаження..."
         running: "Виконання..."
-        save_for_comparison: "📌 Зберегти для порівняння"
-        saved_marker: "📌 Збережено"
+        save_for_comparison: "Зберегти для порівняння"
+        saved_marker: "Збережено"
       status:
         pg_stat_ready: "Активно"
         not_preloaded: "Потрібне передзавантаження"
@@ -615,19 +616,20 @@ uk:
         create_extension_title: "Створення розширення pg_stat_statements"
         create_extension_intro: "Розширення pg_stat_statements ще не створено в цій базі даних. Натисніть, щоб створити його:"
         create_extension_note: "Якщо бібліотеку не передзавантажено, її також потрібно додати до shared_preload_libraries та перезапустити PostgreSQL."
-        reset_stats_title: "⚠️ Скидання статистики"
+        reset_stats_title: "Скидання статистики"
         reset_stats_confirm: "Ви впевнені, що хочете скинути статистику pg_stat_statements?"
         reset_stats_warning: "Ця дія очистить усю зібрану статистику запитів і не може бути скасована."
-        ide_settings_title: "⚙️ Налаштування IDE"
-        problem_detected_title: "⚠️ Виявлено проблему"
-        query_analyzer_title: "📊 Аналізатор запиту"
+        ide_settings_title: "Налаштування IDE"
+        problem_detected_title: "Виявлено проблему"
+        query_analyzer_title: "Аналізатор запиту"
         query_label: "Запит:"
         parameters_label: "Параметри:"
-        migration_title: "🗑️ Міграція видалення індексу"
+        migration_title: "Міграція видалення індексу"
         migration_subtitle: "Згенерована міграція для видалення індексу:"
         migration_warning: "Створення міграції згенерує файл міграції у вашому проєкті. Запуск цієї міграції видалить індекс із БД, що може значно вплинути на продуктивність застосунку."
         migration_warning_dev_only: "Цю операцію слід виконувати лише в локальному dev-середовищі."
-        query_execution_disabled_title: "⚠️ Виконання запитів вимкнено"
+        query_execution_disabled_title: "Виконання запитів вимкнено"
+        migration_disabled_title: "Створення міграцій вимкнено"
         query_execution_disabled_intro: "Щоб увімкнути цю функцію, додайте до конфігурації:"
         query_execution_disabled_env_note: "...або замість цього встановіть змінну середовища:"
         run_query_title: "SQL-консоль"
@@ -670,25 +672,27 @@ uk:
         waiting_for_locks: "чекають блокувань"
         percent_used_suffix: "% використано"
       categories:
-        requires_pg_stat: "🔒 Потрібен pg_stat_statements"
+        requires_pg_stat: "Потрібен pg_stat_statements"
+        pg_stat_missing_reason: "Потрібен pg_stat_statements, але розширення не встановлено в базі «%{database}». Створіть його там або перемкніться на базу, де воно є."
+        pg_stat_not_preloaded_reason: "Потрібен pg_stat_statements. Розширення є в базі «%{database}», але відсутнє в shared_preload_libraries — даних не буде, доки PostgreSQL не перезапустять із ним."
         reports_count_suffix: "звітів"
-        primary_only_reason: "🔒 Ця категорія працює лише на первинній базі — вона перевіряє моделі хост-застосунку. Щоб користуватися, перемкніться на базу за замовчуванням."
-        standalone_no_host_app_reason: "🔒 Недоступно в автономному режимі — ця категорія перевіряє моделі хост-застосунку, а при самостійному запуску дашборда хост-застосунку немає."
+        primary_only_reason: "Ця категорія працює лише на первинній базі — вона перевіряє моделі хост-застосунку. Щоб користуватися, перемкніться на базу за замовчуванням."
+        standalone_no_host_app_reason: "Недоступно в автономному режимі — ця категорія перевіряє моделі хост-застосунку, а при самостійному запуску дашборда хост-застосунку немає."
       documentation:
-        toggle_title: "📖 Що показує цей звіт?"
-        what_section: "📋 Що"
-        why_section: "❓ Чому це важливо"
-        nuances_section: "⚠️ Нюанси"
-        thresholds_section: "📊 Пороги"
-        threshold_warning_label: "⚠️ Warning:"
-        threshold_critical_label: "🔴 Critical:"
+        toggle_title: "Що показує цей звіт?"
+        what_section: "Що"
+        why_section: "Чому це важливо"
+        nuances_section: "Нюанси"
+        thresholds_section: "Пороги"
+        threshold_warning_label: "Warning:"
+        threshold_critical_label: "Critical:"
         threshold_inverted_note: "(менше — гірше)"
       filters:
-        title: "🔍 Параметри фільтрації"
+        title: "Параметри фільтрації"
         current_value: "зараз"
       saved:
-        title: "📌 Збережено для порівняння"
-        saved_at_prefix: "▸ Збережено:"
+        title: "Збережено для порівняння"
+        saved_at_prefix: "Збережено:"
         click_to_expand: "Натисніть, щоб розгорнути"
         confirm_clear_all: "Видалити всі збережені записи для цього звіту?"
         remove_title: "Видалити"
@@ -702,9 +706,9 @@ uk:
         execution_time_label: "Час виконання:"
         null_placeholder: "<null>"
       sections:
-        recommendation: "💡 Рекомендація"
-        detected_issues: "⚠️ Виявлені проблеми"
-        execution_plan: "📊 План виконання"
+        recommendation: "Рекомендація"
+        detected_issues: "Виявлені проблеми"
+        execution_plan: "План виконання"
         line_label: "Рядок"
         current_label: "Поточне:"
         threshold_label: "Поріг:"
@@ -712,8 +716,8 @@ uk:
         warning_eq: "warning"
         critical_eq: "critical"
       levels:
-        critical: "🔴 Критично"
-        warning: "⚠️ Увага"
+        critical: "Критично"
+        warning: "Увага"
       errors:
         error_prefix: "Помилка:"
         unable_fetch_metrics: "Не вдалося отримати статистику БД."
@@ -741,8 +745,9 @@ uk:
         run_query_failed: "Не вдалося виконати запит"
         query_required: "Введіть запит"
         create_migration_failed: "Не вдалося створити міграцію"
-        explain_disabled_toast: "⚠️ EXPLAIN ANALYZE вимкнено. Увімкніть у конфігурації: config.allow_raw_query_execution = true"
-        execute_disabled_toast: "⚠️ Виконання запитів вимкнено. Увімкніть у конфігурації: config.allow_raw_query_execution = true"
+        explain_disabled_toast: "EXPLAIN ANALYZE вимкнено. Увімкніть у конфігурації: config.allow_raw_query_execution = true"
+        execute_disabled_toast: "Виконання запитів вимкнено. Увімкніть у конфігурації: config.allow_raw_query_execution = true"
+        migration_disabled_toast: "Створення міграцій вимкнено. Увімкніть у конфігурації: config.allow_raw_query_execution = true"
         query_monitoring_error: "Помилка моніторингу запитів"
         query_hash_required: "Потрібен хеш запиту"
         query_execution_disabled: "Виконання запитів із дашборду вимкнено. Увімкніть у конфігурації: 'config.allow_raw_query_execution = true'"

data/lib/pg_reports/connection/error_translator.rb

@@ -9,6 +9,16 @@ module PgReports
     #   PgReports::Connection::ErrorTranslator.translate(error)
     #   # => { title: "...", detail: "...", hint: "GRANT ...", code: "42501" }
     module ErrorTranslator
+      # Relations the reports read that are supplied by an extension rather than
+      # by core PostgreSQL. Used to turn "relation X does not exist" into the
+      # actionable "extension Y isn't installed here".
+      EXTENSION_RELATIONS = {
+        "pg_stat_statements" => "pg_stat_statements",
+        "pg_stat_statements_info" => "pg_stat_statements",
+        "pgstattuple" => "pgstattuple",
+        "pg_buffercache" => "pg_buffercache"
+      }.freeze
+
       module_function
 
       # Returns a Hash with :title, :detail, :hint, :code, :raw_message.
@@ -23,6 +33,8 @@ module PgReports
         when "28000", "28P01" then auth_failed(message)
         when "08001", "08006", "08000", "08003", "08004" then connection_refused(message)
         when "53300" then too_many_connections(message)
+        when "42P01" then undefined_table(message)
+        when "42883" then undefined_function(message)
         else generic(error)
         end
 
@@ -92,6 +104,37 @@ module PgReports
         }
       end
 
+      # A report asked for a relation this database doesn't have. Almost always an
+      # extension that exists on one database in the cluster but not the one
+      # currently selected — extensions are per-database, the dashboard is not.
+      def undefined_table(message)
+        target = extract_object(message, /relation "([^"]+)" does not exist/)
+
+        if target && EXTENSION_RELATIONS.key?(target)
+          extension = EXTENSION_RELATIONS.fetch(target)
+          return {
+            title: "#{extension} not available",
+            detail: "This report reads \"#{target}\", which does not exist on the selected database.",
+            hint: "CREATE EXTENSION IF NOT EXISTS #{extension};"
+          }
+        end
+
+        {
+          title: "Relation not found",
+          detail: target ? "The selected database has no relation named \"#{target}\"." : "The report referenced a relation that does not exist on the selected database.",
+          hint: nil
+        }
+      end
+
+      def undefined_function(message)
+        target = extract_object(message, /function ([\w.]+)\(/)
+        {
+          title: "Function not found",
+          detail: target ? "The selected database has no function named \"#{target}\"." : "The report called a function that does not exist on the selected database.",
+          hint: "It is usually provided by an extension that is not installed on this database."
+        }
+      end
+
       def generic(error)
         {
           title: error.class.name.split("::").last,

data/lib/pg_reports/dashboard/reports_registry.rb

@@ -237,6 +237,10 @@ module PgReports
           name: "Queries",
           icon: "⚡",
           color: "#6366f1",
+          # Every report here reads the pg_stat_statements view. The extension is
+          # created per-database, so availability has to be re-checked against
+          # whichever database the dashboard is pointed at — not once at boot.
+          requires: :pg_stat_statements,
           reports: {
             slow_queries: {name: "Slow Queries", description: "Queries with high mean execution time"},
             heavy_queries: {name: "Heavy Queries", description: "Most frequently called queries"},
@@ -412,6 +416,12 @@ module PgReports
       def self.target_constraint(category)
         REPORTS.dig(category.to_sym, :target_constraint)
       end
+
+      # A database-level dependency the whole category needs, or nil. Currently
+      # only :pg_stat_statements — the caller resolves what "available" means.
+      def self.requires(category)
+        REPORTS.dig(category.to_sym, :requires)
+      end
     end
   end
 end

data/lib/pg_reports/explain_analyzer.rb

@@ -313,15 +313,12 @@ module PgReports
       if @summary[:critical_problems] > 0
         @summary[:status] = "critical"
         @summary[:status_text] = "Critical issues detected"
-        @summary[:status_icon] = "🔴"
       elsif @summary[:warnings] > 0
         @summary[:status] = "warning"
         @summary[:status_text] = "Potential issues detected"
-        @summary[:status_icon] = "🟡"
       else
         @summary[:status] = "good"
         @summary[:status_text] = "No issues detected"
-        @summary[:status_icon] = "🟢"
       end
 
       # Group problems by type for summary

data/lib/pg_reports/query_monitor.rb

@@ -106,10 +106,18 @@ module PgReports
       {
         enabled: enabled,
         session_id: session_id,
-        query_count: @queries.size
+        query_count: @queries.size,
+        history_available: history_available?
       }
     end
 
+    # Whether #load_from_log has anything to return. History is persisted only
+    # when a log file is configured, and the file exists only once something has
+    # been written to it — without both, "Load history" can only ever no-op.
+    def history_available?
+      log_file_enabled? && File.exist?(log_file_path)
+    end
+
     def queries(limit: nil, session_id: nil)
       result = @queries.dup
 
@@ -348,6 +356,10 @@ module PgReports
       end
     end
 
+    # JSON.generate, not #to_json: ActiveSupport overrides #to_json and (up to
+    # Rails 7.0) passes json's removed `quirks_mode` option, so on json >= 3 it
+    # raises ArgumentError. The rescue below would swallow that and leave the
+    # log silently empty. json's own generator takes no such option.
     def write_session_marker(marker_type, sid = @session_id)
       return unless log_file_enabled?
 
@@ -358,7 +370,7 @@ module PgReports
       }
 
       File.open(log_file_path, "a") do |f|
-        f.puts marker.to_json
+        f.puts JSON.generate(marker)
       end
     rescue => e
       # Silently fail - don't break monitoring if file write fails
@@ -371,7 +383,7 @@ module PgReports
 
       File.open(log_file_path, "a") do |f|
         @queries.each do |query|
-          f.puts query.to_json
+          f.puts JSON.generate(query)
         end
       end
     rescue => e

data/lib/pg_reports/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PgReports
-  VERSION = "0.8.2"
+  VERSION = "0.9.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pg_reports
 version: !ruby/object:Gem::Version
-  version: 0.8.2
+  version: 0.9.0
 platform: ruby
 authors:
 - Eldar Avatov