log

Documentation

Overview

Package log contains necessary logging functions

Index

• Constants
• func Debug(format string, args ...interface{})
• func Error(format string, args ...interface{})
• func Fatal(args ...interface{})
• func Fatalf(format string, args ...interface{})
• func GetLevel() int
• func Info(format string, args ...interface{})
• func LogPanic(prefix string)
• func Print(args ...interface{})
• func Printf(format string, args ...interface{})
• func Println(args ...interface{})
• func SetFlags(flags int)
• func SetLevel(level int)
• func SetOutput(w io.Writer)
• func StdLog(prefix string, level int) (std *log.Logger)
• func Tracef(format string, args ...interface{})
• func Writer() io.Writer
• type Timer
  • func StartTimer() Timer
  • func (t *Timer) LogElapsed(message string, args ...interface{})

Examples

• LogPanic

Constants

const (
	ERROR = iota
	INFO  = iota
	DEBUG = iota
)

Logging level

const (
	Ldate = 1 << iota
	Ltime
	Lmicroseconds
	Llongfile
	Lshortfile
	LUTC
	Lmsgprefix
	LstdFlags = Ldate | Ltime
)

These constants are the same as in the standard package "log".

See the output of:

go doc log.Ldate

Functions

func Debug

func Debug(format string, args ...interface{})

Debug writes to debug log

func Error

func Error(format string, args ...interface{})

Error writes to error log

func Fatal

func Fatal(args ...interface{})

Fatal writes to error log and exits application

func Fatalf

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

Fatalf writes to error log and exits application

func GetLevel

func GetLevel() int

GetLevel returns logLevel

func Info

func Info(format string, args ...interface{})

Info writes to info log

func LogPanic

func LogPanic(prefix string)

LogPanic is a convinient deferred helper function to log a panic in a goroutine. It should not be used where proper error handling is required.

Example

package main

import (
	"os"

	"github.com/AdguardTeam/golibs/log"
)

func main() {
	log.SetOutput(os.Stdout)
	log.SetFlags(0)

	f := func() {
		defer log.LogPanic("")

		panic("fail")
	}

	f()

	f = func() {
		defer log.LogPanic("f")

		panic("fail")
	}

	f()

}

Output:


[error] recovered from panic: fail
[error] f: recovered from panic: fail

func Print

func Print(args ...interface{})

Print writes to info log

func Printf

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

Printf writes to info log

func Println

func Println(args ...interface{})

Println writes to info log

func SetFlags

func SetFlags(flags int)

SetFlags sets the output flags for the default logger. The flag bits are Ldate, Ltime, and so on.

func SetLevel

func SetLevel(level int)

SetLevel sets logging level

func SetOutput

func SetOutput(w io.Writer)

SetOutput sets output printing method

func StdLog

func StdLog(prefix string, level int) (std *log.Logger)

StdLog returns a Go standard library logger that writes everything to logs the way this library's logger would. This is useful for cases that require a stdlib logger, for example http.Server.ErrorLog.

func Tracef

func Tracef(format string, args ...interface{})

Tracef writes to debug log and adds the calling function's name

func Writer

func Writer() io.Writer

Writer returns the output destination for the default logger.

Types

type Timer

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

Timer is a wrapper for time

func StartTimer

func StartTimer() Timer

StartTimer returns a Timer with a start time

func (*Timer) LogElapsed

func (t *Timer) LogElapsed(message string, args ...interface{})

LogElapsed writes to log message and elapsed time