anomonitor 0.6.1

data/app/models/anomonitor/anomaly.rb

@@ -0,0 +1,105 @@
+# frozen_string_literal: true
+
+module Anomonitor
+  class Anomaly < ApplicationRecord
+    self.table_name = "anomonitor_anomalies"
+
+    validates :rule, :source, :metric, :value, :severity, :cooldown_key, presence: true
+
+    scope :recent, -> { order(created_at: :desc) }
+    scope :open, -> { where(resolved_at: nil) }
+    scope :resolved, -> { where.not(resolved_at: nil) }
+    scope :webhook_failed, -> { where(webhook_status: "failed") }
+
+    def open?
+      resolved_at.nil?
+    end
+
+    def resolved?
+      !open?
+    end
+
+    def webhook_failed?
+      webhook_status.to_s == "failed"
+    end
+
+    def manual_resolve?
+      tag_value("resolved_by").to_s == "manual"
+    end
+
+    def cleared_after_ack?
+      tag_value("cleared_at").present?
+    end
+
+    def resolve!(by: "auto", notify: false)
+      return self if resolved?
+
+      merge_tags!("resolved_by" => by.to_s)
+      update!(resolved_at: Time.current)
+      if notify
+        event = by.to_s == "manual" ? Notifiers::ACKED : Notifiers::RESOLVED
+        Anomonitor.config.build_notifier.deliver(self, event: event)
+      end
+      self
+    end
+
+    def reopen!
+      # Lift manual-ack silence so the next matching drift can notify again.
+      # Keeps history as resolved unless it was still open.
+      if open?
+        merge_tags!("reopened_at" => Time.current.iso8601)
+        save!
+        return self
+      end
+
+      merge_tags!(
+        "cleared_at" => Time.current.iso8601,
+        "reopened_at" => Time.current.iso8601
+      )
+      save!
+      self
+    end
+
+    def retry_webhook!
+      delivered = Anomonitor.config.build_notifier.deliver(
+        self,
+        event: resolved? ? Notifiers::RESOLVED : Notifiers::DETECTED
+      )
+      update!(
+        webhook_status: delivered ? "delivered" : "failed",
+        webhook_delivered_at: delivered ? Time.current : webhook_delivered_at
+      )
+      delivered
+    end
+
+    def items_list
+      list = tag_value("items_list")
+      return Array(list) if list.is_a?(Array)
+
+      items = tag_value("items")
+      return [] if items.nil? || items.to_s.empty?
+
+      items.to_s.split(",").map(&:strip)
+    end
+
+    def tag_value(key)
+      t = tags
+      return nil unless t.is_a?(Hash)
+
+      t[key.to_s] || t[key.to_sym]
+    end
+
+    def merge_tags!(extra)
+      current = tags.is_a?(Hash) ? tags.stringify_keys : {}
+      extra = extra.stringify_keys
+      extra.each do |k, v|
+        if v.nil?
+          current.delete(k)
+        else
+          current[k] = v
+        end
+      end
+      self.tags = current
+    end
+  end
+end

data/app/models/anomonitor/application_record.rb

@@ -0,0 +1,5 @@
+module Anomonitor
+  class ApplicationRecord < ActiveRecord::Base
+    self.abstract_class = true
+  end
+end

data/app/models/anomonitor/metric_sample.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Anomonitor
+  class MetricSample < ApplicationRecord
+    self.table_name = "anomonitor_metric_samples"
+
+    validates :source, :metric, :value, :sampled_at, presence: true
+
+    scope :recent, ->(hours = 24) { where("sampled_at >= ?", hours.hours.ago) }
+    scope :for_metric, ->(metric) { where(metric: metric) }
+
+    def self.latest_by_source_metric
+      recent(6).order(sampled_at: :desc).each_with_object({}) do |sample, hash|
+        key = [sample.source, sample.metric, sample.tags]
+        hash[key] ||= sample
+      end.values
+    end
+
+    def self.series(source:, metric:, hours: 24)
+      where(source: source, metric: metric)
+        .where("sampled_at >= ?", hours.hours.ago)
+        .order(:sampled_at)
+    end
+  end
+end

