diff --git a/zh/12.1.md b/zh/12.1.md index 8e1ef6b3..8fd0e848 100644 --- a/zh/12.1.md +++ b/zh/12.1.md @@ -1,7 +1,80 @@ # 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是用Go语言实现的一个日志系统,它提供了一些简单的函数来实现复杂的日志分配、过滤和格式化。主要有如下特性: @@ -40,17 +113,17 @@ seelog是用Go语言实现的一个日志系统,它提供了一些简单的函 ``` 编译后运行如果出现了`Hello from seelog`,说明seelog日志系统已经成功安装并且可以正常运行了。 -## 基于seelog的自定义日志处理 +### 基于seelog的自定义日志处理 seelog支持自定义日志处理,下面是我基于它自定义的日志处理包的部分内容: ```Go package logs import ( - "errors" + // "errors" "fmt" seelog "github.com/cihub/seelog" - "io" + // "io" ) var Logger seelog.LoggerInterface