beego 日志配置

  • 2020-09-16
  • 浏览 (44)

beego logs 的设计思路来自于 database/sql,目前支持的引擎有 file、console、net、smtp,可以通过如下方式进行安装:

go get github.com/astaxie/beego/logs

如何使用

通用方式

首先引入包:

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

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

logs.SetLogger("console")

添加输出引擎也支持第二个参数,用来表示配置信息,详细的配置请看下面介绍:

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

然后我们就可以在我们的逻辑中开始任意的使用了:

package main

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

func main() {
    //an official log.Logger
    l := logs.GetLogger()
    l.Println("this is a message of http")
    //an official log.Logger with prefix ORM
    logs.GetLogger("ORM").Println("this is a message of orm")

    logs.Debug("my book is bought in the year of ", 2016)
    logs.Info("this %s cat is %v years old", "yellow", 3)
    logs.Warn("json is a type of kv like", map[string]int{"key": 2016})
    logs.Error(1024, "is a very", "good game")
    logs.Critical("oh,crash")
}

多个实例

一般推荐使用通用方式进行日志,但依然支持单独声明来使用独立的日志

    package main

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

    func main() {
        log := logs.NewLogger()
        log.SetLogger(logs.AdapterConsole)
        log.Debug("this is a debug message")
    }

输出文件名和行号

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

logs.EnableFuncCallDepth(true)

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

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

logs.SetLogFuncCallDepth(3)

异步输出日志

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

logs.Async()

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

logs.Async(1e3)

引擎配置设置

  • console

    `` 命令行输出,默认输出到os.Stdout`:

logs.SetLogger(logs.AdapterConsole, {"level":1,"color":true})


  主要的参数如下说明:

  - level 输出的日志级别
  - color 是否开启打印日志彩色打印(需环境支持彩色输出)

- file

  设置的例子如下所示:

logs.SetLogger(logs.AdapterFile, {"filename":"test.log"})


  主要的参数如下说明:

  - filename 保存的文件名
  - maxlines 每个文件保存的最大行数,默认值 1000000
  - maxsize 每个文件保存的最大尺寸,默认值是 1 << 28, //256 MB
  - daily 是否按照每天 logrotate,默认是 true
  - maxdays 文件最多保存多少天,默认保存 7 天
  - rotate 是否开启 logrotate,默认是 true
  - level 日志保存的时候的级别,默认是 Trace 级别
  - perm 日志文件权限

- multifile

  设置的例子如下所示:

logs.SetLogger(logs.AdapterMultiFile, {"filename":"test.log","separate":["emergency", "alert", "critical", "error", "warning", "notice", "info", "debug"]})


  主要的参数如下说明(除 separate 外,均与file相同):

  - filename 保存的文件名
  - maxlines 每个文件保存的最大行数,默认值 1000000
  - maxsize 每个文件保存的最大尺寸,默认值是 1 << 28, //256 MB
  - daily 是否按照每天 logrotate,默认是 true
  - maxdays 文件最多保存多少天,默认保存 7 天
  - rotate 是否开启 logrotate,默认是 true
  - level 日志保存的时候的级别,默认是 Trace 级别
  - perm 日志文件权限
  - separate 需要单独写入文件的日志级别,设置后命名类似 test.error.log

- conn

  网络输出,设置的例子如下所示:

logs.SetLogger(logs.AdapterConn, {"net":"tcp","addr":":7020"})


  主要的参数说明如下:

  - reconnectOnMsg 是否每次链接都重新打开链接,默认是 false
  - reconnect 是否自动重新链接地址,默认是 false
  - net 发开网络链接的方式,可以使用 tcp、unix、udp 等
  - addr 网络链接的地址
  - level 日志保存的时候的级别,默认是 Trace 级别

- smtp

  邮件发送,设置的例子如下所示:

logs.SetLogger(logs.AdapterMail, {"username":"beegotest@gmail.com","password":"xxxxxxxx","host":"smtp.gmail.com:587","sendTos":["xiemengjun@gmail.com"]})


  主要的参数说明如下:

  - username smtp 验证的用户名
  - password smtp 验证密码
  - host 发送的邮箱地址
  - sendTos 邮件需要发送的人,支持多个
  - subject 发送邮件的标题,默认是 `Diagnostic message from server`
  - level 日志发送的级别,默认是 Trace 级别

- ElasticSearch

  输出到 ElasticSearch:

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


- 简聊

  输出到简聊:

logs.SetLogger(logs.AdapterJianLiao, {"authorname":"xxx","title":"beego", "webhookurl":"https://jianliao.com/xxx", "redirecturl":"https://jianliao.com/xxx","imageurl":"https://jianliao.com/xxx","level":1})


- slack

  输出到slack:

logs.SetLogger(logs.AdapterSlack, {"webhookurl":"https://slack.com/xxx","level":1})
```