data/app/models/anomonitor/mute.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Anomonitor
+  class Mute < ApplicationRecord
+    self.table_name = "anomonitor_mutes"
+
+    validates :muted_until, presence: true
+
+    scope :active, -> { where("muted_until > ?", Time.current) }
+    scope :recent, -> { order(muted_until: :desc) }
+
+    def active?
+      muted_until > Time.current
+    end
+
+    def matches?(anomaly_or_attrs)
+      attrs =
+        if anomaly_or_attrs.respond_to?(:metric)
+          {
+            metric: anomaly_or_attrs.metric,
+            rule: anomaly_or_attrs.rule,
+            source: anomaly_or_attrs.source,
+            tenant: tenant_from(anomaly_or_attrs)
+          }
+        else
+          anomaly_or_attrs
+        end
+
+      return false if metric.present? && metric.to_s != attrs[:metric].to_s
+      return false if rule.present? && rule.to_s != attrs[:rule].to_s
+      return false if source.present? && source.to_s != attrs[:source].to_s
+      return false if tenant.present? && tenant.to_s != attrs[:tenant].to_s
+
+      true
+    end
+
+    def self.muted?(anomaly_or_attrs)
+      active.any? { |m| m.matches?(anomaly_or_attrs) }
+    rescue StandardError
+      false
+    end
+
+    def self.prune_expired!
+      where("muted_until <= ?", Time.current).delete_all
+    end
+
+    private
+
+    def tenant_from(anomaly)
+      tags = anomaly.tags
+      return nil unless tags.is_a?(Hash)
+
+      tags["tenant"] || tags[:tenant]
+    end
+  end
+end

data/app/views/anomonitor/anomalies/index.html.erb

@@ -0,0 +1,54 @@
+<% content_for :title, "Anomalies" %>
+
+<h1>Anomalies</h1>
+<p class="am-lead">Threshold breaches, growth spikes, and sticky schema drift with webhook delivery status.</p>
+
+<%= form_with url: anomalies_path, method: :get, local: true, class: "am-filters" do %>
+  <label>
+    <span>Status</span>
+    <select name="status">
+      <% %w[open resolved all].each do |status| %>
+        <option value="<%= status %>" <%= "selected" if @status_filter == status %>><%= status %></option>
+      <% end %>
+    </select>
+  </label>
+  <button type="submit" class="am-btn">Filter</button>
+<% end %>
+
+<% if @anomalies.any? %>
+  <table class="am-table">
+    <thead>
+      <tr>
+        <th>When</th>
+        <th>Status</th>
+        <th>Rule</th>
+        <th>Source</th>
+        <th>Metric</th>
+        <th>Value</th>
+        <th>Tenant</th>
+        <th>Webhook</th>
+      </tr>
+    </thead>
+    <tbody>
+      <% @anomalies.each do |anomaly| %>
+        <% tags = anomaly.tags.is_a?(Hash) ? anomaly.tags : {} %>
+        <tr>
+          <td><%= link_to l(anomaly.created_at, format: :short), anomaly_path(anomaly) %></td>
+          <td>
+            <span class="am-badge <%= anomaly.open? ? "warn" : "ok" %>">
+              <%= anomaly.open? ? "open" : "resolved" %>
+            </span>
+          </td>
+          <td><%= anomaly.rule %></td>
+          <td><%= anomaly.source %></td>
+          <td><%= anomaly.metric %></td>
+          <td><%= number_with_precision(anomaly.value, precision: 0, delimiter: ",") %></td>
+          <td><%= tags["tenant"] || tags[:tenant] || "—" %></td>
+          <td><span class="am-badge <%= anomaly.webhook_status == 'delivered' ? 'ok' : 'warn' %>"><%= anomaly.webhook_status %></span></td>
+        </tr>
+      <% end %>
+    </tbody>
+  </table>
+<% else %>
+  <p class="am-empty">No anomalies match this filter.</p>
+<% end %>

data/app/views/anomonitor/anomalies/show.html.erb

