48 lines
2.4 KiB
Markdown
48 lines
2.4 KiB
Markdown
# Navy's logger
|
|
|
|
Simple logger I wrote to have a unified system for logging throughout my projects.
|
|
|
|
## Features
|
|
Split into Master and Client for logging between processes, where master resides on the master process and the clients on the spawned processes.
|
|
Should be fairly trivial to modify it to work across nodes with websockets or some other IPC protocol.
|
|
|
|
**Note**
|
|
When logging from a child process, the master logger expects the child process to be be in a wrapper containing at the very least an ID property to work properly (used for identifying which child the message came from).
|
|
Notably the logger will work with just a raw child process object though, it will lack the identifier.
|
|
|
|
The child processes are expected to be attached with the attach() method found in the master logger. This will attatch a listener for the 'message' event.
|
|
|
|
## Logger Options
|
|
```
|
|
{
|
|
//////// SHARED BETWEEN CLIENT & MASTER
|
|
guard: '_logger', // Message guard, e.g this property has to be true in the IPC message for the logger to read it
|
|
loglevel: false, // On the master logger this determines whether the output is written to console (i.e. will always be written to file), on the client this determines whether it is sent to the master at all
|
|
customTypes: [], // Log types, defaults are 'error', 'warn', 'info', 'debug', 'status'. Each one of these has an associated shorthand function, the custom ones will receive one too, e.g. adding 'access' to the custom types will add a logger.access() function
|
|
logLevelMapping: {
|
|
debug: 0,
|
|
info: 1,
|
|
status: 2,
|
|
warn: 3,
|
|
error: 4
|
|
}
|
|
|
|
/////// MASTER EXCLUSIVE
|
|
customStreams: [], // File streams, by default there are streams for error and default
|
|
customTypeMapping: {}, // This maps a type to a stream, e.g. adding "warn": "error" will pipe any warnings to the error log file
|
|
customColours: {}, // Supports any colours chalk.js supports, e.g. "warn": "green" will turn warning outputs green
|
|
fileRotationFreq: 1, // How frequently to roate files in days - will not work with anything less than 1 day currently
|
|
directory: './logs', // Directory in which to write log files
|
|
broadcastLevel: 4, // Level at which to broadcast to webhook if supplied
|
|
webhook: {
|
|
url: string
|
|
}
|
|
}
|
|
```
|
|
|
|
**Built-in log levels**
|
|
0 - Debug
|
|
1 - Info
|
|
2 - Status
|
|
3 - Warning
|
|
4 - Error |
