Error monitoring and crash reporting for modern applications
Website • Documentation • JavaScript Guide • GitHub
--- **IronTelemetry** helps you capture exceptions, track user journeys, and get actionable insights to fix issues faster. Built for developers who want simple, powerful error monitoring without the complexity. ## Features - **Exception Capture** - Automatically capture and report exceptions with full stack traces - **Journey Tracking** - Understand what users did before an error occurred - **Breadcrumbs** - Add context with custom breadcrumbs and metadata - **Source Maps** - See original source code in stack traces - **Lightweight** - Minimal footprint, no impact on performance - **TypeScript First** - Full TypeScript support with type definitions ## Installation ```bash npm install @ironservices/telemetry # or yarn add @ironservices/telemetry # or pnpm add @ironservices/telemetry ``` ## Quick Start ### Initialize the SDK ```typescript import IronTelemetry from '@ironservices/telemetry'; IronTelemetry.init('https://pk_live_xxx@irontelemetry.com'); ``` ### Capture Exceptions ```typescript try { doSomething(); } catch (error) { IronTelemetry.captureException(error); throw error; } // Or use the extension method try { doSomething(); } catch (error) { throw error.capture(); } ``` ### Track User Journeys ```typescript // Start a journey const journey = IronTelemetry.startJourney('checkout', { userId: 'user-123' }); // Add steps journey.step('add_to_cart', { productId: 'prod-456' }); journey.step('enter_shipping'); journey.step('enter_payment'); // Complete or fail journey.complete(); // or journey.fail('Payment declined'); ``` ### Add Breadcrumbs ```typescript IronTelemetry.addBreadcrumb({ category: 'user', message: 'Clicked checkout button', level: 'info', }); ``` ### Set User Context ```typescript IronTelemetry.setUser({ id: 'user-123', email: 'user@example.com', name: 'John Doe', }); ``` ## Framework Integrations ### Express.js ```typescript import express from 'express'; import IronTelemetry from '@ironservices/telemetry'; const app = express(); // Add error handler app.use(IronTelemetry.express.errorHandler()); ``` ### React ```typescript import { ErrorBoundary } from '@ironservices/telemetry/react'; function App() { return (