func ExampleSetLogger() {
xlog.SetLogger(xlog.New(xlog.Config{
Level: xlog.LevelInfo,
Output: xlog.NewConsoleOutput(),
Fields: xlog.F{
"role": "my-service",
},
}))
}
func Example_stdlog() {
// Define logger conf
conf := xlog.Config{
Output: xlog.NewConsoleOutput(),
}
// Remove timestamp and other decorations of the std logger
log.SetFlags(0)
// Plug a xlog instance to Go's std logger
log.SetOutput(xlog.New(conf))
}
func Example_handler() {
c := alice.New()
host, _ := os.Hostname()
conf := xlog.Config{
// Set some global env fields
Fields: xlog.F{
"role": "my-service",
"host": host,
},
}
// Install the logger handler with default output on the console
c.Append(xlog.NewHandler(conf))
// Plug the xlog handler's input to Go's default logger
log.SetFlags(0)
log.SetOutput(xlog.New(conf))
// Install some provided extra handler to set some request's context fields.
// Thanks to those handler, all our logs will come with some pre-populated fields.
c.Append(xlog.RemoteAddrHandler("ip"))
c.Append(xlog.UserAgentHandler("user_agent"))
c.Append(xlog.RefererHandler("referer"))
c.Append(xlog.RequestIDHandler("req_id", "Request-Id"))
// Here is your final handler
h := c.Then(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
// Get the logger from the request's context. You can safely assume it
// will be always there: if the handler is removed, xlog.FromContext
// will return a NopLogger
l := xlog.FromRequest(r)
// Then log some errors
if err := errors.New("some error from elsewhere"); err != nil {
l.Errorf("Here is an error: %v", err)
}
// Or some info with fields
l.Info("Something happend", xlog.F{
"user": "******",
"status": "ok",
})
}))
http.Handle("/", h)
if err := http.ListenAndServe(":8080", nil); err != nil {
log.SetOutput(os.Stderr) // make sure we print to console
log.Fatal(err)
}
}
func init() {
// read config data
cfg.initDefaultConfig()
uno = initUnoconv()
//plug the xlog handler's input to Go's default logger
log.SetFlags(0)
xlogger := xlog.New(cfg.loggerConfig)
log.SetOutput(xlogger)
//register some middleware handlers
mw.initCommonHandlers(
xlog.NewHandler(cfg.loggerConfig),
xaccess.NewHandler(),
)
}