View, Filter, and Analyze the logs in real time
Errsole is an open-source logger with built-in dashboard. It goes beyond traditional logging by capturing log messages and storing them in a specified database. What sets Errsole apart is its interactive web dashboard, which allows users to effortlessly view, filter, and analyze their logs in real time.
- Effortless Integration: Get Errsole up and running with minimal setup, seamlessly integrating into your Node.js projects.
- Automated Log Capture: Automatically captures both informational and error logs, ensuring that you never miss vital application insights.
- Web Dashboard: Utilize the intuitive web interface for a comprehensive log analysis experience, enabling efficient log viewing, filtering, and real-time insights.
-
Installation: Begin by installing Errsole and its MongoDB adapter through npm:
npm install errsole errsole-mongodb
-
Configuration: Initialize Errsole in your application with MongoDB as the storage option:
const errsole = require('errsole'); const ErrsoleMongoDB = require('errsole-mongodb'); errsole.initialize({ storage: new ErrsoleMongoDB('your-mongodb-url', 'your-database-name'), port: 8001, // Optional: Specify the dashboard port (default is 8001) path: '/' // Optional: Specify the dashboard base path (default is '/') });
- Replace
'your-mongodb-url'
with your actual MongoDB connection URL. - Replace
'your-database-name'
with the name of the database where logs should be stored.
- Replace
Integrate Errsole into a simple Express app to see it in action:
const express = require('express');
const app = express();
// Errsole setup (as shown above)
app.get('/', (req, res) => {
res.send('Hello World');
});
app.listen(3000, () => console.log('Server running on http://localhost:3000'));
Once Errsole is integrated and your application is running, access the Errsole dashboard through your web browser:
http://localhost:8001/
If you specified a custom port or path during initialization, adjust the URL accordingly.
Contributing: Contributions are highly encouraged! If you have suggestions for improvements, feel free to fork the repository, make your changes, and submit a pull request.
Support: For support, questions, or feature requests, please open an issue on the GitHub repository. We're here to help make Errsole even better!