Merge pull request astaxie#779 from vCaesar/u8-pr

Add logrus example and Update log

Author: astaxie

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