error_radar 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2914a57eb370a3b003c69d8ab3e9899826dade79b35f62bffc97e8fed40748bf
-  data.tar.gz: f0f0772a121489558626b8780c1d10f3d1d08fb1e71b067c0a422c5da5eab709
+  metadata.gz: 486749dc9fc6c6e2cc617340f184cf8dbeb4196199c3017eb7bf6f667718fe74
+  data.tar.gz: 13da87d1772c71901b66fb4cd6b4d29a809b539b6fccaee5613defae97c0a04d
 SHA512:
-  metadata.gz: e9ddda42dc56d8512da27db0fa371639b08925af149200fd4a016904eb2fdc2ee8fc7d4febb5b008db2b1f3e3b689acda1c068c1883d55f38fa833201346cb12
-  data.tar.gz: e76130935b55369dbb16d839a3d4e29fbe6c2cb28390915ffc43cee00bd8bb9c5ebc1585cecbbd656cfaf2a22d91465eb41e8529ee17ba91fae86023cf89563d
+  metadata.gz: 6a9fe7aa11d7668ca353e0c6331eac9a339c43263f93bc3650085bd72f2072968376006f7481661037c7d9f80fdca0057b8a28d9779a92050b931fb4eccd441f
+  data.tar.gz: f98150abaa5c7bd7695ddd38ba91d65db73bfe81ce7e739c9f91fac20c596b3303643fc282320b2366f9b1b6bd4da48c2bfca7bd8d182e1162c3a7786770384a

data/CHANGELOG.md

@@ -2,6 +2,58 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.4.0] - 2026-07-03
+
+### Added
+- **Slack notifications**: sends a Block Kit message with error details and a
+  deep-link button. Configure with `config.slack_webhook_url` and optional
+  `config.slack_channel`.
+- **Discord notifications**: sends a rich embed to any Discord webhook.
+  Configure with `config.discord_webhook_url`.
+- **Email notifications**: delivers an HTML + plain-text email via ActionMailer.
+  Configure `config.email_recipients` and `config.email_from`.
+- **Generic webhook**: POSTs a JSON payload to any URL (PagerDuty, OpsGenie,
+  custom scripts). Configure with `config.webhook_urls = [url1, url2]`.
+- **Custom callbacks**: `config.on_error { |log| ... }` for arbitrary alerting
+  logic (e.g. PagerDuty SDK, Telegram, SMS).
+- **`notify_on` rule set**: controls when alerts fire — `:new_error` (default,
+  first occurrence per fingerprint), `:critical` (any critical severity, 1/hour
+  throttle), `:all` (every occurrence, 1/hour throttle per fingerprint).
+- **In-memory throttle**: prevents notification storms for `:critical` and `:all`
+  rules — at most one alert per fingerprint per hour.
+- **Deep-links in notifications**: set `config.app_host` to include a link to
+  the error detail page in every notification.
+- **`ErrorLog#new_fingerprint?`**: transient predicate (not persisted) that is
+  `true` when the record was just created for the first time.
+
+## [0.3.0] - 2026-07-03
+
+### Added
+- **Zero-config auto-capture for ActiveJob**: any ActiveJob subclass (regardless
+  of queue adapter) now has exceptions captured automatically via
+  `ActiveSupport.on_load(:active_job)`. No need to include the module manually.
+  Disable with `config.install_active_job = false` (e.g. when using Sidekiq only).
+- **Zero-config auto-capture for Rake tasks**: patches `Rake::Task#execute` so
+  every task failure is recorded automatically. Disable with
+  `config.install_rake = false`.
+- **Full error list page** at `/errors` with pagination (50 per page),
+  full-text search (message / error class / source), filter by status /
+  severity / category / date range, sortable columns, and bulk actions
+  (resolve / ignore / reopen / delete).
+- **Bulk actions**: select individual rows or all rows, then resolve, ignore,
+  reopen, or delete in one click.
+- **Quick-action buttons** on the list (✓ resolve, ✕ ignore) without leaving
+  the page.
+- **Improved error detail page**: context and backtrace displayed side-by-side,
+  inline resolution note field, delete button with confirmation.
+- **Navigation bar** across all dashboard pages linking Dashboard ↔ All Errors.
+
+### Changed
+- `show` and `update_status` actions moved from `DashboardController` to the
+  new `ErrorsController`; route paths (`/errors/:id` etc.) are unchanged.
+- Dashboard index h1 changed from "🛰 Error Radar" to "Dashboard" (branding
+  now lives in the shared nav bar).
+
 ## [0.2.0] - 2026-07-02
 
 ### Added

