使用 DTrace pid 提供程序调试 nginx

本文假设读者对 nginx 内部结构和 DTrace有一定的了解。

尽管使用--with-debug 选项构建的 nginx 已经提供了大量有关请求处理的信息,但有时需要更彻底地跟踪代码路径的特定部分,同时忽略其余的调试输出。DTrace pid 提供程序(在 Solaris、macOS 上可用)是探索用户态程序内部结构的有用工具,因为它不需要更改任何代码,并且可以帮助完成任务。用于跟踪和打印 nginx 函数调用的简单 DTrace 脚本可能如下所示:

#pragma D option flowindent

pid$target:nginx::entry {
}

pid$target:nginx::return {
}

不过,用于函数调用跟踪的 DTrace 功能仅提供有限数量的有用信息。函数参数的实时检查通常更有趣,但也有点复杂。下面的示例旨在帮助读者更加熟悉 DTrace 以及使用 DTrace 分析 nginx 行为的过程。

将 DTrace 与 nginx 结合使用的常见场景之一如下:附加到 nginx 工作进程以记录请求行和请求开始时间。要附加的相应函数是 ngx_http_process_request(),并且所讨论的参数是指向ngx_http_request_t结构的指针。用于此类请求日志记录的 DTrace 脚本可以非常简单:

pid$target::*ngx_http_process_request:entry
{
    this->request = (ngx_http_request_t *)copyin(arg0, sizeof(ngx_http_request_t));
    this->request_line = stringof(copyin((uintptr_t)this->request->request_line.data,
                                         this->request->request_line.len));
    printf("request line = %s\n", this->request_line);
    printf("request start sec = %d\n", this->request->start_sec);
}

应该注意的是,在上面的示例中,DTrace 需要一些有关ngx_http_request_t结构的知识。不幸的是,虽然可以#include 在 DTrace 脚本中使用特定指令,然后将其传递给 C 预处理器(带有标志-C),但这实际上不起作用。由于存在大量的交叉依赖,几乎所有的 nginx 头文件都必须包含在内。反过来,根据configure脚本设置,nginx 头文件将包括 PCRE、OpenSSL 和各种系统头文件。虽然理论上与特定 nginx 构建相关的所有头文件都可能包含在 DTrace 脚本预处理和编译中,但实际上 DTrace 脚本很可能会因某些头文件中的未知语法而无法编译。

上述问题可以通过在 DTrace 脚本中仅包含相关且必要的结构和类型定义来解决。DTrace 必须知道结构的大小、类型和字段偏移量。因此,可以通过手动优化与 DTrace 一起使用的结构定义来进一步减少依赖性。

让我们使用上面的 DTrace 脚本示例,看看它需要哪些结构定义才能正常工作。

首先objs/ngx_auto_config.h应包含由configure 生成的文件,因为它定义了许多影响各种的常量#ifdef。之后,一些基本类型和定义,如ngx_str_tngx_table_elt_tngx_uint_t应放在 DTrace 脚本的开头。这些定义紧凑、常用且不太可能经常更改。

然后是ngx_http_request_t包含许多指向其他结构的指针的结构。因为这些指针实际上与该脚本无关,并且它们具有相同的大小,所以可以将它们替换为 void 指针。不过,最好添加适当的 typedef,而不是更改定义:

typedef ngx_http_upstream_t     void;
typedef ngx_http_request_body_t void;

最后但并非最不重要的一点是,需要添加两个成员结构(ngx_http_headers_in_tngx_http_headers_out_t)的定义、回调函数的声明和常量的定义。

最终的 DTrace 脚本可以从这里 下载 。

以下示例显示了运行此脚本的输出:

# dtrace -C -I ./objs -s trace_process_request.d -p 4848
dtrace: script 'trace_process_request.d' matched 1 probe
CPU     ID                    FUNCTION:NAME
  1      4 .XAbmO.ngx_http_process_request:entry request line = GET / HTTP/1.1
request start sec = 1349162898

  0      4 .XAbmO.ngx_http_process_request:entry request line = GET /en/docs/nginx_dtrace_pid_provider.html HTTP/1.1
request start sec = 1349162899

使用类似的技术,读者应该能够跟踪其他 nginx 函数调用。

也可以看看