Logger (日志) 中间件

Logger 中间件记录有关每个 HTTP 请求的信息。

用法

  1. e.Use(middleware.Logger())

输出样例

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

自定义配置

用法

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

上面的示例使用 Format 来记录请求方法和请求 URI 。

输出样例

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

配置

  1. LoggerConfig struct {
  2. // Skipper 定义了一个跳过中间件的函数.
  3. Skipper Skipper
  4. // 日志的格式可以使用下面的标签定义。:
  5. //
  6. // - time_unix
  7. // - time_unix_nano
  8. // - time_rfc3339
  9. // - time_rfc3339_nano
  10. // - id (Request ID - Not implemented)
  11. // - remote_ip
  12. // - uri
  13. // - host
  14. // - method
  15. // - path
  16. // - referer
  17. // - user_agent
  18. // - status
  19. // - latency (In microseconds)
  20. // - latency_human (Human readable)
  21. // - bytes_in (Bytes received)
  22. // - bytes_out (Bytes sent)
  23. // - header:<name>
  24. // - query:<name>
  25. // - form:<name>
  26. //
  27. // 例如 "${remote_ip} ${status}"
  28. //
  29. // 可选。默认值是 DefaultLoggerConfig.Format.
  30. Format string `json:"format"`
  31. // Output 是记录日志的位置。
  32. // 可选。默认值是 os.Stdout.
  33. Output io.Writer
  34. }

默认配置

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

更多细节见:golang echo 代码详解之 log 篇