data/app/controllers/error_radar/dashboard_controller.rb

@@ -5,7 +5,6 @@ module ErrorRadar
   # kanban board over ErrorLog statuses.
   class DashboardController < ApplicationController
     before_action :authenticate_request!
-    before_action :set_error, only: %i[show update_status]
 
     KANBAN_LIMIT = 100
     SEVERITY_ORDER = { 'critical' => 0, 'error' => 1, 'warning' => 2, 'info' => 3 }.freeze
@@ -47,29 +46,8 @@ module ErrorRadar
       @external_links = build_external_links
     end
 
-    def show; end
-
-    def update_status
-      new_status = params[:status].to_s
-      unless ErrorLog.statuses.key?(new_status)
-        return render json: { ok: false, error: 'invalid status' }, status: :unprocessable_entity
-      end
-
-      if new_status == 'resolved'
-        @error.resolve!(by: error_radar_current_user)
-      else
-        @error.update!(status: new_status, resolved_at: nil)
-      end
-
-      render json: { ok: true, id: @error.id, status: @error.status }
-    end
-
     private
 
-    def set_error
-      @error = ErrorLog.find(params[:id])
-    end
-
     def build_external_links
       links = {}
       if defined?(::RailsAdmin)

data/app/controllers/error_radar/errors_controller.rb

