無論在任何項目中，日志都是一個非常重要的模塊，無論是問題定位還是日常信息的管理，都離不開他
在nginx中，ngx_errlog_module模塊專門用于處理nginx日志信息，是nginx的core模塊之一
在 main 函數中，時間初始化結束后馬上進行的就是日志模塊的初始化
日志結構：
日志模塊的初始化主要做的事情就是初始化全局變量 ngx_log，并創建 errlog 文件
ngx_log_s 結構
ngx_log 變量是一個 ngx_log_s 結構體，定義在 core/ngx_log.h 文件中，結構如下：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
// struct ngx_log_s// 日志結構 {{{struct ngx_log_s { ngx_uint_t log_level; // 日志等級 ngx_open_file_t *file; // 日志文件信息 ngx_atomic_uint_t connection; // 引用該日志對象的連接數 ngx_log_handler_pt handler; // 輸出日志時需要調用的回調函數 void *data; // 回調函數所需要的參數 ngx_log_writer_pt writer; void *wdata; /* * we declare "action" as "char *" because the actions are usually * the static strings and in the "u_char *" case we have to override * their types all the time */ char *action; // 日志記錄前，保存當前正在進行的動作 ngx_log_t *next; // 指向下一日志對象}; // }}} |
日志級別
nginx 中日志共分為9個級別：
|
1
2
3
4
5
6
7
8
9
|
#define NGX_LOG_STDERR 0#define NGX_LOG_EMERG 1#define NGX_LOG_ALERT 2#define NGX_LOG_CRIT 3#define NGX_LOG_ERR 4#define NGX_LOG_WARN 5#define NGX_LOG_NOTICE 6#define NGX_LOG_INFO 7#define NGX_LOG_DEBUG 8 |
ngx_open_file_s 結構
其中，日志的文件描述結構如下：
|
1
2
3
4
5
6
7
8
9
|
// struct ngx_open_file_s// 打開文件結構 {{{struct ngx_open_file_s { ngx_fd_t fd; ngx_str_t name; void (*flush)(ngx_open_file_t *file, ngx_log_t *log); // 文件刷新時調用的回調 void *data; // 回調函數使用的參數}; // }}} |
所有文件相關的數據結構和操作都在 core/ngx_conf_file.h 和 core/ngx_conf_file.c 文件中
日志初始化過程
日志相關的初始化操作都在 core/ngx_log.c 文件中，現在我們調用的是其中的初始化函數：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
|
// ngx_log_t *ngx_log_init(u_char *prefix);// 初始化 ngx_log 結構，創建 errlog 文件 {{{ngx_log_t *ngx_log_init(u_char *prefix){ u_char *p, *name; size_t nlen, plen; ngx_log.file = &ngx_log_file; ngx_log.log_level = NGX_LOG_NOTICE; name = (u_char *) NGX_ERROR_LOG_PATH; /* * we use ngx_strlen() here since BCC warns about * condition is always false and unreachable code */ nlen = ngx_strlen(name); if (nlen == 0) { ngx_log_file.fd = ngx_stderr; return &ngx_log; } p = NULL; // 判斷是否是絕對路徑#if (NGX_WIN32) if (name[1] != ':') {#else if (name[0] != '/') {#endif if (prefix) { plen = ngx_strlen(prefix); } else {#ifdef NGX_PREFIX prefix = (u_char *) NGX_PREFIX; plen = ngx_strlen(prefix);#else plen = 0;#endif } if (plen) { name = malloc(plen + nlen + 2); if (name == NULL) { return NULL; } p = ngx_cpymem(name, prefix, plen); if (!ngx_path_separator(*(p - 1))) { *p++ = '/'; } ngx_cpystrn(p, (u_char *) NGX_ERROR_LOG_PATH, nlen + 1); p = name; } } ngx_log_file.fd = ngx_open_file(name, NGX_FILE_APPEND, NGX_FILE_CREATE_OR_OPEN, NGX_FILE_DEFAULT_ACCESS); if (ngx_log_file.fd == NGX_INVALID_FILE) { ngx_log_stderr(ngx_errno, "[alert] could not open error log file: " ngx_open_file_n " \"%s\" failed", name);#if (NGX_WIN32) ngx_event_log(ngx_errno, "could not open error log file: " ngx_open_file_n " \"%s\" failed", name);#endif ngx_log_file.fd = ngx_stderr; } if (p) { ngx_free(p); } return &ngx_log;}// }}} |
這個初始化過程非常容易理解，之后其他的日志操作也都在這個文件中，我們遇到之后再進行詳細講解
函數執行后，返回 ngx_log 結構的地址
ngx_log 結構取值如下：
|
1
2
3
4
5
6
7
8
9
10
11
|
{ log_level = 6, file = 0x80e3000 <ngx_log_file>, connection = 0, handler = 0x0, data = 0x0, writer = 0x0, wdata = 0x0, action = 0x0, next = 0x0} |
file 字段取值：
|
1
2
3
4
5
6
7
8
9
|
{ fd = 3, name = { len = 0, data = 0x0 }, flush = 0x0, data = 0x0} |
使用ngx_log_if不記錄特定日志
第一步：
先到Github下載ngx_log_if地址https://github.com/cfsego/ngx_log_if/
第二步：
安裝第三方模塊到Nginx。第三方模塊的安裝可以參考http://wiki.nginx.org/3rdPartyModules 使用--add-module添加解壓后的ngx_log_if如下
|
1
|
./configure --add-module=/var/local/ngx_log_if-master |
然后再編譯安裝Nginx即可。
第三步：
配置access_log_bypass_if到nginx.conf配置文件中
|
1
2
3
4
5
6
7
8
|
server { location / { access_log_bypass_if ($status = 404); #不記錄404狀態的所有日志信息 access_log_bypass_if ($uri ~* 'images'); #不記錄uri中所有images目錄下文件的日志信息 access_log_bypass_if ($uri = '/index.html'); #不記錄uri為/index.html的日志信息 access_log_bypass_if ($host ~* 'tonv.cc'); #不記錄host為tonv.cc的所有日志信息 }} |
重啟Nginx即可過濾不顯示特定的日志了
