Categorygithub.com/zenoss/glog
modulepackage
0.0.0-20170517181832-26e2e6479188
Repository: https://github.com/zenoss/glog.git
Documentation: pkg.go.dev

# README

glog

Leveled execution logs for Go.

This is an efficient pure Go implementation of leveled logs in the manner of the open source C++ package http://code.google.com/p/google-glog

By binding methods to booleans it is possible to use the log package without paying the expense of evaluating the arguments to the log. Through the -vmodule flag, the package also provides fine-grained control over logging at the file level.

The comment from glog.go introduces the ideas:

Package glog implements logging analogous to the Google-internal
C++ INFO/ERROR/V setup.  It provides functions Info, Warning,
Error, Fatal, plus formatting variants such as Infof. It
also provides V-style logging controlled by the -v and
-vmodule=file=2 flags.

Basic examples:

	glog.Info("Prepare to repel boarders")

	glog.Fatalf("Initialization failed: %s", err)

See the documentation for the V function for an explanation
of these examples:

	if glog.V(2) {
		glog.Info("Starting transaction...")
	}

	glog.V(2).Infoln("Processed", nItems, "elements")

The repository contains an open source version of the log package used inside Google. The master copy of the source lives inside Google, not here. The code in this repo is for export only and is not itself under development. Feature requests will be ignored.

Send bug reports to [email protected].

# Functions

Error logs to the ERROR, WARNING, and INFO logs.
Errorf logs to the ERROR, WARNING, and INFO logs.
Errorln logs to the ERROR, WARNING, and INFO logs.
Fatal logs to the FATAL, ERROR, WARNING, and INFO logs, including a stack trace of all running goroutines, then calls os.Exit(255).
Fatalf logs to the FATAL, ERROR, WARNING, and INFO logs, including a stack trace of all running goroutines, then calls os.Exit(255).
Fatalln logs to the FATAL, ERROR, WARNING, and INFO logs, including a stack trace of all running goroutines, then calls os.Exit(255).
Flush flushes all pending log I/O.
Programatic Method to set logging verbosity.
Info logs to the INFO log.
Infof logs to the INFO log.
Infoln logs to the INFO log.
Programatic Method to set logging to stderr and files.
Programmatically set logDir value.
Programmatically set logDirCleanup value.
Programatic Method to set logstash type.
Programatic Method to set the logstash url.
Programatic Method to set stderr threshold.
Programatic Method to set logging to stderr instead of file.
No description provided by the author
Programatic Method to set logging verbosity.
Programatic Method to set vmodule.
V reports whether verbosity at the call site is at least the requested level.
Warning logs to the WARNING and INFO logs.
Warningf logs to the WARNING and INFO logs.
Warningln logs to the WARNING and INFO logs.

# Variables

MaxSize is the maximum size of a log file in bytes.
Stats tracks the number of lines of output and number of bytes per severity level.

# Structs

OutputStats tracks the number of output lines and bytes written.

# Type aliases

Level specifies a level of verbosity for V logs.
Verbose is a boolean type that implements Infof (like Printf) etc.