使用 DTrace pid 提供程序调试 nginx

虽然使用了 —with-debug 选项构建的 nginx 已经提供了大量关于请求处理的信息，但有时候更有必要详细地跟踪代码路径的特定部分，同时省略其余不必要的调试输出。DTrace pid 提供程序（在 Solaris，MacOS 上可用）是一个用于浏览用户程序内部的有用工具，因为它不需要更改任何代码，就可以帮助您完成任务。跟踪和打印 nginx 函数调用的简单 DTrace 脚本示例如下所示：

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

使用 DTrace 与 nginx 的常见方案之一是：附加到 nginx 的工作进程来记录请求行和请求开始时间。附加的相应函数是 ，参数指向的是一个 ngx_http_request_t 结构的指针。使用 DTrace 脚本实现这种请求日志记录可以简单到：

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

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

首先应该包含由 configure 生成的 objs/ngx_auto_config.h 文件，因为它定义了一些影响各个方面的 ＃ifdef 常量。之后，一些基本类型和定义（如 ，ngx_table_elt_t，ngx_uint_t 等）应放在 DTrace 脚本的开头。这些定义经常被使用但不太可能经常改变的。

最后但同样重要的是，需要添加两个成员结构的定义（ngx_http_headers_in_t，）、回调函数声明和常量定义。

最后，DTrace 脚本可以从 下载。

以下示例是运行此脚本的输出：

原文档