Nginx开发从入门到精通十三
来源:互联网 发布:图表数据区域怎么设置 编辑:程序博客网 时间:2024/04/29 08:09
文章转载自 http://tengine.taobao.org/book/#id2
著作权归作者淘宝核心系统服务器平台组成员所有。
附录C 模块编译,调试与测试
C.1 编译与安装
环境要求
操作系统:目前Nginx各版本在以下操作系统和平台测试通过:
FreeBSD 3 — 10 / i386; FreeBSD 5 — 10 / amd64;
Linux 2.2 — 3 / i386; Linux 2.6 — 3 / amd64;
Solaris 9 / i386, sun4u; Solaris 10 / i386, amd64, sun4v;
AIX 7.1 / powerpc;
HP-UX 11.31 / ia64;
MacOS X / ppc, i386;
Windows XP, Windows Server 2003
磁盘空间:必须保证至少10M以上的磁盘工具,并且随着编译设置及第三方模块的安装而有所不同;
编译器及相关工具: 必须确保操作系统安装有GCC编译器;make工具;用户可通过yum命令安装编译器及相关工具:yum -y install gcc gcc-c++ make;
模块依赖性:Nginx的一些模块需要第三方库的支持,如rewrite模块需要pcre库,gzip模块需要zlib模块,ssl功能你需要openssl库等。用户可通过yum命令安装这些依赖库:yum -y install pcre pcre-devel zlib zlib-devel openssl openssl-devel;
下载
Nginx是开源软件,用户可以访问 http://nginx.org/ 网站获取源码包或Windows二进制文件下载。其中1.3.x版本为开发版本,1.2.x版本为稳定版本。开发版本分支会较快的获得新功能和缺陷修复,但同时也可能会遇到新的缺陷。一旦更新稳定下来,就会被加入稳定版本分支。
作为生产环境,通常建议用户使用稳定版本。
Nginx在Windows环境下安装
nginx的windows版本使用原生win32 API(非Cygwin模拟层)。当前存在的已知问题:1.采用select作为通知方法,所以不具备很高的性能和扩展性;2.虽然可以启动若干工作进程运行,实际上只有一个进程在处理请求所有请求;3.一个工作进程只能处理不超过1024个并发连接;4.缓存和其他需要共享内存支持的模块在windows vista及后续版本的操作系统中无法工作,因为在这些操作系统中,地址空间的布局是随机的;5.除了XSLT过滤器、图像过滤器、GeoIP模块和嵌入Perl语言支持以外,Nginx的Windows版本与Unix版本相比,功能几乎齐全。
安装Nginx的Windows版本,建议下载最新的1.3.13开发版本,因为开发分支上包含了所有已知的问题修复,尤其是针对Windows版本的问题修复。解压下载得到的zip文件,进入nginx-1.3.13目录,运行nginx。
C盘根目录下安装例子
Nginx的Windows版本的控制命令包含如下:
Nginx在Linux环境下安装
Nginx在Linux环境下可以通过编译源码的方式安装,最简单的安装命令如下:
按照以上命令,Nginx将被默认安装到/usr/local/nginx目录下。用户可以通过./configure –help命令查看Nginx可选择的编译选项进行自定义安装配置。
Nginx的configure脚本支持以下选项:
在不同版本间,选项可能会有些许变化,请总是使用./configure –help命令来检查当前的选项列表。
测试
将Nginx conf文件的server block部分的配置如下:
用户可以通过访问“http://localhost:80/index.html”页面来查看Nginx的欢迎页面。
Nginx在Windows环境下查看nginx进程
用户还可以通过命令行运行tasklist命令来查看nginx进程:
如果nginx没有启动或没有得到预期展示页面,可查看error.log文件以查看失败原因。如果日志文件不存在,可在Windows事件日志中查看。
Nginx在Linux环境下查看nginx进程
用户可以通过执行ps/top命令来查看nginx进程:
同上,如果nginx没有启动或者没有得到预期展示页面,可以查看error.log文件或调试来查看失败原因。
C.2 调试日志
用户在使用Nginx的过程中,可能会遇到所请求的资源不正确,Nginx Core Dump,段错误等异常情况,这时需要有相应的机制来进行调试及问题定位,特别是面对大量的日志信息,合理的调试处理机制对用户来说是一件非常重要的事情。以下将着重为大家介绍调试日志。
一,开启调试日志:
要开启调试日志,首先需要在配置Nginx时打开调试功能,然后编译:
然后在配置文件中设置error_log的级别为:
Nginx的Windows二进制版本总是将调试日志开启的,因此只需要设置debug的日志级别即可。
二,日志级别分析:
在此,我们通过分析Nginx源码了解下Nginx将日志分为几个等级及不同日志等级之间的相互关系:
Ngx_log.h代码
其中默认有效的第一级别日志是”stderr”,”emerg”,”alert”,”crit”,”error”,”warn”,”notice”,”info”,”debug”。 而Ngx_log.h内列出的其他debug第二级别日志:”debug_core”,”debug_alloc”,”debug_mutex”,”debug_event”,”debug_http”,”debug_mail”,”debug_mysql”等则需要在配置Nginx时启动调试日志功能才能使用,并且用户可以通过修改Ngx_log.h及Ngx_log.c源码来更新debug第二级别。
我们再通过Ngx_log.c的部分代码分析下可以如何使用这些日志级别:
Ngx_log.c代码
按照以上代码逻辑,我们可以得出以下结论:
1. 第一级别日志之间是互斥的,如果配置文件内加入如下配置项:
那么启动Nginx将报错如下:
但是需要注意的是,在配置文件不同block中是允许重新定义错误日志的。但是当用户在重新定义错误日志时,如果没有指定相应的日志级别,那么调试日志将会被屏蔽。下面的例子里,在server层中重新定义的日志就屏蔽了这个虚拟主机的调试日志:
为了避免这个问题,可以注释这行重新定义日志的配置,或者也给日志指定debug级别:
2. 第二级别日志是多选的,用户可以根据项目需要配置多个第二级别日志:
3. 在第一级别日志与第二级别日志组合配置时,仅有在第一级别日志为”debug”时才可以有第二级别的配置,其他第一级别日志的情况下指定第二级别日志将无法启动Nginx,如:
启动Nginx将获得如下错误信息:
当用户开启debug级别日志时,会输出所有debug_开头的调试信息,因此可以通过上面组合debug_core|debug_http的形式来获取用户所需要的调试信息。
三,日志格式设置:
用户在使用Nginx提供web服务的时候,可能会有很多场景需要记录日志,如打点日志,访问日志,数据统计日志,性能分析日志等。为了更加方便的对日志进行分析,我们可以通过设置日志格式的方式来要求Nginx按照用户要求进行日志的展现。
控制nginx日志输出的指令如下:
上面例子中通过使用特殊字符(^A)来作为日志字段的分隔符,用户后续可以使用sort和grep之类的工具对特定url做分析,如统计各url请求量倒排取前50个:
类似上面的日志定制化设置,可以让用户在调试日志的过程中随心所欲,如鱼得水。 详细的log_format指令和access_log指令,用户可以访问Nginx官网的HttpLog模块 http://wiki.nginx.org/HttpLogModule 。
四,调试日志的几个注意点:
1. 勘误:在Nginx Wiki里面error log相关部分(http://wiki.nginx.org/NginxHttpMainModule#error_log )的介绍中提到
但是,我们从源码上看:
当error_log 的日志级别选项为配置时,默认日志级别为error,无上面提及的三个section的区别。故特在此勘误。
2. 配置error_log off并不能关闭日志记录——日志信息会被写入到文件名为off的文件当中。如果要关闭日志记录,用户可以做如下配置:
3. 如果nginx进程没有权限将日志信息写入指定的log地址,那么nginx会在启动是报错:
4. 通过debug_connection配置项,用户可以针对某些地址开启调试日志:
C.3 使用GDB调试
C.4 功能测试
C.5 性能/压力测试
C.6 常见缺陷分析
- Nginx开发从入门到精通十三
- Nginx开发从入门到精通
- Nginx开发从入门到精通¶
- Nginx开发从入门到精通
- Nginx开发从入门到精通
- Nginx开发从入门到精通
- Nginx开发从入门到精通
- Nginx 开发从入门到精通
- Nginx开发从入门到精通
- 他山之石-Nginx开发从入门到精通
- Nginx开发从入门到精通一
- Nginx开发从入门到精通二
- Nginx开发从入门到精通三
- Nginx开发从入门到精通四
- Nginx开发从入门到精通五
- Nginx开发从入门到精通六
- Nginx开发从入门到精通七
- Nginx开发从入门到精通八
- 装修总结
- Nginx开发从入门到精通十二
- Android-WebView 的使用
- python中threading的高级函数应用解析
- 交叉编译busybox流程以及出现问题的解决方法
- Nginx开发从入门到精通十三
- 解决“安装程序无法创建新的系统分区,也无法定位现有系统分区”问题方法
- 安装windows和ubuntu双系统 + 配置ubuntu远程桌面 + 移动硬盘中安装ubuntu
- java基础-API-集合框架-Map、Collections、Arrays
- 触摸时白色圆圈的中心不在十字架中心的问题
- 【LeetCode】7(4)Search a 2D Matrix(Medium)
- python笔记 4
- hdu 5420 Victor and Proposition 线段树建图+强连通分量
- 裸机开发前准备