Logger Middleware

Logger middleware logs the information about each HTTP request.

Usage

e.Use(middleware.Logger())

Sample Output

  1. {"time":"2017-01-12T08:58:07.372015644-08:00","remote_ip":"::1","host":"localhost:1323","method":"GET","uri":"/","status":200,"error":"","latency":14743,"latency_human":"14.743µs","bytes_in":0,"bytes_out":2}

Custom Configuration

Usage

  1. e.Use(middleware.LoggerWithConfig(middleware.LoggerConfig{
  2.   Format: "method=${method}, uri=${uri}, status=${status}\n",
  3. }))

Example above uses a Format which logs request method and request URI.

Sample Output

  1. method=GET, uri=/, status=200

Configuration

  1. LoggerConfig struct {
  2.   // Skipper defines a function to skip middleware.
  3.   Skipper Skipper
  5.   // Tags to constructed the logger format.
  6.   //
  7.   // - time_unix
  8.   // - time_unix_nano
  9.   // - time_rfc3339
  10.   // - time_rfc3339_nano
  11.   // - id (Request ID)
  12.   // - remote_ip
  13.   // - uri
  14.   // - host
  15.   // - method
  16.   // - path
  17.   // - referer
  18.   // - user_agent
  19.   // - status
  20.   // - error
  21.   // - latency (In nanoseconds)
  22.   // - latency_human (Human readable)
  23.   // - bytes_in (Bytes received)
  24.   // - bytes_out (Bytes sent)
  25.   // - header:<NAME>
  26.   // - query:<NAME>
  27.   // - form:<NAME>
  28.   // - cookie:<NAME>
  29.   //
  30.   // Example "${remote_ip} ${status}"
  31.   //
  32.   // Optional. Default value DefaultLoggerConfig.Format.
  33.   Format string `json:"format"`
  35.   // Output is a writer where logs are written.
  36.   // Optional. Default value os.Stdout.
  37.   Output io.Writer
  38. }

Default Configuration

  1. DefaultLoggerConfig = LoggerConfig{
  2.   Skipper: DefaultSkipper,
  3.   Format: `{"time":"${time_rfc3339_nano}","id":"${id}","remote_ip":"${remote_ip}","host":"${host}",` +
  4.     `"method":"${method}","uri":"${uri}","status":${status},"error":"${error}","latency":${latency},` +
  5.     `"latency_human":"${latency_human}","bytes_in":${bytes_in},` +
  6.     `"bytes_out":${bytes_out}}` + "\n",
  7.   Output: os.Stdout
  8. }