logger

README

Zap Logger Wrapper

本封装提供一个基本的 zap logger 封装，其目的在于统一部分项目之间的日志形式。

基本使用

在具体模块中使用

package abc

import (
	"github.com/GuanceCloud/cliutils/logger"
)

var (
	// 最好在模块中将 log 初始化一下，这样比较保险
	log = logger.DefaultSLogger("abc")
)

// 模块初始化
func Init() {
	log = logger.SLogger("abc")
}

func foo() {
	log.Debug("this is debug message")
	log.Infof("this is info message from %d", 1024)
}

在项目中使用

一般而言，我在项目中使用，需要初始化一个 root-logger，该 root-logger 定义了全局的日志存放路径、日志等级等属性：

package main

import (
	"github.com/GuanceCloud/cliutils/logger"
)

func main() {
	r, err := logger.InitRoot(&logger.Option{
		Path: "/path/to/app/log", // 如果不填写路径，日志将出到 stdout
		Level: logger.DEBUG,      // 默认为 DEBUG
		Flags: logger.OPT_DEFAULT,// 开启了自动切割
	})
}

关于自动切割

默认情况下，会按照 32MB（大约） 一个文件来切割，最大保持 5 个切片，保存时长为 30 天。

提供环境变量来配置日志路径

调用 InitRoot() 时，如果传入的路径为空字符串，那么会尝试从 LOGGER_PATH 这个环境变量中获取有效的日志路径。某些情况下，可以将该路径设置成 /dev/null（UNIX） 或 nul（windows），用来屏蔽日志输出。

Documentation

Overview

Package logger wrapped zap as a basic logging implement.

Index

• Constants
• Variables
• func Close()
• func InitRoot(opt *Option) error
• func Reset()
• func SetGlobalRootLogger(fpath, level string, options int) error
• func TotalSLoggers() int64
• type Logger
  • func DefaultSLogger(name string) *Logger
  • func SLogger(name string) *Logger
• type Option

Constants

const (
	// 禁用 JSON 形式输出.
	OPT_ENC_CONSOLE = 1 //nolint:golint,stylecheck
	// 显示代码路径时，不显示全路径.
	OPT_SHORT_CALLER = 2 //nolint:stylecheck,golint
	// 日志写到 stdout.
	OPT_STDOUT = 4 //nolint:stylecheck,golint
	// 日志内容中追加颜色.
	OPT_COLOR = 8 //nolint:stylecheck,golint
	// 日志自动切割.
	OPT_ROTATE = 32 //nolint:stylecheck,golint
	// 默认日志 flags.
	OPT_DEFAULT = OPT_ENC_CONSOLE | OPT_SHORT_CALLER | OPT_ROTATE //nolint:stylecheck,golint

	DEBUG  = "debug"
	INFO   = "info"
	WARN   = "warn"
	ERROR  = "error"
	PANIC  = "panic"
	DPANIC = "dpanic"
	FATAL  = "fatal"
)

const (
	NameKeyMod   = "mod"
	NameKeyMsg   = "msg"
	NameKeyLevel = "lev"
	NameKeyTime  = "ts"
	NameKeyPos   = "pos"
)

const (
	STDOUT = "stdout" // log output to stdout
)

Variables

var (
	MaxSize    = 32 // MB
	MaxBackups = 5
	MaxAge     = 30 // day

)

var (
	SchemeTCP = "tcp"
	SchemeUDP = "udp"
)

var (
	StdoutColor bool
	StdoutLevel = DEBUG
)

Functions

func Close

func Close()

func InitRoot

func InitRoot(opt *Option) error

InitRoot used to setup global root logger, include

• log level
• log path
• set to disk file(with or without rotate)
• set to some remtoe TCP/UDP server
• a bounch of other OPT_XXXs

func Reset

func Reset()

func SetGlobalRootLogger

func SetGlobalRootLogger(fpath, level string, options int) error

SetGlobalRootLogger deprecated, use InitRoot() instead.

func TotalSLoggers

func TotalSLoggers() int64

Types

type Logger

type Logger struct {
	*zap.SugaredLogger
}

func DefaultSLogger

func DefaultSLogger(name string) *Logger

func SLogger

func SLogger(name string) *Logger

type Option

type Option struct {
	Path  string
	Level string
	Flags int
}