By default, Epsagon automatically captures any unhandled exceptions in your code, and identify other unique scenarios of errors (for example when your service returns a >=500 status code.

In some cases, you would want/need to track down bad events, that are not necessarily break your service.

For example you run an operation to database, and get a valid response that you didn't expected to.
Another scenario can be in a try/catch block, where we handled successfully the error, but we still want to get notified for the problem.

📘

Issues and alerts

When using a custom error, it will generate an issue, that you can track over time, and it will send you an alert if you've configured to receive alerts for exceptions.

Setting a custom error

Let's use the following example, in Node.js:

const epsagon = require('epsagon');

epsagon.init({
    token: 'token',
    appName: 'custom-error-demo',
    metadataOnly: false,
});

async function test(params) {
    // a bad response comes from the DB
    epsagon.setError(Error('Unexpected result from the DB'));
}

epsagon.nodeWrapper(test)()

This will result in the following trace:

And the following issue:

Another example can be on a try/catch scenario:

const epsagon = require('epsagon');

epsagon.init({
    token: 'token',
    appName: 'custom-error-demo',
    metadataOnly: false,
});

async function test(params) {
    try {
        // Code crash
    } catch (err) {
      // Handling the exception, and reporting to Epsagon
      epsagon.setError(err);
    }
}

epsagon.nodeWrapper(test)()