logger

README

Пакет логгера

Version: 0.2.0

Fetures

• Логгер, кроме фунции (с файлом и строкой) из которой вызван, сохраняет идентификатор потока
• Логгер параллельно с выводом записывает сообщения в файл и в базу данных
• Гибкая настройка выводимых и сохраняемых типов сообщений
• Работа с файлом конфирурации "из коробки"

Featured

• Отправка сообщений в лог-сервер

Использование

import (
    "gitlab.com/leolab/go/logger"
    "gitlab.com/leolab/go/AppConf"
)

var log Logger

func main(){
    cfg,err:=appconf.NewAppConf()
    if err!=nil{
        panic(err.Error())
    }
    log,err = logger NewLogger(cfg)
    if err!=nil{
        panic(err.Error())
    }

}

Теги замены

Теги применяются в шаблонах вывода лога в консоль и записи в файл

• %file%
• %line%
• %func%
• %type% - Уровень лога
• %msg%
• %goID% - идентификатор рутины
• %procID% - идентификатор процесса (системный)

Параметры

• --logger.file
• --logger.dsn
• --logger.levels = "" - общие параметры, либо:
  • --logger.levels.verbose = "debug,notify,warning,error,request,event"
  • --logger.levels.file = "info,warning,error,request,event"
  • --logger.level.store = "debug,info,notify,warning,error,request,event"
• --logger.dbg = "false"
• --logger.silent = "true"
• --logger.tpl.file = "%date% %time%.%time.ns% %procID%:%goID% [%type%] %msg% from %func% (%file%:%line%)"
• --logger.tpl.cons = "%date% %time%.%time.ns% %procID%:%goID% [%type%] %msg% from %func% (%file%:%line%)"

Уровни логгера

• debug
• info
• notify
• warning
• error
• request
• event

Documentation

Index

• Constants
• type LogLevel
• type LogLevels
  • func (l *LogLevels) Add(lvl LogLevel)
  • func (l *LogLevels) Del(lvl LogLevel)
  • func (l *LogLevels) IsSet(lvl LogLevel) bool
  • func (l *LogLevels) Set(lvl ...LogLevel)
• type Logger
  • func NewLogger(cfg *appconf.AppConf) (log *Logger, err *errs.Err)
  • func (l *Logger) Debug(msg string, data ...interface{})
  • func (l *Logger) Error(msg string, data ...interface{})
  • func (l *Logger) Event(msg string, data ...interface{})
  • func (l *Logger) GetRecs(from, limit int, f ...*LoggerRec) (lr []*LoggerRec)
  • func (l *Logger) Info(msg string, data ...interface{})
  • func (l *Logger) Notify(msg string, data ...interface{})
  • func (l *Logger) Request(msg string, data ...interface{})
  • func (l *Logger) Warn(msg string, data ...interface{})
• type LoggerRec

Constants

const (
	ErrConfigError   errs.ErrCode = "ErrConfigError"
	ErrFileError     errs.ErrCode = "ErrFileError"
	ErrDSError       errs.ErrCode = "ErrDSError"
	ErrDSUnsupported errs.ErrCode = "ErrDSUnsupported"
)

Types

type LogLevel

type LogLevel int

const (
	LogLevelDebug   LogLevel = iota
	LogLevelInfo             // LogLevel = 8
	LogLevelNotify           // LogLevel = 4
	LogLevelWarning          // LogLevel = 2
	LogLevelError            // LogLevel = 1
	//Special levels
	LogLevelRequest // = 20
	LogLevelEvent   // = 40
)

type LogLevels

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

func (*LogLevels) Add

func (l *LogLevels) Add(lvl LogLevel)

Добавить уровень логгирования

func (*LogLevels) Del

func (l *LogLevels) Del(lvl LogLevel)

Удалить уровень логгирования

func (*LogLevels) IsSet

func (l *LogLevels) IsSet(lvl LogLevel) bool

Установлен ли уровень

func (*LogLevels) Set

func (l *LogLevels) Set(lvl ...LogLevel)

Установить (переустановить) уровень логгирования

type Logger

type Logger struct {
	Dbg        bool       //=true - к выводу добавляется файл и строка вызова
	Silent     bool       //=true - не производится вывод в консоль
	FileName   string     // имя файла, возможно использование функций replacer
	DSN        string     // имя базы данных (DSN)
	VerbLevel  *LogLevels // Уровень сообщений для вывода в консоль
	FileLevel  *LogLevels // Уровень сообщений для записи в файл
	StoreLevel *LogLevels // Уровень сообщений для записи в БД
	//= Templates >
	FileTemplate string
	ConsTemplate string
	// contains filtered or unexported fields
}

func NewLogger

func NewLogger(cfg *appconf.AppConf) (log *Logger, err *errs.Err)

func (*Logger) Debug

func (l *Logger) Debug(msg string, data ...interface{})

func (*Logger) Error

func (l *Logger) Error(msg string, data ...interface{})

func (*Logger) Event

func (l *Logger) Event(msg string, data ...interface{})

func (*Logger) GetRecs

func (l *Logger) GetRecs(from, limit int, f ...*LoggerRec) (lr []*LoggerRec)

func (*Logger) Info

func (l *Logger) Info(msg string, data ...interface{})

func (*Logger) Notify

func (l *Logger) Notify(msg string, data ...interface{})

func (*Logger) Request

func (l *Logger) Request(msg string, data ...interface{})

func (*Logger) Warn

func (l *Logger) Warn(msg string, data ...interface{})

type LoggerRec

type LoggerRec struct {
	Time   time.Time `gorm:"index"`
	Lvl    string    `gorm:"index"`
	Msg    string
	File   string
	Line   int
	Func   string
	GoID   int
	ProcID int `gorm:"index"`
	//Src    __srcRec //JSON-string(__src)
	Data string //JSON-data
}