Documentation
¶
Overview ¶
package rotatelogs is a port of File-RotateLogs from Perl (https://metacpan.org/release/File-RotateLogs), and it allows you to automatically rotate output files when you write to them according to the filename pattern that you can specify.
Index ¶
- Constants
- Variables
- func Error(template ...interface{})
- func GetWriter(filename string, options ...Option) io.Writer
- func Info(template ...interface{})
- func InitLog(options ...LogOptionsFunc)
- func Warn(template ...interface{})
- type Clock
- type Event
- type EventType
- type FileRotatedEvent
- type Handler
- type HandlerFunc
- type LogOptionsFunc
- func SetEnvType(envType string) LogOptionsFunc
- func SetFileCount(fileCount uint) LogOptionsFunc
- func SetFilePath(logPath string) LogOptionsFunc
- func SetLogField(key string, value interface{}) LogOptionsFunc
- func SetLogFields(field map[string]interface{}) LogOptionsFunc
- func SetMaxAge(maxAge time.Duration) LogOptionsFunc
- func SetOnlyFileSize(onlyFileSize int64) LogOptionsFunc
- func SetRotationCount(n time.Duration) LogOptionsFunc
- type Option
- func ForceNewFile() Option
- func WithClock(c Clock) Option
- func WithHandler(h Handler) Option
- func WithLinkName(s string) Option
- func WithLocation(loc *time.Location) Option
- func WithMaxAge(d time.Duration) Option
- func WithRotationCount(n uint) Option
- func WithRotationSize(s int64) Option
- func WithRotationTime(d time.Duration) Option
- type RotateLogs
Constants ¶
const ( DefaultEnvType = "dev" //默认的开发环境 DefaultFileCount uint = 0 //0:为不限制 DefaultFileSize int64 = 32 * 1024 * 1024 //32兆 DefaultFilePath = "./glogs/%Y-%m-%d.log" //日志路径 DefaultTemplateJoin = " " //日志分割符 msg:"信息1 信息2" //错误级别 LevelInfo = "info" LevelWarn = "warn" LevelError = "error" )
Variables ¶
var Local = clockFn(time.Now)
Local is an object satisfying the Clock interface, which returns the current time in the local timezone
var UTC = clockFn(func() time.Time { return time.Now().UTC() })
UTC is an object satisfying the Clock interface, which returns the current time in UTC
Functions ¶
func GetWriter ¶
按天切割按大小切割 filename 文件名 rotationSize 每个文件的大小 maxAge 文件最大保留天数 rotationCount 最大保留文件个数 rotationTime 设置文件分割时间 rotationCount 设置保留的最大文件数量
func InitLog ¶
func InitLog(options ...LogOptionsFunc)
Types ¶
type FileRotatedEvent ¶
type FileRotatedEvent struct {
// contains filtered or unexported fields
}
func (*FileRotatedEvent) CurrentFile ¶
func (e *FileRotatedEvent) CurrentFile() string
func (*FileRotatedEvent) PreviousFile ¶
func (e *FileRotatedEvent) PreviousFile() string
func (*FileRotatedEvent) Type ¶
func (e *FileRotatedEvent) Type() EventType
type HandlerFunc ¶
type HandlerFunc func(Event)
func (HandlerFunc) Handle ¶
func (h HandlerFunc) Handle(e Event)
type LogOptionsFunc ¶
type LogOptionsFunc func(*logConfig)
配置回调
func SetRotationCount ¶
func SetRotationCount(n time.Duration) LogOptionsFunc
设置保留的最大文件数量、没有默认值(表示不限制)
type Option ¶
type Option interface {
Name() string
Value() interface{}
}
Option is used to pass optional arguments to the RotateLogs constructor
func ForceNewFile ¶
func ForceNewFile() Option
ForceNewFile ensures a new file is created every time New() is called. If the base file name already exists, an implicit rotation is performed
func WithClock ¶
WithClock creates a new Option that sets a clock that the RotateLogs object will use to determine the current time.
By default rotatelogs.Local, which returns the current time in the local time zone, is used. If you would rather use UTC, use rotatelogs.UTC as the argument to this option, and pass it to the constructor.
func WithHandler ¶
WithHandler creates a new Option that specifies the Handler object that gets invoked when an event occurs. Currently `FileRotated` event is supported
func WithLinkName ¶
WithLinkName creates a new Option that sets the symbolic link name that gets linked to the current file name being used.
func WithLocation ¶
WithLocation creates a new Option that sets up a "Clock" interface that the RotateLogs object will use to determine the current time.
This optin works by always returning the in the given location.
func WithMaxAge ¶
WithMaxAge creates a new Option that sets the max age of a log file before it gets purged from the file system.
func WithRotationCount ¶
WithRotationCount creates a new Option that sets the number of files should be kept before it gets purged from the file system.
func WithRotationSize ¶
WithRotationSize creates a new Option that sets the log file size between rotation.
func WithRotationTime ¶
WithRotationTime creates a new Option that sets the time between rotation.
type RotateLogs ¶
type RotateLogs struct {
// contains filtered or unexported fields
}
RotateLogs represents a log file that gets automatically rotated as you write to it.
func New ¶
func New(p string, options ...Option) (*RotateLogs, error)
New creates a new RotateLogs object. A log filename pattern must be passed. Optional `option` parameters may be passed
func (*RotateLogs) Close ¶
func (rl *RotateLogs) Close() error
Close satisfies the io.Closer interface. You must call this method if you performed any writes to the object.
func (*RotateLogs) CurrentFileName ¶
func (rl *RotateLogs) CurrentFileName() string
CurrentFileName returns the current file name that the RotateLogs object is writing to
func (*RotateLogs) Rotate ¶
func (rl *RotateLogs) Rotate() error
Rotate forcefully rotates the log files. If the generated file name clash because file already exists, a numeric suffix of the form ".1", ".2", ".3" and so forth are appended to the end of the log file
Thie method can be used in conjunction with a signal handler so to emulate servers that generate new log files when they receive a SIGHUP
func (*RotateLogs) Write ¶
func (rl *RotateLogs) Write(p []byte) (n int, err error)
Write satisfies the io.Writer interface. It writes to the appropriate file handle that is currently being used. If we have reached rotation time, the target file gets automatically rotated, and also purged if necessary.
Source Files
Directories