README.md

go-logrotate

go-logrotate is a Go package for writing logs to rolling files.

go-logrotate is based on lumberjack.

to import go-logrotate :

import "github.com/fahedouch/go-logrotate"

go-logrotate add new features to Lumberjack:

• Supporting MaxBytes to specify the log size in bytes.
• Supporting unlimited MaxBytes with -1.
• Supporting multiple backups file names :
  • standard file name : foo.log.1
  • time file name: foo-2014-05-04T14-44-33.555.log

Example

To use go-logrotate with the standard library's log package and with file name standard format, just pass it into the SetOutput function when your application starts.

Code:

log.SetOutput(&logrotate.Logger{
    Filename:   "/var/log/myapp/foo.log",
    MaxBytes:    500, // bytes
    MaxBackups: 3,
    MaxAge:     28, //days
    Compress:   true, // disabled by default
})

To use go-logrotate with file name time format. File name time format takes precedence over the standard format.

log.SetOutput(&logrotate.Logger{
    Filename:   "/var/log/myapp/foo.log",
    FilenameTimeFormat: "2006-01-02T15-04-05.000",
    MaxBytes:    500, // bytes
    MaxBackups: 3,
    MaxAge:     28, //days
    Compress:   true, // disabled by default
})