start to translator chinese to English

2016-09-13 21:42:49 +08:00
parent 70144f92b6
commit 1819ce9cd0
201 changed files with 12982 additions and 0 deletions
--- a/en/12.1.md
+++ b/en/12.1.md
@@ -0,0 +1,166 @@
+# 12.1 应用日志
+我们期望开发的Web应用程序能够把整个程序运行过程中出现的各种事件一一记录下来，Go语言中提供了一个简易的log包，我们使用该包可以方便的实现日志记录的功能，这些日志都是基于fmt包的打印再结合panic之类的函数来进行一般的打印、抛出错误处理。Go目前标准包只是包含了简单的功能，如果我们想把我们的应用日志保存到文件，然后又能够结合日志实现很多复杂的功能（编写过Java或者C++的读者应该都使用过log4j和log4cpp之类的日志工具），可以使用第三方开发的一个日志系统，`https://github.com/cihub/seelog`，它实现了很强大的日志功能。接下来我们介绍如何通过该日志系统来实现我们应用的日志功能。
+
+## seelog介绍
+seelog是用Go语言实现的一个日志系统，它提供了一些简单的函数来实现复杂的日志分配、过滤和格式化。主要有如下特性：
+
+- XML的动态配置，可以不用重新编译程序而动态的加载配置信息
+- 支持热更新，能够动态改变配置而不需要重启应用
+- 支持多输出流，能够同时把日志输出到多种流中、例如文件流、网络流等
+- 支持不同的日志输出
+
+	- 命令行输出
+	- 文件输出
+	- 缓存输出
+	- 支持log rotate
+	- SMTP邮件
+
+上面只列举了部分特性，seelog是一个特别强大的日志处理系统，详细的内容请参看官方wiki。接下来我将简要介绍一下如何在项目中使用它：
+
+首先安装seelog
+
+	go get -u github.com/cihub/seelog
+	
+然后我们来看一个简单的例子：
+
+	package main
+
+	import log "github.com/cihub/seelog"
+
+	func main() {
+	    defer log.Flush()
+	    log.Info("Hello from Seelog!")
+	}
+
+编译后运行如果出现了`Hello from seelog`，说明seelog日志系统已经成功安装并且可以正常运行了。
+
+## 基于seelog的自定义日志处理
+seelog支持自定义日志处理，下面是我基于它自定义的日志处理包的部分内容：
+
+	package logs
+	
+	import (
+		"errors"
+		"fmt"
+		seelog "github.com/cihub/seelog"
+		"io"
+	)
+	
+	var Logger seelog.LoggerInterface
+	
+	func loadAppConfig() {
+		appConfig := `
+	<seelog minlevel="warn">
+	    <outputs formatid="common">
+	        <rollingfile type="size" filename="/data/logs/roll.log" maxsize="100000" maxrolls="5"/>
+			<filter levels="critical">
+	            <file path="/data/logs/critical.log" formatid="critical"/>
+	            <smtp formatid="criticalemail" senderaddress="astaxie@gmail.com" sendername="ShortUrl API" hostname="smtp.gmail.com" hostport="587" username="mailusername" password="mailpassword">
+	                <recipient address="xiemengjun@gmail.com"/>
+	            </smtp>
+	        </filter>
+	    </outputs>
+	    <formats>
+	        <format id="common" format="%Date/%Time [%LEV] %Msg%n" />
+		    <format id="critical" format="%File %FullPath %Func %Msg%n" />
+		    <format id="criticalemail" format="Critical error on our server!\n    %Time %Date %RelFile %Func %Msg \nSent by Seelog"/>
+	    </formats>
+	</seelog>
+	`
+		logger, err := seelog.LoggerFromConfigAsBytes([]byte(appConfig))
+		if err != nil {
+			fmt.Println(err)
+			return
+		}
+		UseLogger(logger)
+	}
+	
+	func init() {
+		DisableLog()
+		loadAppConfig()
+	}
+	
+	// DisableLog disables all library log output
+	func DisableLog() {
+		Logger = seelog.Disabled
+	}
+	
+	// UseLogger uses a specified seelog.LoggerInterface to output library log.
+	// Use this func if you are using Seelog logging system in your app.
+	func UseLogger(newLogger seelog.LoggerInterface) {
+		Logger = newLogger
+	}
+
+上面主要实现了三个函数，
+
+- `DisableLog`
+	
+	初始化全局变量Logger为seelog的禁用状态，主要为了防止Logger被多次初始化
+- `loadAppConfig`
+
+	根据配置文件初始化seelog的配置信息，这里我们把配置文件通过字符串读取设置好了，当然也可以通过读取XML文件。里面的配置说明如下：
+	
+	- seelog 
+	
+		minlevel参数可选，如果被配置,高于或等于此级别的日志会被记录，同理maxlevel。
+	- outputs
+		
+		输出信息的目的地，这里分成了两份数据，一份记录到log rotate文件里面。另一份设置了filter，如果这个错误级别是critical，那么将发送报警邮件。
+		
+	- formats
+	
+		定义了各种日志的格式
+	
+- `UseLogger`
+
+	设置当前的日志器为相应的日志处理
+	
+上面我们定义了一个自定义的日志处理包，下面就是使用示例：
+
+	package main
+	
+	import (
+		"net/http"
+		"project/logs"
+		"project/configs"
+		"project/routes"
+	)
+	
+	func main() {
+		addr, _ := configs.MainConfig.String("server", "addr")
+		logs.Logger.Info("Start server at:%v", addr)
+		err := http.ListenAndServe(addr, routes.NewMux())
+		logs.Logger.Critical("Server err:%v", err)
+	}
+
+## 发生错误发送邮件
+上面的例子解释了如何设置发送邮件，我们通过如下的smtp配置用来发送邮件：
+
+	<smtp formatid="criticalemail" senderaddress="astaxie@gmail.com" sendername="ShortUrl API" hostname="smtp.gmail.com" hostport="587" username="mailusername" password="mailpassword">
+		<recipient address="xiemengjun@gmail.com"/>
+	</smtp>
+
+邮件的格式通过criticalemail配置，然后通过其他的配置发送邮件服务器的配置，通过recipient配置接收邮件的用户，如果有多个用户可以再添加一行。
+
+要测试这个代码是否正常工作，可以在代码中增加类似下面的一个假消息。不过记住过后要把它删除，否则上线之后就会收到很多垃圾邮件。
+
+	logs.Logger.Critical("test Critical message")
+
+现在，只要我们的应用在线上记录一个Critical的信息，你的邮箱就会收到一个Email，这样一旦线上的系统出现问题，你就能立马通过邮件获知，就能及时的进行处理。			
+## 使用应用日志
+对于应用日志，每个人的应用场景可能会各不相同，有些人利用应用日志来做数据分析，有些人利用应用日志来做性能分析，有些人来做用户行为分析，还有些就是纯粹的记录，以方便应用出现问题的时候辅助查找问题。
+
+举一个例子，我们需要跟踪用户尝试登陆系统的操作。这里会把成功与不成功的尝试都记录下来。记录成功的使用"Info"日志级别，而不成功的使用"warn"级别。如果想查找所有不成功的登陆，我们可以利用linux的grep之类的命令工具，如下：
+
+	# cat /data/logs/roll.log | grep "failed login"
+	2012-12-11 11:12:00 WARN : failed login attempt from 11.22.33.44 username password
+
+通过这种方式我们就可以很方便的查找相应的信息，这样有利于我们针对应用日志做一些统计和分析。另外我们还需要考虑日志的大小，对于一个高流量的Web应用来说，日志的增长是相当可怕的，所以我们在seelog的配置文件里面设置了logrotate，这样就能保证日志文件不会因为不断变大而导致我们的磁盘空间不够引起问题。
+
+## 小结
+通过上面对seelog系统及如何基于它进行自定义日志系统的学习，现在我们可以很轻松的随需构建一个合适的功能强大的日志处理系统了。日志处理系统为数据分析提供了可靠的数据源，比如通过对日志的分析，我们可以进一步优化系统，或者应用出现问题时方便查找定位问题，另外seelog也提供了日志分级功能，通过对minlevel的配置，我们可以很方便的设置测试或发布版本的输出消息级别。
+
+## links
+   * [目录](<preface.md>)
+   * 上一章: [部署与维护](<12.0.md>)
+   * 下一节: [网站错误处理](<12.2.md>)