๐Ÿš ShellApps Blog
โ† Back to posts

Real-Time Error Tracking for Production Apps

ยท Priya Sharma

Your users will find bugs you never imagined. The question is whether you find out from them or from your error tracker.

Why We Built Error Tracking into Experience Platform

Most teams end up with a patchwork of tools: one for analytics, one for errors, one for feature flags. That means three SDKs, three dashboards, and three bills. We think that's unnecessary overhead.

ShellApps Experience Platform bundles error tracking alongside analytics, feature flags, and feedback โ€” all through a single SDK.

How It Works

Automatic Error Capture

Drop in the SDK, and unhandled exceptions are captured automatically โ€” both in the browser and in Node.js.

import { ShellApps } from '@shellapps/experience-sdk';

const client = new ShellApps({
  appId: 'your-app-id',
  errorTracking: true  // that's it
});

Stack traces are source-mapped, so you see your original code โ€” not minified gibberish.

Manual Error Reporting

Sometimes you want to capture handled errors too:

try {
  await processPayment(order);
} catch (error) {
  client.captureError(error, {
    context: { orderId: order.id, amount: order.total },
    level: 'critical'
  });
  showFallbackUI();
}

Grouping and Deduplication

Nobody wants 10,000 alerts for the same bug. Errors are grouped by stack trace signature, so one bug = one issue, regardless of how many users hit it.

Each issue shows:

  • First and last seen timestamps
  • Affected users count
  • Browser and OS breakdown
  • Full stack trace with source context
  • Custom context you attached

Alerting

Set up alerts by severity level. Critical errors can trigger immediately; warnings can batch into a daily digest. We support webhooks, email, and Slack notifications out of the box.

Performance Impact

The SDK is under 8KB gzipped. Error capture uses a background queue, so it never blocks your main thread. Network requests are batched and sent during idle periods.

We've tested with apps processing millions of events per day. The SDK adds less than 1ms of overhead per page load.

Getting Started

If you're already using Experience Platform for analytics or flags, you have error tracking โ€” just enable it in your SDK config. If you're new, the error tracking docs will have you up and running in under five minutes.

Free tier includes 5,000 error events per month with 30-day retention. More than enough to catch the important stuff.

experience-platform error-tracking monitoring