rails_pulse 0.4.2 → 0.5.0.pre.1

data/app/services/rails_pulse/summary_service.rb

@@ -1,6 +1,20 @@
 module RailsPulse
-  # Aggregates one period (hour, day, week or month) of requests, operations,
-  # job runs and exception occurrences into rails_pulse_summaries rows.
+  # Aggregates one period (hour, day, week or month) into
+  # rails_pulse_summaries rows.
+  #
+  # Hours are computed from raw rows by FromRawRows. Days are rolled up from
+  # their hours, and weeks and months from their days, by FromChildPeriods,
+  # so a long period never re-reads raw rows: its cost does not grow with
+  # its length, and it stays correct after raw retention has pruned them.
+  #
+  # Every period gets one overall request row (type RailsPulse::Request,
+  # summarizable_id 0), written even when the period is empty (count: 0) so
+  # its timestamp keeps advancing every period — and only once the period
+  # has ended. It is the heartbeat several
+  # health checks use to detect whether SummaryJob is still running
+  # (dashboard banner, rails_pulse:status, StoragePressure staleness, and
+  # CleanupService's summarized_cutoff), and the marker this service uses to
+  # tell whether a child period has been summarized.
   #
   # Rows are written with upsert_all against the summaries table's unique
   # index, one statement per summarizable kind, so re-running a period (the
@@ -10,6 +24,11 @@ module RailsPulse
   class SummaryService
     UNIQUE_INDEX = :idx_pulse_summaries_unique
 
+    # The period each longer period is rolled up from. Weeks and months build
+    # from days because weeks do not tile months.
+    CHILD_PERIOD_TYPES = { "day" => "hour", "week" => "day", "month" => "day" }.freeze
+    CHILD_PERIOD_STEPS = { "hour" => 1.hour, "day" => 1.day }.freeze
+
     attr_reader :period_type, :start_time, :end_time
 
     def initialize(period_type, start_time)
@@ -19,15 +38,35 @@ module RailsPulse
     end
 
     def perform
+      # A period is summarized only once it has ended. The overall request
+      # row doubles as the heartbeat that CleanupService's summarized_cutoff
+      # and summarize_missing_child_periods trust to mean "fully aggregated";
+      # written mid-period, it would let cleanup delete raw rows that were
+      # never counted and let a later rollup bake the partial numbers in as
+      # final.
+      if end_time >= Time.current
+        RailsPulse.logger.info "Skipping #{period_type} summary for #{start_time}: period has not ended"
+        return
+      end
+
       RailsPulse.logger.info "Starting #{period_type} summary for #{start_time}"
 
+      summarize_missing_child_periods if rollup?
+
+      # Rows are computed before the transaction opens. A busy period's
+      # aggregation can take seconds; doing it with the transaction already
+      # open leaves it idle from the database's perspective and vulnerable to
+      # a configured idle_in_transaction_session_timeout on installs that set
+      # one.
+      rows = summary_rows
+
       # The engine's own connection: on a separate-database install
       # ActiveRecord::Base would open the transaction on the host's primary.
       RailsPulse::ApplicationRecord.transaction do
-        upsert_summaries(request_summary_rows + route_summary_rows) # Overall and per-route
-        upsert_summaries(query_summary_rows)                        # Per-query
-        upsert_summaries(job_summary_rows)                          # Per-job
-        aggregate_exceptions                                        # Per-exception-group frequency
+        upsert_summaries(rows[:requests_and_routes])
+        upsert_summaries(rows[:queries])
+        upsert_summaries(rows[:jobs])
+        upsert_exception_summaries(rows[:exceptions])
       end
 
       RailsPulse.logger.info "Completed #{period_type} summary"
@@ -38,126 +77,42 @@ module RailsPulse
 
     private
 
-    # Every row in one call must have the same keys, which is why the
-    # summarizable kinds are upserted separately: request and route rows carry
-    # status columns, query rows do not, exception rows carry only a count.
-    def upsert_summaries(rows)
-      return if rows.empty?
-
-      # MySQL resolves the conflict through any unique key and rejects an
-      # explicit target.
-      unique_by = Summary.connection.supports_insert_conflict_target? ? UNIQUE_INDEX : nil
-      Summary.upsert_all(rows, unique_by: unique_by)
-    end
-
-    def summary_row(summarizable_type, summarizable_id)
-      {
-        summarizable_type: summarizable_type,
-        summarizable_id: summarizable_id,
-        period_type: period_type,
-        period_start: start_time,
-        period_end: end_time
-      }
+    def rollup?
+      CHILD_PERIOD_TYPES.key?(period_type)
     end
 
