solid_observer 0.5.0 → 0.6.0

data/lib/solid_observer/services/health_score.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+require "active_support/core_ext/numeric/time"
+
+module SolidObserver
+  module Services
+    class HealthScore
+      STATUS_RANK = {stable: 0, degraded: 1, critical: 2}.freeze
+      UNAVAILABLE = {status: :degraded, available: false}.freeze
+      WINDOW = 15.minutes
+
+      def self.call
+        new.call
+      end
+
+      def call
+        components = collect_components
+        {
+          overall: overall_status(components.values.map { |entry| entry[:status] }),
+          components: components
+        }
+      end
+
+      private
+
+      # :reek:FeatureEnvy
+      # :reek:TooManyStatements
+      def collect_components
+        config = SolidObserver.config
+        components = {}
+
+        components[:queue] = queue_component if config.solid_queue_enabled?
+
+        unless config.realtime_mode?
+          components[:cache] = stats_component(:cache, CacheStats) if config.solid_cache_enabled?
+          components[:cable] = stats_component(:cable, CableStats) if config.solid_cable_enabled?
+        end
+
+        components
+      end
+
+      def queue_component
+        snapshot = SolidObserver::QueueStats.snapshot
+        return UNAVAILABLE.dup unless snapshot[:available]
+
+        {status: queue_stability(snapshot), available: true}
+      rescue => error
+        degrade(:queue, error)
+      end
+
+      def queue_stability(snapshot)
+        return :critical if snapshot[:failed_last_hour].to_i.positive?
+        return :degraded if snapshot[:failed_last_24h].to_i.positive?
+
+        :stable
+      end
+
+      def stats_component(name, stats_class)
+        stability = stats_class.call(window: WINDOW)[:stability]
+        return UNAVAILABLE.dup unless stability&.[](:available)
+
+        {status: stability[:state] || :degraded, available: true}
+      rescue => error
+        degrade(name, error)
+      end
+
+      def overall_status(statuses)
+        return :stable if statuses.empty?
+
+        statuses.max_by { |status| STATUS_RANK.fetch(status, 1) }
+      end
+
+      def degrade(name, error)
+        log_component_error(name, error)
+        UNAVAILABLE.dup
+      end
+
+      def log_component_error(name, error)
+        return unless defined?(Rails)
+
+        Rails.logger&.warn("HealthScore #{name} error: #{error.message}")
+      end
+    end
+  end
+end

data/lib/solid_observer/services/record_cable_event.rb

