Docs/Alerts & Incident Engine

Real-Time Incident Triage & Observability

Alerts & Incident Engine

Open Analytics incorporates an autonomous, real-time telemetry anomaly engine that automatically monitors crash spikes, Core Web Vitals degradation, search crawler readiness, and user frustration without requiring manual query configurations.

Autonomous Anomaly Radar

Continuously evaluates inbound telemetry streams to trigger alerts on repeated crashes (5x+), error storms, and dead ends.

Native OS Desktop Alerts

Browser Notifications API with dual-tone Web Audio synthesized chimes and 45-second background tab synchronization.

Granular Ignore Rules

Mute entire notification types or define regex and substring pattern rules across error messages, titles, and route paths.

Telemetry Heuristics

7 Autonomous Incident Types

Each anomaly is evaluated against verified historical baselines and assigned an automated severity level:

Repeated Error Spikes

Real-Time Telemetry

critical

Triggers high-priority alerts when identical runtime exceptions recur 5 or more times within a sliding window. Progressive milestone brackets notify teams at 10x, 25x, 50x, and 100x+ frequency.

Threshold:>= 5 identical occurrences

Error Velocity Storms

Rate Ingestion Surge

critical

Catastrophic error storm detection that activates when error velocity spikes sharply, indicating broken production deployments, invalid third-party scripts, or API gateway downtime.

Threshold:> 10 errors / 5 minutes

SEO Missing Title Audits

Automated Site Scan

warning

Scans indexed landing pages and routes for missing, blank, or placeholder document titles that negatively impact search engine indexability and social media metadata previews.

Threshold:Missing or empty <title>

AEO Low Dwell Friction

Behavioral Retention

warning

Identifies answer engine routes where visitors immediately bounce without engaging, signaling misleading headings, slow initial rendering, or content mismatch for AI search queries.

Threshold:Average dwell < 10s on content routes

GEO AI Citation Radar

Generative Engine Audit

info

Monitors readiness for generative search engines (OpenAI SearchGPT, Perplexity, ClaudeBot, Gemini) and notifies teams when crawler visibility or structured citation drops below benchmark.

Threshold:Citation readiness score < 50%

Core Web Vitals Degradation

RUM Performance Threshold

warning

Continuous field monitoring of real visitor experience. Generates incident tickets when 75th-percentile interaction responsiveness (INP) or loading times (LCP) slip into the poor threshold.

Threshold:p75 INP > 500ms or LCP > 4.0s

Behavioral Rage Click Hotspots

UX Friction Telemetry

warning

Captures rapid, repeated tapping on broken buttons, stalled links, or unresponsive elements. Groups frustrated sessions by DOM selector to accelerate frontend bug remediation.

Threshold:>= 3 rapid taps within 500ms and 40px

Native Operating System Integration

Desktop Notifications & Synthesized Audio Chimes

Engineering and DevOps teams cannot afford to stare at an open browser tab 24/7. Open Analytics integrates directly with the native operating system desktop notification center:

Background Tab Synchronization

PlatformContext executes an automated 45-second background sync poll. If a repeated error spike or storm occurs while your dashboard tab is minimized, an OS desktop alert appears instantly.

Synthesized Web Audio Engine

Dual-tone audible chimes (D5 587.33 Hz transitioning smoothly to A5 880.00 Hz) are generated dynamically using the native browser Web Audio API oscillator, requiring 0 external MP3 downloads.

1-Click Deep Navigation

Clicking any desktop alert immediately focuses your browser window and routes directly to the affected crash trace (`/errors`), SEO report (`/seo`), or incident summary (`/notifications`).

Automated Permission Prompt Banner

The floating in-app prompt banner (`BrowserNotificationPrompt.tsx`) seamlessly handles browser gesture requirements, requesting permissions politely with instant session snooze options.

Alert Noise Reduction

Granular Ignore & Suppression Rules

Eliminate alert fatigue by suppressing known staging issues, benign third-party analytics script warnings, or specific development routes before notifications are written to the database:

Two-Tier Suppression Architecture

1. General Type Muting

Toggle on or off any of the 7 general notification categories across the entire project. For example, turn off SEO title audits during initial site construction.

2. Custom Pattern Rules

Match against specific route pathnames (e.g., /staging), error messages, or alert titles using contains, exact, prefix, or regular expressions.

1-Click Inline Mute Menus

Every alert card in the Notification Center popover and `/notifications` dashboard features an interactive BellOff menu. With a single click, engineers can mute the notification type, silence all alerts on the affected route, or suppress the specific incident signature permanently.

Developer Integration

Alert Rules REST API

Programmatically configure thresholds and manage ignore rules via the project API:

// Configure project alert rules & suppression filters via REST API
const res = await fetch("/api/projects/prj_production_app/alert-rules", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    action: "add_rule",
    rule: {
      id: "rule_suppress_staging",
      name: "Ignore Staging Pathnames",
      type: "all",
      matchField: "route",
      matchType: "starts_with",
      pattern: "/staging",
      enabled: true,
    }
  })
});
const { alertSettings } = await res.json();

Explore Notifications Dashboard

View active incidents, run optimization scans, and manage project alert rules in real time.

Open Notification Hub