log

Overview ¶

Package log provides a wrapper to the underlying logging library.

Logging should be done by accessing the log.Logger object to issue log statements.

Using any of the base loggers (Debug, Info, Warn, Error) any additional fields will be concatenated onto the "msg" field. This may cause serialization issues.

It's suggested to use the "with" log methods (Debugw, Infow, Warnw, Errorw) to include additional fields in the log line.

Examples:

  Log with additional fields in JSON:
	  log.Logger.Infow("My message to log", "key1", "value1", "key2", 9999, "key3", errors.New("an error"))
		or
		log.Logger.Infow("My message to log", log.String("key1", "value1"))

	Log data directly into the message:
	  log.Logger.Info("My message to log with data", " key1: ", SOMEVAR, " key2: ", 9999)

NOT RECOMMENDED

Log data in the message and additional fields:
	log.Logger.Infow(fmt.Sprintf("My message to log with data 5v"), "error", error)

Log data directly into the message without serialization:
	log.Logger.Infof("My message to log with data %v", 77.33232)
	log.Logger.Infof("My message to log with data %d", 77.33232)

Note:

    When using the logger if you use the "f" methods such as Infof the data in the message will
		be serialized unless you use Sprintf style in the message and the correct type on the data
		such as %v, %s, %d.  The suggested approach is to separate any data into separate fields for
		logging.