-    # `durations` must be sorted. Empty input yields count 0 and nil
-    # percentiles, which is what an idle period should record.
-    def duration_metrics(durations)
-      avg = durations.any? ? durations.sum.to_f / durations.size : 0
-
-      {
-        count: durations.size,
-        avg_duration: avg,
-        min_duration: durations.first,
-        max_duration: durations.last,
-        total_duration: durations.sum,
-        p50_duration: RailsPulse::Statistics.calculate_percentile(durations, 0.5),
-        p95_duration: RailsPulse::Statistics.calculate_percentile(durations, 0.95),
-        p99_duration: RailsPulse::Statistics.calculate_percentile(durations, 0.99),
-        stddev_duration: RailsPulse::Statistics.calculate_stddev(durations, avg)
-      }
+    def source
+      @source ||=
+        if rollup?
+          FromChildPeriods.new(child_period_type, child_period_starts)
+        else
+          FromRawRows.new(start_time...end_time)
+        end
     end
 
-    def status_metrics(statuses)
+    def summary_rows
       {
-        error_count: statuses.count { |s| s >= 500 },
-        success_count: statuses.count { |s| s < 500 },
-        status_2xx: statuses.count { |s| s.between?(200, 299) },
-        status_3xx: statuses.count { |s| s.between?(300, 399) },
-        status_4xx: statuses.count { |s| s.between?(400, 499) },
-        status_5xx: statuses.count { |s| s >= 500 }
+        requests_and_routes: with_period(source.request_rows + source.route_rows),
+        queries: with_period(source.query_rows),
+        jobs: with_period(source.job_rows),
+        exceptions: with_period(exception_rows)
       }
     end
 
-    # One row for ALL requests in the period, written even when the period is
-    # empty (count: 0) so its timestamp keeps advancing every period — it is
-    # the heartbeat several health checks use to detect whether SummaryJob is
-    # still running (dashboard banner, rails_pulse:status, StoragePressure
-    # staleness, and CleanupService's summarized_cutoff). summarizable_id 0
-    # marks the overall rollup.
-    def request_summary_rows
-      request_data = Request.where(occurred_at: start_time...end_time).pluck(:duration, :status)
-      durations = request_data.map(&:first).compact.sort
-      statuses = request_data.map(&:second)
-
-      [ summary_row("RailsPulse::Request", 0).merge(duration_metrics(durations), status_metrics(statuses)) ]
+    def with_period(rows)
+      rows.map { |row| row.merge(period_type: period_type, period_start: start_time, period_end: end_time) }
     end
 
-    def route_summary_rows
-      all_rows = Request
-        .where(occurred_at: start_time...end_time)
-        .where.not(route_id: nil)
-        .pluck(:route_id, :duration, :status)
-
-      all_rows.group_by(&:first).map do |route_id, rows|
-        durations = rows.map { |_, d, _| d }.compact.sort
-        statuses = rows.map { |_, _, s| s }
-
-        summary_row("RailsPulse::Route", route_id)
-          .merge(duration_metrics(durations), status_metrics(statuses), count: rows.size)
-      end
-    end
-
-    def query_summary_rows
-      all_rows = Operation
-        .where(occurred_at: start_time...end_time)
-        .where.not(query_id: nil)
-        .pluck(:query_id, :duration)
-
-      all_rows.group_by(&:first).filter_map do |query_id, rows|
-        durations = rows.map(&:last).compact.sort
-        next if durations.empty?
-
-        summary_row("RailsPulse::Query", query_id).merge(duration_metrics(durations))
-      end
-    end
+    # Every row in one call must have the same keys, which is why the
+    # summarizable kinds are upserted separately: request and route rows carry
+    # status columns, query rows do not, exception rows carry only a count.
+    def upsert_summaries(rows)
+      return if rows.empty?
 
