接口列表

核心文件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. Codeforces D. Iahub and Xors

    题目大意:给定一个N*N的区间,1:对(x0,y0,x1,y1)每个直 都xor v: 2: 求(x0,y0,x1,y1)区间的 sum xor: http://codeforces.com/blog ...

  2. SPOJ MIXTURES 区间dp

    Harry Potter has n mixtures in front of him, arranged in a row. Each mixture has one of 100 differen ...

  3. java文本文件加密解密类

    原文:http://www.open-open.com/code/view/1420031154765 import java.awt.*; import java.awt.event.*; impo ...

  4. python把日期转换为秒数;日期转为字符串;datetime、date

    1.秒数是相对于1970.1.1号的秒数 2.日期的模块有time.datetime 3. import datetime t = datetime.datetime(2009, 10, 21, 0, ...

  5. (CF)Codeforces445A DZY Loves Chessboard(纯实现题)

    转载请注明出处:http://blog.csdn.net/u012860063? viewmode=contents 题目链接:http://codeforces.com/problemset/pro ...

  6. fedora关闭防火墙

    sudo systemctl stop iptables sudo sytemctl stop firewalld

  7. react 创建组件 (四)Stateless Functional Component

    上面我们提到的创建组件的方式,都是用来创建包含状态和用户交互的复杂组件,当组件本身只是用来展示,所有数据都是通过props传入的时候,我们便可以使用Stateless Functional Compo ...

  8. 微信小程序 开发环境配置

    1.注册小程序 (1)微信公众平台:https://mp.weixin.qq.com/(2)立即注册 (3)流程 (4)小程序注册 (5)填写相关信息,并去邮箱激活.这样小程序的账号就注册完成了. 2 ...

  9. Android Studio代码自己主动检測错误提示

    Android Studio的代码自己主动检測的错误提示方式感觉有点奇葩.和Eclipse区别非常大,Eclipse检測到某个资源文件找不到或者错误,都会在Project中相应的文件前面打叉.可是An ...

  10. JAVA的WebService规范JAX-WS

    JAX-WS的服务端.客户端双方传输数据使用的SOAP消息格式封装数据. 一.下载apache-cxf-3.1.4.zip. 二.编写服务端 1.编写一个Web Service用来传输参数的类 pac ...