doc.go 998 B

12345678910111213141516171819202122232425
  1. // Package level implements leveled logging on top of Go kit's log package.
  2. //
  3. // Deprecated: Use github.com/go-kit/log/level instead.
  4. //
  5. // To use the level package, create a logger as per normal in your func main,
  6. // and wrap it with level.NewFilter.
  7. //
  8. // var logger log.Logger
  9. // logger = log.NewLogfmtLogger(os.Stderr)
  10. // logger = level.NewFilter(logger, level.AllowInfo()) // <--
  11. // logger = log.With(logger, "ts", log.DefaultTimestampUTC)
  12. //
  13. // Then, at the callsites, use one of the level.Debug, Info, Warn, or Error
  14. // helper methods to emit leveled log events.
  15. //
  16. // logger.Log("foo", "bar") // as normal, no level
  17. // level.Debug(logger).Log("request_id", reqID, "trace_data", trace.Get())
  18. // if value > 100 {
  19. // level.Error(logger).Log("value", value)
  20. // }
  21. //
  22. // NewFilter allows precise control over what happens when a log event is
  23. // emitted without a level key, or if a squelched level is used. Check the
  24. // Option functions for details.
  25. package level