-    def job_summary_rows
-      all_rows = JobRun
-        .where(occurred_at: start_time...end_time)
-        .where(status: JobRun::FINAL_STATUSES)
-        .where.not(job_id: nil)
-        .pluck(:job_id, :duration, :status)
-      return [] if all_rows.empty?
-
-      # A run whose job row has gone (count-based cleanup) has nothing to
-      # summarize against.
-      known_job_ids = Job.where(id: all_rows.map(&:first).uniq).pluck(:id).to_set
-
-      all_rows.group_by(&:first).filter_map do |job_id, runs|
-        next unless known_job_ids.include?(job_id)
-
-        durations = runs.map { |_, d, _| d }.compact.map(&:to_f).sort
-        next if durations.empty?
-
-        statuses = runs.map { |_, _, s| s }
-        summary_row("RailsPulse::Job", job_id).merge(
-          duration_metrics(durations),
-          count: runs.size,
-          error_count: statuses.count { |s| s != "success" },
-          success_count: statuses.count { |s| s == "success" }
-        )
-      end
+      # MySQL resolves the conflict through any unique key and rejects an
+      # explicit target.
+      unique_by = Summary.connection.supports_insert_conflict_target? ? UNIQUE_INDEX : nil
+      Summary.upsert_all(rows, unique_by: unique_by)
     end
 
     # Exception frequency, per group and overall.
@@ -167,28 +122,61 @@ module RailsPulse
     # something happened last week — the history is gone as soon as cleanup
     # runs. Only `count` is meaningful here; the duration columns stay null
     # because an exception has no duration.
-    def aggregate_exceptions
-      return unless RailsPulse.configuration.track_exceptions
-      return unless ExceptionOccurrence.table_exists?
-
-      counts = ExceptionOccurrence
-        .where(occurred_at: start_time...end_time)
-        .group(:exception_group_id)
-        .count
-
-      return if counts.empty?
-
-      rows = counts.map { |group_id, occurrences| summary_row("RailsPulse::ExceptionGroup", group_id).merge(count: occurrences) }
-      # A rollup across every group, so the dashboard can chart total exception
-      # volume without loading one series per group.
-      rows << summary_row("RailsPulse::ExceptionGroup", 0).merge(count: counts.values.sum)
+    #
+    # Exceptions are the newest summarizable and the only optional one, so
+    # both the query here and the upsert in upsert_exception_summaries are
+    # individually rescued: a failure in either must not lose the route,
+    # query and job summaries computed or written alongside it.
+    def exception_rows
+      return [] unless RailsPulse.configuration.track_exceptions
+      return [] unless ExceptionOccurrence.table_exists?
+
+      source.exception_rows
+    rescue ActiveRecord::ActiveRecordError => e
+      RailsPulse.logger.error "Exception summary skipped: #{e.message}"
+      []
+    end
 
+    def upsert_exception_summaries(rows)
       upsert_summaries(rows)
     rescue ActiveRecord::ActiveRecordError => e
-      # Exceptions are the newest summarizable and the only optional one. A
-      # failure here must not lose the route, query and job summaries that were
-      # written in the same transaction.
       RailsPulse.logger.error "Exception summary skipped: #{e.message}"
     end
+
+    def child_period_type
+      CHILD_PERIOD_TYPES.fetch(period_type)
+    end
+
+    # Every child boundary inside this period. perform refuses periods that
+    # have not ended, so a rollup's children have all ended too.
+    def child_period_starts
+      @child_period_starts ||= begin
+        step = CHILD_PERIOD_STEPS.fetch(child_period_type)
+        starts = []
+        current = start_time
+        while current <= end_time
+          starts << current
+          current += step
+        end
+        starts
+      end
+    end
+
+    # A child period without its heartbeat row was never summarized
+    # (SummaryJob was not running, or a backfill asked only for the longer
+    # period), so it is summarized now, recursively, before being rolled up.
+    def summarize_missing_child_periods
+      summarized = Summary
+        .where(summarizable_type: "RailsPulse::Request", summarizable_id: 0, period_type: child_period_type)
+        .where(period_start: start_time..end_time)
+        .pluck(:period_start)
+        .to_set(&:to_i)
+
+      child_period_starts.each do |child_start|
+        next if summarized.include?(child_start.to_i)
+
+        SummaryService.new(child_period_type, child_start).perform
+      end
+    end
   end
 end

