log

Documentation

Overview

Package log contains adapter for third-party loggers

Example:

package main

import (
	"github.com/insolar/insolar/configuration"
	"github.com/insolar/insolar/log"
)

func main() {
	// global logger
	log.SetLevel("Debug")
	log.Debugln("debug log message")

	// local logger
	logger, _ := log.NewLog(configuration.Log{Level: "Warning", Adapter: "logrus"})
	logger.Warnln("warning log message")
}

Index

• Variables
• func Debug(args ...interface{})
• func Debugf(format string, args ...interface{})
• func Debugln(args ...interface{})
• func Error(args ...interface{})
• func Errorf(format string, args ...interface{})
• func Errorln(args ...interface{})
• func Fatal(args ...interface{})
• func Fatalf(format string, args ...interface{})
• func Fatalln(args ...interface{})
• func GetLevel() string
• func Info(args ...interface{})
• func Infof(format string, args ...interface{})
• func Infoln(args ...interface{})
• func NewLog(cfg configuration.Log) (core.Logger, error)
• func Panic(args ...interface{})
• func Panicf(format string, args ...interface{})
• func Panicln(args ...interface{})
• func SetGlobalLogger(logger core.Logger)
• func SetLevel(level string) error
• func SetOutput(w io.Writer)
• func Warn(args ...interface{})
• func Warnf(format string, args ...interface{})
• func Warnln(args ...interface{})
• func WithSkipDelta(cl core.Logger, delta int) core.Logger

Variables

var GlobalLogger = func() core.Logger {
	holder := configuration.NewHolder().MustInit(false)
	logger, err := newLogrusAdapter(holder.Configuration.Log)
	if err != nil {
		stdlog.Println("warning:", err.Error())
	}

	logger.skipCallNumber = defaultSkipCallNumber + 1
	if err := logger.SetLevel(holder.Configuration.Log.Level); err != nil {
		stdlog.Println("warning:", err.Error())
	}
	return logger
}()

GlobalLogger creates global logger with correct skipCallNumber TODO: make it private again

Functions

func Debug

func Debug(args ...interface{})

Debug logs a message at level Debug to the global logger.

func Debugf

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

Debugf logs a message at level Debug to the global logger.

func Debugln

func Debugln(args ...interface{})

Debugln logs a message at level Debug to the global logger.

func Error

func Error(args ...interface{})

Error logs a message at level Error to the global logger.

func Errorf

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

Errorf logs a message at level Error to the global logger.

func Errorln

func Errorln(args ...interface{})

Errorln logs a message at level Error to the global logger.

func Fatal

func Fatal(args ...interface{})

Fatal logs a message at level Fatal to the global logger.

func Fatalf

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

Fatalf logs a message at level Fatal to the global logger.

func Fatalln

func Fatalln(args ...interface{})

Fatalln logs a message at level Fatal to the global logger.

func GetLevel

func GetLevel() string

GetLevel lets log level for global logger

func Info

func Info(args ...interface{})

Info logs a message at level Info to the global logger.

func Infof

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

Infof logs a message at level Info to the global logger.

func Infoln

func Infoln(args ...interface{})

Infoln logs a message at level Info to the global logger.

func NewLog

func NewLog(cfg configuration.Log) (core.Logger, error)

NewLog creates logger instance with particular configuration

func Panic

func Panic(args ...interface{})

Panic logs a message at level Panic to the global logger.

func Panicf

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

Panicf logs a message at level Panic to the global logger.

func Panicln

func Panicln(args ...interface{})

Panicln logs a message at level Panic to the global logger.

func SetGlobalLogger

func SetGlobalLogger(logger core.Logger)

func SetLevel

func SetLevel(level string) error

SetLevel lets log level for global logger

func SetOutput

func SetOutput(w io.Writer)

SetOutput sets the output destination for the logger.

func Warn

func Warn(args ...interface{})

Warn logs a message at level Warn to the global logger.

func Warnf

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

Warnf logs a message at level Warn to the global logger.

func Warnln

func Warnln(args ...interface{})

Warnln logs a message at level Warn to the global logger.

func WithSkipDelta

func WithSkipDelta(cl core.Logger, delta int) core.Logger

WithSkipDelta changes current skip stack frames value for underlying logrus adapter on delta value. More about skip value is here https://golang.org/pkg/runtime/#Caller.

This is useful than logger methods called not from place they should report, like helper functions.