🤖 Sniffer AutoBug

The CDN-driven auto-capture pipeline that watches your production application 24/7 and feeds detected errors into Sniffer via a real-time live feed.

🌟 Overview#

Sniffer AutoBug is the always-on capture layer that pairs with the 📡 Live Logs error-monitoring system. Where Live Logs is the list of detected errors and 🛰️ System Bugs is the triage UI, AutoBug is the pipeline that delivers them — the CDN snippet, the WebSocket live feed, and the configuration page that controls how captured events are turned into bugs.

It uses the same sniffer.js snippet that powers the 💬 Feedback Widget , but the AutoBug subsystem focuses on silent, automatic capture: errors fired by uncaught exceptions, network failures, performance regressions, and other runtime signals.

🖼️ Insert image of the Sniffer AutoBug settings + live feed page side-by-side.

Routes:

Settings → /sf/projects/:id/settings/sniffer-autobug
Live feed (embedded) → on the same page

🧩 How It Works#


Browser (snippet)
    │  fires JS error / network failure / perf event
    ▼
Sniffer Edge (CDN ingestion)
    │  dedup + enrich (device, geo, session)
    ▼
WebSocket /auto-bugs channel
    │  emit `new-auto-bug` event
    ▼
Sniffer AutoBug UI
    │  appears in Live Feed
    │  matched against config rules
    ▼
[Optional] Auto-create [📋 Task Board](https://app.interactivedox.com/documentation-portal/product/6a019976848b35a281f94e9c/1.1.2/6a2bae2de68b4486d43a9d17/workflows/task-board) issue
       OR add to [🛰️ System Bugs](https://app.interactivedox.com/documentation-portal/product/6a019976848b35a281f94e9c/1.1.2/6a2bae2de68b4486d43a9d17/feedback-and-monitoring/system-bugs)
       OR fan-out to Slack / Teams / Jira

⚙️ Configuration Page#

Route: /sf/projects/:id/settings/sniffer-autobug

The Settings tab has two main areas: Settings (left) and Live Feed (right).

Settings Panel#

Setting	Description
AutoBug Enabled	Master toggle for the entire AutoBug pipeline on this project
Default Status	Status to assign newly-captured auto-bugs (e.g., `NEW`) — dropdown with color chips
Default Severity	Severity to assign auto-bugs (Critical / High / Medium / Low)
Auto-Create Task	Toggle — create a Task Board issue per dedup’d error
Dedup Window	Time window (in minutes) for fingerprint-based deduplication
Capture Sample Rate	Percentage (1–100) — useful for high-volume apps
Allowed Origins	Hostname whitelist (`*.example.com`, `app.acme.io`)
Ignore Patterns	Regex array of error messages to drop
PII Mask Keys	List of input names / regexes whose values are scrubbed before upload
Source Map URLs	Optional — URLs to source maps so stack traces are un-minified
Routing Rules	Auto-assign / auto-tag based on URL pattern

Live Feed Panel#

A real-time stream of incoming auto-bugs, powered by a WebSocket on /auto-bugs.

Element	Description
New bug row	One row per `new-auto-bug` event (animated entrance)
Pause / Resume	Stop the stream temporarily
Filter	Narrow by error type, URL, severity
Click-through	Open the full 🛰️ System Bug detail
Inline actions	Mark as ignored, mark as resolved, link to a task

WebSocket events:

Event	Trigger
`new-auto-bug`	A brand-new fingerprint just appeared
`auto-bug-updated`	Existing bug got a new occurrence / count++
`auto-bugs-update`	Batch update (e.g., status reassignment)

🖼️ Insert image of the Live Feed with 5+ rows streaming in real-time.

📥 The Snippet#


<script
  src="https://cdn.snifferweb.com/sniffer.js"
  data-project-id="YOUR_PROJECT_ID"
  data-autobug="true"
  data-environment="production"
></script>

Data Attribute	Purpose
`data-project-id`	Required — your Sniffer project ID
`data-autobug`	`true` to enable AutoBug capture (default `true`)
`data-environment`	Tag uploads with the env (matches Env Topology )
`data-feedback`	`false` to disable the feedback widget
`data-sample`	Override sample rate (0–1.0)
`data-user-id`	Identify the current user (for affected-user counts)
`data-mask`	Comma-separated regexes for PII masking

Tip: The same script tag is shared with 💬 Feedback Widget and 📡 Live Logs . Use data attributes to control which sub-systems are active.

🎯 Routing Rules#

Configure rules that act on incoming auto-bugs before they become System Bugs or Task Board issues:

Rule Component	Description
URL pattern	Match by page (e.g., `/checkout/*`)
Error type	JS Error / Network / Promise / Resource / CSP
Status code	Match HTTP status code (e.g., 5xx only)
Browser / OS	Filter by browser/OS
Severity override	Force a specific severity for matches
Auto-tag	Apply tags to matching auto-bugs
Auto-assign	Assign to a team / user
Notify channel	Send to a specific Slack/Teams channel
Drop	Silently drop matches (useful for noisy 3rd-party errors)

Rules evaluated top-to-bottom — drag to reorder.

🖼️ Insert image of the Routing Rules table with multiple rules.

🚨 Alert Thresholds#

The AutoBug pipeline can fire alerts before issues are auto-created:

Threshold	Effect
Immediate	Alert on first occurrence
3+ count	Alert after 3rd occurrence
10+ count	Alert after 10 occurrences
Burst rate	Alert when N occurrences within M minutes
New user	Alert when an error impacts a previously-unaffected user

Alerts are delivered via the channels configured in 🔗 Integrations (Slack, Teams, email, in-app).

🤖 AI on AutoBug#

Each captured auto-bug feeds into AI:

🤖 AI Analysis automatically runs on new auto-bugs
🛠️ Orchestrator can be configured to auto-trigger an investigate job for high-severity auto-bugs
Stack traces are matched against GitHub/Bitbucket repo to suggest the affected file
Pattern detection clusters similar auto-bugs into a single “issue family”

🔐 Privacy#

Aspect	Behaviour
PII masking	Apply masks defined in project settings + 🏢 PII Management before upload
Allowed origins	Only events from whitelisted hostnames are accepted
No cookies	No 3rd-party cookies — uses a single first-party session ID
GDPR	Personal data flags drive retention; data is deletable on request

🔐 Permissions#

Action	Required Permission
View AutoBug settings	`LIVE_LOGS.VIEW`
Configure AutoBug	`LIVE_LOGS.CONFIGURE`
View live feed	`LIVE_LOGS.VIEW`
Resolve / ignore auto-bugs	`LIVE_LOGS.CONFIGURE`

🐞 Troubleshooting#

Symptom	Likely Cause / Fix
Live Feed shows nothing	Snippet not loaded / hostname not in Allowed Origins
Bursts of duplicate auto-bugs	Increase Dedup Window or sharpen fingerprint via PII mask
Some errors aren’t captured	Check Sample Rate and Ignore Patterns
Stack traces are minified	Upload source maps or set Source Map URLs
Auto-create is on but no Task Board issues appear	Auto-Create-Task toggle is OFF — verify in settings

See ❓ Troubleshooting → .

Topic	Description
📡 Live Logs →	The detection pipeline (what AutoBug delivers)
🛰️ System Bugs →	Triage UI for captured errors
📋 Task Board →	Auto-created Task Board issues
🐛 Bug Details →	Detail drawer with AI Analysis
🛠️ Orchestrator →	Autonomous follow-up jobs on captured errors
⚙️ Settings & Permissions →	Enable AutoBug at the project level
🔗 Integrations →	Slack / Teams / email alert delivery