接口列表

核心文件ngx_log.h

主要接口如下:

ngx_log_error(level, log, err, fmt, ...)

ngx_log_debug(level, log, err, fmt, ...)

ngx_log_debug0(level, log, err, fmt)

ngx_log_debug1(level, log, err, fmt, arg1)

ngx_log_debug2(level, log, err, fmt, arg1, arg2)

ngx_log_debug3(level, log, err, fmt, arg1, arg2, arg3)

ngx_log_debug4(level, log, err, fmt, arg1, arg2, arg3, arg4)

ngx_log_debug5(level, log, err, fmt, arg1, arg2, arg3, arg4, arg5)

ngx_log_debug6(level, log, err, fmt, arg1, arg2, arg3, arg4, arg5, arg6)

ngx_log_debug7(level, log, err, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7)

ngx_log_debug8(level, log, err, fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8)

可以简单分成三组

ngx_log_error(level, log, err, fmt, ...)

ngx_log_debug(level, log, err, fmt, ...)

ngx_log_debugX(level, log, err, fmt, ...)

ngx_log_error接口

ngx_log_error(level, log, err, fmt, ...) 标准的分级打印接口。

第1个参数level可选宏如下:

#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

打印等级通过nginx.conf中的error_log指令可以配置,其中WARN以上级别打印会直接打印到stderr上,对于某些临时调试场景有意义。

第2个参数log,用于部分回调功能。(还未深入研究)【个人认为此参数应该以全局变量方式存在,不应该设置为参数,影响在算法模块中使用日志】

常见获取方式包括

[ngx_conf_t].log
[ngx_http_request_t].connection.log
[ngx_connection_t].log

第3个参数err,用于记录errno,非系统调用错误,一般使用0即可。【个人认为此参数过设计】

后续参数为可变长的字符串参数,其中针对ngx常用的几个类型有特殊定义,可以参考下文中的表格。

使用示例:

static void*
ngx_http_mytest_create_srv_conf(ngx_conf_t *cf)
{
...
ngx_log_error(NGX_LOG_ALERT, cf->log, 0, "ngx_http_mytest_create_srv_conf");
...
}
static ngx_int_t
ngx_http_ws_cache_info_filter(ngx_http_request_t *r)
{
...
ngx_log_error(NGX_LOG_WARN, r->connection->log, 0, "ws_cache_info context already exist!");
...
}

ngx_log_debug接口

第一个参数,实际上为模块类型标识,会与log->log_level进行比对,如果比对失败将不进行打印。

进行打印时功能等价于ngx_log_error的NGX_LOG_DEBUG级别,后续参数含义也一致。

#define NGX_LOG_DEBUG_CORE        0x010
#define NGX_LOG_DEBUG_ALLOC 0x020
#define NGX_LOG_DEBUG_MUTEX 0x040
#define NGX_LOG_DEBUG_EVENT 0x080
#define NGX_LOG_DEBUG_HTTP 0x100
#define NGX_LOG_DEBUG_MAIL 0x200
#define NGX_LOG_DEBUG_STREAM 0x400

注意:ngx_log_debug接口并不在NGX_DEBUG宏限制范围内,也就是说即使编译时没有添加--debug参数,ngx_log_debug接口依然可以使用。

【个人认为:level参数没有意义应该删除,接口应该放在NGX_DEBUG宏限制范围内,与ngx_log_debugX语义保持一致】

使用示例:

static ngx_int_t
ngx_http_ws_cache_info_filter(ngx_http_request_t *r)
{
...
ngx_log_debug(NGX_LOG_DEBUG_HTTP, r->connection->log, 0, "enter ngx_http_ws_cache_info_filter");
...
}

ngx_log_debugX接口

用于固定数量参数的打印接口,参数与ngx_log_debug一致,接口定义在NGX_DEBUG宏限制范围内,即必须在编译时开启--debug参数,这组接口才能使用。

【个人认为:ngx_log_debugX接口本意应该为了不支持动态数量参数的C编译器设计的,一般通途不大,但它时唯一一组可以通过编译参数去除的调试接口,所以还有广泛使用。根因还是ngx_log_debug接口设计不合理】

使用示例:

static ngx_int_t
ngx_http_ws_cache_info_variable(ngx_http_request_t *r, ngx_http_variable_value_t *v, uintptr_t data)
{
...
ngx_log_debug1(NGX_LOG_DEBUG_HTTP, r->connection->log, 0, "arg_name=%V", &arg_name);
...
}

ngx特殊格式化

标识符 对应类型
%O off_t
%T time_t
%z ssize_t
%i ngx_int_t
%p void *
%V ngx_str_t *
%s u_char * (null-terminated)
%*s size_t + u_char *

