Merge pull request #779 from vCaesar/u8-pr
Add logrus example and Update log
This commit is contained in:
83
zh/12.1.md
83
zh/12.1.md
@@ -1,7 +1,80 @@
|
|||||||
# 12.1 应用日志
|
# 12.1 应用日志
|
||||||
我们期望开发的Web应用程序能够把整个程序运行过程中出现的各种事件一一记录下来,Go语言中提供了一个简易的log包,我们使用该包可以方便的实现日志记录的功能,这些日志都是基于fmt包的打印再结合panic之类的函数来进行一般的打印、抛出错误处理。Go目前标准包只是包含了简单的功能,如果我们想把我们的应用日志保存到文件,然后又能够结合日志实现很多复杂的功能(编写过Java或者C++的读者应该都使用过log4j和log4cpp之类的日志工具),可以使用第三方开发的一个日志系统,`https://github.com/cihub/seelog`,它实现了很强大的日志功能。接下来我们介绍如何通过该日志系统来实现我们应用的日志功能。
|
我们期望开发的Web应用程序能够把整个程序运行过程中出现的各种事件一一记录下来,Go语言中提供了一个简易的log包,我们使用该包可以方便的实现日志记录的功能,这些日志都是基于fmt包的打印再结合panic之类的函数来进行一般的打印、抛出错误处理。Go目前标准包只是包含了简单的功能,如果我们想把我们的应用日志保存到文件,然后又能够结合日志实现很多复杂的功能(编写过Java或者C++的读者应该都使用过log4j和log4cpp之类的日志工具),可以使用第三方开发的日志系统:[logrus](https://github.com/sirupsen/logrus)和[seelog](https://github.com/cihub/seelog),它们实现了很强大的日志功能,可以结合自己项目选择。接下来我们介绍如何通过该日志系统来实现我们应用的日志功能。
|
||||||
|
|
||||||
[logrus](https://github.com/sirupsen/logrus)是另外一个不错的日志系统,结合自己项目选择
|
##logrus介绍
|
||||||
|
logrus是用Go语言实现的一个日志系统,与标准库log完全兼容并且核心API很稳定,是Go语言目前最活跃的日志库
|
||||||
|
|
||||||
|
首先安装logrus
|
||||||
|
```Go
|
||||||
|
|
||||||
|
go get -u github.com/sirupsen/logrus
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
简单例子:
|
||||||
|
|
||||||
|
```Go
|
||||||
|
|
||||||
|
package main
|
||||||
|
|
||||||
|
import (
|
||||||
|
log "github.com/Sirupsen/logrus"
|
||||||
|
)
|
||||||
|
|
||||||
|
func main() {
|
||||||
|
log.WithFields(log.Fields{
|
||||||
|
"animal": "walrus",
|
||||||
|
}).Info("A walrus appears")
|
||||||
|
}
|
||||||
|
```
|
||||||
|
### 基于logrus的自定义日志处理
|
||||||
|
```Go
|
||||||
|
|
||||||
|
package main
|
||||||
|
|
||||||
|
import (
|
||||||
|
log "github.com/Sirupsen/logrus"
|
||||||
|
"os"
|
||||||
|
)
|
||||||
|
|
||||||
|
func init() {
|
||||||
|
// 日志格式化为JSON而不是默认的ASCII
|
||||||
|
log.SetFormatter(&log.JSONFormatter{})
|
||||||
|
|
||||||
|
// 输出stdout而不是默认的stderr,也可以是一个文件
|
||||||
|
log.SetOutput(os.Stdout)
|
||||||
|
|
||||||
|
// 只记录严重或以上警告
|
||||||
|
log.SetLevel(log.WarnLevel)
|
||||||
|
}
|
||||||
|
|
||||||
|
func main() {
|
||||||
|
log.WithFields(log.Fields{
|
||||||
|
"animal": "walrus",
|
||||||
|
"size": 10,
|
||||||
|
}).Info("A group of walrus emerges from the ocean")
|
||||||
|
|
||||||
|
log.WithFields(log.Fields{
|
||||||
|
"omg": true,
|
||||||
|
"number": 122,
|
||||||
|
}).Warn("The group's number increased tremendously!")
|
||||||
|
|
||||||
|
log.WithFields(log.Fields{
|
||||||
|
"omg": true,
|
||||||
|
"number": 100,
|
||||||
|
}).Fatal("The ice breaks!")
|
||||||
|
|
||||||
|
// 通过日志语句重用字段
|
||||||
|
// logrus.Entry返回自WithFields()
|
||||||
|
contextLogger := log.WithFields(log.Fields{
|
||||||
|
"common": "this is a common field",
|
||||||
|
"other": "I also should be logged always",
|
||||||
|
})
|
||||||
|
|
||||||
|
contextLogger.Info("I'll be logged with common and other field")
|
||||||
|
contextLogger.Info("Me too")
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
## seelog介绍
|
## seelog介绍
|
||||||
seelog是用Go语言实现的一个日志系统,它提供了一些简单的函数来实现复杂的日志分配、过滤和格式化。主要有如下特性:
|
seelog是用Go语言实现的一个日志系统,它提供了一些简单的函数来实现复杂的日志分配、过滤和格式化。主要有如下特性:
|
||||||
@@ -40,17 +113,17 @@ seelog是用Go语言实现的一个日志系统,它提供了一些简单的函
|
|||||||
```
|
```
|
||||||
编译后运行如果出现了`Hello from seelog`,说明seelog日志系统已经成功安装并且可以正常运行了。
|
编译后运行如果出现了`Hello from seelog`,说明seelog日志系统已经成功安装并且可以正常运行了。
|
||||||
|
|
||||||
## 基于seelog的自定义日志处理
|
### 基于seelog的自定义日志处理
|
||||||
seelog支持自定义日志处理,下面是我基于它自定义的日志处理包的部分内容:
|
seelog支持自定义日志处理,下面是我基于它自定义的日志处理包的部分内容:
|
||||||
```Go
|
```Go
|
||||||
|
|
||||||
package logs
|
package logs
|
||||||
|
|
||||||
import (
|
import (
|
||||||
"errors"
|
// "errors"
|
||||||
"fmt"
|
"fmt"
|
||||||
seelog "github.com/cihub/seelog"
|
seelog "github.com/cihub/seelog"
|
||||||
"io"
|
// "io"
|
||||||
)
|
)
|
||||||
|
|
||||||
var Logger seelog.LoggerInterface
|
var Logger seelog.LoggerInterface
|
||||||
|
|||||||
Reference in New Issue
Block a user