@@ -0,0 +1,54 @@
+<% content_for :title, "Anomaly ##{@anomaly.id}" %>
+
+<h1>Anomaly #<%= @anomaly.id %></h1>
+<p class="am-lead"><%= @anomaly.rule %> on <%= @anomaly.source %> / <%= @anomaly.metric %></p>
+
+<div class="am-actions">
+  <% if @anomaly.open? %>
+    <%= button_to "Resolve / ack", resolve_anomaly_path(@anomaly), method: :post, class: "am-btn" %>
+  <% else %>
+    <%= button_to "Allow alerts again", reopen_anomaly_path(@anomaly), method: :post, class: "am-btn am-btn-muted" %>
+  <% end %>
+  <% if @anomaly.webhook_failed? %>
+    <%= button_to "Retry webhook", retry_webhook_anomaly_path(@anomaly), method: :post, class: "am-btn am-btn-warn" %>
+  <% end %>
+</div>
+
+<dl class="am-detail">
+  <dt>Severity</dt>
+  <dd><span class="am-badge <%= @anomaly.severity %>"><%= @anomaly.severity %></span></dd>
+
+  <dt>Value</dt>
+  <dd><%= @anomaly.value %></dd>
+
+  <dt>Threshold</dt>
+  <dd><%= @anomaly.threshold || "—" %></dd>
+
+  <dt>Sampled at</dt>
+  <dd><%= @anomaly.sampled_at %></dd>
+
+  <dt>Webhook</dt>
+  <dd><%= @anomaly.webhook_status %><%= " @ #{@anomaly.webhook_delivered_at}" if @anomaly.webhook_delivered_at %></dd>
+
+  <dt>Status</dt>
+  <dd>
+    <%= @anomaly.resolved_at ? "resolved @ #{@anomaly.resolved_at}" : "open" %>
+    <% if @anomaly.manual_resolve? %>
+      <span class="am-badge warn">manual ack</span>
+    <% end %>
+  </dd>
+
+  <dt>Cooldown key</dt>
+  <dd><%= @anomaly.cooldown_key %></dd>
+
+  <% items = @anomaly.items_list %>
+  <% if items.any? %>
+    <dt>Items (<%= items.size %>)</dt>
+    <dd class="am-tags"><%= items.join("\n") %></dd>
+  <% end %>
+
+  <dt>Tags</dt>
+  <dd class="am-tags"><%= @anomaly.tags.inspect %></dd>
+</dl>
+
+<p style="margin-top: 1.25rem"><%= link_to "← All anomalies", anomalies_path %></p>

data/app/views/anomonitor/dashboard/show.html.erb

