log

Documentation

Index

• Constants
• func Fatal(v ...interface{})
• func Fatalf(format string, v ...interface{})
• func Fatalln(v ...interface{})
• func Output(calldepth int, s string) error
• func Panic(v ...interface{})
• func Panicf(format string, v ...interface{})
• func Panicln(v ...interface{})
• func Print(v ...interface{})
• func Printf(format string, v ...interface{})
• func Println(v ...interface{})
• type Logger
  • func New(projectID string, options ...LoggerOption) *Logger
  • func (l *Logger) Close()
  • func (l *Logger) Critical(message interface{})
  • func (l *Logger) Criticalf(format string, a ...interface{})
  • func (l *Logger) Debug(message interface{})
  • func (l *Logger) Debugf(format string, a ...interface{})
  • func (l *Logger) Error(message interface{})
  • func (l *Logger) Errorf(format string, a ...interface{})
  • func (l *Logger) Flags() int
  • func (l *Logger) Info(message interface{})
  • func (l *Logger) Infof(format string, a ...interface{})
  • func (l *Logger) Output(calldepth int, s string) error
  • func (l *Logger) Prefix() string
  • func (l *Logger) SetFlags(flag int)
  • func (l *Logger) SetPrefix(prefix string)
  • func (l *Logger) WithRequest(r *http.Request) *Logger
• type LoggerOption
  • func WithContext(ctx context.Context) LoggerOption
  • func WithDebug(debug bool) LoggerOption
  • func WithDefaultSeverity(defaultSeverity logging.Severity) LoggerOption
  • func WithLocal(local bool) LoggerOption
  • func WithLogName(logname string) LoggerOption
  • func WithPrefix(prefix string) LoggerOption
• type LoggerOptions

Constants

const (
	Ldate         = 1 << iota     // the date in the local time zone: 2009/01/23
	Ltime                         // the time in the local time zone: 01:23:23
	Lmicroseconds                 // microsecond resolution: 01:23:23.123123.  assumes Ltime.
	Llongfile                     // full file name and line number: /a/b/c/d.go:23
	Lshortfile                    // final file name element and line number: d.go:23. overrides Llongfile
	LUTC                          // if Ldate or Ltime is set, use UTC rather than the local time zone
	LstdFlags     = Ldate | Ltime // initial values for the standard logger
)

These flags define which text to prefix to each log entry generated by the Logger. Bits are or'ed together to control what's printed. There is no control over the order they appear (the order listed here) or the format they present (as described in the comments). The prefix is followed by a colon only when Llongfile or Lshortfile is specified. For example, flags Ldate | Ltime (or LstdFlags) produce,

2009/01/23 01:23:23 message

while flags Ldate | Ltime | Lmicroseconds | Llongfile produce,

2009/01/23 01:23:23.123123 /a/b/c/d.go:23: message

Functions

func Fatal

func Fatal(v ...interface{})

Fatal is equivalent to Print() followed by a call to os.Exit(1).

func Fatalf

func Fatalf(format string, v ...interface{})

Fatalf is equivalent to Printf() followed by a call to os.Exit(1).

func Fatalln

func Fatalln(v ...interface{})

Fatalln is equivalent to Println() followed by a call to os.Exit(1).

func Output

func Output(calldepth int, s string) error

Output writes the output for a logging event. The string s contains the text to print after the prefix specified by the flags of the Logger. A newline is appended if the last character of s is not already a newline. Calldepth is the count of the number of frames to skip when computing the file name and line number if Llongfile or Lshortfile is set; a value of 1 will print the details for the caller of Output.

func Panic

func Panic(v ...interface{})

Panic is equivalent to Print() followed by a call to panic().

func Panicf

func Panicf(format string, v ...interface{})

Panicf is equivalent to Printf() followed by a call to panic().

func Panicln

func Panicln(v ...interface{})

Panicln is equivalent to Println() followed by a call to panic().

func Print

func Print(v ...interface{})

Print calls Output to print to the standard logger. Arguments are handled in the manner of fmt.Print.

func Printf

func Printf(format string, v ...interface{})

Printf calls Output to print to the standard logger. Arguments are handled in the manner of fmt.Printf.

func Println

func Println(v ...interface{})

Println calls Output to print to the standard logger. Arguments are handled in the manner of fmt.Println.

Types

type Logger

type Logger struct {
	// contains filtered or unexported fields
}

func New

func New(projectID string, options ...LoggerOption) *Logger

func (*Logger) Close

func (l *Logger) Close()

func (*Logger) Critical

func (l *Logger) Critical(message interface{})

func (*Logger) Criticalf

func (l *Logger) Criticalf(format string, a ...interface{})

func (*Logger) Debug

func (l *Logger) Debug(message interface{})

func (*Logger) Debugf

func (l *Logger) Debugf(format string, a ...interface{})

func (*Logger) Error

func (l *Logger) Error(message interface{})

func (*Logger) Errorf

func (l *Logger) Errorf(format string, a ...interface{})

func (*Logger) Flags

func (l *Logger) Flags() int

Flags returns the output flags for the logger.

func (*Logger) Info

func (l *Logger) Info(message interface{})

func (*Logger) Infof

func (l *Logger) Infof(format string, a ...interface{})

func (*Logger) Output

func (l *Logger) Output(calldepth int, s string) error

Output writes the output for a logging event. The string s contains the text to print after the prefix specified by the flags of the Logger. A newline is appended if the last character of s is not already a newline. Calldepth is used to recover the PC and is provided for generality, although at the moment on all pre-defined paths it will be 2.

func (*Logger) Prefix

func (l *Logger) Prefix() string

Prefix returns the output prefix for the logger.

func (*Logger) SetFlags

func (l *Logger) SetFlags(flag int)

SetFlags sets the output flags for the logger.

func (*Logger) SetPrefix

func (l *Logger) SetPrefix(prefix string)

SetPrefix sets the output prefix for the logger.

func (*Logger) WithRequest

func (l *Logger) WithRequest(r *http.Request) *Logger

WithRequest returns a shallow copy of logger with a request present

type LoggerOption

type LoggerOption func(*LoggerOptions)

func WithContext

func WithContext(ctx context.Context) LoggerOption

func WithDebug

func WithDebug(debug bool) LoggerOption

func WithDefaultSeverity

func WithDefaultSeverity(defaultSeverity logging.Severity) LoggerOption

func WithLocal

func WithLocal(local bool) LoggerOption

func WithLogName

func WithLogName(logname string) LoggerOption

func WithPrefix

func WithPrefix(prefix string) LoggerOption

type LoggerOptions

type LoggerOptions struct {
	LogName         string
	Prefix          string
	Debug           bool
	Local           bool
	DefaultSeverity logging.Severity
	Context         context.Context
}