@@ -0,0 +1,137 @@
+# frozen_string_literal: true
+
+module ErrorRadar
+  class ErrorsController < ApplicationController
+    before_action :authenticate_request!
+    before_action :set_error, only: %i[show update_status destroy]
+
+    rescue_from ActiveRecord::RecordNotFound do
+      redirect_to errors_path, alert: 'Error not found.'
+    end
+
+    PER_PAGE = 50
+
+    def index
+      scope = build_scope
+      @total_count  = scope.count
+      @page         = [params[:page].to_i, 1].max
+      @total_pages  = [(@total_count.to_f / PER_PAGE).ceil, 1].max
+      @page         = [@page, @total_pages].min if @total_pages > 0
+      @errors       = scope.limit(PER_PAGE).offset((@page - 1) * PER_PAGE)
+      @filter_params = active_filter_params
+      @pages        = pagination_pages(@page, @total_pages)
+    end
+
+    def show; end
+
+    def update_status
+      new_status = params[:status].to_s
+      unless ErrorLog.statuses.key?(new_status)
+        return render json: { ok: false, error: 'invalid status' }, status: :unprocessable_entity
+      end
+
+      if new_status == 'resolved'
+        @error.resolve!(by: error_radar_current_user, note: params[:note].presence)
+      else
+        @error.update!(status: new_status, resolved_at: nil)
+      end
+
+      render json: { ok: true, id: @error.id, status: @error.status }
+    end
+
+    def destroy
+      @error.destroy!
+      render json: { ok: true }
+    end
+
+    def bulk
+      ids = Array(params[:ids]).map(&:to_i).select(&:positive?)
+      action = params[:bulk_action].to_s
+
+      if ids.empty?
+        return render json: { ok: false, error: 'no ids selected' }, status: :unprocessable_entity
+      end
+      unless %w[resolve ignore reopen delete].include?(action)
+        return render json: { ok: false, error: 'unknown action' }, status: :unprocessable_entity
+      end
+
+      count = apply_bulk(ids, action)
+      render json: { ok: true, count: count, action: action }
+    end
+
+    private
+
+    def set_error
+      @error = ErrorLog.find(params[:id])
+    end
+
+    def build_scope
+      scope = ErrorLog.all
+
+      if params[:status].present? && ErrorLog.statuses.key?(params[:status])
+        scope = scope.where(status: params[:status])
+      end
+
+      if params[:severity].present? && ErrorLog.severities.key?(params[:severity])
+        scope = scope.where(severity: params[:severity])
+      end
+
+      if params[:category].present? && ErrorLog.categories.key?(params[:category])
+        scope = scope.where(category: params[:category])
+      end
+
+      if params[:q].present?
+        q = "%#{params[:q].downcase}%"
+        scope = scope.where(
+          'lower(message) LIKE :q OR lower(error_class) LIKE :q OR lower(source) LIKE :q', q: q
+        )
+      end
+
+      from_date = params[:from].present? ? (Date.parse(params[:from]) rescue nil) : nil
+      to_date   = params[:to].present?   ? (Date.parse(params[:to]) rescue nil)   : nil
+      scope = scope.where('last_seen_at >= ?', from_date) if from_date
+      scope = scope.where('last_seen_at <= ?', to_date.end_of_day) if to_date
+
+      sort_col = %w[last_seen_at first_seen_at occurrences].include?(params[:sort]) ? params[:sort] : 'last_seen_at'
+      sort_dir = params[:order] == 'asc' ? :asc : :desc
+      scope.order(sort_col => sort_dir)
+    end
+
+    def apply_bulk(ids, action)
+      case action
+      when 'resolve'
+        ErrorLog.where(id: ids).update_all(
+          status: ErrorLog.statuses[:resolved],
+          resolved_at: Time.current,
+          resolved_by: error_radar_current_user
+        )
+      when 'ignore'
+        ErrorLog.where(id: ids).update_all(status: ErrorLog.statuses[:ignored])
+      when 'reopen'
+        ErrorLog.where(id: ids).update_all(status: ErrorLog.statuses[:open], resolved_at: nil)
+      when 'delete'
+        ErrorLog.where(id: ids).delete_all
+      end
+      ids.size
+    end
+
+    def active_filter_params
+      params.permit(:q, :status, :severity, :category, :from, :to, :sort, :order).to_h
+    end
+
+    def pagination_pages(current, total)
+      return [] if total <= 1
+      return (1..total).to_a if total <= 9
+
+      visible = [1, total, *(current - 2..current + 2)]
+                .select { |p| p.between?(1, total) }
+                .sort.uniq
+      result = []
+      visible.each_with_index do |p, i|
+        result << '...' if i > 0 && p > visible[i - 1] + 1
+        result << p
+      end
+      result
+    end
+  end
+end

data/app/mailers/error_radar/error_mailer.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module ErrorRadar
+  class ErrorMailer < ActionMailer::Base
+    layout false
+
+    def new_error(error_log)
+      @error    = error_log
+      @is_new   = error_log.new_fingerprint?
+      @url      = build_url
+      @app_name = ErrorRadar::Notifier.app_name
+
+      prefix  = @is_new ? 'New' : 'Critical'
+      subject = "[#{@app_name}] #{prefix} #{@error.severity}: #{@error.error_class}"
+
+      mail(
+        to:      ErrorRadar.config.email_recipients,
+        from:    ErrorRadar.config.email_from || 'noreply@localhost',
+        subject: subject
+      )
+    end
+
+    private
+
+    def build_url
+      host = ErrorRadar.config.app_host.to_s.chomp('/')
+      return nil if host.empty?
+
+      "#{host}/error_radar/errors/#{@error.id}"
+    end
+  end
+end

data/app/models/error_radar/error_log.rb

