Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
...
...
...
dev/github.com/gogf/gf/v2/net/ghttp#ServerConfig
配置属性
日志相关配置属性如下：
| Code Block | ||
|---|---|---|
| ||
Logger *glog.Logger // Logger for server.
LogPath string // Directory for storing logging files.
LogStdout bool // Printing logging content to stdout.
ErrorStack bool // Logging stack information when error.
ErrorLogEnabled bool // Enable error logging files.
ErrorLogPattern string // Error log file pattern like: error-{Ymd}.log
AccessLogEnabled bool // Enable access logging files.
AccessLogPattern string // Error log file pattern like: access-{Ymd}.log |
...
简要说明：
...
- 默认情况下，日志不会输出到文件中，而是直接打印到终端。默认情况下的
access日志终端输出是关闭的，仅有error日志默认开启。
...
- 所有的选项均可通过
Server.Set*方法设置，大部分选项可以通过Server.Get*方法获取。
...
Logger是一个自定义的日志管理对象，开发者也可以传递一个完整的日志管理对象，忽略其他日志选项配置。
...
LogPath属性用于设置日志目录，只有在设置了日志目录的情况下才会输出日志到日志文件中。
...
ErrorLogPattern及AccessLogPattern用于配置日志文件名称格式，默认为error-{Ymd}.log及access-{Ymd}.log，例如：error-20191212.log,access-20191212.log。
...
- 其他配置选项说明请参考注释和API文档。
配置文件
官方推荐使用配置文件的方式来管理服务配置以及日志日志配置。 一个参考的日志配置内容示例（以
...
yaml格式为例）：
...
| Code Block | ||
|---|---|---|
| ||
server: LogPath: |
...
"/var/log/gf-demos/server"
|
...
LogStdout: |
...
false
|
...
ErrorStack |
...
: |
...
true
|
...
ErrorLogEnabled |
...
: |
...
true
|
...
ErrorLogPattern |
...
: |
...
"error.{Ymd}.log"
|
...
AccessLogEnabled |
...
: true |
...
AccessLogPattern: |
...
"access.{Ymd}.log" |
...
当Server启动时将会自动去读取默认配置文件config.
...
yaml中的server节点配置。
配置方法
日志的配置也可以通过Server对象的Set*
...
...
请求日志：
| Code Block | ||
|---|---|---|
| ||
2018-04-20 18:11:57.344 200 "GET http 127.0.0.1:8199 /log/access HTTP/1.1" 0.120, 127.0.0.1, "", "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Ubuntu Chromium/53.0.2785.143 Chrome/53.0.2785.143 Safari/537.36" |
...
日志格式:
...
| Code Block | ||
|---|---|---|
| ||
请求时间(精确到毫秒) HTTP状态码 |
...
"请求方式 请求前缀 请求地址 请求协议 |
...
" 执行时间( |
...
秒) 客户端IP "来源URL |
...
", "UserAgent" |
其中，请求前缀为http或者https，请求协议往往为HTTP/1.0或者HTTP/1.1。
| Note |
|---|
注意，日志中记录的 |
...
|
...
秒时间，也就是说执行时间都是毫秒级不到1秒。 |
错误日志
...
错误日志：
| Code Block | ||
|---|---|---|
| ||
2019-12-20 20:10:56.484 [ERRO] 500, "GET http 127.0.0.1:8199 /log/error HTTP/1.1" 0.210, 127.0.0.1, "", "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/78.0.3904.108 Safari/537.36"
Stack:
1. OMG
1). main.main.func1
/Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/.example/net/ghttp/server/log/log_error.go:10
|
错误信息会打印出对应错误产生的堆栈信息（堆栈信息中不包含框架内部调用信息），以便于错误定位以及开发者分析问题原因。
| Tip |
|---|
...
|
...
即可。 |
自定义日志处理
开发者可以自定义处理Server的请求日志，方法有两种：
...
- 可以通过日志配置项传递自定义的
*glog.Logger对象。
...
- 可以通过中间件来统一捕获处理，参考 路由管理-中间件/拦截器 章节。
Server日志与业务日志
这是一个FAQ。
我们需要注意的是，这里提到的日志都是Server的日志，类似于nginx, apache, tomcat等等一系列Web Server服务的日志，只允许Server输出内容，开发者无法往Server的日志文件中写入日志内容，并且日志类型和格式是完全固定的。
...
GoFrame框架也提供了日志模块，由glog
...
日志组件实现，开发者通过glog
...
组件打印的日志属于业务日志，程序业务代码可以决定输出什么内容，输出到哪里，输出格式是什么样等。并且常用g.Log()方法来输出业务日志，该方法支持自动读取配置文件中的
...
| Panel | ||
|---|---|---|
| ||
|