@@ -0,0 +1,124 @@
+<% content_for :title, "Overview" %>
+
+<h1>Overview</h1>
+<p class="am-lead">Queue depth, growth, and anomaly status across configured collectors.</p>
+
+<div class="am-status-row">
+  <span>Mode: <span class="am-badge ok"><%= poller_mode_label(@status) %></span></span>
+  <span>Poller: <span class="am-badge <%= poller_state_badge_class(@status) %>"><%= poller_state_label(@status) %></span></span>
+  <span>Last run: <%= poller_last_run_label(@status) %></span>
+  <span><%= poller_cron?(@status) ? "Schedule" : "Interval" %>: <%= poller_schedule_label(@status) %></span>
+  <% if @status[:last_error].present? || @status["last_error"].present? %>
+    <span class="am-badge danger"><%= @status[:last_error] || @status["last_error"] %></span>
+  <% end %>
+</div>
+
+<%= form_with url: root_path, method: :get, local: true, class: "am-filters" do %>
+  <label>
+    <span>Tenant</span>
+    <select name="tenant">
+      <option value="">All tenants</option>
+      <% @tenants.each do |tenant| %>
+        <option value="<%= tenant %>" <%= "selected" if @tenant == tenant %>><%= tenant %></option>
+      <% end %>
+    </select>
+  </label>
+  <button type="submit" class="am-btn">Filter</button>
+<% end %>
+
+<% if @tenant %>
+  <p class="am-lead">Showing tenant <code><%= @tenant %></code> — <%= link_to "clear", root_path %>.</p>
+<% end %>
+
+<section class="am-section">
+  <h2>Current metrics<% if @tenant %> · <%= @tenant %><% end %></h2>
+  <% if @latest_metrics.any? %>
+    <div class="am-grid">
+      <% @latest_metrics.first(12).each do |sample| %>
+        <div class="am-stat">
+          <div class="label"><%= sample.source %> · <%= sample.metric %></div>
+          <div class="value"><%= number_with_precision(sample.value, precision: 0, delimiter: ",") %></div>
+          <div class="meta">
+            <%= time_ago_in_words(sample.sampled_at) %> ago
+            <% tags = sample.tags.is_a?(Hash) ? sample.tags : {} %>
+            <% if tags["tenant"] || tags[:tenant] || tags["queue"] || tags[:queue] %>
+              · <%= [tags["tenant"] || tags[:tenant], tags["queue"] || tags[:queue]].compact.join(" / ") %>
+            <% end %>
+          </div>
+        </div>
+      <% end %>
+    </div>
+  <% else %>
+    <p class="am-empty">No samples yet. <% if poller_cron?(@status) %>Run <code>rails anomonitor:poll</code> (or wait for cron).<% else %>The poller will populate metrics after the first tick.<% end %></p>
+  <% end %>
+</section>
+
+<% if @by_tenant && @by_tenant.size > 1 && @tenant.nil? %>
+  <section class="am-section">
+    <h2>By tenant</h2>
+    <div class="am-grid">
+      <% @by_tenant.first(8).each do |tenant, samples| %>
+        <div class="am-stat">
+          <div class="label"><%= link_to tenant, root_path(tenant: tenant == "(untagged)" ? nil : tenant) %></div>
+          <div class="value"><%= samples.size %></div>
+          <div class="meta">metric series</div>
+        </div>
+      <% end %>
+    </div>
+  </section>
+<% end %>
+
+<section class="am-section">
+  <h2>Recent history</h2>
+  <% if @series.any? %>
+    <div class="am-grid">
+      <% @series.first(6).each do |(key, rows)| %>
+        <% source, metric = key %>
+        <% max = rows.map(&:value).max.to_f %>
+        <div class="am-stat">
+          <div class="label"><%= source %> · <%= metric %></div>
+          <div class="am-bars">
+            <% rows.each do |row| %>
+              <% height = max.positive? ? [(row.value / max * 100).round, 4].max : 4 %>
+              <div class="am-bar" style="height: <%= height %>%" title="<%= row.value %> @ <%= row.sampled_at %>"></div>
+            <% end %>
+          </div>
+        </div>
+      <% end %>
+    </div>
+  <% else %>
+    <p class="am-empty">No history yet.</p>
+  <% end %>
+</section>
+
+<section class="am-section">
+  <h2>Open anomalies</h2>
+  <% if @recent_anomalies.any? %>
+    <table class="am-table">
+      <thead>
+        <tr>
+          <th>When</th>
+          <th>Rule</th>
+          <th>Source</th>
+          <th>Metric</th>
+          <th>Value</th>
+          <th>Severity</th>
+        </tr>
+      </thead>
+      <tbody>
+        <% @recent_anomalies.each do |anomaly| %>
+          <tr>
+            <td><%= link_to time_ago_in_words(anomaly.created_at) + " ago", anomaly_path(anomaly) %></td>
+            <td><%= anomaly.rule %></td>
+            <td><%= anomaly.source %></td>
+            <td><%= anomaly.metric %></td>
+            <td><%= number_with_precision(anomaly.value, precision: 0, delimiter: ",") %></td>
+            <td><span class="am-badge <%= anomaly.severity %>"><%= anomaly.severity %></span></td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  <% else %>
+    <p class="am-empty">No open anomalies. <%= link_to "View all", anomalies_path(status: "all") %>.</p>
+  <% end %>
+</section>

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

