解析Nginx中的日志模塊及日志基本的初始化和過濾配置

更新時(shí)間：2016年07月13日 17:24:22 作者：zeyu203

ngx_errlog_module是Nginx中用來管理日志的模塊,解析Nginx中的日志模塊及日志基本的初始化和過濾配置,需要的朋友可以參考下

無論在任何項(xiàng)目中，日志都是一個(gè)非常重要的模塊，無論是問題定位還是日常信息的管理，都離不開他

在nginx中，ngx_errlog_module模塊專門用于處理nginx日志信息，是nginx的core模塊之一

在 main 函數(shù)中，時(shí)間初始化結(jié)束后馬上進(jìn)行的就是日志模塊的初始化

日志結(jié)構(gòu)：
日志模塊的初始化主要做的事情就是初始化全局變量 ngx_log，并創(chuàng)建 errlog 文件

ngx_log_s 結(jié)構(gòu)
ngx_log 變量是一個(gè) ngx_log_s 結(jié)構(gòu)體，定義在 core/ngx_log.h 文件中，結(jié)構(gòu)如下：

// struct ngx_log_s
// 日志結(jié)構(gòu) {{{
struct ngx_log_s {
 ngx_uint_t   log_level;  // 日志等級
 ngx_open_file_t  *file;   // 日志文件信息
 ngx_atomic_uint_t connection; // 引用該日志對象的連接數(shù)
 ngx_log_handler_pt handler;  // 輸出日志時(shí)需要調(diào)用的回調(diào)函數(shù)
 void    *data;   // 回調(diào)函數(shù)所需要的參數(shù)
 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;  // 日志記錄前，保存當(dāng)前正在進(jìn)行的動(dòng)作
 ngx_log_t   *next;   // 指向下一日志對象
}; // }}}

日志級別
nginx 中日志共分為9個(gè)級別：

#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 結(jié)構(gòu)
其中，日志的文件描述結(jié)構(gòu)如下：

// struct ngx_open_file_s
// 打開文件結(jié)構(gòu) {{{
struct ngx_open_file_s {
 ngx_fd_t    fd;
 ngx_str_t    name;
 void    (*flush)(ngx_open_file_t *file, ngx_log_t *log);
   // 文件刷新時(shí)調(diào)用的回調(diào)
 void     *data; // 回調(diào)函數(shù)使用的參數(shù)
}; // }}}

所有文件相關(guān)的數(shù)據(jù)結(jié)構(gòu)和操作都在 core/ngx_conf_file.h 和 core/ngx_conf_file.c 文件中

日志初始化過程
日志相關(guān)的初始化操作都在 core/ngx_log.c 文件中，現(xiàn)在我們調(diào)用的是其中的初始化函數(shù)：

// ngx_log_t *ngx_log_init(u_char *prefix);
// 初始化 ngx_log 結(jié)構(gòu)，創(chuàng)建 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;
}
// }}}

這個(gè)初始化過程非常容易理解，之后其他的日志操作也都在這個(gè)文件中，我們遇到之后再進(jìn)行詳細(xì)講解

函數(shù)執(zhí)行后，返回 ngx_log 結(jié)構(gòu)的地址

ngx_log 結(jié)構(gòu)取值如下：

{
 log_level = 6, 
 file = 0x80e3000 <ngx_log_file>, 
 connection = 0, 
 handler = 0x0, 
 data = 0x0, 
 writer = 0x0, 
 wdata = 0x0, 
 action = 0x0, 
 next = 0x0
}

file 字段取值：

{
 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如下

./configure --add-module=/var/local/ngx_log_if-master

然后再編譯安裝Nginx即可。
第三步：
配置access_log_bypass_if到nginx.conf配置文件中

server {
 location / {
  access_log_bypass_if ($status = 404); #不記錄404狀態(tài)的所有日志信息
  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即可過濾不顯示特定的日志了

您可能感興趣的文章: