https://github.com/errsole/errsole.js

Collect, Store, and Visualize Logs with a Single Module
https://github.com/errsole/errsole.js

bunyan log log4j log4js logger logging logs node nodejs open-source opensource pino winston

Last synced: 30 days ago
JSON representation

Collect, Store, and Visualize Logs with a Single Module

• Host: GitHub
• URL: https://github.com/errsole/errsole.js
• Owner: errsole
• License: mit
• Created: 2021-05-28T16:23:12.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2024-09-18T09:09:58.000Z (2 months ago)
• Last Synced: 2024-09-18T10:12:39.349Z (2 months ago)
• Topics: bunyan, log, log4j, log4js, logger, logging, logs, node, nodejs, open-source, opensource, pino, winston
• Language: JavaScript
• Homepage:
• Size: 16.1 MB
• Stars: 180
• Watchers: 4
• Forks: 43
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-rainmana - errsole/errsole.js - Collect, Store, and Visualize Logs with a Single Module (JavaScript)

README

        


  

  
Collect, Store, and Visualize Logs with a Single Module


  


  

  

  

  

    

  

  


Errsole is an open-source logger for Node.js. It has a built-in web dashboard to view, filter, and search your app logs.

https://github.com/errsole/errsole.js/assets/3775513/b59424fa-c3b3-4a65-b603-e35499fe4263

## Features

### Minimal Setup

Just include the Errsole package in your code—no need for dedicated servers, software installations, or complicated configurations.

### Logger++

Errsole automatically collects all logs from the Node.js console. Additionally, it provides a custom logger with multiple log levels and allows you to include metadata with your logs for better context. [Read More](https://github.com/errsole/errsole.js/blob/master/docs/custom-logging-functions.md)

### Store Anywhere

Store your logs wherever you want—whether in a file or any database of your choice. You can also configure log rotation to specify how long logs should be retained.

### Web Dashboard

View, filter, and search through your logs using the built-in Web Dashboard. Secure authentication and team management features ensure that only you and your team can access the logs.

### Critical Error Notifications

Get immediate notifications when your app crashes or encounters critical errors. The notification includes the error message, the app name, the environment, the server name, and a direct link to view the error in your logs.

## Benchmarks

A Node.js app using Errsole Logger can handle 90,000 more requests per minute than when using Elasticsearch and 70,000 more requests per minute than when using Amazon CloudWatch. [Read More](https://github.com/errsole/errsole.js/blob/master/docs/benchmarks.md)



## Setup

#### File-based Logging

* [Errsole with SQLite](https://github.com/errsole/errsole.js/blob/master/docs/sqlite-storage.md)

#### Centralized Logging

* [Errsole with MongoDB](https://github.com/errsole/errsole.js/blob/master/docs/mongodb-storage.md)

* [Errsole with MySQL](https://github.com/errsole/errsole.js/blob/master/docs/mysql-storage.md)

* [Errsole with PostgreSQL](https://github.com/errsole/errsole.js/blob/master/docs/postgresql-storage.md)

#### Advanced Configuration

* [Advanced Configuration](https://github.com/errsole/errsole.js/blob/master/docs/advanced-configuration.md)

#### Custom Logging Functions

* [Custom Logging Functions](https://github.com/errsole/errsole.js/blob/master/docs/custom-logging-functions.md)

#### Web Dashboard Access

* [Web Dashboard Access](https://github.com/errsole/errsole.js/blob/master/docs/web-dashboard-access.md)

#### Winston with Errsole

* [Winston with Errsole](https://github.com/errsole/errsole.js/blob/master/docs/winston-errsole.md)

## Useful Links

* [FAQs](https://github.com/errsole/errsole.js/discussions/categories/faqs)

* **Encountering issues?** [Open an issue](https://github.com/errsole/errsole.js/issues/new) on our GitHub repository.

* **Have questions?** Use our [Q&A forum](https://github.com/errsole/errsole.js/discussions/categories/q-a).

* **Want to request a feature or share your ideas?** Use our [discussion forum](https://github.com/errsole/errsole.js/discussions/categories/general).

* **Want to contribute?** First, share your idea with the community in our [discussion forum](https://github.com/errsole/errsole.js/discussions/categories/general) to see what others are saying. Then, fork the repository, make your changes, and submit a pull request.

## License

[MIT](https://github.com/errsole/errsole.js/blob/master/LICENSE)