changing debug to trace
This commit is contained in:
		
							parent
							
								
									b23b09dadf
								
							
						
					
					
						commit
						fa162e3005
					
				|  | @ -84,9 +84,9 @@ func GetFSFromImage(root string, img v1.Image) ([]string, error) { | ||||||
| 
 | 
 | ||||||
| 	for i, l := range layers { | 	for i, l := range layers { | ||||||
| 		if mediaType, err := l.MediaType(); err == nil { | 		if mediaType, err := l.MediaType(); err == nil { | ||||||
| 			logrus.Debugf("Extracting layer %d of media type %s", mediaType) | 			logrus.Tracef("Extracting layer %d of media type %s", mediaType) | ||||||
| 		} else { | 		} else { | ||||||
| 			logrus.Debugf("Extracting layer %d", i) | 			logrus.Tracef("Extracting layer %d", i) | ||||||
| 		} | 		} | ||||||
| 
 | 
 | ||||||
| 		r, err := l.Uncompressed() | 		r, err := l.Uncompressed() | ||||||
|  | @ -206,10 +206,10 @@ func extractFile(dest string, hdr *tar.Header, tr io.Reader) error { | ||||||
| 	} | 	} | ||||||
| 	switch hdr.Typeflag { | 	switch hdr.Typeflag { | ||||||
| 	case tar.TypeReg: | 	case tar.TypeReg: | ||||||
| 		logrus.Debugf("creating file %s", path) | 		logrus.Tracef("creating file %s", path) | ||||||
| 		// It's possible a file is in the tar before its directory.
 | 		// It's possible a file is in the tar before its directory.
 | ||||||
| 		if _, err := os.Stat(dir); os.IsNotExist(err) { | 		if _, err := os.Stat(dir); os.IsNotExist(err) { | ||||||
| 			logrus.Debugf("base %s for file %s does not exist. Creating.", base, path) | 			logrus.Tracef("base %s for file %s does not exist. Creating.", base, path) | ||||||
| 			if err := os.MkdirAll(dir, 0755); err != nil { | 			if err := os.MkdirAll(dir, 0755); err != nil { | ||||||
| 				return err | 				return err | ||||||
| 			} | 			} | ||||||
|  | @ -233,19 +233,19 @@ func extractFile(dest string, hdr *tar.Header, tr io.Reader) error { | ||||||
| 		} | 		} | ||||||
| 		currFile.Close() | 		currFile.Close() | ||||||
| 	case tar.TypeDir: | 	case tar.TypeDir: | ||||||
| 		logrus.Debugf("creating dir %s", path) | 		logrus.Tracef("creating dir %s", path) | ||||||
| 		if err := mkdirAllWithPermissions(path, mode, uid, gid); err != nil { | 		if err := mkdirAllWithPermissions(path, mode, uid, gid); err != nil { | ||||||
| 			return err | 			return err | ||||||
| 		} | 		} | ||||||
| 
 | 
 | ||||||
| 	case tar.TypeLink: | 	case tar.TypeLink: | ||||||
| 		logrus.Debugf("link from %s to %s", hdr.Linkname, path) | 		logrus.Tracef("link from %s to %s", hdr.Linkname, path) | ||||||
| 		abs, err := filepath.Abs(hdr.Linkname) | 		abs, err := filepath.Abs(hdr.Linkname) | ||||||
| 		if err != nil { | 		if err != nil { | ||||||
| 			return err | 			return err | ||||||
| 		} | 		} | ||||||
| 		if CheckWhitelist(abs) { | 		if CheckWhitelist(abs) { | ||||||
| 			logrus.Debugf("skipping symlink from %s to %s because %s is whitelisted", hdr.Linkname, path, hdr.Linkname) | 			logrus.Tracef("skipping symlink from %s to %s because %s is whitelisted", hdr.Linkname, path, hdr.Linkname) | ||||||
| 			return nil | 			return nil | ||||||
| 		} | 		} | ||||||
| 		// The base directory for a link may not exist before it is created.
 | 		// The base directory for a link may not exist before it is created.
 | ||||||
|  | @ -265,7 +265,7 @@ func extractFile(dest string, hdr *tar.Header, tr io.Reader) error { | ||||||
| 		} | 		} | ||||||
| 
 | 
 | ||||||
| 	case tar.TypeSymlink: | 	case tar.TypeSymlink: | ||||||
| 		logrus.Debugf("symlink from %s to %s", hdr.Linkname, path) | 		logrus.Tracef("symlink from %s to %s", hdr.Linkname, path) | ||||||
| 		// The base directory for a symlink may not exist before it is created.
 | 		// The base directory for a symlink may not exist before it is created.
 | ||||||
| 		if err := os.MkdirAll(dir, 0755); err != nil { | 		if err := os.MkdirAll(dir, 0755); err != nil { | ||||||
| 			return err | 			return err | ||||||
|  | @ -327,27 +327,27 @@ func DetectFilesystemWhitelist(path string) error { | ||||||
| 	reader := bufio.NewReader(f) | 	reader := bufio.NewReader(f) | ||||||
| 	for { | 	for { | ||||||
| 		line, err := reader.ReadString('\n') | 		line, err := reader.ReadString('\n') | ||||||
| 		logrus.Debugf("Read the following line from %s: %s", path, line) | 		logrus.Tracef("Read the following line from %s: %s", path, line) | ||||||
| 		if err != nil && err != io.EOF { | 		if err != nil && err != io.EOF { | ||||||
| 			return err | 			return err | ||||||
| 		} | 		} | ||||||
| 		lineArr := strings.Split(line, " ") | 		lineArr := strings.Split(line, " ") | ||||||
| 		if len(lineArr) < 5 { | 		if len(lineArr) < 5 { | ||||||
| 			if err == io.EOF { | 			if err == io.EOF { | ||||||
| 				logrus.Debugf("Reached end of file %s", path) | 				logrus.Tracef("Reached end of file %s", path) | ||||||
| 				break | 				break | ||||||
| 			} | 			} | ||||||
| 			continue | 			continue | ||||||
| 		} | 		} | ||||||
| 		if lineArr[4] != constants.RootDir { | 		if lineArr[4] != constants.RootDir { | ||||||
| 			logrus.Debugf("Appending %s from line: %s", lineArr[4], line) | 			logrus.Tracef("Appending %s from line: %s", lineArr[4], line) | ||||||
| 			whitelist = append(whitelist, WhitelistEntry{ | 			whitelist = append(whitelist, WhitelistEntry{ | ||||||
| 				Path:            lineArr[4], | 				Path:            lineArr[4], | ||||||
| 				PrefixMatchOnly: false, | 				PrefixMatchOnly: false, | ||||||
| 			}) | 			}) | ||||||
| 		} | 		} | ||||||
| 		if err == io.EOF { | 		if err == io.EOF { | ||||||
| 			logrus.Debugf("Reached end of file %s", path) | 			logrus.Tracef("Reached end of file %s", path) | ||||||
| 			break | 			break | ||||||
| 		} | 		} | ||||||
| 	} | 	} | ||||||
|  | @ -422,7 +422,7 @@ func CreateFile(path string, reader io.Reader, perm os.FileMode, uid uint32, gid | ||||||
| 	// Create directory path if it doesn't exist
 | 	// Create directory path if it doesn't exist
 | ||||||
| 	baseDir := filepath.Dir(path) | 	baseDir := filepath.Dir(path) | ||||||
| 	if _, err := os.Lstat(baseDir); os.IsNotExist(err) { | 	if _, err := os.Lstat(baseDir); os.IsNotExist(err) { | ||||||
| 		logrus.Debugf("baseDir %s for file %s does not exist. Creating.", baseDir, path) | 		logrus.Tracef("baseDir %s for file %s does not exist. Creating.", baseDir, path) | ||||||
| 		if err := os.MkdirAll(baseDir, 0755); err != nil { | 		if err := os.MkdirAll(baseDir, 0755); err != nil { | ||||||
| 			return err | 			return err | ||||||
| 		} | 		} | ||||||
|  |  | ||||||
|  | @ -0,0 +1,2 @@ | ||||||
|  | logrus | ||||||
|  | vendor | ||||||
|  | @ -0,0 +1,25 @@ | ||||||
|  | language: go | ||||||
|  | go_import_path: github.com/sirupsen/logrus | ||||||
|  | git: | ||||||
|  |   depth: 1 | ||||||
|  | env: | ||||||
|  |   - GO111MODULE=on | ||||||
|  |   - GO111MODULE=off | ||||||
|  | go: [ 1.11.x, 1.12.x ] | ||||||
|  | os: [ linux, osx ] | ||||||
|  | matrix: | ||||||
|  |   exclude: | ||||||
|  |     - go: 1.12.x | ||||||
|  |       env: GO111MODULE=off | ||||||
|  |     - go: 1.11.x | ||||||
|  |       os: osx | ||||||
|  | install: | ||||||
|  |   - ./travis/install.sh | ||||||
|  |   - if [[ "$GO111MODULE" ==  "on" ]]; then go mod download; fi | ||||||
|  |   - if [[ "$GO111MODULE" == "off" ]]; then go get github.com/stretchr/testify/assert golang.org/x/sys/unix github.com/konsorten/go-windows-terminal-sequences; fi | ||||||
|  | script: | ||||||
|  |   - ./travis/cross_build.sh | ||||||
|  |   - export GOMAXPROCS=4 | ||||||
|  |   - export GORACE=halt_on_error=1 | ||||||
|  |   - go test -race -v ./... | ||||||
|  |   - if [[ "$TRAVIS_OS_NAME" == "linux" ]]; then go test -race -v -tags appengine ./... ; fi | ||||||
|  | @ -0,0 +1,200 @@ | ||||||
|  | # 1.4.2 | ||||||
|  |   * Fixes build break for plan9, nacl, solaris | ||||||
|  | # 1.4.1 | ||||||
|  | This new release introduces: | ||||||
|  |   * Enhance TextFormatter to not print caller information when they are empty (#944) | ||||||
|  |   * Remove dependency on golang.org/x/crypto (#932, #943)  | ||||||
|  | 
 | ||||||
|  | Fixes: | ||||||
|  |   * Fix Entry.WithContext method to return a copy of the initial entry (#941) | ||||||
|  | 
 | ||||||
|  | # 1.4.0 | ||||||
|  | This new release introduces: | ||||||
|  |   * Add `DeferExitHandler`, similar to `RegisterExitHandler` but prepending the handler to the list of handlers (semantically like `defer`) (#848). | ||||||
|  |   * Add `CallerPrettyfier` to `JSONFormatter` and `TextFormatter (#909, #911) | ||||||
|  |   * Add `Entry.WithContext()` and `Entry.Context`, to set a context on entries to be used e.g. in hooks (#919). | ||||||
|  | 
 | ||||||
|  | Fixes: | ||||||
|  |   * Fix wrong method calls `Logger.Print` and `Logger.Warningln` (#893). | ||||||
|  |   * Update `Entry.Logf` to not do string formatting unless the log level is enabled (#903) | ||||||
|  |   * Fix infinite recursion on unknown `Level.String()` (#907) | ||||||
|  |   * Fix race condition in `getCaller` (#916). | ||||||
|  | 
 | ||||||
|  | 
 | ||||||
|  | # 1.3.0 | ||||||
|  | This new release introduces: | ||||||
|  |   * Log, Logf, Logln functions for Logger and Entry that take a Level | ||||||
|  | 
 | ||||||
|  | Fixes: | ||||||
|  |   * Building prometheus node_exporter on AIX (#840) | ||||||
|  |   * Race condition in TextFormatter (#468) | ||||||
|  |   * Travis CI import path (#868) | ||||||
|  |   * Remove coloured output on Windows (#862) | ||||||
|  |   * Pointer to func as field in JSONFormatter (#870) | ||||||
|  |   * Properly marshal Levels (#873) | ||||||
|  | 
 | ||||||
|  | # 1.2.0 | ||||||
|  | This new release introduces: | ||||||
|  |   * A new method `SetReportCaller` in the `Logger` to enable the file, line and calling function from which the trace has been issued | ||||||
|  |   * A new trace level named `Trace` whose level is below `Debug` | ||||||
|  |   * A configurable exit function to be called upon a Fatal trace | ||||||
|  |   * The `Level` object now implements `encoding.TextUnmarshaler` interface | ||||||
|  | 
 | ||||||
|  | # 1.1.1 | ||||||
|  | This is a bug fix release. | ||||||
|  |   * fix the build break on Solaris | ||||||
|  |   * don't drop a whole trace in JSONFormatter when a field param is a function pointer which can not be serialized | ||||||
|  | 
 | ||||||
|  | # 1.1.0 | ||||||
|  | This new release introduces: | ||||||
|  |   * several fixes: | ||||||
|  |     * a fix for a race condition on entry formatting | ||||||
|  |     * proper cleanup of previously used entries before putting them back in the pool | ||||||
|  |     * the extra new line at the end of message in text formatter has been removed | ||||||
|  |   * a new global public API to check if a level is activated: IsLevelEnabled | ||||||
|  |   * the following methods have been added to the Logger object | ||||||
|  |     * IsLevelEnabled | ||||||
|  |     * SetFormatter | ||||||
|  |     * SetOutput | ||||||
|  |     * ReplaceHooks | ||||||
|  |   * introduction of go module | ||||||
|  |   * an indent configuration for the json formatter | ||||||
|  |   * output colour support for windows | ||||||
|  |   * the field sort function is now configurable for text formatter | ||||||
|  |   * the CLICOLOR and CLICOLOR\_FORCE environment variable support in text formater | ||||||
|  | 
 | ||||||
|  | # 1.0.6 | ||||||
|  | 
 | ||||||
|  | This new release introduces: | ||||||
|  |   * a new api WithTime which allows to easily force the time of the log entry | ||||||
|  |     which is mostly useful for logger wrapper | ||||||
|  |   * a fix reverting the immutability of the entry given as parameter to the hooks | ||||||
|  |     a new configuration field of the json formatter in order to put all the fields | ||||||
|  |     in a nested dictionnary | ||||||
|  |   * a new SetOutput method in the Logger | ||||||
|  |   * a new configuration of the textformatter to configure the name of the default keys | ||||||
|  |   * a new configuration of the text formatter to disable the level truncation | ||||||
|  | 
 | ||||||
|  | # 1.0.5 | ||||||
|  | 
 | ||||||
|  | * Fix hooks race (#707) | ||||||
|  | * Fix panic deadlock (#695) | ||||||
|  | 
 | ||||||
|  | # 1.0.4 | ||||||
|  | 
 | ||||||
|  | * Fix race when adding hooks (#612) | ||||||
|  | * Fix terminal check in AppEngine (#635) | ||||||
|  | 
 | ||||||
|  | # 1.0.3 | ||||||
|  | 
 | ||||||
|  | * Replace example files with testable examples | ||||||
|  | 
 | ||||||
|  | # 1.0.2 | ||||||
|  | 
 | ||||||
|  | * bug: quote non-string values in text formatter (#583) | ||||||
|  | * Make (*Logger) SetLevel a public method | ||||||
|  | 
 | ||||||
|  | # 1.0.1 | ||||||
|  | 
 | ||||||
|  | * bug: fix escaping in text formatter (#575) | ||||||
|  | 
 | ||||||
|  | # 1.0.0 | ||||||
|  | 
 | ||||||
|  | * Officially changed name to lower-case | ||||||
|  | * bug: colors on Windows 10 (#541) | ||||||
|  | * bug: fix race in accessing level (#512) | ||||||
|  | 
 | ||||||
|  | # 0.11.5 | ||||||
|  | 
 | ||||||
|  | * feature: add writer and writerlevel to entry (#372) | ||||||
|  | 
 | ||||||
|  | # 0.11.4 | ||||||
|  | 
 | ||||||
|  | * bug: fix undefined variable on solaris (#493) | ||||||
|  | 
 | ||||||
|  | # 0.11.3 | ||||||
|  | 
 | ||||||
|  | * formatter: configure quoting of empty values (#484) | ||||||
|  | * formatter: configure quoting character (default is `"`) (#484) | ||||||
|  | * bug: fix not importing io correctly in non-linux environments (#481) | ||||||
|  | 
 | ||||||
|  | # 0.11.2 | ||||||
|  | 
 | ||||||
|  | * bug: fix windows terminal detection (#476) | ||||||
|  | 
 | ||||||
|  | # 0.11.1 | ||||||
|  | 
 | ||||||
|  | * bug: fix tty detection with custom out (#471) | ||||||
|  | 
 | ||||||
|  | # 0.11.0 | ||||||
|  | 
 | ||||||
|  | * performance: Use bufferpool to allocate (#370) | ||||||
|  | * terminal: terminal detection for app-engine (#343) | ||||||
|  | * feature: exit handler (#375) | ||||||
|  | 
 | ||||||
|  | # 0.10.0 | ||||||
|  | 
 | ||||||
|  | * feature: Add a test hook (#180) | ||||||
|  | * feature: `ParseLevel` is now case-insensitive (#326) | ||||||
|  | * feature: `FieldLogger` interface that generalizes `Logger` and `Entry` (#308) | ||||||
|  | * performance: avoid re-allocations on `WithFields` (#335) | ||||||
|  | 
 | ||||||
|  | # 0.9.0 | ||||||
|  | 
 | ||||||
|  | * logrus/text_formatter: don't emit empty msg | ||||||
|  | * logrus/hooks/airbrake: move out of main repository | ||||||
|  | * logrus/hooks/sentry: move out of main repository | ||||||
|  | * logrus/hooks/papertrail: move out of main repository | ||||||
|  | * logrus/hooks/bugsnag: move out of main repository | ||||||
|  | * logrus/core: run tests with `-race` | ||||||
|  | * logrus/core: detect TTY based on `stderr` | ||||||
|  | * logrus/core: support `WithError` on logger | ||||||
|  | * logrus/core: Solaris support | ||||||
|  | 
 | ||||||
|  | # 0.8.7 | ||||||
|  | 
 | ||||||
|  | * logrus/core: fix possible race (#216) | ||||||
|  | * logrus/doc: small typo fixes and doc improvements | ||||||
|  | 
 | ||||||
|  | 
 | ||||||
|  | # 0.8.6 | ||||||
|  | 
 | ||||||
|  | * hooks/raven: allow passing an initialized client | ||||||
|  | 
 | ||||||
|  | # 0.8.5 | ||||||
|  | 
 | ||||||
|  | * logrus/core: revert #208 | ||||||
|  | 
 | ||||||
|  | # 0.8.4 | ||||||
|  | 
 | ||||||
|  | * formatter/text: fix data race (#218) | ||||||
|  | 
 | ||||||
|  | # 0.8.3 | ||||||
|  | 
 | ||||||
|  | * logrus/core: fix entry log level (#208) | ||||||
|  | * logrus/core: improve performance of text formatter by 40% | ||||||
|  | * logrus/core: expose `LevelHooks` type | ||||||
|  | * logrus/core: add support for DragonflyBSD and NetBSD | ||||||
|  | * formatter/text: print structs more verbosely | ||||||
|  | 
 | ||||||
|  | # 0.8.2 | ||||||
|  | 
 | ||||||
|  | * logrus: fix more Fatal family functions | ||||||
|  | 
 | ||||||
|  | # 0.8.1 | ||||||
|  | 
 | ||||||
|  | * logrus: fix not exiting on `Fatalf` and `Fatalln` | ||||||
|  | 
 | ||||||
|  | # 0.8.0 | ||||||
|  | 
 | ||||||
|  | * logrus: defaults to stderr instead of stdout | ||||||
|  | * hooks/sentry: add special field for `*http.Request` | ||||||
|  | * formatter/text: ignore Windows for colors | ||||||
|  | 
 | ||||||
|  | # 0.7.3 | ||||||
|  | 
 | ||||||
|  | * formatter/\*: allow configuration of timestamp layout | ||||||
|  | 
 | ||||||
|  | # 0.7.2 | ||||||
|  | 
 | ||||||
|  | * formatter/text: Add configuration option for time format (#158) | ||||||
|  | @ -0,0 +1,495 @@ | ||||||
|  | # Logrus <img src="http://i.imgur.com/hTeVwmJ.png" width="40" height="40" alt=":walrus:" class="emoji" title=":walrus:"/> [](https://travis-ci.org/sirupsen/logrus) [](https://godoc.org/github.com/sirupsen/logrus) | ||||||
|  | 
 | ||||||
|  | Logrus is a structured logger for Go (golang), completely API compatible with | ||||||
|  | the standard library logger. | ||||||
|  | 
 | ||||||
|  | **Seeing weird case-sensitive problems?** It's in the past been possible to | ||||||
|  | import Logrus as both upper- and lower-case. Due to the Go package environment, | ||||||
|  | this caused issues in the community and we needed a standard. Some environments | ||||||
|  | experienced problems with the upper-case variant, so the lower-case was decided. | ||||||
|  | Everything using `logrus` will need to use the lower-case: | ||||||
|  | `github.com/sirupsen/logrus`. Any package that isn't, should be changed. | ||||||
|  | 
 | ||||||
|  | To fix Glide, see [these | ||||||
|  | comments](https://github.com/sirupsen/logrus/issues/553#issuecomment-306591437). | ||||||
|  | For an in-depth explanation of the casing issue, see [this | ||||||
|  | comment](https://github.com/sirupsen/logrus/issues/570#issuecomment-313933276). | ||||||
|  | 
 | ||||||
|  | **Are you interested in assisting in maintaining Logrus?** Currently I have a | ||||||
|  | lot of obligations, and I am unable to provide Logrus with the maintainership it | ||||||
|  | needs. If you'd like to help, please reach out to me at `simon at author's | ||||||
|  | username dot com`. | ||||||
|  | 
 | ||||||
|  | Nicely color-coded in development (when a TTY is attached, otherwise just | ||||||
|  | plain text): | ||||||
|  | 
 | ||||||
|  |  | ||||||
|  | 
 | ||||||
|  | With `log.SetFormatter(&log.JSONFormatter{})`, for easy parsing by logstash | ||||||
|  | or Splunk: | ||||||
|  | 
 | ||||||
|  | ```json | ||||||
|  | {"animal":"walrus","level":"info","msg":"A group of walrus emerges from the | ||||||
|  | ocean","size":10,"time":"2014-03-10 19:57:38.562264131 -0400 EDT"} | ||||||
|  | 
 | ||||||
|  | {"level":"warning","msg":"The group's number increased tremendously!", | ||||||
|  | "number":122,"omg":true,"time":"2014-03-10 19:57:38.562471297 -0400 EDT"} | ||||||
|  | 
 | ||||||
|  | {"animal":"walrus","level":"info","msg":"A giant walrus appears!", | ||||||
|  | "size":10,"time":"2014-03-10 19:57:38.562500591 -0400 EDT"} | ||||||
|  | 
 | ||||||
|  | {"animal":"walrus","level":"info","msg":"Tremendously sized cow enters the ocean.", | ||||||
|  | "size":9,"time":"2014-03-10 19:57:38.562527896 -0400 EDT"} | ||||||
|  | 
 | ||||||
|  | {"level":"fatal","msg":"The ice breaks!","number":100,"omg":true, | ||||||
|  | "time":"2014-03-10 19:57:38.562543128 -0400 EDT"} | ||||||
|  | ``` | ||||||
|  | 
 | ||||||
|  | With the default `log.SetFormatter(&log.TextFormatter{})` when a TTY is not | ||||||
|  | attached, the output is compatible with the | ||||||
|  | [logfmt](http://godoc.org/github.com/kr/logfmt) format: | ||||||
|  | 
 | ||||||
|  | ```text | ||||||
|  | time="2015-03-26T01:27:38-04:00" level=debug msg="Started observing beach" animal=walrus number=8 | ||||||
|  | time="2015-03-26T01:27:38-04:00" level=info msg="A group of walrus emerges from the ocean" animal=walrus size=10 | ||||||
|  | time="2015-03-26T01:27:38-04:00" level=warning msg="The group's number increased tremendously!" number=122 omg=true | ||||||
|  | time="2015-03-26T01:27:38-04:00" level=debug msg="Temperature changes" temperature=-4 | ||||||
|  | time="2015-03-26T01:27:38-04:00" level=panic msg="It's over 9000!" animal=orca size=9009 | ||||||
|  | time="2015-03-26T01:27:38-04:00" level=fatal msg="The ice breaks!" err=&{0x2082280c0 map[animal:orca size:9009] 2015-03-26 01:27:38.441574009 -0400 EDT panic It's over 9000!} number=100 omg=true | ||||||
|  | ``` | ||||||
|  | To ensure this behaviour even if a TTY is attached, set your formatter as follows: | ||||||
|  | 
 | ||||||
|  | ```go | ||||||
|  | 	log.SetFormatter(&log.TextFormatter{ | ||||||
|  | 		DisableColors: true, | ||||||
|  | 		FullTimestamp: true, | ||||||
|  | 	}) | ||||||
|  | ``` | ||||||
|  | 
 | ||||||
|  | #### Logging Method Name | ||||||
|  | 
 | ||||||
|  | If you wish to add the calling method as a field, instruct the logger via: | ||||||
|  | ```go | ||||||
|  | log.SetReportCaller(true) | ||||||
|  | ``` | ||||||
|  | This adds the caller as 'method' like so: | ||||||
|  | 
 | ||||||
|  | ```json | ||||||
|  | {"animal":"penguin","level":"fatal","method":"github.com/sirupsen/arcticcreatures.migrate","msg":"a penguin swims by", | ||||||
|  | "time":"2014-03-10 19:57:38.562543129 -0400 EDT"} | ||||||
|  | ``` | ||||||
|  | 
 | ||||||
|  | ```text | ||||||
|  | time="2015-03-26T01:27:38-04:00" level=fatal method=github.com/sirupsen/arcticcreatures.migrate msg="a penguin swims by" animal=penguin | ||||||
|  | ``` | ||||||
|  | Note that this does add measurable overhead - the cost will depend on the version of Go, but is | ||||||
|  | between 20 and 40% in recent tests with 1.6 and 1.7.  You can validate this in your | ||||||
|  | environment via benchmarks:  | ||||||
|  | ``` | ||||||
|  | go test -bench=.*CallerTracing | ||||||
|  | ``` | ||||||
|  | 
 | ||||||
|  | 
 | ||||||
|  | #### Case-sensitivity | ||||||
|  | 
 | ||||||
|  | The organization's name was changed to lower-case--and this will not be changed | ||||||
|  | back. If you are getting import conflicts due to case sensitivity, please use | ||||||
|  | the lower-case import: `github.com/sirupsen/logrus`. | ||||||
|  | 
 | ||||||
|  | #### Example | ||||||
|  | 
 | ||||||
|  | The simplest way to use Logrus is simply the package-level exported logger: | ||||||
|  | 
 | ||||||
|  | ```go | ||||||
|  | package main | ||||||
|  | 
 | ||||||
|  | import ( | ||||||
|  |   log "github.com/sirupsen/logrus" | ||||||
|  | ) | ||||||
|  | 
 | ||||||
|  | func main() { | ||||||
|  |   log.WithFields(log.Fields{ | ||||||
|  |     "animal": "walrus", | ||||||
|  |   }).Info("A walrus appears") | ||||||
|  | } | ||||||
|  | ``` | ||||||
|  | 
 | ||||||
|  | Note that it's completely api-compatible with the stdlib logger, so you can | ||||||
|  | replace your `log` imports everywhere with `log "github.com/sirupsen/logrus"` | ||||||
|  | and you'll now have the flexibility of Logrus. You can customize it all you | ||||||
|  | want: | ||||||
|  | 
 | ||||||
|  | ```go | ||||||
|  | package main | ||||||
|  | 
 | ||||||
|  | import ( | ||||||
|  |   "os" | ||||||
|  |   log "github.com/sirupsen/logrus" | ||||||
|  | ) | ||||||
|  | 
 | ||||||
|  | func init() { | ||||||
|  |   // Log as JSON instead of the default ASCII formatter. | ||||||
|  |   log.SetFormatter(&log.JSONFormatter{}) | ||||||
|  | 
 | ||||||
|  |   // Output to stdout instead of the default stderr | ||||||
|  |   // Can be any io.Writer, see below for File example | ||||||
|  |   log.SetOutput(os.Stdout) | ||||||
|  | 
 | ||||||
|  |   // Only log the warning severity or above. | ||||||
|  |   log.SetLevel(log.WarnLevel) | ||||||
|  | } | ||||||
|  | 
 | ||||||
|  | func main() { | ||||||
|  |   log.WithFields(log.Fields{ | ||||||
|  |     "animal": "walrus", | ||||||
|  |     "size":   10, | ||||||
|  |   }).Info("A group of walrus emerges from the ocean") | ||||||
|  | 
 | ||||||
|  |   log.WithFields(log.Fields{ | ||||||
|  |     "omg":    true, | ||||||
|  |     "number": 122, | ||||||
|  |   }).Warn("The group's number increased tremendously!") | ||||||
|  | 
 | ||||||
|  |   log.WithFields(log.Fields{ | ||||||
|  |     "omg":    true, | ||||||
|  |     "number": 100, | ||||||
|  |   }).Fatal("The ice breaks!") | ||||||
|  | 
 | ||||||
|  |   // A common pattern is to re-use fields between logging statements by re-using | ||||||
|  |   // the logrus.Entry returned from WithFields() | ||||||
|  |   contextLogger := log.WithFields(log.Fields{ | ||||||
|  |     "common": "this is a common field", | ||||||
|  |     "other": "I also should be logged always", | ||||||
|  |   }) | ||||||
|  | 
 | ||||||
|  |   contextLogger.Info("I'll be logged with common and other field") | ||||||
|  |   contextLogger.Info("Me too") | ||||||
|  | } | ||||||
|  | ``` | ||||||
|  | 
 | ||||||
|  | For more advanced usage such as logging to multiple locations from the same | ||||||
|  | application, you can also create an instance of the `logrus` Logger: | ||||||
|  | 
 | ||||||
|  | ```go | ||||||
|  | package main | ||||||
|  | 
 | ||||||
|  | import ( | ||||||
|  |   "os" | ||||||
|  |   "github.com/sirupsen/logrus" | ||||||
|  | ) | ||||||
|  | 
 | ||||||
|  | // Create a new instance of the logger. You can have any number of instances. | ||||||
|  | var log = logrus.New() | ||||||
|  | 
 | ||||||
|  | func main() { | ||||||
|  |   // The API for setting attributes is a little different than the package level | ||||||
|  |   // exported logger. See Godoc. | ||||||
|  |   log.Out = os.Stdout | ||||||
|  | 
 | ||||||
|  |   // You could set this to any `io.Writer` such as a file | ||||||
|  |   // file, err := os.OpenFile("logrus.log", os.O_CREATE|os.O_WRONLY, 0666) | ||||||
|  |   // if err == nil { | ||||||
|  |   //  log.Out = file | ||||||
|  |   // } else { | ||||||
|  |   //  log.Info("Failed to log to file, using default stderr") | ||||||
|  |   // } | ||||||
|  | 
 | ||||||
|  |   log.WithFields(logrus.Fields{ | ||||||
|  |     "animal": "walrus", | ||||||
|  |     "size":   10, | ||||||
|  |   }).Info("A group of walrus emerges from the ocean") | ||||||
|  | } | ||||||
|  | ``` | ||||||
|  | 
 | ||||||
|  | #### Fields | ||||||
|  | 
 | ||||||
|  | Logrus encourages careful, structured logging through logging fields instead of | ||||||
|  | long, unparseable error messages. For example, instead of: `log.Fatalf("Failed | ||||||
|  | to send event %s to topic %s with key %d")`, you should log the much more | ||||||
|  | discoverable: | ||||||
|  | 
 | ||||||
|  | ```go | ||||||
|  | log.WithFields(log.Fields{ | ||||||
|  |   "event": event, | ||||||
|  |   "topic": topic, | ||||||
|  |   "key": key, | ||||||
|  | }).Fatal("Failed to send event") | ||||||
|  | ``` | ||||||
|  | 
 | ||||||
|  | We've found this API forces you to think about logging in a way that produces | ||||||
|  | much more useful logging messages. We've been in countless situations where just | ||||||
|  | a single added field to a log statement that was already there would've saved us | ||||||
|  | hours. The `WithFields` call is optional. | ||||||
|  | 
 | ||||||
|  | In general, with Logrus using any of the `printf`-family functions should be | ||||||
|  | seen as a hint you should add a field, however, you can still use the | ||||||
|  | `printf`-family functions with Logrus. | ||||||
|  | 
 | ||||||
|  | #### Default Fields | ||||||
|  | 
 | ||||||
|  | Often it's helpful to have fields _always_ attached to log statements in an | ||||||
|  | application or parts of one. For example, you may want to always log the | ||||||
|  | `request_id` and `user_ip` in the context of a request. Instead of writing | ||||||
|  | `log.WithFields(log.Fields{"request_id": request_id, "user_ip": user_ip})` on | ||||||
|  | every line, you can create a `logrus.Entry` to pass around instead: | ||||||
|  | 
 | ||||||
|  | ```go | ||||||
|  | requestLogger := log.WithFields(log.Fields{"request_id": request_id, "user_ip": user_ip}) | ||||||
|  | requestLogger.Info("something happened on that request") # will log request_id and user_ip | ||||||
|  | requestLogger.Warn("something not great happened") | ||||||
|  | ``` | ||||||
|  | 
 | ||||||
|  | #### Hooks | ||||||
|  | 
 | ||||||
|  | You can add hooks for logging levels. For example to send errors to an exception | ||||||
|  | tracking service on `Error`, `Fatal` and `Panic`, info to StatsD or log to | ||||||
|  | multiple places simultaneously, e.g. syslog. | ||||||
|  | 
 | ||||||
|  | Logrus comes with [built-in hooks](hooks/). Add those, or your custom hook, in | ||||||
|  | `init`: | ||||||
|  | 
 | ||||||
|  | ```go | ||||||
|  | import ( | ||||||
|  |   log "github.com/sirupsen/logrus" | ||||||
|  |   "gopkg.in/gemnasium/logrus-airbrake-hook.v2" // the package is named "airbrake" | ||||||
|  |   logrus_syslog "github.com/sirupsen/logrus/hooks/syslog" | ||||||
|  |   "log/syslog" | ||||||
|  | ) | ||||||
|  | 
 | ||||||
|  | func init() { | ||||||
|  | 
 | ||||||
|  |   // Use the Airbrake hook to report errors that have Error severity or above to | ||||||
|  |   // an exception tracker. You can create custom hooks, see the Hooks section. | ||||||
|  |   log.AddHook(airbrake.NewHook(123, "xyz", "production")) | ||||||
|  | 
 | ||||||
|  |   hook, err := logrus_syslog.NewSyslogHook("udp", "localhost:514", syslog.LOG_INFO, "") | ||||||
|  |   if err != nil { | ||||||
|  |     log.Error("Unable to connect to local syslog daemon") | ||||||
|  |   } else { | ||||||
|  |     log.AddHook(hook) | ||||||
|  |   } | ||||||
|  | } | ||||||
|  | ``` | ||||||
|  | Note: Syslog hook also support connecting to local syslog (Ex. "/dev/log" or "/var/run/syslog" or "/var/run/log"). For the detail, please check the [syslog hook README](hooks/syslog/README.md). | ||||||
|  | 
 | ||||||
|  | A list of currently known of service hook can be found in this wiki [page](https://github.com/sirupsen/logrus/wiki/Hooks) | ||||||
|  | 
 | ||||||
|  | 
 | ||||||
|  | #### Level logging | ||||||
|  | 
 | ||||||
|  | Logrus has seven logging levels: Trace, Debug, Info, Warning, Error, Fatal and Panic. | ||||||
|  | 
 | ||||||
|  | ```go | ||||||
|  | log.Trace("Something very low level.") | ||||||
|  | log.Debug("Useful debugging information.") | ||||||
|  | log.Info("Something noteworthy happened!") | ||||||
|  | log.Warn("You should probably take a look at this.") | ||||||
|  | log.Error("Something failed but I'm not quitting.") | ||||||
|  | // Calls os.Exit(1) after logging | ||||||
|  | log.Fatal("Bye.") | ||||||
|  | // Calls panic() after logging | ||||||
|  | log.Panic("I'm bailing.") | ||||||
|  | ``` | ||||||
|  | 
 | ||||||
|  | You can set the logging level on a `Logger`, then it will only log entries with | ||||||
|  | that severity or anything above it: | ||||||
|  | 
 | ||||||
|  | ```go | ||||||
|  | // Will log anything that is info or above (warn, error, fatal, panic). Default. | ||||||
|  | log.SetLevel(log.InfoLevel) | ||||||
|  | ``` | ||||||
|  | 
 | ||||||
|  | It may be useful to set `log.Level = logrus.DebugLevel` in a debug or verbose | ||||||
|  | environment if your application has that. | ||||||
|  | 
 | ||||||
|  | #### Entries | ||||||
|  | 
 | ||||||
|  | Besides the fields added with `WithField` or `WithFields` some fields are | ||||||
|  | automatically added to all logging events: | ||||||
|  | 
 | ||||||
|  | 1. `time`. The timestamp when the entry was created. | ||||||
|  | 2. `msg`. The logging message passed to `{Info,Warn,Error,Fatal,Panic}` after | ||||||
|  |    the `AddFields` call. E.g. `Failed to send event.` | ||||||
|  | 3. `level`. The logging level. E.g. `info`. | ||||||
|  | 
 | ||||||
|  | #### Environments | ||||||
|  | 
 | ||||||
|  | Logrus has no notion of environment. | ||||||
|  | 
 | ||||||
|  | If you wish for hooks and formatters to only be used in specific environments, | ||||||
|  | you should handle that yourself. For example, if your application has a global | ||||||
|  | variable `Environment`, which is a string representation of the environment you | ||||||
|  | could do: | ||||||
|  | 
 | ||||||
|  | ```go | ||||||
|  | import ( | ||||||
|  |   log "github.com/sirupsen/logrus" | ||||||
|  | ) | ||||||
|  | 
 | ||||||
|  | init() { | ||||||
|  |   // do something here to set environment depending on an environment variable | ||||||
|  |   // or command-line flag | ||||||
|  |   if Environment == "production" { | ||||||
|  |     log.SetFormatter(&log.JSONFormatter{}) | ||||||
|  |   } else { | ||||||
|  |     // The TextFormatter is default, you don't actually have to do this. | ||||||
|  |     log.SetFormatter(&log.TextFormatter{}) | ||||||
|  |   } | ||||||
|  | } | ||||||
|  | ``` | ||||||
|  | 
 | ||||||
|  | This configuration is how `logrus` was intended to be used, but JSON in | ||||||
|  | production is mostly only useful if you do log aggregation with tools like | ||||||
|  | Splunk or Logstash. | ||||||
|  | 
 | ||||||
|  | #### Formatters | ||||||
|  | 
 | ||||||
|  | The built-in logging formatters are: | ||||||
|  | 
 | ||||||
|  | * `logrus.TextFormatter`. Logs the event in colors if stdout is a tty, otherwise | ||||||
|  |   without colors. | ||||||
|  |   * *Note:* to force colored output when there is no TTY, set the `ForceColors` | ||||||
|  |     field to `true`.  To force no colored output even if there is a TTY  set the | ||||||
|  |     `DisableColors` field to `true`. For Windows, see | ||||||
|  |     [github.com/mattn/go-colorable](https://github.com/mattn/go-colorable). | ||||||
|  |   * When colors are enabled, levels are truncated to 4 characters by default. To disable | ||||||
|  |     truncation set the `DisableLevelTruncation` field to `true`. | ||||||
|  |   * All options are listed in the [generated docs](https://godoc.org/github.com/sirupsen/logrus#TextFormatter). | ||||||
|  | * `logrus.JSONFormatter`. Logs fields as JSON. | ||||||
|  |   * All options are listed in the [generated docs](https://godoc.org/github.com/sirupsen/logrus#JSONFormatter). | ||||||
|  | 
 | ||||||
|  | Third party logging formatters: | ||||||
|  | 
 | ||||||
|  | * [`FluentdFormatter`](https://github.com/joonix/log). Formats entries that can be parsed by Kubernetes and Google Container Engine. | ||||||
|  | * [`GELF`](https://github.com/fabienm/go-logrus-formatters). Formats entries so they comply to Graylog's [GELF 1.1 specification](http://docs.graylog.org/en/2.4/pages/gelf.html). | ||||||
|  | * [`logstash`](https://github.com/bshuster-repo/logrus-logstash-hook). Logs fields as [Logstash](http://logstash.net) Events. | ||||||
|  | * [`prefixed`](https://github.com/x-cray/logrus-prefixed-formatter). Displays log entry source along with alternative layout. | ||||||
|  | * [`zalgo`](https://github.com/aybabtme/logzalgo). Invoking the P͉̫o̳̼̊w̖͈̰͎e̬͔̭͂r͚̼̹̲ ̫͓͉̳͈ō̠͕͖̚f̝͍̠ ͕̲̞͖͑Z̖̫̤̫ͪa͉̬͈̗l͖͎g̳̥o̰̥̅!̣͔̲̻͊̄ ̙̘̦̹̦. | ||||||
|  | * [`nested-logrus-formatter`](https://github.com/antonfisher/nested-logrus-formatter). Converts logrus fields to a nested structure. | ||||||
|  | 
 | ||||||
|  | You can define your formatter by implementing the `Formatter` interface, | ||||||
|  | requiring a `Format` method. `Format` takes an `*Entry`. `entry.Data` is a | ||||||
|  | `Fields` type (`map[string]interface{}`) with all your fields as well as the | ||||||
|  | default ones (see Entries section above): | ||||||
|  | 
 | ||||||
|  | ```go | ||||||
|  | type MyJSONFormatter struct { | ||||||
|  | } | ||||||
|  | 
 | ||||||
|  | log.SetFormatter(new(MyJSONFormatter)) | ||||||
|  | 
 | ||||||
|  | func (f *MyJSONFormatter) Format(entry *Entry) ([]byte, error) { | ||||||
|  |   // Note this doesn't include Time, Level and Message which are available on | ||||||
|  |   // the Entry. Consult `godoc` on information about those fields or read the | ||||||
|  |   // source of the official loggers. | ||||||
|  |   serialized, err := json.Marshal(entry.Data) | ||||||
|  |     if err != nil { | ||||||
|  |       return nil, fmt.Errorf("Failed to marshal fields to JSON, %v", err) | ||||||
|  |     } | ||||||
|  |   return append(serialized, '\n'), nil | ||||||
|  | } | ||||||
|  | ``` | ||||||
|  | 
 | ||||||
|  | #### Logger as an `io.Writer` | ||||||
|  | 
 | ||||||
|  | Logrus can be transformed into an `io.Writer`. That writer is the end of an `io.Pipe` and it is your responsibility to close it. | ||||||
|  | 
 | ||||||
|  | ```go | ||||||
|  | w := logger.Writer() | ||||||
|  | defer w.Close() | ||||||
|  | 
 | ||||||
|  | srv := http.Server{ | ||||||
|  |     // create a stdlib log.Logger that writes to | ||||||
|  |     // logrus.Logger. | ||||||
|  |     ErrorLog: log.New(w, "", 0), | ||||||
|  | } | ||||||
|  | ``` | ||||||
|  | 
 | ||||||
|  | Each line written to that writer will be printed the usual way, using formatters | ||||||
|  | and hooks. The level for those entries is `info`. | ||||||
|  | 
 | ||||||
|  | This means that we can override the standard library logger easily: | ||||||
|  | 
 | ||||||
|  | ```go | ||||||
|  | logger := logrus.New() | ||||||
|  | logger.Formatter = &logrus.JSONFormatter{} | ||||||
|  | 
 | ||||||
|  | // Use logrus for standard log output | ||||||
|  | // Note that `log` here references stdlib's log | ||||||
|  | // Not logrus imported under the name `log`. | ||||||
|  | log.SetOutput(logger.Writer()) | ||||||
|  | ``` | ||||||
|  | 
 | ||||||
|  | #### Rotation | ||||||
|  | 
 | ||||||
|  | Log rotation is not provided with Logrus. Log rotation should be done by an | ||||||
|  | external program (like `logrotate(8)`) that can compress and delete old log | ||||||
|  | entries. It should not be a feature of the application-level logger. | ||||||
|  | 
 | ||||||
|  | #### Tools | ||||||
|  | 
 | ||||||
|  | | Tool | Description | | ||||||
|  | | ---- | ----------- | | ||||||
|  | |[Logrus Mate](https://github.com/gogap/logrus_mate)|Logrus mate is a tool for Logrus to manage loggers, you can initial logger's level, hook and formatter by config file, the logger will generated with different config at different environment.| | ||||||
|  | |[Logrus Viper Helper](https://github.com/heirko/go-contrib/tree/master/logrusHelper)|An Helper around Logrus to wrap with spf13/Viper to load configuration with fangs! And to simplify Logrus configuration use some behavior of [Logrus Mate](https://github.com/gogap/logrus_mate). [sample](https://github.com/heirko/iris-contrib/blob/master/middleware/logrus-logger/example) | | ||||||
|  | 
 | ||||||
|  | #### Testing | ||||||
|  | 
 | ||||||
|  | Logrus has a built in facility for asserting the presence of log messages. This is implemented through the `test` hook and provides: | ||||||
|  | 
 | ||||||
|  | * decorators for existing logger (`test.NewLocal` and `test.NewGlobal`) which basically just add the `test` hook | ||||||
|  | * a test logger (`test.NewNullLogger`) that just records log messages (and does not output any): | ||||||
|  | 
 | ||||||
|  | ```go | ||||||
|  | import( | ||||||
|  |   "github.com/sirupsen/logrus" | ||||||
|  |   "github.com/sirupsen/logrus/hooks/test" | ||||||
|  |   "github.com/stretchr/testify/assert" | ||||||
|  |   "testing" | ||||||
|  | ) | ||||||
|  | 
 | ||||||
|  | func TestSomething(t*testing.T){ | ||||||
|  |   logger, hook := test.NewNullLogger() | ||||||
|  |   logger.Error("Helloerror") | ||||||
|  | 
 | ||||||
|  |   assert.Equal(t, 1, len(hook.Entries)) | ||||||
|  |   assert.Equal(t, logrus.ErrorLevel, hook.LastEntry().Level) | ||||||
|  |   assert.Equal(t, "Helloerror", hook.LastEntry().Message) | ||||||
|  | 
 | ||||||
|  |   hook.Reset() | ||||||
|  |   assert.Nil(t, hook.LastEntry()) | ||||||
|  | } | ||||||
|  | ``` | ||||||
|  | 
 | ||||||
|  | #### Fatal handlers | ||||||
|  | 
 | ||||||
|  | Logrus can register one or more functions that will be called when any `fatal` | ||||||
|  | level message is logged. The registered handlers will be executed before | ||||||
|  | logrus performs a `os.Exit(1)`. This behavior may be helpful if callers need | ||||||
|  | to gracefully shutdown. Unlike a `panic("Something went wrong...")` call which can be intercepted with a deferred `recover` a call to `os.Exit(1)` can not be intercepted. | ||||||
|  | 
 | ||||||
|  | ``` | ||||||
|  | ... | ||||||
|  | handler := func() { | ||||||
|  |   // gracefully shutdown something... | ||||||
|  | } | ||||||
|  | logrus.RegisterExitHandler(handler) | ||||||
|  | ... | ||||||
|  | ``` | ||||||
|  | 
 | ||||||
|  | #### Thread safety | ||||||
|  | 
 | ||||||
|  | By default, Logger is protected by a mutex for concurrent writes. The mutex is held when calling hooks and writing logs. | ||||||
|  | If you are sure such locking is not needed, you can call logger.SetNoLock() to disable the locking. | ||||||
|  | 
 | ||||||
|  | Situation when locking is not needed includes: | ||||||
|  | 
 | ||||||
|  | * You have no hooks registered, or hooks calling is already thread-safe. | ||||||
|  | 
 | ||||||
|  | * Writing to logger.Out is already thread-safe, for example: | ||||||
|  | 
 | ||||||
|  |   1) logger.Out is protected by locks. | ||||||
|  | 
 | ||||||
|  |   2) logger.Out is a os.File handler opened with `O_APPEND` flag, and every write is smaller than 4k. (This allow multi-thread/multi-process writing) | ||||||
|  | 
 | ||||||
|  |      (Refer to http://www.notthewizard.com/2014/06/17/are-files-appends-really-atomic/) | ||||||
|  | @ -51,9 +51,9 @@ func Exit(code int) { | ||||||
| 	os.Exit(code) | 	os.Exit(code) | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| // RegisterExitHandler adds a Logrus Exit handler, call logrus.Exit to invoke
 | // RegisterExitHandler appends a Logrus Exit handler to the list of handlers,
 | ||||||
| // all handlers. The handlers will also be invoked when any Fatal log entry is
 | // call logrus.Exit to invoke all handlers. The handlers will also be invoked when
 | ||||||
| // made.
 | // any Fatal log entry is made.
 | ||||||
| //
 | //
 | ||||||
| // This method is useful when a caller wishes to use logrus to log a fatal
 | // This method is useful when a caller wishes to use logrus to log a fatal
 | ||||||
| // message but also needs to gracefully shutdown. An example usecase could be
 | // message but also needs to gracefully shutdown. An example usecase could be
 | ||||||
|  | @ -62,3 +62,15 @@ func Exit(code int) { | ||||||
| func RegisterExitHandler(handler func()) { | func RegisterExitHandler(handler func()) { | ||||||
| 	handlers = append(handlers, handler) | 	handlers = append(handlers, handler) | ||||||
| } | } | ||||||
|  | 
 | ||||||
|  | // DeferExitHandler prepends a Logrus Exit handler to the list of handlers,
 | ||||||
|  | // call logrus.Exit to invoke all handlers. The handlers will also be invoked when
 | ||||||
|  | // any Fatal log entry is made.
 | ||||||
|  | //
 | ||||||
|  | // This method is useful when a caller wishes to use logrus to log a fatal
 | ||||||
|  | // message but also needs to gracefully shutdown. An example usecase could be
 | ||||||
|  | // closing database connections, or sending a alert that the application is
 | ||||||
|  | // closing.
 | ||||||
|  | func DeferExitHandler(handler func()) { | ||||||
|  | 	handlers = append([]func(){handler}, handlers...) | ||||||
|  | } | ||||||
|  |  | ||||||
|  | @ -0,0 +1,14 @@ | ||||||
|  | version: "{build}" | ||||||
|  | platform: x64 | ||||||
|  | clone_folder: c:\gopath\src\github.com\sirupsen\logrus | ||||||
|  | environment:   | ||||||
|  |   GOPATH: c:\gopath | ||||||
|  | branches:   | ||||||
|  |   only: | ||||||
|  |     - master | ||||||
|  | install:   | ||||||
|  |   - set PATH=%GOPATH%\bin;c:\go\bin;%PATH% | ||||||
|  |   - go version | ||||||
|  | build_script:   | ||||||
|  |   - go get -t | ||||||
|  |   - go test | ||||||
|  | @ -2,13 +2,33 @@ package logrus | ||||||
| 
 | 
 | ||||||
| import ( | import ( | ||||||
| 	"bytes" | 	"bytes" | ||||||
|  | 	"context" | ||||||
| 	"fmt" | 	"fmt" | ||||||
| 	"os" | 	"os" | ||||||
|  | 	"reflect" | ||||||
|  | 	"runtime" | ||||||
|  | 	"strings" | ||||||
| 	"sync" | 	"sync" | ||||||
| 	"time" | 	"time" | ||||||
| ) | ) | ||||||
| 
 | 
 | ||||||
| var bufferPool *sync.Pool | var ( | ||||||
|  | 	bufferPool *sync.Pool | ||||||
|  | 
 | ||||||
|  | 	// qualified package name, cached at first use
 | ||||||
|  | 	logrusPackage string | ||||||
|  | 
 | ||||||
|  | 	// Positions in the call stack when tracing to report the calling method
 | ||||||
|  | 	minimumCallerDepth int | ||||||
|  | 
 | ||||||
|  | 	// Used for caller information initialisation
 | ||||||
|  | 	callerInitOnce sync.Once | ||||||
|  | ) | ||||||
|  | 
 | ||||||
|  | const ( | ||||||
|  | 	maximumCallerDepth int = 25 | ||||||
|  | 	knownLogrusFrames  int = 4 | ||||||
|  | ) | ||||||
| 
 | 
 | ||||||
| func init() { | func init() { | ||||||
| 	bufferPool = &sync.Pool{ | 	bufferPool = &sync.Pool{ | ||||||
|  | @ -16,15 +36,18 @@ func init() { | ||||||
| 			return new(bytes.Buffer) | 			return new(bytes.Buffer) | ||||||
| 		}, | 		}, | ||||||
| 	} | 	} | ||||||
|  | 
 | ||||||
|  | 	// start at the bottom of the stack before the package-name cache is primed
 | ||||||
|  | 	minimumCallerDepth = 1 | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| // Defines the key when adding errors using WithError.
 | // Defines the key when adding errors using WithError.
 | ||||||
| var ErrorKey = "error" | var ErrorKey = "error" | ||||||
| 
 | 
 | ||||||
| // An entry is the final or intermediate Logrus logging entry. It contains all
 | // An entry is the final or intermediate Logrus logging entry. It contains all
 | ||||||
| // the fields passed with WithField{,s}. It's finally logged when Debug, Info,
 | // the fields passed with WithField{,s}. It's finally logged when Trace, Debug,
 | ||||||
| // Warn, Error, Fatal or Panic is called on it. These objects can be reused and
 | // Info, Warn, Error, Fatal or Panic is called on it. These objects can be
 | ||||||
| // passed around as much as you wish to avoid field duplication.
 | // reused and passed around as much as you wish to avoid field duplication.
 | ||||||
| type Entry struct { | type Entry struct { | ||||||
| 	Logger *Logger | 	Logger *Logger | ||||||
| 
 | 
 | ||||||
|  | @ -34,22 +57,31 @@ type Entry struct { | ||||||
| 	// Time at which the log entry was created
 | 	// Time at which the log entry was created
 | ||||||
| 	Time time.Time | 	Time time.Time | ||||||
| 
 | 
 | ||||||
| 	// Level the log entry was logged at: Debug, Info, Warn, Error, Fatal or Panic
 | 	// Level the log entry was logged at: Trace, Debug, Info, Warn, Error, Fatal or Panic
 | ||||||
| 	// This field will be set on entry firing and the value will be equal to the one in Logger struct field.
 | 	// This field will be set on entry firing and the value will be equal to the one in Logger struct field.
 | ||||||
| 	Level Level | 	Level Level | ||||||
| 
 | 
 | ||||||
| 	// Message passed to Debug, Info, Warn, Error, Fatal or Panic
 | 	// Calling method, with package name
 | ||||||
|  | 	Caller *runtime.Frame | ||||||
|  | 
 | ||||||
|  | 	// Message passed to Trace, Debug, Info, Warn, Error, Fatal or Panic
 | ||||||
| 	Message string | 	Message string | ||||||
| 
 | 
 | ||||||
| 	// When formatter is called in entry.log(), an Buffer may be set to entry
 | 	// When formatter is called in entry.log(), a Buffer may be set to entry
 | ||||||
| 	Buffer *bytes.Buffer | 	Buffer *bytes.Buffer | ||||||
|  | 
 | ||||||
|  | 	// Contains the context set by the user. Useful for hook processing etc.
 | ||||||
|  | 	Context context.Context | ||||||
|  | 
 | ||||||
|  | 	// err may contain a field formatting error
 | ||||||
|  | 	err string | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func NewEntry(logger *Logger) *Entry { | func NewEntry(logger *Logger) *Entry { | ||||||
| 	return &Entry{ | 	return &Entry{ | ||||||
| 		Logger: logger, | 		Logger: logger, | ||||||
| 		// Default is five fields, give a little extra room
 | 		// Default is three fields, plus one optional.  Give a little extra room.
 | ||||||
| 		Data: make(Fields, 5), | 		Data: make(Fields, 6), | ||||||
| 	} | 	} | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
|  | @ -69,6 +101,11 @@ func (entry *Entry) WithError(err error) *Entry { | ||||||
| 	return entry.WithField(ErrorKey, err) | 	return entry.WithField(ErrorKey, err) | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
|  | // Add a context to the Entry.
 | ||||||
|  | func (entry *Entry) WithContext(ctx context.Context) *Entry { | ||||||
|  | 	return &Entry{Logger: entry.Logger, Data: entry.Data, Time: entry.Time, err: entry.err, Context: ctx} | ||||||
|  | } | ||||||
|  | 
 | ||||||
| // Add a single field to the Entry.
 | // Add a single field to the Entry.
 | ||||||
| func (entry *Entry) WithField(key string, value interface{}) *Entry { | func (entry *Entry) WithField(key string, value interface{}) *Entry { | ||||||
| 	return entry.WithFields(Fields{key: value}) | 	return entry.WithFields(Fields{key: value}) | ||||||
|  | @ -80,15 +117,88 @@ func (entry *Entry) WithFields(fields Fields) *Entry { | ||||||
| 	for k, v := range entry.Data { | 	for k, v := range entry.Data { | ||||||
| 		data[k] = v | 		data[k] = v | ||||||
| 	} | 	} | ||||||
|  | 	fieldErr := entry.err | ||||||
| 	for k, v := range fields { | 	for k, v := range fields { | ||||||
|  | 		isErrField := false | ||||||
|  | 		if t := reflect.TypeOf(v); t != nil { | ||||||
|  | 			switch t.Kind() { | ||||||
|  | 			case reflect.Func: | ||||||
|  | 				isErrField = true | ||||||
|  | 			case reflect.Ptr: | ||||||
|  | 				isErrField = t.Elem().Kind() == reflect.Func | ||||||
|  | 			} | ||||||
|  | 		} | ||||||
|  | 		if isErrField { | ||||||
|  | 			tmp := fmt.Sprintf("can not add field %q", k) | ||||||
|  | 			if fieldErr != "" { | ||||||
|  | 				fieldErr = entry.err + ", " + tmp | ||||||
|  | 			} else { | ||||||
|  | 				fieldErr = tmp | ||||||
|  | 			} | ||||||
|  | 		} else { | ||||||
| 			data[k] = v | 			data[k] = v | ||||||
| 		} | 		} | ||||||
| 	return &Entry{Logger: entry.Logger, Data: data, Time: entry.Time} | 	} | ||||||
|  | 	return &Entry{Logger: entry.Logger, Data: data, Time: entry.Time, err: fieldErr, Context: entry.Context} | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| // Overrides the time of the Entry.
 | // Overrides the time of the Entry.
 | ||||||
| func (entry *Entry) WithTime(t time.Time) *Entry { | func (entry *Entry) WithTime(t time.Time) *Entry { | ||||||
| 	return &Entry{Logger: entry.Logger, Data: entry.Data, Time: t} | 	return &Entry{Logger: entry.Logger, Data: entry.Data, Time: t, err: entry.err, Context: entry.Context} | ||||||
|  | } | ||||||
|  | 
 | ||||||
|  | // getPackageName reduces a fully qualified function name to the package name
 | ||||||
|  | // There really ought to be to be a better way...
 | ||||||
|  | func getPackageName(f string) string { | ||||||
|  | 	for { | ||||||
|  | 		lastPeriod := strings.LastIndex(f, ".") | ||||||
|  | 		lastSlash := strings.LastIndex(f, "/") | ||||||
|  | 		if lastPeriod > lastSlash { | ||||||
|  | 			f = f[:lastPeriod] | ||||||
|  | 		} else { | ||||||
|  | 			break | ||||||
|  | 		} | ||||||
|  | 	} | ||||||
|  | 
 | ||||||
|  | 	return f | ||||||
|  | } | ||||||
|  | 
 | ||||||
|  | // getCaller retrieves the name of the first non-logrus calling function
 | ||||||
|  | func getCaller() *runtime.Frame { | ||||||
|  | 
 | ||||||
|  | 	// cache this package's fully-qualified name
 | ||||||
|  | 	callerInitOnce.Do(func() { | ||||||
|  | 		pcs := make([]uintptr, 2) | ||||||
|  | 		_ = runtime.Callers(0, pcs) | ||||||
|  | 		logrusPackage = getPackageName(runtime.FuncForPC(pcs[1]).Name()) | ||||||
|  | 
 | ||||||
|  | 		// now that we have the cache, we can skip a minimum count of known-logrus functions
 | ||||||
|  | 		// XXX this is dubious, the number of frames may vary
 | ||||||
|  | 		minimumCallerDepth = knownLogrusFrames | ||||||
|  | 	}) | ||||||
|  | 
 | ||||||
|  | 	// Restrict the lookback frames to avoid runaway lookups
 | ||||||
|  | 	pcs := make([]uintptr, maximumCallerDepth) | ||||||
|  | 	depth := runtime.Callers(minimumCallerDepth, pcs) | ||||||
|  | 	frames := runtime.CallersFrames(pcs[:depth]) | ||||||
|  | 
 | ||||||
|  | 	for f, again := frames.Next(); again; f, again = frames.Next() { | ||||||
|  | 		pkg := getPackageName(f.Function) | ||||||
|  | 
 | ||||||
|  | 		// If the caller isn't part of this package, we're done
 | ||||||
|  | 		if pkg != logrusPackage { | ||||||
|  | 			return &f | ||||||
|  | 		} | ||||||
|  | 	} | ||||||
|  | 
 | ||||||
|  | 	// if we got here, we failed to find the caller's context
 | ||||||
|  | 	return nil | ||||||
|  | } | ||||||
|  | 
 | ||||||
|  | func (entry Entry) HasCaller() (has bool) { | ||||||
|  | 	return entry.Logger != nil && | ||||||
|  | 		entry.Logger.ReportCaller && | ||||||
|  | 		entry.Caller != nil | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| // This function is not declared with a pointer value because otherwise
 | // This function is not declared with a pointer value because otherwise
 | ||||||
|  | @ -107,6 +217,9 @@ func (entry Entry) log(level Level, msg string) { | ||||||
| 
 | 
 | ||||||
| 	entry.Level = level | 	entry.Level = level | ||||||
| 	entry.Message = msg | 	entry.Message = msg | ||||||
|  | 	if entry.Logger.ReportCaller { | ||||||
|  | 		entry.Caller = getCaller() | ||||||
|  | 	} | ||||||
| 
 | 
 | ||||||
| 	entry.fireHooks() | 	entry.fireHooks() | ||||||
| 
 | 
 | ||||||
|  | @ -137,9 +250,9 @@ func (entry *Entry) fireHooks() { | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (entry *Entry) write() { | func (entry *Entry) write() { | ||||||
| 	serialized, err := entry.Logger.Formatter.Format(entry) |  | ||||||
| 	entry.Logger.mu.Lock() | 	entry.Logger.mu.Lock() | ||||||
| 	defer entry.Logger.mu.Unlock() | 	defer entry.Logger.mu.Unlock() | ||||||
|  | 	serialized, err := entry.Logger.Formatter.Format(entry) | ||||||
| 	if err != nil { | 	if err != nil { | ||||||
| 		fmt.Fprintf(os.Stderr, "Failed to obtain reader, %v\n", err) | 		fmt.Fprintf(os.Stderr, "Failed to obtain reader, %v\n", err) | ||||||
| 	} else { | 	} else { | ||||||
|  | @ -150,26 +263,30 @@ func (entry *Entry) write() { | ||||||
| 	} | 	} | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (entry *Entry) Debug(args ...interface{}) { | func (entry *Entry) Log(level Level, args ...interface{}) { | ||||||
| 	if entry.Logger.level() >= DebugLevel { | 	if entry.Logger.IsLevelEnabled(level) { | ||||||
| 		entry.log(DebugLevel, fmt.Sprint(args...)) | 		entry.log(level, fmt.Sprint(args...)) | ||||||
| 	} | 	} | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
|  | func (entry *Entry) Trace(args ...interface{}) { | ||||||
|  | 	entry.Log(TraceLevel, args...) | ||||||
|  | } | ||||||
|  | 
 | ||||||
|  | func (entry *Entry) Debug(args ...interface{}) { | ||||||
|  | 	entry.Log(DebugLevel, args...) | ||||||
|  | } | ||||||
|  | 
 | ||||||
| func (entry *Entry) Print(args ...interface{}) { | func (entry *Entry) Print(args ...interface{}) { | ||||||
| 	entry.Info(args...) | 	entry.Info(args...) | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (entry *Entry) Info(args ...interface{}) { | func (entry *Entry) Info(args ...interface{}) { | ||||||
| 	if entry.Logger.level() >= InfoLevel { | 	entry.Log(InfoLevel, args...) | ||||||
| 		entry.log(InfoLevel, fmt.Sprint(args...)) |  | ||||||
| 	} |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (entry *Entry) Warn(args ...interface{}) { | func (entry *Entry) Warn(args ...interface{}) { | ||||||
| 	if entry.Logger.level() >= WarnLevel { | 	entry.Log(WarnLevel, args...) | ||||||
| 		entry.log(WarnLevel, fmt.Sprint(args...)) |  | ||||||
| 	} |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (entry *Entry) Warning(args ...interface{}) { | func (entry *Entry) Warning(args ...interface{}) { | ||||||
|  | @ -177,37 +294,37 @@ func (entry *Entry) Warning(args ...interface{}) { | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (entry *Entry) Error(args ...interface{}) { | func (entry *Entry) Error(args ...interface{}) { | ||||||
| 	if entry.Logger.level() >= ErrorLevel { | 	entry.Log(ErrorLevel, args...) | ||||||
| 		entry.log(ErrorLevel, fmt.Sprint(args...)) |  | ||||||
| 	} |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (entry *Entry) Fatal(args ...interface{}) { | func (entry *Entry) Fatal(args ...interface{}) { | ||||||
| 	if entry.Logger.level() >= FatalLevel { | 	entry.Log(FatalLevel, args...) | ||||||
| 		entry.log(FatalLevel, fmt.Sprint(args...)) | 	entry.Logger.Exit(1) | ||||||
| 	} |  | ||||||
| 	Exit(1) |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (entry *Entry) Panic(args ...interface{}) { | func (entry *Entry) Panic(args ...interface{}) { | ||||||
| 	if entry.Logger.level() >= PanicLevel { | 	entry.Log(PanicLevel, args...) | ||||||
| 		entry.log(PanicLevel, fmt.Sprint(args...)) |  | ||||||
| 	} |  | ||||||
| 	panic(fmt.Sprint(args...)) | 	panic(fmt.Sprint(args...)) | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| // Entry Printf family functions
 | // Entry Printf family functions
 | ||||||
| 
 | 
 | ||||||
| func (entry *Entry) Debugf(format string, args ...interface{}) { | func (entry *Entry) Logf(level Level, format string, args ...interface{}) { | ||||||
| 	if entry.Logger.level() >= DebugLevel { | 	if entry.Logger.IsLevelEnabled(level) { | ||||||
| 		entry.Debug(fmt.Sprintf(format, args...)) | 		entry.Log(level, fmt.Sprintf(format, args...)) | ||||||
| 	} | 	} | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
|  | func (entry *Entry) Tracef(format string, args ...interface{}) { | ||||||
|  | 	entry.Logf(TraceLevel, format, args...) | ||||||
|  | } | ||||||
|  | 
 | ||||||
|  | func (entry *Entry) Debugf(format string, args ...interface{}) { | ||||||
|  | 	entry.Logf(DebugLevel, format, args...) | ||||||
|  | } | ||||||
|  | 
 | ||||||
| func (entry *Entry) Infof(format string, args ...interface{}) { | func (entry *Entry) Infof(format string, args ...interface{}) { | ||||||
| 	if entry.Logger.level() >= InfoLevel { | 	entry.Logf(InfoLevel, format, args...) | ||||||
| 		entry.Info(fmt.Sprintf(format, args...)) |  | ||||||
| 	} |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (entry *Entry) Printf(format string, args ...interface{}) { | func (entry *Entry) Printf(format string, args ...interface{}) { | ||||||
|  | @ -215,9 +332,7 @@ func (entry *Entry) Printf(format string, args ...interface{}) { | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (entry *Entry) Warnf(format string, args ...interface{}) { | func (entry *Entry) Warnf(format string, args ...interface{}) { | ||||||
| 	if entry.Logger.level() >= WarnLevel { | 	entry.Logf(WarnLevel, format, args...) | ||||||
| 		entry.Warn(fmt.Sprintf(format, args...)) |  | ||||||
| 	} |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (entry *Entry) Warningf(format string, args ...interface{}) { | func (entry *Entry) Warningf(format string, args ...interface{}) { | ||||||
|  | @ -225,36 +340,36 @@ func (entry *Entry) Warningf(format string, args ...interface{}) { | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (entry *Entry) Errorf(format string, args ...interface{}) { | func (entry *Entry) Errorf(format string, args ...interface{}) { | ||||||
| 	if entry.Logger.level() >= ErrorLevel { | 	entry.Logf(ErrorLevel, format, args...) | ||||||
| 		entry.Error(fmt.Sprintf(format, args...)) |  | ||||||
| 	} |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (entry *Entry) Fatalf(format string, args ...interface{}) { | func (entry *Entry) Fatalf(format string, args ...interface{}) { | ||||||
| 	if entry.Logger.level() >= FatalLevel { | 	entry.Logf(FatalLevel, format, args...) | ||||||
| 		entry.Fatal(fmt.Sprintf(format, args...)) | 	entry.Logger.Exit(1) | ||||||
| 	} |  | ||||||
| 	Exit(1) |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (entry *Entry) Panicf(format string, args ...interface{}) { | func (entry *Entry) Panicf(format string, args ...interface{}) { | ||||||
| 	if entry.Logger.level() >= PanicLevel { | 	entry.Logf(PanicLevel, format, args...) | ||||||
| 		entry.Panic(fmt.Sprintf(format, args...)) |  | ||||||
| 	} |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| // Entry Println family functions
 | // Entry Println family functions
 | ||||||
| 
 | 
 | ||||||
| func (entry *Entry) Debugln(args ...interface{}) { | func (entry *Entry) Logln(level Level, args ...interface{}) { | ||||||
| 	if entry.Logger.level() >= DebugLevel { | 	if entry.Logger.IsLevelEnabled(level) { | ||||||
| 		entry.Debug(entry.sprintlnn(args...)) | 		entry.Log(level, entry.sprintlnn(args...)) | ||||||
| 	} | 	} | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
|  | func (entry *Entry) Traceln(args ...interface{}) { | ||||||
|  | 	entry.Logln(TraceLevel, args...) | ||||||
|  | } | ||||||
|  | 
 | ||||||
|  | func (entry *Entry) Debugln(args ...interface{}) { | ||||||
|  | 	entry.Logln(DebugLevel, args...) | ||||||
|  | } | ||||||
|  | 
 | ||||||
| func (entry *Entry) Infoln(args ...interface{}) { | func (entry *Entry) Infoln(args ...interface{}) { | ||||||
| 	if entry.Logger.level() >= InfoLevel { | 	entry.Logln(InfoLevel, args...) | ||||||
| 		entry.Info(entry.sprintlnn(args...)) |  | ||||||
| 	} |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (entry *Entry) Println(args ...interface{}) { | func (entry *Entry) Println(args ...interface{}) { | ||||||
|  | @ -262,9 +377,7 @@ func (entry *Entry) Println(args ...interface{}) { | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (entry *Entry) Warnln(args ...interface{}) { | func (entry *Entry) Warnln(args ...interface{}) { | ||||||
| 	if entry.Logger.level() >= WarnLevel { | 	entry.Logln(WarnLevel, args...) | ||||||
| 		entry.Warn(entry.sprintlnn(args...)) |  | ||||||
| 	} |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (entry *Entry) Warningln(args ...interface{}) { | func (entry *Entry) Warningln(args ...interface{}) { | ||||||
|  | @ -272,22 +385,16 @@ func (entry *Entry) Warningln(args ...interface{}) { | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (entry *Entry) Errorln(args ...interface{}) { | func (entry *Entry) Errorln(args ...interface{}) { | ||||||
| 	if entry.Logger.level() >= ErrorLevel { | 	entry.Logln(ErrorLevel, args...) | ||||||
| 		entry.Error(entry.sprintlnn(args...)) |  | ||||||
| 	} |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (entry *Entry) Fatalln(args ...interface{}) { | func (entry *Entry) Fatalln(args ...interface{}) { | ||||||
| 	if entry.Logger.level() >= FatalLevel { | 	entry.Logln(FatalLevel, args...) | ||||||
| 		entry.Fatal(entry.sprintlnn(args...)) | 	entry.Logger.Exit(1) | ||||||
| 	} |  | ||||||
| 	Exit(1) |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (entry *Entry) Panicln(args ...interface{}) { | func (entry *Entry) Panicln(args ...interface{}) { | ||||||
| 	if entry.Logger.level() >= PanicLevel { | 	entry.Logln(PanicLevel, args...) | ||||||
| 		entry.Panic(entry.sprintlnn(args...)) |  | ||||||
| 	} |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| // Sprintlnn => Sprint no newline. This is to get the behavior of how
 | // Sprintlnn => Sprint no newline. This is to get the behavior of how
 | ||||||
|  |  | ||||||
|  | @ -1,6 +1,7 @@ | ||||||
| package logrus | package logrus | ||||||
| 
 | 
 | ||||||
| import ( | import ( | ||||||
|  | 	"context" | ||||||
| 	"io" | 	"io" | ||||||
| 	"time" | 	"time" | ||||||
| ) | ) | ||||||
|  | @ -21,30 +22,33 @@ func SetOutput(out io.Writer) { | ||||||
| 
 | 
 | ||||||
| // SetFormatter sets the standard logger formatter.
 | // SetFormatter sets the standard logger formatter.
 | ||||||
| func SetFormatter(formatter Formatter) { | func SetFormatter(formatter Formatter) { | ||||||
| 	std.mu.Lock() | 	std.SetFormatter(formatter) | ||||||
| 	defer std.mu.Unlock() | } | ||||||
| 	std.Formatter = formatter | 
 | ||||||
|  | // SetReportCaller sets whether the standard logger will include the calling
 | ||||||
|  | // method as a field.
 | ||||||
|  | func SetReportCaller(include bool) { | ||||||
|  | 	std.SetReportCaller(include) | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| // SetLevel sets the standard logger level.
 | // SetLevel sets the standard logger level.
 | ||||||
| func SetLevel(level Level) { | func SetLevel(level Level) { | ||||||
| 	std.mu.Lock() |  | ||||||
| 	defer std.mu.Unlock() |  | ||||||
| 	std.SetLevel(level) | 	std.SetLevel(level) | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| // GetLevel returns the standard logger level.
 | // GetLevel returns the standard logger level.
 | ||||||
| func GetLevel() Level { | func GetLevel() Level { | ||||||
| 	std.mu.Lock() | 	return std.GetLevel() | ||||||
| 	defer std.mu.Unlock() | } | ||||||
| 	return std.level() | 
 | ||||||
|  | // IsLevelEnabled checks if the log level of the standard logger is greater than the level param
 | ||||||
|  | func IsLevelEnabled(level Level) bool { | ||||||
|  | 	return std.IsLevelEnabled(level) | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| // AddHook adds a hook to the standard logger hooks.
 | // AddHook adds a hook to the standard logger hooks.
 | ||||||
| func AddHook(hook Hook) { | func AddHook(hook Hook) { | ||||||
| 	std.mu.Lock() | 	std.AddHook(hook) | ||||||
| 	defer std.mu.Unlock() |  | ||||||
| 	std.Hooks.Add(hook) |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| // WithError creates an entry from the standard logger and adds an error to it, using the value defined in ErrorKey as key.
 | // WithError creates an entry from the standard logger and adds an error to it, using the value defined in ErrorKey as key.
 | ||||||
|  | @ -52,6 +56,11 @@ func WithError(err error) *Entry { | ||||||
| 	return std.WithField(ErrorKey, err) | 	return std.WithField(ErrorKey, err) | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
|  | // WithContext creates an entry from the standard logger and adds a context to it.
 | ||||||
|  | func WithContext(ctx context.Context) *Entry { | ||||||
|  | 	return std.WithContext(ctx) | ||||||
|  | } | ||||||
|  | 
 | ||||||
| // WithField creates an entry from the standard logger and adds a field to
 | // WithField creates an entry from the standard logger and adds a field to
 | ||||||
| // it. If you want multiple fields, use `WithFields`.
 | // it. If you want multiple fields, use `WithFields`.
 | ||||||
| //
 | //
 | ||||||
|  | @ -80,6 +89,11 @@ func WithTime(t time.Time) *Entry { | ||||||
| 	return std.WithTime(t) | 	return std.WithTime(t) | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
|  | // Trace logs a message at level Trace on the standard logger.
 | ||||||
|  | func Trace(args ...interface{}) { | ||||||
|  | 	std.Trace(args...) | ||||||
|  | } | ||||||
|  | 
 | ||||||
| // Debug logs a message at level Debug on the standard logger.
 | // Debug logs a message at level Debug on the standard logger.
 | ||||||
| func Debug(args ...interface{}) { | func Debug(args ...interface{}) { | ||||||
| 	std.Debug(args...) | 	std.Debug(args...) | ||||||
|  | @ -120,6 +134,11 @@ func Fatal(args ...interface{}) { | ||||||
| 	std.Fatal(args...) | 	std.Fatal(args...) | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
|  | // Tracef logs a message at level Trace on the standard logger.
 | ||||||
|  | func Tracef(format string, args ...interface{}) { | ||||||
|  | 	std.Tracef(format, args...) | ||||||
|  | } | ||||||
|  | 
 | ||||||
| // Debugf logs a message at level Debug on the standard logger.
 | // Debugf logs a message at level Debug on the standard logger.
 | ||||||
| func Debugf(format string, args ...interface{}) { | func Debugf(format string, args ...interface{}) { | ||||||
| 	std.Debugf(format, args...) | 	std.Debugf(format, args...) | ||||||
|  | @ -160,6 +179,11 @@ func Fatalf(format string, args ...interface{}) { | ||||||
| 	std.Fatalf(format, args...) | 	std.Fatalf(format, args...) | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
|  | // Traceln logs a message at level Trace on the standard logger.
 | ||||||
|  | func Traceln(args ...interface{}) { | ||||||
|  | 	std.Traceln(args...) | ||||||
|  | } | ||||||
|  | 
 | ||||||
| // Debugln logs a message at level Debug on the standard logger.
 | // Debugln logs a message at level Debug on the standard logger.
 | ||||||
| func Debugln(args ...interface{}) { | func Debugln(args ...interface{}) { | ||||||
| 	std.Debugln(args...) | 	std.Debugln(args...) | ||||||
|  |  | ||||||
|  | @ -2,7 +2,16 @@ package logrus | ||||||
| 
 | 
 | ||||||
| import "time" | import "time" | ||||||
| 
 | 
 | ||||||
| const defaultTimestampFormat = time.RFC3339 | // Default key names for the default fields
 | ||||||
|  | const ( | ||||||
|  | 	defaultTimestampFormat = time.RFC3339 | ||||||
|  | 	FieldKeyMsg            = "msg" | ||||||
|  | 	FieldKeyLevel          = "level" | ||||||
|  | 	FieldKeyTime           = "time" | ||||||
|  | 	FieldKeyLogrusError    = "logrus_error" | ||||||
|  | 	FieldKeyFunc           = "func" | ||||||
|  | 	FieldKeyFile           = "file" | ||||||
|  | ) | ||||||
| 
 | 
 | ||||||
| // The Formatter interface is used to implement a custom Formatter. It takes an
 | // The Formatter interface is used to implement a custom Formatter. It takes an
 | ||||||
| // `Entry`. It exposes all the fields, including the default ones:
 | // `Entry`. It exposes all the fields, including the default ones:
 | ||||||
|  | @ -18,7 +27,7 @@ type Formatter interface { | ||||||
| 	Format(*Entry) ([]byte, error) | 	Format(*Entry) ([]byte, error) | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| // This is to not silently overwrite `time`, `msg` and `level` fields when
 | // This is to not silently overwrite `time`, `msg`, `func` and `level` fields when
 | ||||||
| // dumping it. If this code wasn't there doing:
 | // dumping it. If this code wasn't there doing:
 | ||||||
| //
 | //
 | ||||||
| //  logrus.WithField("level", 1).Info("hello")
 | //  logrus.WithField("level", 1).Info("hello")
 | ||||||
|  | @ -30,7 +39,7 @@ type Formatter interface { | ||||||
| //
 | //
 | ||||||
| // It's not exported because it's still using Data in an opinionated way. It's to
 | // It's not exported because it's still using Data in an opinionated way. It's to
 | ||||||
| // avoid code duplication between the two default formatters.
 | // avoid code duplication between the two default formatters.
 | ||||||
| func prefixFieldClashes(data Fields, fieldMap FieldMap) { | func prefixFieldClashes(data Fields, fieldMap FieldMap, reportCaller bool) { | ||||||
| 	timeKey := fieldMap.resolve(FieldKeyTime) | 	timeKey := fieldMap.resolve(FieldKeyTime) | ||||||
| 	if t, ok := data[timeKey]; ok { | 	if t, ok := data[timeKey]; ok { | ||||||
| 		data["fields."+timeKey] = t | 		data["fields."+timeKey] = t | ||||||
|  | @ -48,4 +57,22 @@ func prefixFieldClashes(data Fields, fieldMap FieldMap) { | ||||||
| 		data["fields."+levelKey] = l | 		data["fields."+levelKey] = l | ||||||
| 		delete(data, levelKey) | 		delete(data, levelKey) | ||||||
| 	} | 	} | ||||||
|  | 
 | ||||||
|  | 	logrusErrKey := fieldMap.resolve(FieldKeyLogrusError) | ||||||
|  | 	if l, ok := data[logrusErrKey]; ok { | ||||||
|  | 		data["fields."+logrusErrKey] = l | ||||||
|  | 		delete(data, logrusErrKey) | ||||||
|  | 	} | ||||||
|  | 
 | ||||||
|  | 	// If reportCaller is not set, 'func' will not conflict.
 | ||||||
|  | 	if reportCaller { | ||||||
|  | 		funcKey := fieldMap.resolve(FieldKeyFunc) | ||||||
|  | 		if l, ok := data[funcKey]; ok { | ||||||
|  | 			data["fields."+funcKey] = l | ||||||
|  | 		} | ||||||
|  | 		fileKey := fieldMap.resolve(FieldKeyFile) | ||||||
|  | 		if l, ok := data[fileKey]; ok { | ||||||
|  | 			data["fields."+fileKey] = l | ||||||
|  | 		} | ||||||
|  | 	} | ||||||
| } | } | ||||||
|  |  | ||||||
|  | @ -0,0 +1,10 @@ | ||||||
|  | module github.com/sirupsen/logrus | ||||||
|  | 
 | ||||||
|  | require ( | ||||||
|  | 	github.com/davecgh/go-spew v1.1.1 // indirect | ||||||
|  | 	github.com/konsorten/go-windows-terminal-sequences v1.0.1 | ||||||
|  | 	github.com/pmezard/go-difflib v1.0.0 // indirect | ||||||
|  | 	github.com/stretchr/objx v0.1.1 // indirect | ||||||
|  | 	github.com/stretchr/testify v1.2.2 | ||||||
|  | 	golang.org/x/sys v0.0.0-20190422165155-953cdadca894 | ||||||
|  | ) | ||||||
|  | @ -0,0 +1,16 @@ | ||||||
|  | github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c= | ||||||
|  | github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= | ||||||
|  | github.com/konsorten/go-windows-terminal-sequences v0.0.0-20180402223658-b729f2633dfe h1:CHRGQ8V7OlCYtwaKPJi3iA7J+YdNKdo8j7nG5IgDhjs= | ||||||
|  | github.com/konsorten/go-windows-terminal-sequences v0.0.0-20180402223658-b729f2633dfe/go.mod h1:T0+1ngSBFLxvqU3pZ+m/2kptfBszLMUkC4ZK/EgS/cQ= | ||||||
|  | github.com/konsorten/go-windows-terminal-sequences v1.0.1 h1:mweAR1A6xJ3oS2pRaGiHgQ4OO8tzTaLawm8vnODuwDk= | ||||||
|  | github.com/konsorten/go-windows-terminal-sequences v1.0.1/go.mod h1:T0+1ngSBFLxvqU3pZ+m/2kptfBszLMUkC4ZK/EgS/cQ= | ||||||
|  | github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= | ||||||
|  | github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= | ||||||
|  | github.com/stretchr/objx v0.1.1 h1:2vfRuCMp5sSVIDSqO8oNnWJq7mPa6KVP3iPIwFBuy8A= | ||||||
|  | github.com/stretchr/objx v0.1.1/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME= | ||||||
|  | github.com/stretchr/testify v1.2.2 h1:bSDNvY7ZPG5RlJ8otE/7V6gMiyenm9RtJ7IUVIAoJ1w= | ||||||
|  | github.com/stretchr/testify v1.2.2/go.mod h1:a8OnRcib4nhh0OaRAV+Yts87kKdq0PP7pXfy6kDkUVs= | ||||||
|  | golang.org/x/sys v0.0.0-20180905080454-ebe1bf3edb33 h1:I6FyU15t786LL7oL/hn43zqTuEGr4PN7F4XJ1p4E3Y8= | ||||||
|  | golang.org/x/sys v0.0.0-20180905080454-ebe1bf3edb33/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= | ||||||
|  | golang.org/x/sys v0.0.0-20190422165155-953cdadca894 h1:Cz4ceDQGXuKRnVBDTS23GTn/pU5OE2C0WrNTOYK1Uuc= | ||||||
|  | golang.org/x/sys v0.0.0-20190422165155-953cdadca894/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= | ||||||
|  | @ -1,8 +1,10 @@ | ||||||
| package logrus | package logrus | ||||||
| 
 | 
 | ||||||
| import ( | import ( | ||||||
|  | 	"bytes" | ||||||
| 	"encoding/json" | 	"encoding/json" | ||||||
| 	"fmt" | 	"fmt" | ||||||
|  | 	"runtime" | ||||||
| ) | ) | ||||||
| 
 | 
 | ||||||
| type fieldKey string | type fieldKey string | ||||||
|  | @ -10,13 +12,6 @@ type fieldKey string | ||||||
| // FieldMap allows customization of the key names for default fields.
 | // FieldMap allows customization of the key names for default fields.
 | ||||||
| type FieldMap map[fieldKey]string | type FieldMap map[fieldKey]string | ||||||
| 
 | 
 | ||||||
| // Default key names for the default fields
 |  | ||||||
| const ( |  | ||||||
| 	FieldKeyMsg   = "msg" |  | ||||||
| 	FieldKeyLevel = "level" |  | ||||||
| 	FieldKeyTime  = "time" |  | ||||||
| ) |  | ||||||
| 
 |  | ||||||
| func (f FieldMap) resolve(key fieldKey) string { | func (f FieldMap) resolve(key fieldKey) string { | ||||||
| 	if k, ok := f[key]; ok { | 	if k, ok := f[key]; ok { | ||||||
| 		return k | 		return k | ||||||
|  | @ -43,14 +38,24 @@ type JSONFormatter struct { | ||||||
| 	// 		 FieldKeyTime:  "@timestamp",
 | 	// 		 FieldKeyTime:  "@timestamp",
 | ||||||
| 	// 		 FieldKeyLevel: "@level",
 | 	// 		 FieldKeyLevel: "@level",
 | ||||||
| 	// 		 FieldKeyMsg:   "@message",
 | 	// 		 FieldKeyMsg:   "@message",
 | ||||||
|  | 	// 		 FieldKeyFunc:  "@caller",
 | ||||||
| 	//    },
 | 	//    },
 | ||||||
| 	// }
 | 	// }
 | ||||||
| 	FieldMap FieldMap | 	FieldMap FieldMap | ||||||
|  | 
 | ||||||
|  | 	// CallerPrettyfier can be set by the user to modify the content
 | ||||||
|  | 	// of the function and file keys in the json data when ReportCaller is
 | ||||||
|  | 	// activated. If any of the returned value is the empty string the
 | ||||||
|  | 	// corresponding key will be removed from json fields.
 | ||||||
|  | 	CallerPrettyfier func(*runtime.Frame) (function string, file string) | ||||||
|  | 
 | ||||||
|  | 	// PrettyPrint will indent all json logs
 | ||||||
|  | 	PrettyPrint bool | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| // Format renders a single log entry
 | // Format renders a single log entry
 | ||||||
| func (f *JSONFormatter) Format(entry *Entry) ([]byte, error) { | func (f *JSONFormatter) Format(entry *Entry) ([]byte, error) { | ||||||
| 	data := make(Fields, len(entry.Data)+3) | 	data := make(Fields, len(entry.Data)+4) | ||||||
| 	for k, v := range entry.Data { | 	for k, v := range entry.Data { | ||||||
| 		switch v := v.(type) { | 		switch v := v.(type) { | ||||||
| 		case error: | 		case error: | ||||||
|  | @ -68,22 +73,49 @@ func (f *JSONFormatter) Format(entry *Entry) ([]byte, error) { | ||||||
| 		data = newData | 		data = newData | ||||||
| 	} | 	} | ||||||
| 
 | 
 | ||||||
| 	prefixFieldClashes(data, f.FieldMap) | 	prefixFieldClashes(data, f.FieldMap, entry.HasCaller()) | ||||||
| 
 | 
 | ||||||
| 	timestampFormat := f.TimestampFormat | 	timestampFormat := f.TimestampFormat | ||||||
| 	if timestampFormat == "" { | 	if timestampFormat == "" { | ||||||
| 		timestampFormat = defaultTimestampFormat | 		timestampFormat = defaultTimestampFormat | ||||||
| 	} | 	} | ||||||
| 
 | 
 | ||||||
|  | 	if entry.err != "" { | ||||||
|  | 		data[f.FieldMap.resolve(FieldKeyLogrusError)] = entry.err | ||||||
|  | 	} | ||||||
| 	if !f.DisableTimestamp { | 	if !f.DisableTimestamp { | ||||||
| 		data[f.FieldMap.resolve(FieldKeyTime)] = entry.Time.Format(timestampFormat) | 		data[f.FieldMap.resolve(FieldKeyTime)] = entry.Time.Format(timestampFormat) | ||||||
| 	} | 	} | ||||||
| 	data[f.FieldMap.resolve(FieldKeyMsg)] = entry.Message | 	data[f.FieldMap.resolve(FieldKeyMsg)] = entry.Message | ||||||
| 	data[f.FieldMap.resolve(FieldKeyLevel)] = entry.Level.String() | 	data[f.FieldMap.resolve(FieldKeyLevel)] = entry.Level.String() | ||||||
| 
 | 	if entry.HasCaller() { | ||||||
| 	serialized, err := json.Marshal(data) | 		funcVal := entry.Caller.Function | ||||||
| 	if err != nil { | 		fileVal := fmt.Sprintf("%s:%d", entry.Caller.File, entry.Caller.Line) | ||||||
| 		return nil, fmt.Errorf("Failed to marshal fields to JSON, %v", err) | 		if f.CallerPrettyfier != nil { | ||||||
|  | 			funcVal, fileVal = f.CallerPrettyfier(entry.Caller) | ||||||
| 		} | 		} | ||||||
| 	return append(serialized, '\n'), nil | 		if funcVal != "" { | ||||||
|  | 			data[f.FieldMap.resolve(FieldKeyFunc)] = funcVal | ||||||
|  | 		} | ||||||
|  | 		if fileVal != "" { | ||||||
|  | 			data[f.FieldMap.resolve(FieldKeyFile)] = fileVal | ||||||
|  | 		} | ||||||
|  | 	} | ||||||
|  | 
 | ||||||
|  | 	var b *bytes.Buffer | ||||||
|  | 	if entry.Buffer != nil { | ||||||
|  | 		b = entry.Buffer | ||||||
|  | 	} else { | ||||||
|  | 		b = &bytes.Buffer{} | ||||||
|  | 	} | ||||||
|  | 
 | ||||||
|  | 	encoder := json.NewEncoder(b) | ||||||
|  | 	if f.PrettyPrint { | ||||||
|  | 		encoder.SetIndent("", "  ") | ||||||
|  | 	} | ||||||
|  | 	if err := encoder.Encode(data); err != nil { | ||||||
|  | 		return nil, fmt.Errorf("failed to marshal fields to JSON, %v", err) | ||||||
|  | 	} | ||||||
|  | 
 | ||||||
|  | 	return b.Bytes(), nil | ||||||
| } | } | ||||||
|  |  | ||||||
|  | @ -1,6 +1,7 @@ | ||||||
| package logrus | package logrus | ||||||
| 
 | 
 | ||||||
| import ( | import ( | ||||||
|  | 	"context" | ||||||
| 	"io" | 	"io" | ||||||
| 	"os" | 	"os" | ||||||
| 	"sync" | 	"sync" | ||||||
|  | @ -11,7 +12,7 @@ import ( | ||||||
| type Logger struct { | type Logger struct { | ||||||
| 	// The logs are `io.Copy`'d to this in a mutex. It's common to set this to a
 | 	// The logs are `io.Copy`'d to this in a mutex. It's common to set this to a
 | ||||||
| 	// file, or leave it default which is `os.Stderr`. You can also set this to
 | 	// file, or leave it default which is `os.Stderr`. You can also set this to
 | ||||||
| 	// something more adventorous, such as logging to Kafka.
 | 	// something more adventurous, such as logging to Kafka.
 | ||||||
| 	Out io.Writer | 	Out io.Writer | ||||||
| 	// Hooks for the logger instance. These allow firing events based on logging
 | 	// Hooks for the logger instance. These allow firing events based on logging
 | ||||||
| 	// levels and log entries. For example, to send errors to an error tracking
 | 	// levels and log entries. For example, to send errors to an error tracking
 | ||||||
|  | @ -24,6 +25,10 @@ type Logger struct { | ||||||
| 	// own that implements the `Formatter` interface, see the `README` or included
 | 	// own that implements the `Formatter` interface, see the `README` or included
 | ||||||
| 	// formatters for examples.
 | 	// formatters for examples.
 | ||||||
| 	Formatter Formatter | 	Formatter Formatter | ||||||
|  | 
 | ||||||
|  | 	// Flag for whether to log caller info (off by default)
 | ||||||
|  | 	ReportCaller bool | ||||||
|  | 
 | ||||||
| 	// The logging level the logger should log at. This is typically (and defaults
 | 	// The logging level the logger should log at. This is typically (and defaults
 | ||||||
| 	// to) `logrus.Info`, which allows Info(), Warn(), Error() and Fatal() to be
 | 	// to) `logrus.Info`, which allows Info(), Warn(), Error() and Fatal() to be
 | ||||||
| 	// logged.
 | 	// logged.
 | ||||||
|  | @ -32,8 +37,12 @@ type Logger struct { | ||||||
| 	mu MutexWrap | 	mu MutexWrap | ||||||
| 	// Reusable empty entry
 | 	// Reusable empty entry
 | ||||||
| 	entryPool sync.Pool | 	entryPool sync.Pool | ||||||
|  | 	// Function to exit the application, defaults to `os.Exit()`
 | ||||||
|  | 	ExitFunc exitFunc | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
|  | type exitFunc func(int) | ||||||
|  | 
 | ||||||
| type MutexWrap struct { | type MutexWrap struct { | ||||||
| 	lock     sync.Mutex | 	lock     sync.Mutex | ||||||
| 	disabled bool | 	disabled bool | ||||||
|  | @ -73,6 +82,8 @@ func New() *Logger { | ||||||
| 		Formatter:    new(TextFormatter), | 		Formatter:    new(TextFormatter), | ||||||
| 		Hooks:        make(LevelHooks), | 		Hooks:        make(LevelHooks), | ||||||
| 		Level:        InfoLevel, | 		Level:        InfoLevel, | ||||||
|  | 		ExitFunc:     os.Exit, | ||||||
|  | 		ReportCaller: false, | ||||||
| 	} | 	} | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
|  | @ -85,6 +96,7 @@ func (logger *Logger) newEntry() *Entry { | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (logger *Logger) releaseEntry(entry *Entry) { | func (logger *Logger) releaseEntry(entry *Entry) { | ||||||
|  | 	entry.Data = map[string]interface{}{} | ||||||
| 	logger.entryPool.Put(entry) | 	logger.entryPool.Put(entry) | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
|  | @ -113,6 +125,13 @@ func (logger *Logger) WithError(err error) *Entry { | ||||||
| 	return entry.WithError(err) | 	return entry.WithError(err) | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
|  | // Add a context to the log entry.
 | ||||||
|  | func (logger *Logger) WithContext(ctx context.Context) *Entry { | ||||||
|  | 	entry := logger.newEntry() | ||||||
|  | 	defer logger.releaseEntry(entry) | ||||||
|  | 	return entry.WithContext(ctx) | ||||||
|  | } | ||||||
|  | 
 | ||||||
| // Overrides the time of the log entry.
 | // Overrides the time of the log entry.
 | ||||||
| func (logger *Logger) WithTime(t time.Time) *Entry { | func (logger *Logger) WithTime(t time.Time) *Entry { | ||||||
| 	entry := logger.newEntry() | 	entry := logger.newEntry() | ||||||
|  | @ -120,20 +139,24 @@ func (logger *Logger) WithTime(t time.Time) *Entry { | ||||||
| 	return entry.WithTime(t) | 	return entry.WithTime(t) | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (logger *Logger) Debugf(format string, args ...interface{}) { | func (logger *Logger) Logf(level Level, format string, args ...interface{}) { | ||||||
| 	if logger.level() >= DebugLevel { | 	if logger.IsLevelEnabled(level) { | ||||||
| 		entry := logger.newEntry() | 		entry := logger.newEntry() | ||||||
| 		entry.Debugf(format, args...) | 		entry.Logf(level, format, args...) | ||||||
| 		logger.releaseEntry(entry) | 		logger.releaseEntry(entry) | ||||||
| 	} | 	} | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
|  | func (logger *Logger) Tracef(format string, args ...interface{}) { | ||||||
|  | 	logger.Logf(TraceLevel, format, args...) | ||||||
|  | } | ||||||
|  | 
 | ||||||
|  | func (logger *Logger) Debugf(format string, args ...interface{}) { | ||||||
|  | 	logger.Logf(DebugLevel, format, args...) | ||||||
|  | } | ||||||
|  | 
 | ||||||
| func (logger *Logger) Infof(format string, args ...interface{}) { | func (logger *Logger) Infof(format string, args ...interface{}) { | ||||||
| 	if logger.level() >= InfoLevel { | 	logger.Logf(InfoLevel, format, args...) | ||||||
| 		entry := logger.newEntry() |  | ||||||
| 		entry.Infof(format, args...) |  | ||||||
| 		logger.releaseEntry(entry) |  | ||||||
| 	} |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (logger *Logger) Printf(format string, args ...interface{}) { | func (logger *Logger) Printf(format string, args ...interface{}) { | ||||||
|  | @ -143,123 +166,91 @@ func (logger *Logger) Printf(format string, args ...interface{}) { | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (logger *Logger) Warnf(format string, args ...interface{}) { | func (logger *Logger) Warnf(format string, args ...interface{}) { | ||||||
| 	if logger.level() >= WarnLevel { | 	logger.Logf(WarnLevel, format, args...) | ||||||
| 		entry := logger.newEntry() |  | ||||||
| 		entry.Warnf(format, args...) |  | ||||||
| 		logger.releaseEntry(entry) |  | ||||||
| 	} |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (logger *Logger) Warningf(format string, args ...interface{}) { | func (logger *Logger) Warningf(format string, args ...interface{}) { | ||||||
| 	if logger.level() >= WarnLevel { | 	logger.Warnf(format, args...) | ||||||
| 		entry := logger.newEntry() |  | ||||||
| 		entry.Warnf(format, args...) |  | ||||||
| 		logger.releaseEntry(entry) |  | ||||||
| 	} |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (logger *Logger) Errorf(format string, args ...interface{}) { | func (logger *Logger) Errorf(format string, args ...interface{}) { | ||||||
| 	if logger.level() >= ErrorLevel { | 	logger.Logf(ErrorLevel, format, args...) | ||||||
| 		entry := logger.newEntry() |  | ||||||
| 		entry.Errorf(format, args...) |  | ||||||
| 		logger.releaseEntry(entry) |  | ||||||
| 	} |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (logger *Logger) Fatalf(format string, args ...interface{}) { | func (logger *Logger) Fatalf(format string, args ...interface{}) { | ||||||
| 	if logger.level() >= FatalLevel { | 	logger.Logf(FatalLevel, format, args...) | ||||||
| 		entry := logger.newEntry() | 	logger.Exit(1) | ||||||
| 		entry.Fatalf(format, args...) |  | ||||||
| 		logger.releaseEntry(entry) |  | ||||||
| 	} |  | ||||||
| 	Exit(1) |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (logger *Logger) Panicf(format string, args ...interface{}) { | func (logger *Logger) Panicf(format string, args ...interface{}) { | ||||||
| 	if logger.level() >= PanicLevel { | 	logger.Logf(PanicLevel, format, args...) | ||||||
|  | } | ||||||
|  | 
 | ||||||
|  | func (logger *Logger) Log(level Level, args ...interface{}) { | ||||||
|  | 	if logger.IsLevelEnabled(level) { | ||||||
| 		entry := logger.newEntry() | 		entry := logger.newEntry() | ||||||
| 		entry.Panicf(format, args...) | 		entry.Log(level, args...) | ||||||
| 		logger.releaseEntry(entry) | 		logger.releaseEntry(entry) | ||||||
| 	} | 	} | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
|  | func (logger *Logger) Trace(args ...interface{}) { | ||||||
|  | 	logger.Log(TraceLevel, args...) | ||||||
|  | } | ||||||
|  | 
 | ||||||
| func (logger *Logger) Debug(args ...interface{}) { | func (logger *Logger) Debug(args ...interface{}) { | ||||||
| 	if logger.level() >= DebugLevel { | 	logger.Log(DebugLevel, args...) | ||||||
| 		entry := logger.newEntry() |  | ||||||
| 		entry.Debug(args...) |  | ||||||
| 		logger.releaseEntry(entry) |  | ||||||
| 	} |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (logger *Logger) Info(args ...interface{}) { | func (logger *Logger) Info(args ...interface{}) { | ||||||
| 	if logger.level() >= InfoLevel { | 	logger.Log(InfoLevel, args...) | ||||||
| 		entry := logger.newEntry() |  | ||||||
| 		entry.Info(args...) |  | ||||||
| 		logger.releaseEntry(entry) |  | ||||||
| 	} |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (logger *Logger) Print(args ...interface{}) { | func (logger *Logger) Print(args ...interface{}) { | ||||||
| 	entry := logger.newEntry() | 	entry := logger.newEntry() | ||||||
| 	entry.Info(args...) | 	entry.Print(args...) | ||||||
| 	logger.releaseEntry(entry) | 	logger.releaseEntry(entry) | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (logger *Logger) Warn(args ...interface{}) { | func (logger *Logger) Warn(args ...interface{}) { | ||||||
| 	if logger.level() >= WarnLevel { | 	logger.Log(WarnLevel, args...) | ||||||
| 		entry := logger.newEntry() |  | ||||||
| 		entry.Warn(args...) |  | ||||||
| 		logger.releaseEntry(entry) |  | ||||||
| 	} |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (logger *Logger) Warning(args ...interface{}) { | func (logger *Logger) Warning(args ...interface{}) { | ||||||
| 	if logger.level() >= WarnLevel { | 	logger.Warn(args...) | ||||||
| 		entry := logger.newEntry() |  | ||||||
| 		entry.Warn(args...) |  | ||||||
| 		logger.releaseEntry(entry) |  | ||||||
| 	} |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (logger *Logger) Error(args ...interface{}) { | func (logger *Logger) Error(args ...interface{}) { | ||||||
| 	if logger.level() >= ErrorLevel { | 	logger.Log(ErrorLevel, args...) | ||||||
| 		entry := logger.newEntry() |  | ||||||
| 		entry.Error(args...) |  | ||||||
| 		logger.releaseEntry(entry) |  | ||||||
| 	} |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (logger *Logger) Fatal(args ...interface{}) { | func (logger *Logger) Fatal(args ...interface{}) { | ||||||
| 	if logger.level() >= FatalLevel { | 	logger.Log(FatalLevel, args...) | ||||||
| 		entry := logger.newEntry() | 	logger.Exit(1) | ||||||
| 		entry.Fatal(args...) |  | ||||||
| 		logger.releaseEntry(entry) |  | ||||||
| 	} |  | ||||||
| 	Exit(1) |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (logger *Logger) Panic(args ...interface{}) { | func (logger *Logger) Panic(args ...interface{}) { | ||||||
| 	if logger.level() >= PanicLevel { | 	logger.Log(PanicLevel, args...) | ||||||
|  | } | ||||||
|  | 
 | ||||||
|  | func (logger *Logger) Logln(level Level, args ...interface{}) { | ||||||
|  | 	if logger.IsLevelEnabled(level) { | ||||||
| 		entry := logger.newEntry() | 		entry := logger.newEntry() | ||||||
| 		entry.Panic(args...) | 		entry.Logln(level, args...) | ||||||
| 		logger.releaseEntry(entry) | 		logger.releaseEntry(entry) | ||||||
| 	} | 	} | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
|  | func (logger *Logger) Traceln(args ...interface{}) { | ||||||
|  | 	logger.Logln(TraceLevel, args...) | ||||||
|  | } | ||||||
|  | 
 | ||||||
| func (logger *Logger) Debugln(args ...interface{}) { | func (logger *Logger) Debugln(args ...interface{}) { | ||||||
| 	if logger.level() >= DebugLevel { | 	logger.Logln(DebugLevel, args...) | ||||||
| 		entry := logger.newEntry() |  | ||||||
| 		entry.Debugln(args...) |  | ||||||
| 		logger.releaseEntry(entry) |  | ||||||
| 	} |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (logger *Logger) Infoln(args ...interface{}) { | func (logger *Logger) Infoln(args ...interface{}) { | ||||||
| 	if logger.level() >= InfoLevel { | 	logger.Logln(InfoLevel, args...) | ||||||
| 		entry := logger.newEntry() |  | ||||||
| 		entry.Infoln(args...) |  | ||||||
| 		logger.releaseEntry(entry) |  | ||||||
| 	} |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (logger *Logger) Println(args ...interface{}) { | func (logger *Logger) Println(args ...interface{}) { | ||||||
|  | @ -269,44 +260,32 @@ func (logger *Logger) Println(args ...interface{}) { | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (logger *Logger) Warnln(args ...interface{}) { | func (logger *Logger) Warnln(args ...interface{}) { | ||||||
| 	if logger.level() >= WarnLevel { | 	logger.Logln(WarnLevel, args...) | ||||||
| 		entry := logger.newEntry() |  | ||||||
| 		entry.Warnln(args...) |  | ||||||
| 		logger.releaseEntry(entry) |  | ||||||
| 	} |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (logger *Logger) Warningln(args ...interface{}) { | func (logger *Logger) Warningln(args ...interface{}) { | ||||||
| 	if logger.level() >= WarnLevel { | 	logger.Warnln(args...) | ||||||
| 		entry := logger.newEntry() |  | ||||||
| 		entry.Warnln(args...) |  | ||||||
| 		logger.releaseEntry(entry) |  | ||||||
| 	} |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (logger *Logger) Errorln(args ...interface{}) { | func (logger *Logger) Errorln(args ...interface{}) { | ||||||
| 	if logger.level() >= ErrorLevel { | 	logger.Logln(ErrorLevel, args...) | ||||||
| 		entry := logger.newEntry() |  | ||||||
| 		entry.Errorln(args...) |  | ||||||
| 		logger.releaseEntry(entry) |  | ||||||
| 	} |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (logger *Logger) Fatalln(args ...interface{}) { | func (logger *Logger) Fatalln(args ...interface{}) { | ||||||
| 	if logger.level() >= FatalLevel { | 	logger.Logln(FatalLevel, args...) | ||||||
| 		entry := logger.newEntry() | 	logger.Exit(1) | ||||||
| 		entry.Fatalln(args...) |  | ||||||
| 		logger.releaseEntry(entry) |  | ||||||
| 	} |  | ||||||
| 	Exit(1) |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (logger *Logger) Panicln(args ...interface{}) { | func (logger *Logger) Panicln(args ...interface{}) { | ||||||
| 	if logger.level() >= PanicLevel { | 	logger.Logln(PanicLevel, args...) | ||||||
| 		entry := logger.newEntry() | } | ||||||
| 		entry.Panicln(args...) | 
 | ||||||
| 		logger.releaseEntry(entry) | func (logger *Logger) Exit(code int) { | ||||||
|  | 	runHandlers() | ||||||
|  | 	if logger.ExitFunc == nil { | ||||||
|  | 		logger.ExitFunc = os.Exit | ||||||
| 	} | 	} | ||||||
|  | 	logger.ExitFunc(code) | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| //When file is opened with appending mode, it's safe to
 | //When file is opened with appending mode, it's safe to
 | ||||||
|  | @ -320,18 +299,53 @@ func (logger *Logger) level() Level { | ||||||
| 	return Level(atomic.LoadUint32((*uint32)(&logger.Level))) | 	return Level(atomic.LoadUint32((*uint32)(&logger.Level))) | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
|  | // SetLevel sets the logger level.
 | ||||||
| func (logger *Logger) SetLevel(level Level) { | func (logger *Logger) SetLevel(level Level) { | ||||||
| 	atomic.StoreUint32((*uint32)(&logger.Level), uint32(level)) | 	atomic.StoreUint32((*uint32)(&logger.Level), uint32(level)) | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (logger *Logger) SetOutput(out io.Writer) { | // GetLevel returns the logger level.
 | ||||||
| 	logger.mu.Lock() | func (logger *Logger) GetLevel() Level { | ||||||
| 	defer logger.mu.Unlock() | 	return logger.level() | ||||||
| 	logger.Out = out |  | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
|  | // AddHook adds a hook to the logger hooks.
 | ||||||
| func (logger *Logger) AddHook(hook Hook) { | func (logger *Logger) AddHook(hook Hook) { | ||||||
| 	logger.mu.Lock() | 	logger.mu.Lock() | ||||||
| 	defer logger.mu.Unlock() | 	defer logger.mu.Unlock() | ||||||
| 	logger.Hooks.Add(hook) | 	logger.Hooks.Add(hook) | ||||||
| } | } | ||||||
|  | 
 | ||||||
|  | // IsLevelEnabled checks if the log level of the logger is greater than the level param
 | ||||||
|  | func (logger *Logger) IsLevelEnabled(level Level) bool { | ||||||
|  | 	return logger.level() >= level | ||||||
|  | } | ||||||
|  | 
 | ||||||
|  | // SetFormatter sets the logger formatter.
 | ||||||
|  | func (logger *Logger) SetFormatter(formatter Formatter) { | ||||||
|  | 	logger.mu.Lock() | ||||||
|  | 	defer logger.mu.Unlock() | ||||||
|  | 	logger.Formatter = formatter | ||||||
|  | } | ||||||
|  | 
 | ||||||
|  | // SetOutput sets the logger output.
 | ||||||
|  | func (logger *Logger) SetOutput(output io.Writer) { | ||||||
|  | 	logger.mu.Lock() | ||||||
|  | 	defer logger.mu.Unlock() | ||||||
|  | 	logger.Out = output | ||||||
|  | } | ||||||
|  | 
 | ||||||
|  | func (logger *Logger) SetReportCaller(reportCaller bool) { | ||||||
|  | 	logger.mu.Lock() | ||||||
|  | 	defer logger.mu.Unlock() | ||||||
|  | 	logger.ReportCaller = reportCaller | ||||||
|  | } | ||||||
|  | 
 | ||||||
|  | // ReplaceHooks replaces the logger hooks and returns the old ones
 | ||||||
|  | func (logger *Logger) ReplaceHooks(hooks LevelHooks) LevelHooks { | ||||||
|  | 	logger.mu.Lock() | ||||||
|  | 	oldHooks := logger.Hooks | ||||||
|  | 	logger.Hooks = hooks | ||||||
|  | 	logger.mu.Unlock() | ||||||
|  | 	return oldHooks | ||||||
|  | } | ||||||
|  |  | ||||||
|  | @ -14,22 +14,11 @@ type Level uint32 | ||||||
| 
 | 
 | ||||||
| // Convert the Level to a string. E.g. PanicLevel becomes "panic".
 | // Convert the Level to a string. E.g. PanicLevel becomes "panic".
 | ||||||
| func (level Level) String() string { | func (level Level) String() string { | ||||||
| 	switch level { | 	if b, err := level.MarshalText(); err == nil { | ||||||
| 	case DebugLevel: | 		return string(b) | ||||||
| 		return "debug" | 	} else { | ||||||
| 	case InfoLevel: |  | ||||||
| 		return "info" |  | ||||||
| 	case WarnLevel: |  | ||||||
| 		return "warning" |  | ||||||
| 	case ErrorLevel: |  | ||||||
| 		return "error" |  | ||||||
| 	case FatalLevel: |  | ||||||
| 		return "fatal" |  | ||||||
| 	case PanicLevel: |  | ||||||
| 		return "panic" |  | ||||||
| 	} |  | ||||||
| 
 |  | ||||||
| 		return "unknown" | 		return "unknown" | ||||||
|  | 	} | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| // ParseLevel takes a string level and returns the Logrus log level constant.
 | // ParseLevel takes a string level and returns the Logrus log level constant.
 | ||||||
|  | @ -47,12 +36,47 @@ func ParseLevel(lvl string) (Level, error) { | ||||||
| 		return InfoLevel, nil | 		return InfoLevel, nil | ||||||
| 	case "debug": | 	case "debug": | ||||||
| 		return DebugLevel, nil | 		return DebugLevel, nil | ||||||
|  | 	case "trace": | ||||||
|  | 		return TraceLevel, nil | ||||||
| 	} | 	} | ||||||
| 
 | 
 | ||||||
| 	var l Level | 	var l Level | ||||||
| 	return l, fmt.Errorf("not a valid logrus Level: %q", lvl) | 	return l, fmt.Errorf("not a valid logrus Level: %q", lvl) | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
|  | // UnmarshalText implements encoding.TextUnmarshaler.
 | ||||||
|  | func (level *Level) UnmarshalText(text []byte) error { | ||||||
|  | 	l, err := ParseLevel(string(text)) | ||||||
|  | 	if err != nil { | ||||||
|  | 		return err | ||||||
|  | 	} | ||||||
|  | 
 | ||||||
|  | 	*level = Level(l) | ||||||
|  | 
 | ||||||
|  | 	return nil | ||||||
|  | } | ||||||
|  | 
 | ||||||
|  | func (level Level) MarshalText() ([]byte, error) { | ||||||
|  | 	switch level { | ||||||
|  | 	case TraceLevel: | ||||||
|  | 		return []byte("trace"), nil | ||||||
|  | 	case DebugLevel: | ||||||
|  | 		return []byte("debug"), nil | ||||||
|  | 	case InfoLevel: | ||||||
|  | 		return []byte("info"), nil | ||||||
|  | 	case WarnLevel: | ||||||
|  | 		return []byte("warning"), nil | ||||||
|  | 	case ErrorLevel: | ||||||
|  | 		return []byte("error"), nil | ||||||
|  | 	case FatalLevel: | ||||||
|  | 		return []byte("fatal"), nil | ||||||
|  | 	case PanicLevel: | ||||||
|  | 		return []byte("panic"), nil | ||||||
|  | 	} | ||||||
|  | 
 | ||||||
|  | 	return nil, fmt.Errorf("not a valid logrus level %d", level) | ||||||
|  | } | ||||||
|  | 
 | ||||||
| // A constant exposing all logging levels
 | // A constant exposing all logging levels
 | ||||||
| var AllLevels = []Level{ | var AllLevels = []Level{ | ||||||
| 	PanicLevel, | 	PanicLevel, | ||||||
|  | @ -61,6 +85,7 @@ var AllLevels = []Level{ | ||||||
| 	WarnLevel, | 	WarnLevel, | ||||||
| 	InfoLevel, | 	InfoLevel, | ||||||
| 	DebugLevel, | 	DebugLevel, | ||||||
|  | 	TraceLevel, | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| // These are the different logging levels. You can set the logging level to log
 | // These are the different logging levels. You can set the logging level to log
 | ||||||
|  | @ -69,7 +94,7 @@ const ( | ||||||
| 	// PanicLevel level, highest level of severity. Logs and then calls panic with the
 | 	// PanicLevel level, highest level of severity. Logs and then calls panic with the
 | ||||||
| 	// message passed to Debug, Info, ...
 | 	// message passed to Debug, Info, ...
 | ||||||
| 	PanicLevel Level = iota | 	PanicLevel Level = iota | ||||||
| 	// FatalLevel level. Logs and then calls `os.Exit(1)`. It will exit even if the
 | 	// FatalLevel level. Logs and then calls `logger.Exit(1)`. It will exit even if the
 | ||||||
| 	// logging level is set to Panic.
 | 	// logging level is set to Panic.
 | ||||||
| 	FatalLevel | 	FatalLevel | ||||||
| 	// ErrorLevel level. Logs. Used for errors that should definitely be noted.
 | 	// ErrorLevel level. Logs. Used for errors that should definitely be noted.
 | ||||||
|  | @ -82,6 +107,8 @@ const ( | ||||||
| 	InfoLevel | 	InfoLevel | ||||||
| 	// DebugLevel level. Usually only enabled when debugging. Very verbose logging.
 | 	// DebugLevel level. Usually only enabled when debugging. Very verbose logging.
 | ||||||
| 	DebugLevel | 	DebugLevel | ||||||
|  | 	// TraceLevel level. Designates finer-grained informational events than the Debug.
 | ||||||
|  | 	TraceLevel | ||||||
| ) | ) | ||||||
| 
 | 
 | ||||||
| // Won't compile if StdLogger can't be realized by a log.Logger
 | // Won't compile if StdLogger can't be realized by a log.Logger
 | ||||||
|  | @ -140,4 +167,20 @@ type FieldLogger interface { | ||||||
| 	Errorln(args ...interface{}) | 	Errorln(args ...interface{}) | ||||||
| 	Fatalln(args ...interface{}) | 	Fatalln(args ...interface{}) | ||||||
| 	Panicln(args ...interface{}) | 	Panicln(args ...interface{}) | ||||||
|  | 
 | ||||||
|  | 	// IsDebugEnabled() bool
 | ||||||
|  | 	// IsInfoEnabled() bool
 | ||||||
|  | 	// IsWarnEnabled() bool
 | ||||||
|  | 	// IsErrorEnabled() bool
 | ||||||
|  | 	// IsFatalEnabled() bool
 | ||||||
|  | 	// IsPanicEnabled() bool
 | ||||||
|  | } | ||||||
|  | 
 | ||||||
|  | // Ext1FieldLogger (the first extension to FieldLogger) is superfluous, it is
 | ||||||
|  | // here for consistancy. Do not use. Use Logger or Entry instead.
 | ||||||
|  | type Ext1FieldLogger interface { | ||||||
|  | 	FieldLogger | ||||||
|  | 	Tracef(format string, args ...interface{}) | ||||||
|  | 	Trace(args ...interface{}) | ||||||
|  | 	Traceln(args ...interface{}) | ||||||
| } | } | ||||||
|  |  | ||||||
|  | @ -1,10 +0,0 @@ | ||||||
| // +build darwin freebsd openbsd netbsd dragonfly
 |  | ||||||
| // +build !appengine,!gopherjs
 |  | ||||||
| 
 |  | ||||||
| package logrus |  | ||||||
| 
 |  | ||||||
| import "golang.org/x/sys/unix" |  | ||||||
| 
 |  | ||||||
| const ioctlReadTermios = unix.TIOCGETA |  | ||||||
| 
 |  | ||||||
| type Termios unix.Termios |  | ||||||
|  | @ -1,4 +1,4 @@ | ||||||
| // +build appengine gopherjs
 | // +build appengine
 | ||||||
| 
 | 
 | ||||||
| package logrus | package logrus | ||||||
| 
 | 
 | ||||||
|  |  | ||||||
|  | @ -0,0 +1,13 @@ | ||||||
|  | // +build darwin dragonfly freebsd netbsd openbsd
 | ||||||
|  | 
 | ||||||
|  | package logrus | ||||||
|  | 
 | ||||||
|  | import "golang.org/x/sys/unix" | ||||||
|  | 
 | ||||||
|  | const ioctlReadTermios = unix.TIOCGETA | ||||||
|  | 
 | ||||||
|  | func isTerminal(fd int) bool { | ||||||
|  | 	_, err := unix.IoctlGetTermios(fd, ioctlReadTermios) | ||||||
|  | 	return err == nil | ||||||
|  | } | ||||||
|  | 
 | ||||||
|  | @ -0,0 +1,11 @@ | ||||||
|  | // +build js nacl plan9
 | ||||||
|  | 
 | ||||||
|  | package logrus | ||||||
|  | 
 | ||||||
|  | import ( | ||||||
|  | 	"io" | ||||||
|  | ) | ||||||
|  | 
 | ||||||
|  | func checkIfTerminal(w io.Writer) bool { | ||||||
|  | 	return false | ||||||
|  | } | ||||||
|  | @ -1,18 +1,16 @@ | ||||||
| // +build !appengine,!gopherjs
 | // +build !appengine,!js,!windows,!nacl,!plan9
 | ||||||
| 
 | 
 | ||||||
| package logrus | package logrus | ||||||
| 
 | 
 | ||||||
| import ( | import ( | ||||||
| 	"io" | 	"io" | ||||||
| 	"os" | 	"os" | ||||||
| 
 |  | ||||||
| 	"golang.org/x/crypto/ssh/terminal" |  | ||||||
| ) | ) | ||||||
| 
 | 
 | ||||||
| func checkIfTerminal(w io.Writer) bool { | func checkIfTerminal(w io.Writer) bool { | ||||||
| 	switch v := w.(type) { | 	switch v := w.(type) { | ||||||
| 	case *os.File: | 	case *os.File: | ||||||
| 		return terminal.IsTerminal(int(v.Fd())) | 		return isTerminal(int(v.Fd())) | ||||||
| 	default: | 	default: | ||||||
| 		return false | 		return false | ||||||
| 	} | 	} | ||||||
|  |  | ||||||
|  | @ -0,0 +1,11 @@ | ||||||
|  | package logrus | ||||||
|  | 
 | ||||||
|  | import ( | ||||||
|  | 	"golang.org/x/sys/unix" | ||||||
|  | ) | ||||||
|  | 
 | ||||||
|  | // IsTerminal returns true if the given file descriptor is a terminal.
 | ||||||
|  | func isTerminal(fd int) bool { | ||||||
|  | 	_, err := unix.IoctlGetTermio(fd, unix.TCGETA) | ||||||
|  | 	return err == nil | ||||||
|  | } | ||||||
|  | @ -0,0 +1,13 @@ | ||||||
|  | // +build linux aix
 | ||||||
|  | 
 | ||||||
|  | package logrus | ||||||
|  | 
 | ||||||
|  | import "golang.org/x/sys/unix" | ||||||
|  | 
 | ||||||
|  | const ioctlReadTermios = unix.TCGETS | ||||||
|  | 
 | ||||||
|  | func isTerminal(fd int) bool { | ||||||
|  | 	_, err := unix.IoctlGetTermios(fd, ioctlReadTermios) | ||||||
|  | 	return err == nil | ||||||
|  | } | ||||||
|  | 
 | ||||||
|  | @ -0,0 +1,34 @@ | ||||||
|  | // +build !appengine,!js,windows
 | ||||||
|  | 
 | ||||||
|  | package logrus | ||||||
|  | 
 | ||||||
|  | import ( | ||||||
|  | 	"io" | ||||||
|  | 	"os" | ||||||
|  | 	"syscall" | ||||||
|  | 
 | ||||||
|  | 	sequences "github.com/konsorten/go-windows-terminal-sequences" | ||||||
|  | ) | ||||||
|  | 
 | ||||||
|  | func initTerminal(w io.Writer) { | ||||||
|  | 	switch v := w.(type) { | ||||||
|  | 	case *os.File: | ||||||
|  | 		sequences.EnableVirtualTerminalProcessing(syscall.Handle(v.Fd()), true) | ||||||
|  | 	} | ||||||
|  | } | ||||||
|  | 
 | ||||||
|  | func checkIfTerminal(w io.Writer) bool { | ||||||
|  | 	var ret bool | ||||||
|  | 	switch v := w.(type) { | ||||||
|  | 	case *os.File: | ||||||
|  | 		var mode uint32 | ||||||
|  | 		err := syscall.GetConsoleMode(syscall.Handle(v.Fd()), &mode) | ||||||
|  | 		ret = (err == nil) | ||||||
|  | 	default: | ||||||
|  | 		ret = false | ||||||
|  | 	} | ||||||
|  | 	if ret { | ||||||
|  | 		initTerminal(w) | ||||||
|  | 	} | ||||||
|  | 	return ret | ||||||
|  | } | ||||||
|  | @ -1,14 +0,0 @@ | ||||||
| // Based on ssh/terminal:
 |  | ||||||
| // Copyright 2013 The Go Authors. All rights reserved.
 |  | ||||||
| // Use of this source code is governed by a BSD-style
 |  | ||||||
| // license that can be found in the LICENSE file.
 |  | ||||||
| 
 |  | ||||||
| // +build !appengine,!gopherjs
 |  | ||||||
| 
 |  | ||||||
| package logrus |  | ||||||
| 
 |  | ||||||
| import "golang.org/x/sys/unix" |  | ||||||
| 
 |  | ||||||
| const ioctlReadTermios = unix.TCGETS |  | ||||||
| 
 |  | ||||||
| type Termios unix.Termios |  | ||||||
|  | @ -3,6 +3,8 @@ package logrus | ||||||
| import ( | import ( | ||||||
| 	"bytes" | 	"bytes" | ||||||
| 	"fmt" | 	"fmt" | ||||||
|  | 	"os" | ||||||
|  | 	"runtime" | ||||||
| 	"sort" | 	"sort" | ||||||
| 	"strings" | 	"strings" | ||||||
| 	"sync" | 	"sync" | ||||||
|  | @ -10,18 +12,13 @@ import ( | ||||||
| ) | ) | ||||||
| 
 | 
 | ||||||
| const ( | const ( | ||||||
| 	nocolor = 0 |  | ||||||
| 	red    = 31 | 	red    = 31 | ||||||
| 	green   = 32 |  | ||||||
| 	yellow = 33 | 	yellow = 33 | ||||||
| 	blue   = 36 | 	blue   = 36 | ||||||
| 	gray   = 37 | 	gray   = 37 | ||||||
| ) | ) | ||||||
| 
 | 
 | ||||||
| var ( | var baseTimestamp time.Time | ||||||
| 	baseTimestamp time.Time |  | ||||||
| 	emptyFieldMap FieldMap |  | ||||||
| ) |  | ||||||
| 
 | 
 | ||||||
| func init() { | func init() { | ||||||
| 	baseTimestamp = time.Now() | 	baseTimestamp = time.Now() | ||||||
|  | @ -35,6 +32,9 @@ type TextFormatter struct { | ||||||
| 	// Force disabling colors.
 | 	// Force disabling colors.
 | ||||||
| 	DisableColors bool | 	DisableColors bool | ||||||
| 
 | 
 | ||||||
|  | 	// Override coloring based on CLICOLOR and CLICOLOR_FORCE. - https://bixense.com/clicolors/
 | ||||||
|  | 	EnvironmentOverrideColors bool | ||||||
|  | 
 | ||||||
| 	// Disable timestamp logging. useful when output is redirected to logging
 | 	// Disable timestamp logging. useful when output is redirected to logging
 | ||||||
| 	// system that already adds timestamps.
 | 	// system that already adds timestamps.
 | ||||||
| 	DisableTimestamp bool | 	DisableTimestamp bool | ||||||
|  | @ -51,6 +51,9 @@ type TextFormatter struct { | ||||||
| 	// be desired.
 | 	// be desired.
 | ||||||
| 	DisableSorting bool | 	DisableSorting bool | ||||||
| 
 | 
 | ||||||
|  | 	// The keys sorting function, when uninitialized it uses sort.Strings.
 | ||||||
|  | 	SortingFunc func([]string) | ||||||
|  | 
 | ||||||
| 	// Disables the truncation of the level text to 4 characters.
 | 	// Disables the truncation of the level text to 4 characters.
 | ||||||
| 	DisableLevelTruncation bool | 	DisableLevelTruncation bool | ||||||
| 
 | 
 | ||||||
|  | @ -69,7 +72,13 @@ type TextFormatter struct { | ||||||
| 	//         FieldKeyMsg:   "@message"}}
 | 	//         FieldKeyMsg:   "@message"}}
 | ||||||
| 	FieldMap FieldMap | 	FieldMap FieldMap | ||||||
| 
 | 
 | ||||||
| 	sync.Once | 	// CallerPrettyfier can be set by the user to modify the content
 | ||||||
|  | 	// of the function and file keys in the data when ReportCaller is
 | ||||||
|  | 	// activated. If any of the returned value is the empty string the
 | ||||||
|  | 	// corresponding key will be removed from fields.
 | ||||||
|  | 	CallerPrettyfier func(*runtime.Frame) (function string, file string) | ||||||
|  | 
 | ||||||
|  | 	terminalInitOnce sync.Once | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (f *TextFormatter) init(entry *Entry) { | func (f *TextFormatter) init(entry *Entry) { | ||||||
|  | @ -78,17 +87,77 @@ func (f *TextFormatter) init(entry *Entry) { | ||||||
| 	} | 	} | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
|  | func (f *TextFormatter) isColored() bool { | ||||||
|  | 	isColored := f.ForceColors || (f.isTerminal && (runtime.GOOS != "windows")) | ||||||
|  | 
 | ||||||
|  | 	if f.EnvironmentOverrideColors { | ||||||
|  | 		if force, ok := os.LookupEnv("CLICOLOR_FORCE"); ok && force != "0" { | ||||||
|  | 			isColored = true | ||||||
|  | 		} else if ok && force == "0" { | ||||||
|  | 			isColored = false | ||||||
|  | 		} else if os.Getenv("CLICOLOR") == "0" { | ||||||
|  | 			isColored = false | ||||||
|  | 		} | ||||||
|  | 	} | ||||||
|  | 
 | ||||||
|  | 	return isColored && !f.DisableColors | ||||||
|  | } | ||||||
|  | 
 | ||||||
| // Format renders a single log entry
 | // Format renders a single log entry
 | ||||||
| func (f *TextFormatter) Format(entry *Entry) ([]byte, error) { | func (f *TextFormatter) Format(entry *Entry) ([]byte, error) { | ||||||
| 	prefixFieldClashes(entry.Data, f.FieldMap) | 	data := make(Fields) | ||||||
| 
 | 	for k, v := range entry.Data { | ||||||
| 	keys := make([]string, 0, len(entry.Data)) | 		data[k] = v | ||||||
| 	for k := range entry.Data { | 	} | ||||||
|  | 	prefixFieldClashes(data, f.FieldMap, entry.HasCaller()) | ||||||
|  | 	keys := make([]string, 0, len(data)) | ||||||
|  | 	for k := range data { | ||||||
| 		keys = append(keys, k) | 		keys = append(keys, k) | ||||||
| 	} | 	} | ||||||
| 
 | 
 | ||||||
|  | 	var funcVal, fileVal string | ||||||
|  | 
 | ||||||
|  | 	fixedKeys := make([]string, 0, 4+len(data)) | ||||||
|  | 	if !f.DisableTimestamp { | ||||||
|  | 		fixedKeys = append(fixedKeys, f.FieldMap.resolve(FieldKeyTime)) | ||||||
|  | 	} | ||||||
|  | 	fixedKeys = append(fixedKeys, f.FieldMap.resolve(FieldKeyLevel)) | ||||||
|  | 	if entry.Message != "" { | ||||||
|  | 		fixedKeys = append(fixedKeys, f.FieldMap.resolve(FieldKeyMsg)) | ||||||
|  | 	} | ||||||
|  | 	if entry.err != "" { | ||||||
|  | 		fixedKeys = append(fixedKeys, f.FieldMap.resolve(FieldKeyLogrusError)) | ||||||
|  | 	} | ||||||
|  | 	if entry.HasCaller() { | ||||||
|  | 		if f.CallerPrettyfier != nil { | ||||||
|  | 			funcVal, fileVal = f.CallerPrettyfier(entry.Caller) | ||||||
|  | 		} else { | ||||||
|  | 			funcVal = entry.Caller.Function | ||||||
|  | 			fileVal = fmt.Sprintf("%s:%d", entry.Caller.File, entry.Caller.Line) | ||||||
|  | 		} | ||||||
|  | 
 | ||||||
|  | 		if funcVal != "" { | ||||||
|  | 			fixedKeys = append(fixedKeys, f.FieldMap.resolve(FieldKeyFunc)) | ||||||
|  | 		} | ||||||
|  | 		if fileVal != "" { | ||||||
|  | 			fixedKeys = append(fixedKeys, f.FieldMap.resolve(FieldKeyFile)) | ||||||
|  | 		} | ||||||
|  | 	} | ||||||
|  | 
 | ||||||
| 	if !f.DisableSorting { | 	if !f.DisableSorting { | ||||||
|  | 		if f.SortingFunc == nil { | ||||||
| 			sort.Strings(keys) | 			sort.Strings(keys) | ||||||
|  | 			fixedKeys = append(fixedKeys, keys...) | ||||||
|  | 		} else { | ||||||
|  | 			if !f.isColored() { | ||||||
|  | 				fixedKeys = append(fixedKeys, keys...) | ||||||
|  | 				f.SortingFunc(fixedKeys) | ||||||
|  | 			} else { | ||||||
|  | 				f.SortingFunc(keys) | ||||||
|  | 			} | ||||||
|  | 		} | ||||||
|  | 	} else { | ||||||
|  | 		fixedKeys = append(fixedKeys, keys...) | ||||||
| 	} | 	} | ||||||
| 
 | 
 | ||||||
| 	var b *bytes.Buffer | 	var b *bytes.Buffer | ||||||
|  | @ -98,26 +167,35 @@ func (f *TextFormatter) Format(entry *Entry) ([]byte, error) { | ||||||
| 		b = &bytes.Buffer{} | 		b = &bytes.Buffer{} | ||||||
| 	} | 	} | ||||||
| 
 | 
 | ||||||
| 	f.Do(func() { f.init(entry) }) | 	f.terminalInitOnce.Do(func() { f.init(entry) }) | ||||||
| 
 |  | ||||||
| 	isColored := (f.ForceColors || f.isTerminal) && !f.DisableColors |  | ||||||
| 
 | 
 | ||||||
| 	timestampFormat := f.TimestampFormat | 	timestampFormat := f.TimestampFormat | ||||||
| 	if timestampFormat == "" { | 	if timestampFormat == "" { | ||||||
| 		timestampFormat = defaultTimestampFormat | 		timestampFormat = defaultTimestampFormat | ||||||
| 	} | 	} | ||||||
| 	if isColored { | 	if f.isColored() { | ||||||
| 		f.printColored(b, entry, keys, timestampFormat) | 		f.printColored(b, entry, keys, data, timestampFormat) | ||||||
| 	} else { | 	} else { | ||||||
| 		if !f.DisableTimestamp { | 
 | ||||||
| 			f.appendKeyValue(b, f.FieldMap.resolve(FieldKeyTime), entry.Time.Format(timestampFormat)) | 		for _, key := range fixedKeys { | ||||||
|  | 			var value interface{} | ||||||
|  | 			switch { | ||||||
|  | 			case key == f.FieldMap.resolve(FieldKeyTime): | ||||||
|  | 				value = entry.Time.Format(timestampFormat) | ||||||
|  | 			case key == f.FieldMap.resolve(FieldKeyLevel): | ||||||
|  | 				value = entry.Level.String() | ||||||
|  | 			case key == f.FieldMap.resolve(FieldKeyMsg): | ||||||
|  | 				value = entry.Message | ||||||
|  | 			case key == f.FieldMap.resolve(FieldKeyLogrusError): | ||||||
|  | 				value = entry.err | ||||||
|  | 			case key == f.FieldMap.resolve(FieldKeyFunc) && entry.HasCaller(): | ||||||
|  | 				value = funcVal | ||||||
|  | 			case key == f.FieldMap.resolve(FieldKeyFile) && entry.HasCaller(): | ||||||
|  | 				value = fileVal | ||||||
|  | 			default: | ||||||
|  | 				value = data[key] | ||||||
| 			} | 			} | ||||||
| 		f.appendKeyValue(b, f.FieldMap.resolve(FieldKeyLevel), entry.Level.String()) | 			f.appendKeyValue(b, key, value) | ||||||
| 		if entry.Message != "" { |  | ||||||
| 			f.appendKeyValue(b, f.FieldMap.resolve(FieldKeyMsg), entry.Message) |  | ||||||
| 		} |  | ||||||
| 		for _, key := range keys { |  | ||||||
| 			f.appendKeyValue(b, key, entry.Data[key]) |  | ||||||
| 		} | 		} | ||||||
| 	} | 	} | ||||||
| 
 | 
 | ||||||
|  | @ -125,10 +203,10 @@ func (f *TextFormatter) Format(entry *Entry) ([]byte, error) { | ||||||
| 	return b.Bytes(), nil | 	return b.Bytes(), nil | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
| func (f *TextFormatter) printColored(b *bytes.Buffer, entry *Entry, keys []string, timestampFormat string) { | func (f *TextFormatter) printColored(b *bytes.Buffer, entry *Entry, keys []string, data Fields, timestampFormat string) { | ||||||
| 	var levelColor int | 	var levelColor int | ||||||
| 	switch entry.Level { | 	switch entry.Level { | ||||||
| 	case DebugLevel: | 	case DebugLevel, TraceLevel: | ||||||
| 		levelColor = gray | 		levelColor = gray | ||||||
| 	case WarnLevel: | 	case WarnLevel: | ||||||
| 		levelColor = yellow | 		levelColor = yellow | ||||||
|  | @ -143,15 +221,37 @@ func (f *TextFormatter) printColored(b *bytes.Buffer, entry *Entry, keys []strin | ||||||
| 		levelText = levelText[0:4] | 		levelText = levelText[0:4] | ||||||
| 	} | 	} | ||||||
| 
 | 
 | ||||||
| 	if f.DisableTimestamp { | 	// Remove a single newline if it already exists in the message to keep
 | ||||||
| 		fmt.Fprintf(b, "\x1b[%dm%s\x1b[0m %-44s ", levelColor, levelText, entry.Message) | 	// the behavior of logrus text_formatter the same as the stdlib log package
 | ||||||
| 	} else if !f.FullTimestamp { | 	entry.Message = strings.TrimSuffix(entry.Message, "\n") | ||||||
| 		fmt.Fprintf(b, "\x1b[%dm%s\x1b[0m[%04d] %-44s ", levelColor, levelText, int(entry.Time.Sub(baseTimestamp)/time.Second), entry.Message) | 
 | ||||||
|  | 	caller := "" | ||||||
|  | 	if entry.HasCaller() { | ||||||
|  | 		funcVal := fmt.Sprintf("%s()", entry.Caller.Function) | ||||||
|  | 		fileVal := fmt.Sprintf("%s:%d", entry.Caller.File, entry.Caller.Line) | ||||||
|  | 
 | ||||||
|  | 		if f.CallerPrettyfier != nil { | ||||||
|  | 			funcVal, fileVal = f.CallerPrettyfier(entry.Caller) | ||||||
|  | 		} | ||||||
|  | 
 | ||||||
|  | 		if fileVal == "" { | ||||||
|  | 			caller = funcVal | ||||||
|  | 		} else if funcVal == "" { | ||||||
|  | 			caller = fileVal | ||||||
| 		} else { | 		} else { | ||||||
| 		fmt.Fprintf(b, "\x1b[%dm%s\x1b[0m[%s] %-44s ", levelColor, levelText, entry.Time.Format(timestampFormat), entry.Message) | 			caller = fileVal + " " + funcVal | ||||||
|  | 		} | ||||||
|  | 	} | ||||||
|  | 
 | ||||||
|  | 	if f.DisableTimestamp { | ||||||
|  | 		fmt.Fprintf(b, "\x1b[%dm%s\x1b[0m%s %-44s ", levelColor, levelText, caller, entry.Message) | ||||||
|  | 	} else if !f.FullTimestamp { | ||||||
|  | 		fmt.Fprintf(b, "\x1b[%dm%s\x1b[0m[%04d]%s %-44s ", levelColor, levelText, int(entry.Time.Sub(baseTimestamp)/time.Second), caller, entry.Message) | ||||||
|  | 	} else { | ||||||
|  | 		fmt.Fprintf(b, "\x1b[%dm%s\x1b[0m[%s]%s %-44s ", levelColor, levelText, entry.Time.Format(timestampFormat), caller, entry.Message) | ||||||
| 	} | 	} | ||||||
| 	for _, k := range keys { | 	for _, k := range keys { | ||||||
| 		v := entry.Data[k] | 		v := data[k] | ||||||
| 		fmt.Fprintf(b, " \x1b[%dm%s\x1b[0m=", levelColor, k) | 		fmt.Fprintf(b, " \x1b[%dm%s\x1b[0m=", levelColor, k) | ||||||
| 		f.appendValue(b, v) | 		f.appendValue(b, v) | ||||||
| 	} | 	} | ||||||
|  |  | ||||||
|  | @ -24,6 +24,8 @@ func (entry *Entry) WriterLevel(level Level) *io.PipeWriter { | ||||||
| 	var printFunc func(args ...interface{}) | 	var printFunc func(args ...interface{}) | ||||||
| 
 | 
 | ||||||
| 	switch level { | 	switch level { | ||||||
|  | 	case TraceLevel: | ||||||
|  | 		printFunc = entry.Trace | ||||||
| 	case DebugLevel: | 	case DebugLevel: | ||||||
| 		printFunc = entry.Debug | 		printFunc = entry.Debug | ||||||
| 	case InfoLevel: | 	case InfoLevel: | ||||||
|  |  | ||||||
		Loading…
	
		Reference in New Issue