data/app/services/rails_pulse/tag_filter_service.rb

@@ -17,12 +17,12 @@ module RailsPulse
     def self.scope(model_class, disabled_tags, show_non_tagged)
       relation = model_class.all
 
-      # Exclude items with disabled tags. Explicit ESCAPE: SQLite has no
-      # default escape character, so without it an underscore in a tag is
-      # never matched literally there and the exclusion matches nothing.
+      # Exclude items with disabled tags.
       disabled_tags.each do |tag|
-        sanitized_tag = ActiveRecord::Base.sanitize_sql_like(tag.to_s, RailsPulse::Taggable::LIKE_ESCAPE)
-        relation = relation.where.not("tags LIKE ? ESCAPE '!'", "%#{sanitized_tag}%")
+        relation = relation.where.not(
+          "tags LIKE ? #{RailsPulse::LikePattern::CLAUSE}",
+          RailsPulse::LikePattern.containing(tag)
+        )
       end
 
       # Exclude non-tagged items if show_non_tagged is false

data/app/views/layouts/rails_pulse/_time_range_selector.html.erb

@@ -136,7 +136,10 @@ end %>
         <div class="flex items-start justify-between">
           <div>
             <h2 class="text-lg font-semibold mbe-4">Custom Date Range</h2>
-            <p class="text-sm text-subtle">Select a custom date and time range for filtering data.</p>
+            <p class="text-sm text-subtle">
+              Select a custom date and time range for filtering data. All times are in
+              <%= RailsPulse::TimeRange.aggregation_zone_label %>.
+            </p>
           </div>
           <%= link_to '#', "aria-label": "Close", data: { action: "click->rails-pulse--time-range#cancelCustom" }, class: "text-subtle hover:text-default" do %>
             <%= rails_pulse_icon "x", width: "20" %>

data/app/views/rails_pulse/components/_operation_details_popover.html.erb

@@ -26,7 +26,7 @@
         <div>
           <h4 class="text-xs font-medium text-subtle uppercase">Occurred At</h4>
           <div class="text-sm">
-            <%= operation.occurred_at.getlocal.strftime("%H:%M:%S.%L") %>
+            <%= operation.occurred_at.strftime("%H:%M:%S.%L") %>
           </div>
         </div>
       <% end %>

data/app/views/rails_pulse/components/_table_head.html.erb

@@ -6,8 +6,8 @@
           <%= column[:label] %>
         <% else %>
           <% sort_params = {} %>