更多完成的标识符可以参考《深入理解Nginx(第2版)》P148 表4-8

nginx开发_调试日志的更多相关文章

  1. nginx开发_配置项

    nginx开发笔记_配置项 模块的配置项即nginx.conf中的指令,HTTP模块指令可以分为三个级别: main级,直接写在http{}块中的指令 server级,写在server{}块中的指令 ...

  2. nginx开发_字符串操作函数

    由于ngx_str_t为非NULL结尾的函数,且网络请求中有大量忽略大小写的需求,所以nginx内部封装了许多字符串操作相关的函数,函数名称极其相识,且使用时有有些约定,特此整理. 赋值&拷贝 ...

  3. Android开发调试日志工具类[支持保存到SD卡]

    直接上代码: package com.example.callstatus; import java.io.File; import java.io.FileWriter; import java.i ...

  4. Arcgis Runtime 100.3开发实例源代码调试日志

    Arcgis Runtime 100.3开发实例源代码调试日志 路径: "D:\arcgis runtime1003\arcgis-runtime-samples-dotnet-master ...

  5. nginx 学习笔记(5) nginx调试日志

    为启动一个调试日志,nginx需要在构建时配置城支持调试模式. ./configure --with-debug ... 而且调试级别应该使用err_log指令来设置: err_log /path/t ...

  6. Nginx开发从入门到精通 学习目录分享学习 (阿里著作)

    Nginx开发从入门到精通   缘起 nginx由于出色的性能,在世界范围内受到了越来越多人的关注,在淘宝内部它更是被广泛的使用,众多的开发以及运维同学都迫切的想要了解nginx模块的开发以及它的内部 ...

  7. nginx自动切割访问日志

    Web 访问日志 (access_log) 记录了所有外部客户端对Web服务器的访问行为,包含了客户端IP,访问日期,访问的URL资源,服务器返回的HTTP状态码等重要信息. 一条典型的Web访问日志 ...

  8. 关于调试日志Log

    __VA_ARGS__  是一个可变参数的宏,这个可变参数的宏是新的C99规范中新增的,目前似乎只有gcc支持(VC6.0的编译器不支持).宏前面加上##的作用在于,当可变参数的个数为0时,这里的## ...

  9. Nginx 基本配置和日志分析

    最近在维护的一个项目,路由转发规则都统一通过Nginx转发,所以再次参考部分博文和书本,熟悉Nginx的基本配置,还有一个重点也是日志的分析 Nginx 常用模块是server块,location块. ...

随机推荐

  1. FireDac心得

    usesFireDAC.Phys.MySQL, FireDAC.Stan.Def, FireDAC.DApt, FireDAC.Comp.Client, FireDAC.Comp.UI, FireDA ...

  2. [Bzoj3172][Tjoi2013]单词(fail树)

    3172: [Tjoi2013]单词 Time Limit: 10 Sec  Memory Limit: 512 MBSubmit: 4777  Solved: 2345[Submit][Status ...

  3. Linux最常用的命名

    一.环境配置 vim /etc/sysconfig/network-scripts/ifcfg-eth0 vim /etc/sysconfig/network vim /etc/hostname vi ...

  4. emacs 下 common lisp 配置

    安装 sbcl .emacs 加入 ;for lisp mode (add-to-list 'load-path "D:/kuaipan/.emacs.d/elpa/slime-201311 ...

  5. Go语言并发之美

    简介           多核处理器越来越普及,那有没有一种简单的办法,能够让我们写的软件释放多核的威力?答案是:Yes.随着Golang, Erlang, Scale等为并发设计的程序语言的兴起,新 ...

  6. js 中 Map/Set 集合

      Map Map是一组键值对的结构,具有极快的查找速度. 举个例子,假设要根据同学的名字查找对应的成绩,如果用Array实现,需要两个Array: 1 var names = ['Michael', ...

  7. weex 小结

    1. import  文件时,必须引入全称,不能省略 .vue import mEcharts from '../components/Echarts.vue' 2.weex 的 cli 中没有 配置 ...

  8. Hdu 4274 Spy's Work

    Spy's Work Time Limit: 2000/1000 MS (Java/Others)    Memory Limit: 32768/32768 K (Java/Others) Total ...

  9. strsep strpbrk

    #include <stdio.h> #include <string.h> int main(void) { char s[] = "aa,bb,cc.11,22, ...

  10. 全志Android SDK编译详解(二)

    注意要确定安装了jdk) 第一步: cd  lichee; ./build.sh  -p sun5i_elite -k 3.0  (apt-get install uboot-mkimage需要安装m ...