Configuration
Options for Pulse.start() — the JS-layer initialization call.
For native-side configuration, see the platform SDK references: iOS SDK Initialization · Android SDK Configuration.
Pulse.start(options?)
Pulse.start({
autoDetectExceptions: true, // JS crash and error detection
autoDetectNetwork: true, // HTTP request interception
autoDetectNavigation: true, // kill switch for navigation tracking
});
All options default to true. Pass false to disable an instrumentation.
| Option | Default | Description |
|---|---|---|
autoDetectExceptions | true | Global JS error handler — catches unhandled exceptions and promise rejections |
autoDetectNetwork | true | Intercepts XMLHttpRequest / fetch / axios — zero code changes required |
autoDetectNavigation | true | Kill switch — set to false to completely disable navigation tracking. Tracking requires the useNavigationTracking hook regardless — see Navigation Instrumentation. |
Network Header Capture
Capture specific request or response headers alongside network spans:
Pulse.start({
networkHeaders: {
requestHeaders: ['x-request-id', 'x-trace-id'],
responseHeaders: ['x-response-time', 'cache-control'],
},
});
Shutdown
Permanently shuts down the SDK. Cannot be reversed in the same process.
Pulse.shutdown();
Next Steps
| I want to… | Go to |
|---|---|
| Configure a specific instrumentation | Instrumentation guides |
| Track business events | Custom Events |
| Report handled errors | Error Tracking |
| Measure operation durations | Custom Spans |
| Catch React render errors | Error Boundaries |
| Attach user identity | User Identification |
| Add global metadata | Global Attributes |
| Gate collection behind consent | Data Collection Consent |
| Configure native iOS instrumentation | iOS SDK Initialization |
| Configure native Android instrumentation | Android SDK Configuration |