免费一键生成名片,外贸优化推广公司,桂林两江四湖游船路线,建设平滑扣皮带网站前言
大家好#xff0c;我是老马。很高兴遇到你。
我们为 java 开发者实现了 java 版本的 nginx https://github.com/houbb/nginx4j 如果你想知道 servlet 如何处理的#xff0c;可以参考我的另一个项目#xff1a; 手写从零实现简易版 tomcat minicat 手写 nginx 系列
…前言
大家好我是老马。很高兴遇到你。
我们为 java 开发者实现了 java 版本的 nginx https://github.com/houbb/nginx4j 如果你想知道 servlet 如何处理的可以参考我的另一个项目 手写从零实现简易版 tomcat minicat 手写 nginx 系列
如果你对 nginx 原理感兴趣可以阅读
从零手写实现 nginx-01-为什么不能有 java 版本的 nginx?
从零手写实现 nginx-02-nginx 的核心能力
从零手写实现 nginx-03-nginx 基于 Netty 实现
从零手写实现 nginx-04-基于 netty http 出入参优化处理
从零手写实现 nginx-05-MIME类型Multipurpose Internet Mail Extensions多用途互联网邮件扩展类型
从零手写实现 nginx-06-文件夹自动索引
从零手写实现 nginx-07-大文件下载
从零手写实现 nginx-08-范围查询
从零手写实现 nginx-09-文件压缩
从零手写实现 nginx-10-sendfile 零拷贝
从零手写实现 nginx-11-filerange 合并
从零手写实现 nginx-12-keep-alive 连接复用
NGINX 调试
通过调试二进制文件、调试日志和核心转储来排除 NGINX 或 NGINX Plus 部署中的问题并追踪错误。
介绍
调试帮助您在程序代码出现问题时识别错误。它通常用于开发或测试第三方或实验性模块。
NGINX 调试功能包括调试日志和创建核心转储文件以及进一步的回溯。
配置 NGINX 二进制文件进行调试
首先您需要在 NGINX 二进制文件中启用调试。NGINX Plus 已经为您提供了 nginx-debug 二进制文件而 NGINX Open Source 需要重新编译。
配置 NGINX Plus 二进制文件
从版本 8 开始NGINX Plus 与标准二进制文件一起提供 nginx-debug 二进制文件。要在 NGINX Plus 中启用调试您需要从 nginx 切换到 nginx-debug 二进制文件。打开终端并运行以下命令
service nginx stop service nginx-debug start
完成后在配置文件中启用调试日志。
编译 NGINX Open Source 二进制文件
要在 NGINX Open Source 中启用调试您需要使用 configure 脚本中指定的 --with-debug 标志重新编译它。
要编译支持调试的 NGINX Open Source
下载并解压 NGINX 源文件转到源文件所在的目录。参见下载源代码。获取 NGINX 配置参数列表。运行命令
nginx -V 21 | grep arguments
将 --with-debug 选项添加到 configure 命令列表中并运行 configure 脚本
./configure --with-debug 其他 configure 参数
编译和安装 NGINX
sudo make
sudo make install
重新启动 NGINX。
NGINX 和调试符号
调试符号有助于获取用于调试的附加信息例如函数、变量、数据结构、源文件和行号信息。
NGINX 默认使用“-g”标志编译其中包含调试符号。
但是如果在运行回溯时出现“没有可用的符号表信息”错误则表示缺少调试符号您需要重新编译 NGINX 并支持调试符号。
确切的编译器标志取决于编译器。例如对于 GCC 编译器系统
使用“-g”标志包含调试符号使用“-O0”标志禁用编译器优化使调试器输出更易于理解
./configure --with-debug --with-cc-opt-O0 -g ...
在 NGINX 配置中启用调试日志
调试日志记录错误和与调试相关的任何信息默认情况下是禁用的。要启用它请确保 NGINX 已编译支持调试参见“为调试配置 NGINX 二进制文件”然后在 NGINX 配置文件中使用 error_log 指令的 debug 参数启用它。调试日志可以写入文件、内存中的分配缓冲区、标准错误输出或 syslog。
建议在 NGINX 配置的“main”级别上启用调试日志以获得正在进行的完整情况。
将调试日志写入文件
将调试日志写入文件可能会在高负载下降低性能。还要注意文件可能会变得非常大快速消耗磁盘空间。为减少负面影响您可以配置调试日志写入内存缓冲区或为特定 IP 地址设置调试日志。有关详细信息请参阅“将调试日志写入内存”和“选定 IP 的调试日志”。
要启用将调试日志写入文件
确保您的 NGINX 配置了 --with-debug 配置选项。运行命令并检查输出是否包含 --with-debug 行 nginx -V 21 | grep -- --with-debug 打开 NGINX 配置文件 sudo vi /etc/nginx/nginx.conf 查找 error_log 指令默认情况下位于 main 上下文中并将日志级别更改为 debug。如果需要更改日志文件的路径 error_log /var/log/nginx/error.log debug; 保存配置并退出配置文件。
将调试日志写入内存
调试日志可以使用循环缓冲区写入内存。优点是在高负载下调试级别的日志记录对性能影响不大。
要启用将调试日志写入内存
确保您的 NGINX 配置了 --with-debug 配置选项。运行命令并检查输出是否包含 --with-debug 行 nginx -V 21 | grep -- --with-debug 在 NGINX 配置文件中使用在 main 上下文中指定的 error_log 指令启用调试日志的内存缓冲区 error_log memory:32m debug;...http {...}
从内存中提取调试日志
可以使用在 GDB 调试器中执行的脚本从内存缓冲区中提取日志。
要从内存中提取调试日志
获取 NGINX 工作进程的 PID ps axu |grep nginx 启动 GDB 调试器 sudo gdb -p 在上一步中获得的 nginx PID 复制脚本将其粘贴到 GDB 中并按“Enter”。该脚本将在当前目录中的 debug_log.txt 文件中保存日志 set $log ngx_cycle-logwhile $log-writer ! ngx_log_memory_writerset $log $log-nextendset $buf (ngx_log_memory_buf_t *) $log-wdatadump binary memory debug_log.txt $buf-start $buf-end 通过按下 CTRLD 退出 GDB。 打开位于当前目录中的“debug_log.txt”文件 sudo less debug_log.txt
选定 IP 的调试日志
可以为特定 IP 地址或 IP 地址范围启用调试日志。在生产环境中记录特定 IP 可能很有用因为它不会对性能产生负面影响。IP 地址在事件块中的 debug_connection 指令中指定该指令可以定义多次
error_log /path/to/log;
...
events {debug_connection 192.168.1.1;debug_connection 192.168.10.0/24;
}
每个虚拟主机的调试日志
通常error_log 指令在主上下文中指定因此适用于所有其他上下文包括服务器和位置。
但是如果在特定服务器或位置块内指定了另一个 error_log 指令则会覆盖全局设置并且这样的 error_log 指令将设置自己的日志文件路径和调试日志级别。
要为特定虚拟主机设置调试日志请在特定服务器块内添加 error_log 指令并设置新的日志文件路径和调试日志级别
error_log /path1/to/log debug;
...
http {...server {error_log /path2/to/log debug;...}
}
要禁用特定虚拟主机的调试日志请在特定服务器块内指定 error_log 指令并仅指定日志文件路径
error_log /path/to/log debug;
...
http {...server {error_log /path/to/log;...}
}
启用核心转储
核心转储文件可以帮助识别和修复导致 NGINX 崩溃的问题。核心转储文件可能包含诸如密码和私钥之类的敏感信息因此请确保对它们进行安全处理。
为了创建核心转储文件必须在操作系统和 NGINX 配置文件中都启用它们。
在操作系统中启用核心转储
在操作系统中执行以下步骤
指定一个工作目录用于保存核心转储文件例如“/tmp/cores” mkdir /tmp/cores 确保该目录可由 NGINX 工作进程写入 sudo chown root:root /tmp/coressudo chmod 1777 /tmp/cores 禁用核心转储文件的最大大小限制 ulimit -c unlimited 如果操作以“Cannot modify limit: operation not permitted”结束请运行以下命令 sudo sh -c ulimit -c unlimited exec su $LOGNAME 为 setuid 和 setgid 进程启用核心转储。 对于 CentOS 7.0、Debian 8.2、Ubuntu 14.04请运行以下命令 echo /tmp/cores/core.%e.%p | sudo tee /proc/sys/kernel/core_pattern
sudo sysctl -w fs.suid_dumpable2
sysctl -p 对于 FreeBSD请运行以下命令 sudo sysctl kern.sugid_coredump1
sudo sysctl kern.corefile/tmp/cores/%N.core.%P
在 NGINX 配置中启用核心转储
要在 NGINX 配置文件中启用核心转储
打开 NGINX 配置文件 sudo vi /usr/local/etc/nginx/nginx.conf 使用 working_directory 指令定义一个目录该目录将保存核心转储文件。该指令在主配置级别上指定 working_directory /tmp/cores/; 确保该目录存在并由 NGINX 工作进程写入。在终端中运行以下命令 sudo chown root:root /tmp/coressudo chmod 1777 /tmp/cores 使用 worker_rlimit_core 指令指定核心转储文件的最大可能大小。该指令也在主配置级别上指定。如果核心转储文件大小超过该值将不会创建核心转储文件。 worker_rlimit_core 500M; 示例 worker_processes auto;error_log /var/log/nginx/error.log debug;working_directory /tmp/cores/;worker_rlimit_core 500M;events {...}http {...}
通过这些设置核心转储文件将在“/tmp/cores/”目录中创建只有当其大小不超过 500 兆字节时才会创建。
从核心转储文件中获取回溯信息
回溯提供了关于程序崩溃时出错的信息。
要从核心转储文件中获取回溯信息
使用 GDB 调试器打开核心转储文件命令格式为 sudo gdb nginx_executable_path coredump_file_path 输入“backtrace”命令以从崩溃时的堆栈中获取堆栈跟踪信息 (gdb) backtrace
如果“backtrace”命令返回“没有可用的符号表信息”消息则需要重新编译 NGINX 二进制文件以包含调试符号。请参阅NGINX和调试符号。
从运行中的进程中转储NGINX配置
您可以从主进程内存中提取当前的NGINX配置。当您需要
验证已加载的配置如果磁盘上的版本被意外删除或覆盖恢复以前的配置
配置转储可以通过提供一个GDB脚本来获得只要您的NGINX具有调试支持。
确保您的NGINX已经构建了调试支持在configure参数列表中使用--with-debug选项。运行命令并检查输出是否包含--with-debug行
nginx -V 21 | grep -- --with-debug
获取NGINX工作进程的PID
ps axu | grep nginx
启动GDB调试器
sudo gdb -p 在上一步中获取的NGINX PID
复制并粘贴脚本到GDB中然后按“Enter”键。该脚本将配置保存在当前目录中的nginx_conf.txt文件中
set $cd ngx_cycle-config_dump
set $nelts $cd.nelts
set $elts (ngx_conf_dump_t*)($cd.elts)
while ($nelts-- 0)
set $name $elts[$nelts]-name.data
printf Dumping %s to nginx_conf.txt\n, $name
append memory nginx_conf.txt \$elts[$nelts]-buffer.start $elts[$nelts]-buffer.end
end
按下CTRLD退出GDB。
打开位于当前目录中的nginx_conf.txt文件
sudo vi nginx_conf.txt
在请求帮助时 在请求调试帮助时请提供以下信息
NGINX版本、编译器版本和配置参数。运行命令
nginx -V
当前完整的NGINX配置。请参阅从运行进程中转储NGINX配置 调试日志。请参阅在NGINX配置中启用调试日志 获取的回溯。请参阅启用核心转储获取回溯信息。
参考资料
https://docs.nginx.com/nginx/admin-guide/monitoring/debugging/