-          <% sort_params[:zoom_start_time] = @zoom_start if @zoom_start.present? %>
-          <% sort_params[:zoom_end_time] = @zoom_end if @zoom_end.present? %>
+          <% sort_params[:zoom_start_time] = @time_range&.zoom_start if @time_range&.zoom_start.present? %>
+          <% sort_params[:zoom_end_time] = @time_range&.zoom_end if @time_range&.zoom_end.present? %>
           <% sort_params[:selected_column_time] = params[:selected_column_time] if params[:selected_column_time].present? %>
           <%= sort_link @ransack_query, column[:field], column[:label],
             sort_params.merge(

data/app/views/rails_pulse/dashboard/_chart_panel.html.erb

@@ -1,7 +1,12 @@
 <div class="grid-item" style="<%= flex_style if defined?(flex_style) %>">
   <div class="card b-full flex flex-col">
     <div class="flex mbe-2">
-      <h2 class="grow font-semibold leading-none uppercase text-xs"><%= title %></h2>
+      <h2 class="grow font-semibold leading-none uppercase text-xs">
+        <%= title %>
+        <% if chart_data %>
+          · <%= render "rails_pulse/shared/aggregation_zone_badge" %>
+        <% end %>
+      </h2>
       <div class="panel-icon-bar flex gap items-center">
         <% if chart_data %>
           <%= series_toggles %>

data/app/views/rails_pulse/dashboard/_deployments_panel.html.erb

@@ -34,7 +34,7 @@
     <div>
       <p class="font-semibold uppercase text-xs text-subtle mbe-1">In this range</p>
       <p class="text-lg font-bold"><%= number_with_delimiter(@deployment_count) %></p>
-      <p class="text-xs text-subtle"><%= humanize_time_range(@selected_time_range) %></p>
+      <p class="text-xs text-subtle"><%= humanize_time_range(@time_range.selected_time_range) %></p>
     </div>
   </div>
 
@@ -55,7 +55,7 @@
       <% end %>
     <% else %>
       <p class="text-sm text-subtle">
-        No deployments recorded in the <%= humanize_time_range(@selected_time_range) %>.
+        No deployments recorded in the <%= humanize_time_range(@time_range.selected_time_range) %>.
         Post to the deployments endpoint from your deploy pipeline, or run
         <code>rails_pulse:record_deployment</code>, and they will appear here and as markers on the charts.
       </p>

data/app/views/rails_pulse/dashboard/_health_badge.html.erb

@@ -1,23 +1,32 @@
 <%# Exceptions do not have a "slow" state — a group that fired at all is
     firing — so the two non-critical labels are overridable. %>
-<% healthy_label = local_assigns.fetch(:healthy_label, "healthy") %>
-<% slow_label    = local_assigns.fetch(:slow_label, "slow") %>
-<% dot_color = health[:critical] > 0 ? "var(--color-negative)" : (health[:slow] > 0 ? "#eab308" : "var(--color-positive)") %>
-<% border_color = health[:critical] > 0 ? "color-mix(in srgb, var(--color-negative) 40%, transparent)" : (health[:slow] > 0 ? "color-mix(in srgb, #eab308 40%, transparent)" : "color-mix(in srgb, var(--color-positive) 40%, transparent)") %>
-<% badge = capture do %>
-  <span class="badge flex items-center gap-half p-2" style="border-color: <%= border_color %>;">
-    <span class="shrink-0 rounded-full" style="width: 10px; height: 10px; background: <%= dot_color %>;"></span>
-    <span class="text-xs font-semibold"><%= name %></span>
-    <% if health[:critical] > 0 %>
-      <span class="text-xs text-subtle"><%= health[:healthy] %> <%= healthy_label %> · <%= health[:slow] %> <%= slow_label %> ·</span>
-      <span class="text-xs font-semibold text-negative"><%= health[:critical] %> <%= critical_label %></span>
-    <% else %>
-      <span class="text-xs text-subtle"><%= health[:healthy] %> <%= healthy_label %> · <%= health[:slow] %> <%= slow_label %> · 0 <%= critical_label %></span>
-    <% end %>
-  </span>
-<% end %>
-<% if local_assigns[:link_url].present? %>
-  <%= link_to link_url, class: "health-badge-link" do %><%= badge %><% end %>
-<% else %>
-  <%= badge %>
+<% hide_when_healthy = local_assigns.fetch(:hide_when_healthy, false) %>
+<% is_healthy = health[:critical].zero? && health[:slow].zero? %>
+<% unless hide_when_healthy && is_healthy %>
+  <% healthy_label = local_assigns.fetch(:healthy_label, "healthy") %>
+  <% slow_label    = local_assigns.fetch(:slow_label, "slow") %>
+  <% dot_color = health[:critical] > 0 ? "var(--color-negative)" : (health[:slow] > 0 ? "#eab308" : "var(--color-positive)") %>
+  <% border_color = health[:critical] > 0 ? "color-mix(in srgb, var(--color-negative) 40%, transparent)" : (health[:slow] > 0 ? "color-mix(in srgb, #eab308 40%, transparent)" : "color-mix(in srgb, var(--color-positive) 40%, transparent)") %>
+  <% subtle_parts = [] %>
+  <% subtle_parts << "#{health[:healthy]} #{healthy_label}" if health[:healthy] > 0 %>
+  <% subtle_parts << "#{health[:slow]} #{slow_label}" if health[:slow] > 0 %>
+  <% subtle_parts << "0 #{healthy_label}" if subtle_parts.empty? && health[:critical].zero? %>
+  <% critical_part = "#{health[:critical]} #{critical_label}" if health[:critical] > 0 %>
+  <% badge = capture do %>
+    <span class="badge flex items-center gap-half p-2" style="border-color: <%= border_color %>;">
+      <span class="shrink-0 rounded-full" style="width: 10px; height: 10px; background: <%= dot_color %>;"></span>
+      <span class="text-xs font-semibold"><%= name %></span>
+      <% if subtle_parts.any? %>
+        <span class="text-xs text-subtle"><%= subtle_parts.join(" · ") %><%= " ·" if critical_part %></span>
+      <% end %>
+      <% if critical_part %>
+        <span class="text-xs font-semibold text-negative"><%= critical_part %></span>
+      <% end %>
+    </span>
+  <% end %>
+  <% if local_assigns[:link_url].present? %>
+    <%= link_to link_url, class: "health-badge-link" do %><%= badge %><% end %>
+  <% else %>
+    <%= badge %>
+  <% end %>
 <% end %>

data/app/views/rails_pulse/dashboard/index.html.erb

@@ -29,10 +29,24 @@
         critical_label: "critical",
         link_url: exceptions_path %>
       <% end %>
+      <%# Nil until a background writer has reported a heartbeat. Shown only
+          when a writer is backlogged or dropping requests. %>
+      <% if @health_summary[:tracking] %>
+        <%= render "rails_pulse/dashboard/health_badge",
+        name: "Tracking",
+        health: @health_summary[:tracking],
+        healthy_label: "writing",
+        slow_label: "backlogged",
+        critical_label: "dropping",
+        hide_when_healthy: true,
+        link_url: storage_path %>
+      <% end %>
+      <%# Shown only when storage is under warning or critical pressure. %>
       <%= render "rails_pulse/dashboard/health_badge",
       name: "Storage",
       health: @health_summary[:storage],
       critical_label: "critical",
+      hide_when_healthy: true,
       link_url: storage_path %>
     </div>
   </div>
@@ -130,7 +144,7 @@
           </span>
         <% end %>
         <span class="text-xs text-subtle mis-2">Ranked by severity ·
-          <%= humanize_time_range(@selected_time_range) %></span>
+          <%= humanize_time_range(@time_range.selected_time_range) %></span>
       </div>
       <div
         data-controller="rails-pulse--popover"
@@ -179,7 +193,7 @@
         </span>
         <p class="font-semibold text-sm text-positive">All clear</p>
         <p class="text-xs text-subtle">No routes, queries, or jobs need attention in the
-          <%= humanize_time_range(@selected_time_range) %>.</p>
+          <%= humanize_time_range(@time_range.selected_time_range) %>.</p>
       </div>
     <% else %>
       <div class="flex flex-col">

data/app/views/rails_pulse/jobs/_chart_tabs.html.erb

@@ -56,6 +56,7 @@
     </div>
     <%= render "rails_pulse/shared/deployment_markers_toggle" %>
   </div>
+  <%= render "rails_pulse/shared/aggregation_zone_badge" %>
 </div>
 
 <!-- Duration Chart -->

data/app/views/rails_pulse/jobs/index.html.erb

@@ -29,7 +29,7 @@
         %>
         <%= form.select :avg_duration,
           duration_options(:job),
-          { selected: @selected_response_range },
+          { selected: @time_range&.selected_response_range },
           { class: "input" }
         %>
         <%= if params.has_key?(:q) || params[:queue_name].present?

data/app/views/rails_pulse/queries/_chart_tabs.html.erb

@@ -56,6 +56,7 @@
     </div>
     <%= render "rails_pulse/shared/deployment_markers_toggle" %>
   </div>
+  <%= render "rails_pulse/shared/aggregation_zone_badge" %>
 </div>
 
 <!-- Query Performance Chart -->

data/app/views/rails_pulse/queries/index.html.erb

@@ -26,7 +26,7 @@
         >
         <%= form.select :avg_duration,
                     duration_options(:query),
-                    { selected: @selected_response_range },
+                    { selected: @time_range&.selected_response_range },
                     { class: "input" } %>
         <%= if params.has_key?(:q)
           link_to "Reset",

data/app/views/rails_pulse/queries/show.html.erb

@@ -24,7 +24,7 @@
         >
         <%= form.select :duration,
           duration_options(:query),
-          { selected: @selected_response_range },
+          { selected: @time_range&.selected_response_range },
           { class: "input" }
         %>
         <%= link_to "Reset", query_path(@query), class: "btn btn--plain", style: "text-decoration: none; color: var(--color-text-muted);" if params.has_key?(:q) %>

data/app/views/rails_pulse/requests/index.html.erb

@@ -23,7 +23,7 @@
 
       <%= form.select :duration_gteq,
         duration_options(:request),
-        { selected: @selected_response_range, prompt: "Min duration" },
+        { selected: @time_range&.selected_response_range, prompt: "Min duration" },
         { class: "input" }
       %>
 

data/app/views/rails_pulse/routes/_chart_tabs.html.erb

@@ -82,6 +82,7 @@
     </div>
     <%= render "rails_pulse/shared/deployment_markers_toggle" %>
   </div>
+  <%= render "rails_pulse/shared/aggregation_zone_badge" %>
 </div>
 <!-- Response Time Chart -->
 <div

data/app/views/rails_pulse/routes/index.html.erb

@@ -34,7 +34,7 @@
                           class: "input" %>
         <%= form.select :avg_duration,
                     duration_options(:route),
-                    { selected: @selected_response_range },
+                    { selected: @time_range&.selected_response_range },
                     { class: "input" } %>
         <%= if params.has_key?(:q)
           link_to "Reset",

data/app/views/rails_pulse/routes/show.html.erb

@@ -26,7 +26,7 @@
           >
           <%= form.select :avg_duration,
             duration_options(:route),
-            { selected: @selected_response_range },
+            { selected: @time_range&.selected_response_range },
             { class: "input" }
           %>
           <%= form.select :http_method_eq,

data/app/views/rails_pulse/shared/_aggregation_zone_badge.html.erb

@@ -0,0 +1,4 @@
+<%# Zone every chart on the page is bucketed and labelled in. The short
+    label is always visible; the title carries the full zone name and, when
+    a controller resolved one, the exact window being shown. %>
+<span class="zone-badge" title="<%= time_range_zone_tooltip %>"><%= RailsPulse::TimeRange.aggregation_zone_short_label %></span>

data/app/views/rails_pulse/storage/show.html.erb

@@ -120,4 +120,41 @@
       <% end %>
     </dl>
   <% end %>
+
+  <%= render "rails_pulse/components/panel",
+      title: "Tracking writers",
+      help_heading: "The background writer",
+      help_text: "Each process queues tracked requests for one writer thread, which reports a heartbeat every minute. When a queue is full the newest request is dropped rather than slowing the app; dropped requests mean the charts undercount traffic. Raise async_queue_size or fix database latency." do %>
+    <% tracking = @status.tracking %>
+    <dl class="descriptive-list mbs-4">
+      <dt>Live writers</dt>
+      <dd><%= tracking[:live_count] %></dd>
+      <dt>Queue depth</dt>
+      <dd><%= number_with_delimiter(tracking[:queue_depth]) %><% if tracking[:queue_size].to_i.positive? %> <span class="text-subtle">/ <%= number_with_delimiter(tracking[:queue_size]) %> per process</span><% end %></dd>
+      <dt>Dropped in the last hour</dt>
+      <dd class="<%= tracking[:dropped].to_i.positive? ? "text-negative font-semibold" : "" %>"><%= number_with_delimiter(tracking[:dropped]) %></dd>
+      <dt>Last heartbeat</dt>
+      <dd>
+        <% if tracking[:last_sampled_at] %>
+          <%= human_readable_occurred_at(tracking[:last_sampled_at]) %>
+          <span class="text-subtle">(<%= time_ago_in_words(tracking[:last_sampled_at]) %>)</span>
+        <% else %>
+          Never — heartbeats start when a process with <code>async</code> on tracks its first request
+        <% end %>
+      </dd>
+      <% tracking[:processes].each do |process| %>
+        <dt><code><%= process[:label] %></code></dt>
+        <dd>
+          <%= number_with_delimiter(process[:queue_depth]) %> / <%= number_with_delimiter(process[:queue_size]) %> queued
+          <% if process[:dropped_last_hour].positive? %>
+            <span class="badge storage-table__percent storage-table__percent--critical"><%= number_with_delimiter(process[:dropped_last_hour]) %> dropped</span>
+          <% else %>
+            <span class="badge storage-table__percent storage-table__percent--uncapped">0 dropped</span>
+          <% end %>
+          <br>
+          <span class="text-subtle">last heartbeat <%= time_ago_in_words(process[:last_seen_at]) %></span>
+        </dd>
+      <% end %>
+    </dl>
+  <% end %>
 </div>