@@ -0,0 +1,135 @@
+<% content_for :title, "Jobs" %>
+
+<h1>Jobs</h1>
+<p class="am-lead">Queue health and live jobs across configured collectors. Read-only — use your host job UI to retry or delete.</p>
+
+<section class="am-section">
+  <h2>Collector health</h2>
+  <% if @health.any? %>
+    <div class="am-grid">
+      <% @health.each do |card| %>
+        <% collector = card[:collector] || {} %>
+        <% ok = collector[:ok].nil? ? collector["ok"] : collector[:ok] %>
+        <div class="am-stat">
+          <div class="label"><%= card[:source] %></div>
+          <div class="am-health-metrics">
+            <span>depth <strong><%= format_metric(card[:queue_depth]) %></strong></span>
+            <span>failed <strong><%= format_metric(card[:failed]) %></strong></span>
+            <span>locked <strong><%= format_metric(card[:locked]) %></strong></span>
+          </div>
+          <div class="meta">
+            <% if ok == true %>
+              <span class="am-badge ok">collector ok</span>
+            <% elsif ok == false %>
+              <span class="am-badge danger">collector error</span>
+            <% else %>
+              <span class="am-badge warn">no poll yet</span>
+            <% end %>
+          </div>
+          <% if card[:series].any? %>
+            <% max = card[:series].map(&:value).max.to_f %>
+            <div class="am-bars">
+              <% card[:series].each do |row| %>
+                <% height = max.positive? ? [(row.value / max * 100).round, 4].max : 4 %>
+                <div class="am-bar" style="height: <%= height %>%" title="<%= row.value %> @ <%= row.sampled_at %>"></div>
+              <% end %>
+            </div>
+          <% end %>
+        </div>
+      <% end %>
+    </div>
+  <% else %>
+    <p class="am-empty">No job collectors enabled.</p>
+  <% end %>
+</section>
+
+<section class="am-section">
+  <h2>Live jobs</h2>
+
+  <%= form_with url: jobs_path, method: :get, local: true, class: "am-filters" do %>
+    <label>
+      <span>Source</span>
+      <select name="source">
+        <option value="">All</option>
+        <% @sources.each do |source| %>
+          <option value="<%= source %>" <%= "selected" if @filters[:source] == source %>><%= source %></option>
+        <% end %>
+      </select>
+    </label>
+    <label>
+      <span>Status</span>
+      <select name="status">
+        <% @status_options.each do |status| %>
+          <option value="<%= status %>" <%= "selected" if @filters[:status] == status %>><%= status %></option>
+        <% end %>
+      </select>
+    </label>
+    <label>
+      <span>Tenant</span>
+      <input type="text" name="tenant" value="<%= @filters[:tenant] %>" placeholder="optional">
+    </label>
+    <label>
+      <span>Queue</span>
+      <input type="text" name="queue" value="<%= @filters[:queue] %>" placeholder="queue name">
+    </label>
+    <label>
+      <span>Search</span>
+      <input type="text" name="q" value="<%= @filters[:q] %>" placeholder="job class / name">
+    </label>
+    <button type="submit" class="am-btn">Filter</button>
+  <% end %>
+
+  <% if @jobs.any? %>
+    <div class="am-table-wrap">
+      <table class="am-table am-jobs-table">
+        <thead>
+          <tr>
+            <th>Source</th>
+            <th>Id</th>
+            <th>Name</th>
+            <th>Status</th>
+            <th>Queue / Tenant</th>
+            <th>When</th>
+            <th>Error</th>
+          </tr>
+        </thead>
+        <tbody>
+          <% @jobs.each do |job| %>
+            <tr>
+              <td><%= job.source %></td>
+              <td><code><%= job.id %></code></td>
+              <td>
+                <code><%= job.name %></code>
+                <% if job.detail.present? %>
+                  <details class="am-job-detail">
+                    <summary>detail</summary>
+                    <pre class="am-tags"><%= job.detail_text %></pre>
+                  </details>
+                <% end %>
+              </td>
+              <td>
+                <span class="am-badge <%= job_status_badge_class(job.status) %>"><%= job.status %></span>
+              </td>
+              <td>
+                <% bits = [job.queue, job.tenant].compact %>
+                <%= bits.any? ? bits.join(" · ") : "—" %>
+              </td>
+              <td>
+                <% when_at = job.failed_at || job.run_at %>
+                <% if when_at %>
+                  <%= time_ago_in_words(when_at) %> ago
+                  <div class="meta"><%= l(when_at, format: :short) rescue when_at %></div>
+                <% else %>
+                  —
+                <% end %>
+              </td>
+              <td><code class="am-tags"><%= job.error.presence || "—" %></code></td>
+            </tr>
+          <% end %>
+        </tbody>
+      </table>
+    </div>
+  <% else %>
+    <p class="am-empty">No live jobs matched these filters (or backends are unavailable).</p>
+  <% end %>
+</section>

