当前位置 主页 > 服务器问题 > nginx问题汇总 >

    解析Nginx中的日志模块及日志基本的初始化和过滤配置

    栏目:nginx问题汇总 时间:2018-10-06 16:57

    ngx_errlog_module是Nginx中用来管理日志的模块,解析Nginx中的日志模块及日志基本的初始化和过滤配置,需要的朋友可以参考下

    无论在任何项目中,日志都是一个非常重要的模块,无论是问题定位还是日常信息的管理,都离不开他

    在nginx中,ngx_errlog_module模块专门用于处理nginx日志信息,是nginx的core模块之一

    在 main 函数中,时间初始化结束后马上进行的就是日志模块的初始化

    日志结构:
    日志模块的初始化主要做的事情就是初始化全局变量 ngx_log,并创建 errlog 文件

    ngx_log_s 结构
    ngx_log 变量是一个 ngx_log_s 结构体,定义在 core/ngx_log.h 文件中,结构如下:

    // 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个级别:

    #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 结构
    其中,日志的文件描述结构如下:

    // 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 文件中,现在我们调用的是其中的初始化函数:

    // 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;}// }}}