log

Documentation

Overview

Package log implements basic but useful request (access) logging middleware.

Index

• Constants
• type Logger
  • func (l Logger) ServeHTTP(w http.ResponseWriter, r *http.Request) (int, error)
• type Rule

Constants

const (
	DefaultLogFilename  = "access.log"
	CommonLogFormat     = `{remote} ` + CommonLogEmptyValue + ` [{when}] "{method} {uri} {proto}" {status} {size}`
	CommonLogEmptyValue = "-"
	CombinedLogFormat   = CommonLogFormat + ` "{>Referer}" "{>User-Agent}"`
	DefaultLogFormat    = CommonLogFormat
)

Types

type Logger

type Logger struct {
	Next      middleware.Handler
	Rules     []Rule
	ErrorFunc func(http.ResponseWriter, *http.Request, int) // failover error handler
}

Logger is a basic request logging middleware.

func (Logger) ServeHTTP

func (l Logger) ServeHTTP(w http.ResponseWriter, r *http.Request) (int, error)

type Rule

type Rule struct {
	PathScope  string
	OutputFile string
	Format     string
	Log        *log.Logger
	Roller     *middleware.LogRoller
}

Rule configures the logging middleware.