beego/logs模块的使用

1. 通用方式

首先引入包：

import ( "github.com/astaxie/beego/logs" )

然后添加输出引擎（log 支持同时输出到多个引擎），这里我们以 console 为例，第一个参数是引擎名（包括：console、file、conn、smtp、es、multifile）

// SetLogger provides a given logger adapter into BeeLogger with config string.
// config need to be correct JSON as string: {"interval":360}.
logs.SetLogger("console")

添加输出引擎也支持第二个参数,用来表示配置信息

logs.SetLogger(logs.AdapterFile,`{"filename":"project.log","level":7,"maxlines":0,"maxsize":0,"daily":true,"maxdays":10}`)

2.输出文件名和行号

日志默认不输出调用的文件名和文件行号,如果你期望输出调用的文件名和文件行号,可以如下设置

// EnableFuncCallDepth enable log funcCallDepth
logs.EnableFuncCallDepth(true)

func EnableFuncCallDepth(b bool) {beeLogger.enableFuncCallDepth = b
}

开启传入参数 true,关闭传入参数 false,默认是关闭的.

如果你的应用自己封装了调用 log 包,那么需要设置 SetLogFuncCallDepth,默认是 2,也就是直接调用的层级,如果你封装了多层,那么需要根据自己的需求进行调整.

logs.SetLogFuncCallDepth(3)

// SetLogFuncCall set the CallDepth, default is 4
func SetLogFuncCall(b bool) {beeLogger.EnableFuncCallDepth(b)beeLogger.SetLogFuncCallDepth(4)
}

3. 异步输出日志

为了提升性能, 可以设置异步输出:

logs.Async()

// Async set the beelogger with Async mode and hold msglen messages
func Async(msgLen ...int64) *BeeLogger {return beeLogger.Async(msgLen...)
}

异步输出允许设置缓冲 chan 的大小

logs.Async(1e3)

4. 引擎配置

console

可以设置输出的级别，或者不设置保持默认，默认输出到 os.Stdout：

// SetLogger provides a given logger adapter into BeeLogger with config string.
// config need to be correct JSON as string: {"interval":360}.
//level 输出的日志级别
//color 是否开启打印日志彩色打印(需环境支持彩色输出)
logs.SetLogger(logs.AdapterConsole, `{"level":1,"color":true}`)

file

设置的例子如下所示：

//file
//filename 保存的文件名
//maxlines 每个文件保存的最大行数，默认值 1000000
//maxsize 每个文件保存的最大尺寸，默认值是 1 << 28, //256 MB
//  daily 是否按照每天 logrotate，默认是 true
//maxdays 文件最多保存多少天，默认保存 7 天
//rotate 是否开启 logrotate，默认是 true
//level 日志保存的时候的级别，默认是 Trace 级别
//perm 日志文件权限
logs.SetLogger(logs.AdapterFile, `{"filename":"test.log"  }`)

multifile

设置的例子如下所示：

//multifile//filename 保存的文件名//maxlines 每个文件保存的最大行数，默认值 1000000//maxsize 每个文件保存的最大尺寸，默认值是 1 << 28, //256 MB// daily 是否按照每天 logrotate，默认是 true//maxdays 文件最多保存多少天，默认保存 7 天//rotate 是否开启 logrotate，默认是 true//level 日志保存的时候的级别，默认是 Trace 级别//perm 日志文件权限//separate 需要单独写入文件的日志级别,设置后命名类似 test.error.loglogs.SetLogger(logs.AdapterMultiFile, `{"filename":"test.log","separate":["emergency", "alert", "critical", "error", "warning", "notice", "info", "debug"]}`)

conn

网络输出，设置的例子如下所示：

//conn（网络输出）//reconnectOnMsg 是否每次链接都重新打开链接，默认是 false//reconnect 是否自动重新链接地址，默认是 false//net 发开网络链接的方式，可以使用 tcp、unix、udp 等//addr 网络链接的地址//level 日志保存的时候的级别，默认是 Trace 级别logs.SetLogger(logs.AdapterConn, `{"net":"tcp","addr":":7020"}`)

smtp

邮件发送，设置的例子如下所示：

//smtp(邮件发送)//username smtp 验证的用户名//password smtp 验证密码//host 发送的邮箱地址//sendTos 邮件需要发送的人，支持多个//subject 发送邮件的标题，默认是 Diagnostic message from server//level 日志发送的级别，默认是 Trace 级别logs.SetLogger(logs.AdapterMail, `{"username":"beegotest@gmail.com","password":"xxxxxxxx","host":"smtp.gmail.com:587","sendTos":["xiemengjun@gmail.com"]}`)

ElasticSearch

输出到 ElasticSearch:

logs.SetLogger(logs.AdapterEs, `{"dsn":"http://localhost:9200/","level":1}`

参考文章：
https://beego.me/docs/mvc/controller/logs.md
https://beego.me/docs/module/logs.md