Noodlog is a Golang JSON parametrized and highly configurable logging library.
It allows you to:
- print go structs as JSON messages;
- print JSON strings and raw strings messages as pure JSONs;
- obscure some sensitive params from your logging;
- chain objects or strings in your logs;
- apply string templates to your logs;
- choose to trace the caller file and function and fine tune the settings;
- apply pretty printing or not;
- apply colors to your logging;
- customize colors per log level.
go get github.com/gyozatech/noodlog
Let's assume you have Go 1.16+ istalled on your computer. Execute the following:
$ mkdir example && cd example
$ go mod init example
$ go get github.com/gyozatech/noodlog
$ touch main.go
Open main.go
and paste the following code:
package main
import (
log "github.com/gyozatech/noodlog"
)
func init() {
log.SetConfigs(
log.Configs{
LogLevel: log.LevelTrace,
JSONPrettyPrint: log.Enable,
TraceCaller: log.Enable,
Colors: log.Enable,
CustomColors: &log.CustomColors{ Trace: log.Cyan },
ObscureSensitiveData: log.Enable,
SensitiveParams: []string{"password"},
},
)
}
func main() {
// simple string message (with custom color)
log.Trace("Hello world!")
// chaining elements
log.Info("You've reached", 3, "login attemps")
// using string formatting
log.Warn("You have %d attempts left", 2)
// logging a struct with a JSON
log.Error(struct{Code int; Error string}{500, "Generic Error"})
// logging a raw JSON string with a JSON (with obscuring "password")
log.Info(`{"username": "gyozatech", "password": "Gy0zApAssw0rd"}`)
// logging a JSON string with a JSON (with obscuring "password")
log.Info("{\"username\": \"nooduser\", \"password\": \"N0oDPasSw0rD\"}")
}
Running this example with:
$ go run main.go
You'll get the following output:
Noodlog allows you to customize the logs through various settings.
You can use various facility functions or the SetConfigs
function which wraps all the configs together.
To set the logging level, after importing the library with:
import (
log "github.com/gyozatech/noodlog"
)
you can use the facility method:
log.LogLevel("warn")
or the SetConfigs
function:
log.SetConfigs(
log.Configs{
LogLevel: log.LevelWarn,
},
)
log.LevelWarn
is a pre-built pointer to the string "warn".
The default log level is info.
After importing the library with:
import (
log "github.com/gyozatech/noodlog"
)
To enable pretty printing of the JSON logs you can use:
log.EnableJSONPrettyPrint()
or
log.SetConfigs(
log.Configs{
JSONPrettyPrint: log.Enable,
},
)
log.Enable
is a pre-built pointer to the bool true.
to disable pretty printing you can use:
log.DisableJSONPrettyPrint()
or
log.SetConfigs(
log.Configs{
JSONPrettyPrint: log.Disable,
},
)
log.Disable
is a pre-built pointer to the bool false.
The default value is false.
After importing the library with:
import (
log "github.com/gyozatech/noodlog"
)
to enable colors in JSON logs you can use:
log.EnableColors()
or
log.SetConfigs(
log.Configs{
Colors: log.Enable,
},
)
log.Enable
is a pre-built pointer to the bool true.
To disable colors you can use:
log.DisableColors()
or
log.SetConfigs(
log.Configs{
Colors: log.Disable,
},
)
log.Disable
is a pre-built pointer to the bool false.
The default value is false.
You can customize the single colors (for log level) by using:
log.SetTraceColor("cyan")
log.SetDebugColor("green")
log.SetInfoColor("default")
log.SetWarnColor("yellow")
log.SetErrorColor("purple")
or
log.SetConfigs(
log.Configs{
Colors: log.Enable,
CustomColors: &log.CustomColors{
Trace: log.Cyan,
Debug: log.Green,
Info: log.Default,
Warn: log.Yellow,
Error: log.Purple,
},
},
)
log.Cyan
, log.Green
, log.Default
, log.Yellow
, log.Purple
, log.Red
, log.Blue
are pre-build pointers to the strings "cyan", "green", "default", "yellow", "purple", "red", "blue".
When enabled, the default colors are:
- trace: "default"
- info: "default"
- debug: "green"
- warn: "yellow"
- error: "red"
Noodles allows you to print the file and the function which are calling the log functions.
After importing the library with:
import (
log "github.com/gyozatech/noodlog"
)
to enable the trace caller you can use:
log.EnableTraceCaller()
or
log.SetConfigs(
log.Configs{
TraceCaller: log.Enable,
},
)
log.Enable
is a pre-built pointer to the bool true.
To disable it:
log.DisableTraceCaller()
or
log.SetConfigs(
log.Configs{
TraceCaller: log.Disable,
},
)
log.Disable
is a pre-built pointer to the bool false.
The default value is false.
Important: if you want to import noodlog only in one package of your project (in order to configure it once) and wraps the logging functions you can use the EnableSinglePointTracing
to trace file and function the real caller and not of your logging package.
For example:
main.go
package main
import (
log "example/logging"
)
func main() {
// main.main real caller we want to track
log.Info("Hello folks!")
}
logging/logger.go
package logging
import (
"github.com/gyozatech/noodlog"
)
func init() {
// configure logger once
noodlog.SetConfig(
noodlog.Configs{
TraceCaller: noodlog.Enable,
SinglePointTracing: noodlog.Enable,
},
)
}
// wrapper function
func Info(message ...interface{}) {
// if we wouldn't enable SinglePointTracing
// logger.Info would have been considered the caller to be tracked
noodlog.Info(message...)
}
Noodlog gives you the possibility to enable the obscuration of sensitive params when recognized in the JSON structures (not in the simple strings that you compose).
After importing the library with:
import (
log "github.com/gyozatech/noodlog"
)
You can enable the sensitive params obscuration with the facility methods:
log.EnableObscureSensitiveData([]string{"param1", "param2", "param3"})
or with the SetConfig
function:
log.SetConfigs(
log.Configs{
ObscureSensitiveData: log.Enable,
SensitiveParams: []string{"param1", "param2", "param3"},
},
)
Where log.Enable
is a pre-built pointer to the bool true.
To disable the sensitive params obscuration you can set:
log.DisableObscureSensitiveData()
or
log.SetConfigs(
log.Configs{
ObscureSensitiveData: log.Disable,
},
)
Where log.Disable
is a pre-built pointer to the bool false.
The default value for the obscuration is false.