logger

README

logger

基本用法

package main

import (
    "github.com/isyscore/isc-gobase/logger"
)

func main() {
    logger.Debug("hello %v", "debug")
    logger.Info("hello %v", "info")
    logger.Warn("hello %v", "warn")
    logger.Error("hello %v", "error")
}

配置

base:
  logger:
    level: info
    # 日志文件目录，默认工程目录的logs文件夹
    home: ./logs/
    color:
      # 启用：true/false，默认：false
      enable: false
    # 日志滚动策略
    rotate:
      # 日志滚动size；默认300MB
      max-size: 300MB
      # 日志文件最大保留天数；默认60天
      max-history: 60d
      # 多久滚动一次；默认一天
      time: 1d
    path:
      # 日志展示格式：full-全路径；short-短路径；默认short
      type: short
    # 指定分组
    group:
      # 分组1
      group1:
        # 分组1的日志级别
        level: info
      # 分组2
      group2:
        # 分组2的日志级别
        level: debug

更多用法

1. 分组打印

对日志进行精细化管控，这里增加日志分组功能，其中默认分组为"root"，我们可以指定我们自己的分组，在代码中不同的业务代码中使用不同的分组，这样在需要的情况下，我们可以对该模块的日志级别进行精细化控制

package main

import (
    "github.com/isyscore/isc-gobase/logger"
)

func main() {
    logger.Group("group1").Info("hello", " ", "info")
    logger.Group("group1").Infof("hello %v", "info")
}

2. 线上日志级别动态修改

支持线上动态的日志修改，base.logger.level为默认分组的日志级别，如下修改为默认分组

2.1 root默认分组修改

curl -X PUT http://localhost:xxx/{api-prefix}/{api-module}/config/update -d '{"key":"base.logger.level", "value":"debug"}'

func main() {
    // 设置为debug后，如下的debug级别能够记录到日志中
    logger.Debug("hello %v", "debug1")
}

2.2 指定分组修改

如下为指定group名字为xxx的，设置日志级别为debug

curl -X PUT http://localhost:xxx/{api-prefix}/{api-module}/config/update -d '{"key":"base.logger.group.xxxx.level", "value":"debug"}'

func main() {
    // 如下的日志就会被打印出来，否则默认info级别是不打印的
    logger.Group("group1").Debugf("hello %v", "debug")
}

Documentation

Index

• func ConfigChangeListener(event listener.BaseEvent)
• func Debug(format string, v ...any)
• func DebugDirect(v ...any)
• func Error(format string, v ...any)
• func ErrorDirect(v ...any)
• func Fatal(format string, v ...any)
• func FatalDirect(v ...any)
• func Group(groupNames ...string) *logrus.Logger
• func Info(format string, v ...any)
• func InfoDirect(v ...any)
• func InitLog()
• func Panic(format string, v ...any)
• func PanicDirect(v ...any)
• func Record(level, format string, v ...any)
• func SetGlobalLevel(strLevel string)
• func Trace(format string, v ...any)
• func TraceDirect(v ...any)
• func Warn(format string, v ...any)
• func WarnDirect(v ...any)
• type StandardFormatter
  • func (m *StandardFormatter) Format(entry *logrus.Entry) ([]byte, error)

Functions

func ConfigChangeListener

func ConfigChangeListener(event listener.BaseEvent)

func Debug

func Debug(format string, v ...any)

func DebugDirect

func DebugDirect(v ...any)

func Error

func Error(format string, v ...any)

func ErrorDirect

func ErrorDirect(v ...any)

func Fatal

func Fatal(format string, v ...any)

func FatalDirect

func FatalDirect(v ...any)

func Group

func Group(groupNames ...string) *logrus.Logger

func Info

func Info(format string, v ...any)

func InfoDirect

func InfoDirect(v ...any)

func InitLog

func InitLog()

func Panic

func Panic(format string, v ...any)

func PanicDirect

func PanicDirect(v ...any)

func Record

func Record(level, format string, v ...any)

func SetGlobalLevel

func SetGlobalLevel(strLevel string)

func Trace

func Trace(format string, v ...any)

func TraceDirect

func TraceDirect(v ...any)

func Warn

func Warn(format string, v ...any)

func WarnDirect

func WarnDirect(v ...any)

Types

type StandardFormatter

type StandardFormatter struct{}

func (*StandardFormatter) Format

func (m *StandardFormatter) Format(entry *logrus.Entry) ([]byte, error)