@@ -29,13 +29,18 @@ module ErrorRadar
     # Record (or roll-up) an error. Idempotent per fingerprint: identical errors
     # increment `occurrences` and bump `last_seen_at` instead of creating a new
     # row. NEVER raises — logging must not break the calling code path.
+    def new_fingerprint?
+      @new_fingerprint || false
+    end
+
     def self.record(category:, message:, severity: :error, error_class: nil, source: nil,
                     backtrace: nil, context: {}, http_status: nil, request_url: nil,
                     api_code: nil, api_subcode: nil, fingerprint: nil)
       now = Time.current
       fp  = presence(fingerprint) || build_fingerprint(category: category, error_class: error_class, source: source, message: message)
 
-      log = find_or_initialize_by(fingerprint: fp)
+      log             = find_or_initialize_by(fingerprint: fp)
+      new_fingerprint = !log.persisted?
 
       if log.persisted?
         log.occurrences += 1
@@ -54,6 +59,7 @@ module ErrorRadar
       log.severity     = severity if log.new_record? || severity_rank(severity) > severity_rank(log.severity)
       log.last_seen_at = now
       log.save!
+      log.instance_variable_set(:@new_fingerprint, new_fingerprint)
       log
     rescue StandardError => e
       ErrorRadar::Tracking.warn_internal("ErrorLog.record failed: #{e.class}: #{e.message}")

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

@@ -3,9 +3,12 @@
   status_labels = { 'open' => 'Open', 'in_progress' => 'In progress', 'resolved' => 'Resolved', 'ignored' => 'Ignored' }
 %>
 
-<h1>🛰 Error Radar</h1>
+<div style="display:flex;align-items:baseline;justify-content:space-between;margin-bottom:4px">
+  <h1>Dashboard</h1>
+  <%= link_to 'View All Errors →', errors_path, style: 'font-size:13px' %>
+</div>
 <div class="sub">
-  Track &amp; triage system errors
+  Error overview &amp; kanban board
   <% @external_links.each do |label, href| %>
     · <%= link_to(label.to_s.humanize, href) %>
   <% end %>
@@ -70,7 +73,10 @@
 
 <div class="grid2">
   <div class="panel">
-    <h2>Top 10 errors (unresolved, by occurrences)</h2>
+    <div style="display:flex;justify-content:space-between;align-items:baseline">
+      <h2 style="margin:0 0 12px">Top 10 errors (unresolved, by occurrences)</h2>
+      <%= link_to 'See all →', errors_path(status: 'open'), style: 'font-size:12px' %>
+    </div>
     <table>
       <thead><tr><th>Severity</th><th>Source</th><th>Message</th><th>Count</th><th>Last seen</th></tr></thead>
       <tbody>

data/app/views/error_radar/error_mailer/new_error.html.erb

