Documentation ¶
Index ¶
- Variables
- func Ctx(ctx context.Context) *zerolog.Logger
- func Debug() *zerolog.Event
- func Err(err error) *zerolog.Event
- func Error() *zerolog.Event
- func Fatal() *zerolog.Event
- func FromRequest(r *http.Request) *zerolog.Logger
- func Hook(h zerolog.Hook) zerolog.Logger
- func IDFromCtx(ctx context.Context) (id xid.ID, ok bool)
- func Info() *zerolog.Event
- func InstanceFromCtx(ctx context.Context) (id xid.ID, ok bool)
- func Level(level zerolog.Level) zerolog.Logger
- func Log() *zerolog.Event
- func Output(w io.Writer) zerolog.Logger
- func Panic() *zerolog.Event
- func Print(v ...interface{})
- func Printf(format string, v ...interface{})
- func Sample(s zerolog.Sampler) zerolog.Logger
- func SetBlockingLogger(w io.Writer)
- func SetConsoleLogger()
- func SetDiscardLogger()
- func SetSimpleConsoleLogger()
- func SetVerboseTestingConsoleLogger(level zerolog.Level)
- func Trace() *zerolog.Event
- func Warn() *zerolog.Event
- func With() zerolog.Context
- func WithID(ctx context.Context) zerolog.Context
- func WithIDContext(ctx context.Context) context.Context
- func WithIDWithoutCaller(ctx context.Context) zerolog.Context
- func WithInstanceContext(ctx context.Context) context.Context
- func WithLevel(level zerolog.Level) *zerolog.Event
- type Config
Constants ¶
This section is empty.
Variables ¶
var ( LoggerWithoutCaller = zerolog.New(os.Stderr).With().Timestamp().Logger() Logger = LoggerWithoutCaller.With().Caller().Logger() )
Logger is the global logger.
Functions ¶
func Ctx ¶
Ctx returns the Logger associated with the ctx. If no logger is associated, a disabled logger is returned.
func Debug ¶
Debug starts a new message with debug level.
You must call Msg on the returned event in order to send the event.
func Err ¶
Err starts a new message with error level with err as a field if not nil or with info level if err is nil.
You must call Msg on the returned event in order to send the event.
func Error ¶
Error starts a new message with error level.
You must call Msg on the returned event in order to send the event.
func Fatal ¶
Fatal starts a new message with fatal level. The os.Exit(1) function is called by the Msg method.
You must call Msg on the returned event in order to send the event.
func Info ¶
Info starts a new message with info level.
You must call Msg on the returned event in order to send the event.
func InstanceFromCtx ¶
InstanceFromCtx returns the unique id associated to the context if any.
func Log ¶
Log starts a new message with no level. Setting zerolog.GlobalLevel to zerolog.Disabled will still disable events produced by this method.
You must call Msg on the returned event in order to send the event.
func Panic ¶
Panic starts a new message with panic level. The message is also sent to the panic function.
You must call Msg on the returned event in order to send the event.
func Print ¶
func Print(v ...interface{})
Print sends a log event using debug level and no extra field. Arguments are handled in the manner of fmt.Print.
func Printf ¶
func Printf(format string, v ...interface{})
Printf sends a log event using debug level and no extra field. Arguments are handled in the manner of fmt.Printf.
func SetBlockingLogger ¶
SetBlockingLogger sets up a logger with a non blocking writer
func SetConsoleLogger ¶
func SetConsoleLogger()
SetConsoleLogger sets up logging for console logging (developmnet)
func SetDiscardLogger ¶
func SetDiscardLogger()
SetDiscardLogger sets global log level to trace and log to a ioutil.Discard writer. Use in tests to ensure that writing logs don't panic and are sileced.
func SetSimpleConsoleLogger ¶
func SetSimpleConsoleLogger()
SetSimpleConsoleLogger sets up logging for console logging to cli tool end users
func SetVerboseTestingConsoleLogger ¶
SetVerboseTestingConsoleLogger
func Trace ¶
Trace starts a new message with trace level.
You must call Msg on the returned event in order to send the event.
func Warn ¶
Warn starts a new message with warn level.
You must call Msg on the returned event in order to send the event.
func WithIDContext ¶
Adds a logger and an request id to the context.Context. To create and use a new context/logger: ctx = log.WithIDContext(ctx) logger := log.WithID(ctx).Logger()
Types ¶
type Config ¶
type Config struct { Debug bool Trace bool Console bool FileName string FileMaxBackups int FileMaxSize int FileMaxAge int }
Config is a collection of stdlib flags configuring logging
func (*Config) RegisterFlags ¶
RegisterFlags registers the flags in a flag.FlagSet with default for json logging
func (*Config) RegisterFlagsConsole ¶
Register registers the flags in a flag.FlagSet with defaults for console logging