Google Git
Sign in
chromium / external / github.com / op / go-logging / 9042ff58edabe68f405f35d384e809c3619d82e8
commit9042ff58edabe68f405f35d384e809c3619d82e8[log] [tgz]
authorÖrjan Persson <o@42mm.org>Thu Sep 18 20:40:52 2014
committerÖrjan Persson <o@42mm.org>Thu Sep 18 20:40:52 2014
tree034fe4df98afe24b216a6330d1b3cb913a08c8fd
parent04abd48333f4f62818329e7f33026b7200a838c9 [diff]
Brain fart
1 file changed
tree: 034fe4df98afe24b216a6330d1b3cb913a08c8fd
  1. examples/
  2. .travis.yml
  3. backend.go
  4. CONTRIBUTORS
  5. format.go
  6. format_test.go
  7. level.go
  8. level_test.go
  9. LICENSE
  10. log.go
  11. log_test.go
  12. logger.go
  13. logger_test.go
  14. memory.go
  15. memory_test.go
  16. multi.go
  17. multi_test.go
  18. README.md
  19. syslog.go
README.md

Golang logging library

Build Status

Package logging implements a logging infrastructure for Go. Its output format is customizable and supports different logging backends like syslog, file and memory. Multiple backends can be utilized with different log levels per backend and logger.

Example

Let's have a look at an example which demonstrates most of the features found in this library.

Example Output

package main

import (
	"os"

	"github.com/op/go-logging"
)

var log = logging.MustGetLogger("example")

// Example format string. Everything except the message has a custom color
// which is dependent on the log level. Many fields have a custom output
// formatting too, eg. the time returns the hour down to the milli second.
var format = "%{color}%{time:15:04:05.000000} ▶ %{level:.4s} %{id:03x}%{color:reset} %{message}"

// Password is just an example type implementing the Redactor interface. Any
// time this is logged, the Redacted() function will be called.
type Password string

func (p Password) Redacted() interface{} {
	return logging.Redact(string(p))
}

func main() {
	// Setup one stderr and one syslog backend and combine them both into one
	// logging backend. By default stderr is used with the standard log flag.
	logBackend := logging.NewLogBackend(os.Stderr, "", 0)
	syslogBackend, err := logging.NewSyslogBackend("")
	if err != nil {
		log.Fatal(err)
	}
	logging.SetBackend(logBackend, syslogBackend)
	logging.SetFormatter(logging.MustStringFormatter(format))

	// For "example", set the log level to DEBUG and ERROR.
	for _, level := range []logging.Level{logging.DEBUG, logging.ERROR} {
		logging.SetLevel(level, "example")

		log.Debug("debug %s", Password("secret"))
		log.Info("info")
		log.Notice("notice")
		log.Warning("warning")
		log.Error("err")
		log.Critical("crit")
	}
}

Installing

Using go get

$ go get github.com/op/go-logging

After this command go-logging is ready to use. Its source will be in:

$GOROOT/src/pkg/github.com/op/go-logging

You can use go get -u -a to update all installed packages.

Documentation

For docs, see http://godoc.org/github.com/op/go-logging or run:

$ go doc github.com/op/go-logging