coeditor/GinSkeleton/docs/zap_log.md

日志功能, 基于 zap + lumberjack 实现

1.特点：高性能、极速，功能：实现日志的标准管理、日志文件的自动分隔备份.
2.该日志在项目骨架启动时我们封装了全局变量(variable.ZapLog)，直接调用即可，底层按照官方标准封装，使用者调用后不需要关闭日志，也不需要担心全局变量写日志存在并发冲突问题，底层会自动加锁后再写。
3.相关包 github 地址：https://github.com/uber-go/zap 、 https://github.com/natefinch/lumberjack

前言

1.日志相关的配置参见，config目录内的config.yml文件，Logs 部分，程序默认处于AppDebug|调试模式，日志输出在console面板，编译时记得切换模式。
2.本文档列举几种最常用的用法, 想要深度学习请参考相关的 github 地址.

日志处理, 标准函数

参数一：文本型
参数二：可变参数，可传递0个或者多个 Field 类型参数，Field 类型传递规则参见下文

>   1. Debug(参数一, 参数二) , 调试级别，会产生大量日志，只在开发模式（AppDebug=true）会输出日志打印在console面板，生产模式该函数禁用。 
>   2. Info(参数一, 参数二) ,  一般信息，默认级别。 
>   3. Warn(参数一, 参数二) ,  警告 
>   4. Panic(参数一, 参数二)、Dpanic(参数一, 参数二) , 恐慌、宕机，不建议使用 
>   5. Error(参数一, 参数二) , 错误
>   6. Fatal(参数一, 参数二) , 致命错误，会导致程序进程退出。 

标准函数的参数二 Field 类型，最常用传递方式

1.Int 类型 ： zap.Int("userID",2019) , 同类的还有 int16 、 int32等
2.String 类型 ： zap.String("userID","2019")
3.Error 类型 ： zap.Error(v_err) ， v_err 为 error(错误类型)，例如使用 v_err:= error.New("模拟一个错误")
4.Bool 类型 ： zap.Bool("is_ok",true)

用法 1 , 高性能模式 .

1.举例展示最常用用法

    variable.ZapLog.Info("基本的运行提示类信息")
    variable.ZapLog.Warn("UserCreate接口参数非法警告，相关参数：",zap.String("userName","demo_name"),zap.Int("userAge",18))  
    variable.ZapLog.Panic("UserDestory接口参数异常，相关参数：",zap.String("userName","demo_name"),zap.String("password","pass123456") 
    variable.ZapLog.Error("UserDestory接口参数错误，相关参数：",zap.Error(error))  
    variable.ZapLog.Fatal("Mysql初始化参数错误，退出运行。相关参数：",zap.String("name","root"), zap.Int("端口",3306))  

用法2 , 语法糖模式 .

1.比第一种用法性能稍低，只不过基于第一种用法，相关的函数全部增加了格式化参数功能

 # 第一种的函数后面全部添加了一个 w ,相关的函数功能和第一种一模一样  
 variable.ZapLog.Sugar().Infow("基本的运行提示类信息",zap.String("name","root"))

# 格式化参数，第一种用法中的函数后面添加了一个 f 
 variable.ZapLog.Sugar().Infof("参数 userId %d\n",2020)

 variable.ZapLog.Sugar().Errorw("程序发生错误",zap.Error(error))
 variable.ZapLog.Sugar().Errorf("参数非法，程序出错，userId %d\n",2020)

 Warn  、 Panic 、Fatal用法类似

日志钩子

1.除了本项目骨架记录日志之外，您还可以对日志进行二次加工处理.
2.日志钩子函数处理位置 > app/service/sys_log_hook/zap_log_hooks.go
3.bootStrap/init.go 中你可以修改钩子函数的位置 相关代码位置 app/service/sys_log_hook/zap_log_hooks.go

func ZapLogHandler(entry zapcore.Entry) error {

	// 参数 entry 介绍
	// entry  参数就是单条日志结构体，主要包括字段如下：
	//Level      日志等级
	//Time       当前时间
	//LoggerName  日志名称
	//Message    日志内容
	//Caller     各个文件调用路径
	//Stack      代码调用栈

	//这里启动一个协程，hook丝毫不会影响程序性能，
	go func(paramEntry zapcore.Entry) {
		//fmt.Println(" GoSkeleton  hook ....，你可以在这里继续处理系统日志....")
		//fmt.Printf("%#+v\n", paramEntry)
	}(entry)
	return nil
}