1. logger包介绍
|
1
|
import "github.com/wonderivan/logger" |
在我们开发go程序的过程中，发现记录程序日志已经不是fmt.print这么简单，我们想到的是打印输出能够明确指定当时运行时间、运行代码段，当然我们可以引入go官方自带包 import “log”，然后通过log.printf、log.println等方式输出，而且默认是日志输出时只带时间的，想要同时输出所运行代码段位置，还需要通过执行一下指定进行相关简单的设置
|
1
2
|
log.setflags(log.lstdflags | log.lshortfile)log.setprefix(xxx) |
然而logger要做的并不仅仅是要这些：
logger支持自定义时间格式
logger支持不同的日志等级输出，能够有效提高日志输出性能和检索；
logger支持控制台+文件+网络的三种方式输出，并且可以任意组合。
logger支持控制台输出颜色区分；
logger支持文本输出的自定制；
logger支持网络日志传输，例如直连logstash发送。
2. logger包使用
logger包使用起来非常方便，很多配置参数都有其默认值，符合通常使用习惯。如果仅需要在控制台输出，则只需要引入该包，然后直接使用即可：
|
1
2
3
4
5
6
7
8
9
10
11
12
|
package main import "github.com/wonderivan/logger"func main() { logger.trace("this is trace") // 由于默认输出，只会在控制台输出debug及其以上日志，所以该条不会输出 logger.debug("this is debug") logger.info("this is info") logger.warn("this is warn") logger.error("this is error") logger.crit("this is critical") logger.alert("this is alert") logger.emer("this is emergency")} |
此时在终端即可输出（如果是非windows终端，支持日志等级颜色区分）：
3. logger详细介绍
在上边介绍了logger的基本使用后，接下来详细介绍一下该包的文本输出和网络输出，及其相关配置项。
3.1 日志等级
当前日志输出等级共8种，从0-7对应的等级由高到底，可以通过配置参数进行配置，默认为debg级别，当配置为某个输出等级时，只有大于等于该等级的日志才会输出。不同的输出适配器支持不同的日志等级配置。
| 等级 | 配置 | 释义 | 控制台颜色 |
| 0 | emer | 系统级紧急，比如磁盘出错，内存异常，网络不可用等 | 红色底 |
| 1 | alrt | 系统级警告，比如数据库访问异常，配置文件出错等 | 紫色 |
| 2 | crit | 系统级危险，比如权限出错，访问异常等 | 蓝色 |
| 3 | eror | 用户级错误 | 红色 |
| 4 | warn | 用户级警告 | 黄色 |
| 5 | info | 用户级重要 | 天蓝色 |
| 6 | debg | 用户级调试 | 绿色 |
| 7 | trac | 用户级基本输出，比如成员信息，结构体值等 | 绿色 |
3.2 配置参数说明
logger当前支持控制台、文件、网络3种方式输出，这3中输出时通过各自的json格式参数进行设置，如果未配置某项适配器时，则不初始化也不会输出到该适配器。
默认配置为只控制台输出debg及其以上日志。
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
|
{ "timeformat":"2006-01-02 15:04:05", // 输出日志开头时间格式 "console": { // 控制台日志配置 "level": "trac", // 控制台日志输出等级 "color": true // 控制台日志颜色开关 }, "file": { // 文件日志配置 "filename": "app.log", // 初始日志文件名 "level": "trac", // 日志文件日志输出等级 "daily": true, // 跨天后是否创建新日志文件，当append=true时有效 "maxlines": 1000000, // 日志文件最大行数，当append=true时有效 "maxsize": 1, // 日志文件最大大小，当append=true时有效 "maxdays": -1, // 日志文件有效期 "append": true, // 是否支持日志追加 "permit": "0660" // 新创建的日志文件权限属性 }, "conn": { // 网络日志配置 "net":"tcp", // 日志传输模式 "addr":"10.1.55.10:1024", // 日志接收服务器 "level": "warn", // 网络日志输出等级 "reconnect":true, // 网络断开后是否重连 "reconnectonmsg":false, // 发送完每条消息后是否断开网络 }} |
输出日志开头时间格式只要该符合go中time.format格式即可，例如：
| 时间类型 | 时间格式 |
|---|---|
| ansic | "mon jan _2 15:04:05 2006" |
| unixdate | "mon jan _2 15:04:05 mst 2006" |
| rubydate | "mon jan 02 15:04:05 -0700 2006" |
| rfc822 | "02 jan 06 15:04 mst" |
| rfc822z | "02 jan 06 15:04 -0700" |
| rfc850 | "monday, 02-jan-06 15:04:05 mst" |
| rfc1123 | "mon, 02 jan 2006 15:04:05 mst" |
| rfc1123z | "mon, 02 jan 2006 15:04:05 -0700" |
| rfc3339 | "2006-01-02t15:04:05z07:00" |
| rfc3339nano | "2006-01-02t15:04:05.999999999z07:00" |
| kitchen | "3:04pm" |
| stamp | "jan _2 15:04:05" |
| stampmilli | "jan _2 15:04:05.000" |
| stampmicro | "jan _2 15:04:05.000000" |
| stampnano | "jan _2 15:04:05.000000000" |
| rfc3339nano1 | "2006-01-02 15:04:05.999999999 -0700 mst" |
| default | "2006-01-02 15:04:05" |
对应的输出开头时间格式为：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
|
========rfc1123z time format======== thu, 02 aug 2018 18:48:04 +0800 [debg] [github.com/wonderivan/logger/log_test.go:115] debug r========stamp time format======== aug 2 18:48:04 [debg] [github.com/wonderivan/logger/log_test.go:115] debug stamp ========stampmilli time format======== aug 2 18:48:04.489 [debg] [github.com/wonderivan/logger/log_test.go:115] debug stampmilli ========stampnano time format======== aug 2 18:48:04.490002155 [debg] [github.com/wonderivan/logger/log_test.go:115] debug stampna========rubydate time format======== thu aug 02 18:48:04 +0800 2018 [debg] [github.com/wonderivan/logger/log_test.go:115] debug ru========rfc822 time format======== 02 aug 18 18:48 cst [debg] [github.com/wonderivan/logger/log_test.go:115] debug rfc822 ========rfc822z time format======== 02 aug 18 18:48 +0800 [debg] [github.com/wonderivan/logger/log_test.go:115] debug rfc822z ========rfc1123 time format======== thu, 02 aug 2018 18:48:04 cst [debg] [github.com/wonderivan/logger/log_test.go:115] debug rfc========rfc3339 time format======== 2018-08-02t18:48:04+08:00 [debg] [github.com/wonderivan/logger/log_test.go:115] debug rfc3339========rfc3339nano time format======== 2018-08-02t18:48:04.490377325+08:00 [debg] [github.com/wonderivan/logger/log_test.go:115] deb========ansic time format======== thu aug 2 18:48:04 2018 [debg] [github.com/wonderivan/logger/log_test.go:115] debug ansic ========unixdate time format======== thu aug 2 18:48:04 cst 2018 [debg] [github.com/wonderivan/logger/log_test.go:115] debug unix========rfc850 time format======== thursday, 02-aug-18 18:48:04 cst [debg] [github.com/wonderivan/logger/log_test.go:115] debug ========kitchen time format======== 6:48pm [debg] [github.com/wonderivan/logger/log_test.go:115] debug kitchen ========stampmicro time format======== aug 2 18:48:04.490662 [debg] [github.com/wonderivan/logger/log_test.go:115] debug stampmicro |
3.3 设置配置参数：
通过调用logger.setlogger(config string)方法设置参数，config支持json配置，也支持指定内容为json配置的文件路径，例如：
|
1
2
3
4
|
// 通过配置参数直接配置logger.setlogger(`{"console": {"level": "debg"}}`)// 通过配置文件配置logger.setlogger("/home/log.json") |
3.4 配置其他相关说明
1、当日志文件配置项append为true时，如果当前写入的日志发生跨天(daily为true)或超过最大限制时，会创建一个新文件，原有文件格式被重命名为： ****.xxxx-xx-xx.xxx.xxx 格式，例如：当向app.log写入日志时，触发了创建新文件操作，则将app.log重命名为 app.2018-01-01.001.log, 如果此时app.2018-01-01.001.log已经存在，则将刚才的app.log重命名为 app.2018-01-01.002.log，以此类推。
2、logger package默认初始化了全局的defaultlogger，所以直接调用logger.setlogger的其实是给该对象设置输出参数，如果想要使用自定义的logger对象，需要通过logger.newlogger()进行初始化。
3、网络配置中的reconnectonmsg为true时，每条发送一条消息都会重连一次网络日志中心，适用于写日志频率极低的情况下的调用,可以减少长时间网络连接而占用资源。但强烈不建议平常使用时设置为true，这将会导致调用方反复的网络重连，极大增加资源消耗和延迟。
4、conn网络输出适配器经过elk集成环境的测试验证，通过该方式发送的日志，能够正常通过elecsearch和kibana检索和分析
4 下载和使用
保证golang开发环境的正常配置，并且go相关工具安装完成，gopath等设置正常（go开发所必须的）。
执行go get github.com/wonderivan/logger , 然后import 该包即可使用。
包源码链接：golang日志包logger
以上为个人经验，希望能给大家一个参考，也希望大家多多支持服务器之家。如有错误或未考虑完全的地方，望不吝赐教。
原文链接：https://blog.csdn.net/q342733584/article/details/81381837