@@ -52,6 +52,7 @@ module SolidObserver
       def build_event_data
         {
           event_type: @event.name.delete_suffix(".action_cable"),
+          correlation_id: CorrelationIdResolver.resolve(@event),
           channel_class: channel_class,
           broadcasting_digest: broadcasting_digest,
           duration: duration_in_seconds,

data/lib/solid_observer/services/record_cache_event.rb

@@ -55,6 +55,7 @@ module SolidObserver
       def build_event_data
         {
           event_type: cache_operation,
+          correlation_id: CorrelationIdResolver.resolve(@event),
           key_digest: key_digest,
           hit: hit_value,
           duration: duration_in_seconds,

data/lib/solid_observer/services/unified_feed.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+module SolidObserver
+  module Services
+    class UnifiedFeed
+      SAFE_KEYS = %i[component event_type recorded_at detail correlation_id error_class].freeze
+
+      def self.call(limit: 20)
+        new(limit: limit).call
+      end
+
+      def initialize(limit:)
+        @limit = limit
+        @config = SolidObserver.config
+      end
+
+      def call
+        return [] if @config.realtime_mode?
+
+        rows = []
+        rows.concat(queue_rows) if @config.solid_queue_enabled?
+        rows.concat(cache_rows) if @config.solid_cache_enabled?
+        rows.concat(cable_rows) if @config.solid_cable_enabled?
+
+        rows.sort_by { |row| row[:recorded_at] || Time.at(0) }.reverse.first(@limit)
+      end
+
+      private
+
+      def queue_rows
+        QueueEvent.recent(@limit).map { |e| normalize_queue(e) }
+      rescue => error
+        log_error(:queue, error)
+        []
+      end
+
+      def cache_rows
+        CacheEvent.recent(@limit).map { |e| normalize_cache(e) }
+      rescue => error
+        log_error(:cache, error)
+        []
+      end
+
+      def cable_rows
+        CableEvent.recent(@limit).map { |e| normalize_cable(e) }
+      rescue => error
+        log_error(:cable, error)
+        []
+      end
+
+      def normalize_queue(event)
+        {
+          component: :queue,
+          event_type: event.event_type,
+          recorded_at: event.recorded_at,
+          detail: [event.job_class, event.queue_name].compact.join(" · "),
+          correlation_id: event.correlation_id,
+          error_class: nil # queue events have no error_class column
+        }
+      end
+
+      def normalize_cache(event)
+        {
+          component: :cache,
+          event_type: event.event_type,
+          recorded_at: event.recorded_at,
+          detail: cache_detail(event),
+          correlation_id: event.correlation_id,
+          error_class: event.error_class
+        }
+      end
+
+      def normalize_cable(event)
+        {
+          component: :cable,
+          event_type: event.event_type,
+          recorded_at: event.recorded_at,
+          detail: cable_detail(event),
+          correlation_id: event.correlation_id,
+          error_class: event.error_class
+        }
+      end
+
+      def cache_detail(event)
+        digest = event.key_digest.to_s
+        digest = "#{digest.first(10)}…" if digest.length > 10
+        digest
+      end
+
+      def cable_detail(event)
+        event.channel_class.presence || event.broadcasting_digest.to_s.first(10)
+      end
+
+      def log_error(component, error)
+        return unless defined?(Rails) && Rails.logger
+
+        Rails.logger.warn("UnifiedFeed #{component} error: #{error.message}")
+      end
+    end
+  end
+end

data/lib/solid_observer/version.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module SolidObserver
-  VERSION = "0.5.0"
+  VERSION = "0.6.0"
   RUBY_MINIMUM_VERSION = "3.2.0"
   RAILS_MINIMUM_VERSION = "8.0"
 end

data/lib/solid_observer.rb

@@ -5,6 +5,7 @@ require "active_support/lazy_load_hooks"
 require_relative "solid_observer/version"
 require_relative "solid_observer/configuration"
 require_relative "solid_observer/correlation_id_resolver"
+require_relative "solid_observer/correlated"
 require_relative "solid_observer/params/jobs_filter"
 require_relative "solid_observer/params/events_filter"
 require_relative "solid_observer/services/ui_auth_check"
@@ -13,6 +14,8 @@ require_relative "solid_observer/cli/base"
 require_relative "solid_observer/cli/status"
 require_relative "solid_observer/cli/storage"
 require_relative "solid_observer/cli/jobs"
+require_relative "solid_observer/cli/trace"
+require_relative "solid_observer/cli/health"
 require_relative "solid_observer/queue_stats"
 require_relative "solid_observer/engine" if defined?(Rails::Engine)
 
@@ -22,6 +25,7 @@ ActiveSupport.on_load(:active_record) do
   require_relative "solid_observer/base_metric"
   require_relative "solid_observer/queries/job_executions_query"
   require_relative "solid_observer/queries/events_query"
+  require_relative "solid_observer/queries/trace_query"
   require_relative "solid_observer/queries/execution_finder"
   require_relative "solid_observer/services/record_event"
   require_relative "solid_observer/services/flush_event_buffer"
@@ -45,6 +49,8 @@ ActiveSupport.on_load(:active_record) do
   require_relative "solid_observer/services/flush_cable_event_buffer"
   require_relative "solid_observer/services/cable_stats"
   require_relative "solid_observer/services/cable_operations"
+  require_relative "solid_observer/services/health_score"
+  require_relative "solid_observer/services/unified_feed"
 end
 
 module SolidObserver

data/lib/tasks/solid_observer.rake

@@ -204,11 +204,26 @@ namespace :solid_observer do
     SolidObserver::CLI::Status.call
   end
 
+  desc "Display aggregate and per-component health status"
+  task health: :environment do
+    SolidObserver::CLI::Health.call
+  end
+
   desc "Display storage information and database statistics"
   task storage: :environment do
     SolidObserver::CLI::Storage.call
   end
 
+  desc "Show the cross-component trace for a correlation_id"
+  task :trace, [:correlation_id, :limit] => :environment do |_t, args|
+    if args[:correlation_id].nil?
+      puts "Error: correlation_id required. Usage: rails solid_observer:trace[CORRELATION_ID,LIMIT]"
+      exit 1
+    end
+
+    SolidObserver::CLI::Trace.call(correlation_id: args[:correlation_id], limit: args[:limit])
+  end
+
   namespace :jobs do
     desc "List jobs with optional filters (status, queue, class, limit)"
     task :list, [:status, :queue, :job_class, :limit] => :environment do |_t, args|

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: solid_observer
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - BartOz
@@ -62,6 +62,7 @@ files:
 - app/controllers/solid_observer/events_controller.rb
 - app/controllers/solid_observer/jobs_controller.rb
 - app/controllers/solid_observer/storages_controller.rb
+- app/controllers/solid_observer/traces_controller.rb
 - app/helpers/solid_observer/application_helper.rb
 - app/helpers/solid_observer/dashboard_helper.rb
 - app/jobs/solid_observer/cleanup_job.rb
@@ -85,10 +86,15 @@ files:
 - app/views/solid_observer/cache_operations/_confirm_clear.html.erb
 - app/views/solid_observer/cache_operations/index.html.erb
 - app/views/solid_observer/dashboard/_chart.html.erb
+- app/views/solid_observer/dashboard/_component_cards.html.erb
+- app/views/solid_observer/dashboard/_health.html.erb
+- app/views/solid_observer/dashboard/_home.html.erb
 - app/views/solid_observer/dashboard/_live_state.html.erb
+- app/views/solid_observer/dashboard/_queue.html.erb
 - app/views/solid_observer/dashboard/_queue_table.html.erb
 - app/views/solid_observer/dashboard/_right_now.html.erb
 - app/views/solid_observer/dashboard/_throughput.html.erb
+- app/views/solid_observer/dashboard/_unified_feed.html.erb
 - app/views/solid_observer/dashboard/index.html.erb
 - app/views/solid_observer/errors/storage_unavailable.html.erb
 - app/views/solid_observer/events/index.html.erb
@@ -99,6 +105,7 @@ files:
 - app/views/solid_observer/shared/_pagination.html.erb
 - app/views/solid_observer/shared/_stat_card.html.erb
 - app/views/solid_observer/storages/show.html.erb
+- app/views/solid_observer/traces/show.html.erb
 - config/routes.rb
 - db/migrate/20260115000001_create_solid_observer_queue_events.rb
 - db/migrate/20260115000002_create_solid_observer_metrics.rb
@@ -110,6 +117,8 @@ files:
 - db/migrate/20260612000001_add_event_type_recorded_at_index_to_cache_events.rb
 - db/migrate/20260619000001_create_solid_observer_cable_events.rb
 - db/migrate/20260619000002_create_solid_observer_cable_metrics.rb
+- db/migrate/20260630000001_add_correlation_id_to_cache_events.rb
+- db/migrate/20260630000002_add_correlation_id_to_cable_events.rb
 - lib/generators/solid_observer/install_generator.rb
 - lib/generators/solid_observer/templates/initializer.rb.tt
 - lib/solid_observer.rb
@@ -124,10 +133,13 @@ files:
 - lib/solid_observer/cache_subscriber.rb
 - lib/solid_observer/chart_buffer.rb
 - lib/solid_observer/cli/base.rb
+- lib/solid_observer/cli/health.rb
 - lib/solid_observer/cli/jobs.rb
 - lib/solid_observer/cli/status.rb
 - lib/solid_observer/cli/storage.rb
+- lib/solid_observer/cli/trace.rb
 - lib/solid_observer/configuration.rb
+- lib/solid_observer/correlated.rb
 - lib/solid_observer/correlation_id_resolver.rb
 - lib/solid_observer/engine.rb
 - lib/solid_observer/event_buffer_core.rb
@@ -136,6 +148,7 @@ files:
 - lib/solid_observer/queries/events_query.rb
 - lib/solid_observer/queries/execution_finder.rb
 - lib/solid_observer/queries/job_executions_query.rb
+- lib/solid_observer/queries/trace_query.rb
 - lib/solid_observer/queue_event_buffer.rb
 - lib/solid_observer/queue_stats.rb
 - lib/solid_observer/services/cable_operations.rb
@@ -149,6 +162,7 @@ files:
 - lib/solid_observer/services/flush_cache_event_buffer.rb
 - lib/solid_observer/services/flush_cache_metrics.rb
 - lib/solid_observer/services/flush_event_buffer.rb
+- lib/solid_observer/services/health_score.rb
 - lib/solid_observer/services/install_migrations.rb
 - lib/solid_observer/services/record_cable_event.rb
 - lib/solid_observer/services/record_cable_metric.rb
@@ -157,6 +171,7 @@ files:
 - lib/solid_observer/services/record_event.rb
 - lib/solid_observer/services/storage_info_snapshot.rb
 - lib/solid_observer/services/ui_auth_check.rb
+- lib/solid_observer/services/unified_feed.rb
 - lib/solid_observer/subscriber.rb
 - lib/solid_observer/version.rb
 - lib/tasks/solid_observer.rake
@@ -183,7 +198,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Observability for the Rails 8's Solid Stack
 test_files: []