@@ -0,0 +1,82 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width,initial-scale=1">
+  <style>
+    body{margin:0;padding:20px;background:#f4f6f8;font-family:-apple-system,"Segoe UI",Roboto,Arial,sans-serif;color:#1f2933}
+    .container{max-width:600px;margin:0 auto}
+    .header{background:#1f2933;color:#fff;padding:24px;border-radius:10px 10px 0 0}
+    .header h1{margin:0 0 6px;font-size:18px}
+    .header .meta{color:#9ca3af;font-size:12px}
+    .body{background:#fff;padding:24px;border-radius:0 0 10px 10px}
+    .grid{display:grid;grid-template-columns:1fr 1fr;gap:16px;margin-bottom:20px}
+    .field .label{font-size:11px;text-transform:uppercase;letter-spacing:.06em;color:#9ca3af;margin-bottom:3px}
+    .field .value{font-size:14px;color:#1f2933}
+    .badge{display:inline-block;padding:3px 10px;border-radius:10px;color:#fff;font-size:12px;font-weight:600}
+    .msg-box{background:#f8fafc;border-left:4px solid #dc3545;padding:12px 14px;border-radius:0 8px 8px 0;font-family:ui-monospace,monospace;font-size:12px;white-space:pre-wrap;word-break:break-word;color:#374151;margin:16px 0}
+    .btn{display:inline-block;background:#2563eb;color:#fff!important;padding:11px 22px;border-radius:8px;text-decoration:none;font-size:14px;font-weight:600;margin-top:8px}
+    .footer{margin-top:20px;font-size:11px;color:#9ca3af;text-align:center}
+    <%
+      sev_colors = { 'critical' => '#7b001c', 'error' => '#dc3545', 'warning' => '#fd7e14', 'info' => '#17a2b8' }
+    %>
+  </style>
+</head>
+<body>
+<div class="container">
+  <div class="header">
+    <h1><%= @is_new ? '🆕 New error detected' : '🔁 Critical error recurring' %></h1>
+    <div class="meta"><%= @app_name %> · <%= @error.last_seen_at&.strftime('%Y-%m-%d %H:%M UTC') %></div>
+  </div>
+
+  <div class="body">
+    <div class="field" style="margin-bottom:20px">
+      <div class="label">Error class</div>
+      <div class="value" style="font-family:ui-monospace,monospace;font-size:17px;font-weight:700"><%= @error.error_class %></div>
+    </div>
+
+    <div class="grid">
+      <div class="field">
+        <div class="label">Source</div>
+        <div class="value"><%= @error.source || 'unknown' %></div>
+      </div>
+      <div class="field">
+        <div class="label">Category</div>
+        <div class="value"><%= @error.category.to_s.humanize %></div>
+      </div>
+      <div class="field">
+        <div class="label">Severity</div>
+        <div class="value">
+          <span class="badge" style="background:<%= sev_colors[@error.severity] || '#6c757d' %>"><%= @error.severity %></span>
+        </div>
+      </div>
+      <div class="field">
+        <div class="label">Occurrences</div>
+        <div class="value" style="font-weight:700;font-size:16px"><%= @error.occurrences %></div>
+      </div>
+      <div class="field">
+        <div class="label">First seen</div>
+        <div class="value"><%= @error.first_seen_at&.strftime('%Y-%m-%d %H:%M') %></div>
+      </div>
+      <div class="field">
+        <div class="label">Last seen</div>
+        <div class="value"><%= @error.last_seen_at&.strftime('%Y-%m-%d %H:%M') %></div>
+      </div>
+    </div>
+
+    <div class="field">
+      <div class="label">Message</div>
+      <div class="msg-box"><%= @error.message.to_s.truncate(600) %></div>
+    </div>
+
+    <% if @url %>
+      <a href="<%= @url %>" class="btn">View in Error Radar →</a>
+    <% end %>
+  </div>
+
+  <div class="footer">
+    Sent by <strong>Error Radar</strong> · <%= @app_name %>
+  </div>
+</div>
+</body>
+</html>

data/app/views/error_radar/error_mailer/new_error.text.erb

@@ -0,0 +1,21 @@
+[<%= @app_name %>] <%= @is_new ? 'New error' : 'Critical error recurring' %>: <%= @error.error_class %>
+<%= '=' * 60 %>
+
+Error class:  <%= @error.error_class %>
+Source:       <%= @error.source || 'unknown' %>
+Category:     <%= @error.category %>
+Severity:     <%= @error.severity %>
+Occurrences:  <%= @error.occurrences %>
+First seen:   <%= @error.first_seen_at&.strftime('%Y-%m-%d %H:%M UTC') %>
+Last seen:    <%= @error.last_seen_at&.strftime('%Y-%m-%d %H:%M UTC') %>
+
+Message:
+<%= @error.message.to_s.truncate(1000) %>
+<% if @url %>
+
+View in Error Radar:
+<%= @url %>
+<% end %>
+
+--
+Sent by Error Radar · <%= @app_name %>