mirror of
https://github.com/log4js-node/log4js-node.git
synced 2025-12-08 19:26:01 +00:00
50 lines
2.5 KiB
Markdown
50 lines
2.5 KiB
Markdown
# File Appender
|
|
|
|
The file appender writes log events to a file. It supports an optional maximum file size, and will keep a configurable number of backups. When using the file appender, you should also call `log4js.shutdown` when your application terminates, to ensure that any remaining asynchronous writes have finished. Although the file appender uses the [streamroller](https://github.com/nomiddlename/streamroller) library, this is included as a dependency of log4js so you do not need to include it yourself.
|
|
|
|
## Configuration
|
|
|
|
* `type` - `"file"`
|
|
* `filename` - `string` - the path of the file where you want your logs written.
|
|
* `maxLogSize` - `integer` (optional) - the maximum size (in bytes) for the log file. If not specified, then no log rolling will happen.
|
|
* `backups` - `integer` (optional, default value = 5) - the number of old log files to keep during log rolling.
|
|
* `layout` - (optional, defaults to basic layout) - see [layouts](layouts.md)
|
|
|
|
Any other configuration parameters will be passed to the underlying [streamroller](https://github.com/nomiddlename/streamroller) implementation (see also node.js core file streams):
|
|
* `encoding` - `string` (default "utf-8")
|
|
* `mode`- `integer` (default 0644)
|
|
* `flags` - `string` (default 'a')
|
|
* `compress` - `boolean` (default false) - compress the backup files during rolling (backup files will have `.gz` extension)
|
|
* `keepFileExt` - `boolean` (default false) - preserve the file extension when rotating log files (`file.log` becomes `file.1.log` instead of `file.log.1`)
|
|
|
|
## Example
|
|
|
|
```javascript
|
|
log4js.configure({
|
|
appenders: {
|
|
everything: { type: 'file', filename: 'all-the-logs.log' }
|
|
},
|
|
categories: {
|
|
default: { appenders: [ 'everything' ], level: 'debug' }
|
|
}
|
|
});
|
|
|
|
const logger = log4js.getLogger();
|
|
logger.debug('I will be logged in all-the-logs.log');
|
|
```
|
|
|
|
This example will result in a single log file (`all-the-logs.log`) containing the log messages.
|
|
|
|
## Example with log rolling (and compressed backups)
|
|
```javascript
|
|
log4js.configure({
|
|
appenders: {
|
|
everything: { type: 'file', filename: 'all-the-logs.log', maxLogSize: 10485760, backups: 3, compress: true }
|
|
},
|
|
categories: {
|
|
default: { appenders: [ 'everything' ], level: 'debug'}
|
|
}
|
|
});
|
|
```
|
|
This will result in one current log file (`all-the-logs.log`). When that reaches 10Mb in size, it will be renamed and compressed to `all-the-logs.log.1.gz` and a new file opened called `all-the-logs.log`. When `all-the-logs.log` reaches 10Mb again, then `all-the-logs.log.1.gz` will be renamed to `all-the-logs.log.2.gz`, and so on.
|