Error Tracking

Gain high-level and granular visibility into errors within your web applications. With OpenReplay, you can troubleshoot with full context, enabling faster resolution of issues.

1. Navigate to the session view > Errors tab
2. Use Omnisearch: select the event “Error Message” and enter the specific error message.

1. Navigate to Console > Errors Tab
2. Open the error to view full sourcemaps.
3. Click on “Find all sessions with this error” to see the list of sessions where the error occurred.

1. Navigate to Cards > Add Card > Monitors
2. Select Table of Errors card

The OpenReplay tracker supports logging three types of errors:

1. Caught Exceptions - Error
2. Rejected Promises - PromiseRejectionEvent
3. Error Events (onError) - ErrorEvent

All of these can be reported using a single method:

tracker.handleError(error, metaObject); // metaObject is optional and is a flat object

Let’s review examples for each type of error:

By default, caught exceptions are not logged to the ‘Console’ tab. To report an error, use the following pattern:

try {
    // application code
} catch (err) {
    // application code that handles the error
    tracker.handleError(err, metaObject); // metaObject is optional and is a flat object
}

If a promise is rejected and needs to be reported to OpenReplay, use this approach:

function myFunc() {
    doSomeAsyncStuff()
        .then((result) => {
            // application code
        })
        .catch(promiseRejectionErr => {
            // application code to handle the error
            tracker.handleError(promiseRejectionErr, metaObject); // metaObject is optional and is a flat object
        });
}

Report errors triggered by events, such as an <img> element failing to load:

<img id="myImg" src="image.gif">
<p id="demo"></p>

<script>
document.getElementById("myImg").addEventListener("error", myFunction);

function myFunction(errorEvent) {
    document.getElementById("demo").innerHTML = "The image could not be loaded.";
    tracker.handleError(errorEvent, { context: "demo" });
}
</script>

If you have any questions about this process, feel free to reach out to us on our Slack or check out our Forum.