data/app/views/anomonitor/metrics/index.html.erb

@@ -0,0 +1,33 @@
+<% content_for :title, "Metrics" %>
+
+<h1>Metrics</h1>
+<p class="am-lead">Recent metric samples from the last 24 hours.</p>
+
+<% if @metrics.any? %>
+  <div class="am-table-wrap">
+    <table class="am-table">
+      <thead>
+        <tr>
+          <th>Sampled</th>
+          <th>Source</th>
+          <th>Metric</th>
+          <th>Value</th>
+          <th>Tags</th>
+        </tr>
+      </thead>
+      <tbody>
+        <% @metrics.each do |sample| %>
+          <tr>
+            <td><%= l(sample.sampled_at, format: :short) %></td>
+            <td><%= sample.source %></td>
+            <td><%= sample.metric %></td>
+            <td><%= number_with_precision(sample.value, precision: 2, strip_insignificant_zeros: true) %></td>
+            <td><code class="am-tags"><%= sample.tags.presence || {} %></code></td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  </div>
+<% else %>
+  <p class="am-empty">No metric samples yet.</p>
+<% end %>

data/app/views/anomonitor/mutes/index.html.erb

@@ -0,0 +1,56 @@
+<% content_for :title, "Mutes" %>
+
+<h1>Mutes / snoozes</h1>
+<p class="am-lead">Silence anomaly creation for a metric, rule, source, and/or tenant until a time.</p>
+
+<%= form_with url: mutes_path, method: :post, local: true, class: "am-filters" do %>
+  <label><span>Metric</span><input type="text" name="metric" placeholder="extra_tables"></label>
+  <label><span>Rule</span><input type="text" name="rule" placeholder="threshold"></label>
+  <label><span>Source</span><input type="text" name="source" placeholder="schema_drift"></label>
+  <label><span>Tenant</span><input type="text" name="tenant" placeholder="optional"></label>
+  <label>
+    <span>Duration</span>
+    <select name="duration">
+      <option value="1h">1 hour</option>
+      <option value="6h">6 hours</option>
+      <option value="24h" selected>24 hours</option>
+      <option value="7d">7 days</option>
+    </select>
+  </label>
+  <label><span>Reason</span><input type="text" name="reason" placeholder="optional"></label>
+  <button type="submit" class="am-btn">Mute</button>
+<% end %>
+
+<% if @mutes.any? %>
+  <table class="am-table">
+    <thead>
+      <tr>
+        <th>Until</th>
+        <th>Metric</th>
+        <th>Rule</th>
+        <th>Source</th>
+        <th>Tenant</th>
+        <th>Reason</th>
+        <th></th>
+      </tr>
+    </thead>
+    <tbody>
+      <% @mutes.each do |mute| %>
+        <tr>
+          <td>
+            <%= l(mute.muted_until, format: :short) rescue mute.muted_until %>
+            <% unless mute.active? %><span class="am-badge warn">expired</span><% end %>
+          </td>
+          <td><%= mute.metric || "—" %></td>
+          <td><%= mute.rule || "—" %></td>
+          <td><%= mute.source || "—" %></td>
+          <td><%= mute.tenant || "—" %></td>
+          <td><%= mute.reason || "—" %></td>
+          <td><%= button_to "Remove", mute_path(mute), method: :delete, class: "am-btn am-btn-muted" %></td>
+        </tr>
+      <% end %>
+    </tbody>
+  </table>
+<% else %>
+  <p class="am-empty">No mutes configured.</p>
+<% end %>