errsole

Errsole

Capture, Reproduce, and Debug Node.js Errors

:star: We appreciate your star, it helps!

Installation and Usage

1. Errsole is a Node.js module. You can install this module using the npm install command:

   npm install errsole
   

2. Click on the button below to get the Errsole code snippet. Put the code snippet at the top of your app's main file.

   

   Example

   /**
    * Put the Errsole code snippet at the top of your app's main file
    */
   const errsole = require('errsole');
   errsole.initialize({
     framework: 'express',
     token: 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'
   });
   
   /**
    * Your app code starts here
    */
   const express = require('express');
   const app = express();
   
   app.get('/', function (req, res) {
     res.send('Hello World');
   });
   
   app.listen(3000);
   

Advanced Configuration

Name	Type	Default	Description
framework	string		Required. Your Node.js framework name.
token	string		Required. Click here to generate a unique token
enableDebugger	boolean	true	Optional. If false, the debugger is disabled.
editCode	boolean	false	Optional. If true, you can edit code while debugging an error. Setting true in staging and production environments is not recommended because your developers can run arbitrary code on your production server.
evalExpression	boolean	false	Optional. If true, you can evaluate JavaScript expressions while debugging an error. Setting true in staging and production environments is not recommended because your developers can run arbitrary code on your production server.

Example

/**
 * Put the Errsole code snippet at the top of your app's main file
 */
const errsole = require('errsole');
errsole.initialize({
  framework: 'express',
  token: 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
  enableDebugger: true,
  editCode: false, // Set true in development and testing environments
  evalExpression: false // Set true in development and testing environments
});

/**
 * Your app code starts here
 */
const express = require('express');
const app = express();

app.get('/', function (req, res) {
  res.send('Hello World');
});

app.listen(3000);

Features

View your Node.js errors and their root cause

Errsole captures all Node.js errors raised in your servers and the HTTP requests that triggered the errors. You can view all your Node.js errors and the root cause of each error in one place.

• Centralized Logging: view errors from all servers in one place
• View the HTTP requests that triggered the errors

Reproduce errors in a sandbox environment

Errsole creates a clone of your Node.js app in your server and reproduces errors in the app clone. You can reproduce errors in the same environment where they occurred and do it any number of times without affecting your app.

• Reproduce errors with a click of a button
• Errors are reproduced in the same environment
• Your app is unaffected and safe

Debug your server code in real-time

Errsole connects a feature-rich debugger to the app clone in your server. You can reproduce errors and debug your server code without affecting your app.

• View and edit code in a sandbox environment
• Set breakpoints and pause execution at any line
• Inspect variables; view call stack
• View debug logs

Collaborate with your team

You can invite developers to your app team and assign errors to them. Your teammates can view, reproduce, and debug your app errors without conflicting with each other.

• Invite developers to your app team
• Assign errors to your teammates
• Your teammates can debug errors without conflict

Demo Video

Support

We appreciate your star, it helps!

If you run into any issues, please email us at [e-mail].

For bug reports, please open an issue on GitHub.

License

MIT