klauscfhq/signale
Signale
Signale is a formatted console logging library for Node.js applications. It serves as a pluggable logging framework and stream-based log router that allows users to record system events using customizable levels, colors, and output styles.
The project distinguishes itself as an interactive console logger capable of overwriting previous messages to reduce terminal clutter during long-running tasks. It also functions as an application performance monitor, providing tools to measure and track execution time between specific code points to identify performance bottlenecks.
The library covers a broad range of capabilities including console output customization through custom loggers and scoped logging, as well as security features for redacting sensitive information from log streams. Users can extend the logging logic via plugins and route log data to multiple writable destinations simultaneously.
Features
- Node.js Logging Libraries - Acts as a comprehensive logging framework specifically designed for the Node.js runtime environment.
- Log Message Styling - Provides a formatted console logging system with customizable styles, colors, and output streams for Node.js.
- Interactive CLI Tooling - Implements dynamic, real-time updates to the terminal interface to prevent console clutter during long-running tasks.
- Log Stream Routers - Enables decoupling logs from the console by routing data to one or multiple writable streams.
- Custom Log Formatting - Provides customizable log layouts, including options to toggle timestamps, filenames, and labels.
- Application Event Recording - Provides capabilities to record system events and status reports with configurable visual styles.
- Severity Level Filtering - Includes a severity-level filtering mechanism to control log visibility based on configured thresholds.
- Interactive Console Loggers - Provides an interactive logger capable of overwriting previous console lines to create live progress indicators.
- Custom Visual Loggers - Allows the definition of new logger types with specific colors and icons to categorize events.
- Logging Verbosity Controls - Allows adjusting log verbosity through global and per-logger severity thresholds.
- Logging Frameworks - Offers a pluggable framework for creating custom loggers and extending rendering logic.
- Multi-Destination Log Routers - Enables routing log events to multiple writable destinations and streams simultaneously.
- Log Rendering Plug-ins - Allows users to define custom rendering functions via a plug-in architecture to modify log output formats.
- Sensitive Variable Redaction - Implements interceptors to mask or redact sensitive data and credentials from log outputs.
- Execution Time Measurements - Enables calculating the elapsed time between two points in the code using unique labels.
- Application Performance Monitoring - Acts as a performance monitor by measuring execution time of specific operations to find bottlenecks.
- Multi-Destination Log Routings - Supports simultaneous log routing to multiple writable destinations for distributed monitoring.
- Logging Extenders - Supports extending the base logging logic to create pluggable loggers with custom behaviors.
- Execution Duration Tracking - Provides an API for measuring the elapsed time of specific named code blocks and operations.
- Console Output Formatting - Provides capabilities to write colored text and styled logs to the console for improved readability.
- Log Streaming - Allows directing log output to custom writable streams instead of the default stdout.
- Named Scope Loggers - Implements scoped logging to group messages by module or component names.
- Logging - Configurable logging tool.
