Nginx常见基本配置---日志、HTTP执行阶段

野性酷女 2023-10-11 10:43 26阅读 0赞

# 日志 #

Nginx通过 ngx\_ http\_ log\_ module来对日志的记录进行配置。

## 记录自定义变量 ##

指令： log_ format
    语法： log_ format name [escape = default | json | none] string …;
    默认值： log_ format combined “...";
    环境： http
    含义：配置日志的格式。

绝大部分请求信息都可以通过 Nginx现有的变量来获取，例如常见的 Cookie、 IP地址、 User\_ Agent、请求体大小、单个请求头、 server\_ ip、后端节点和端口号等。

当然还有自定义变量，如需将自定义变量存放到日志中，只需简单的两步。

*  使用自定义变量前需要先进行初始化：

set $a '123';

*  为自定义变量添加日志格式：

log_format main '$remote_addr $a'

## 日志格式规范 ##

日志经常会被用来分析和查找问题，为了提升日志的可读性，需要规范日志的格式以减少解析日志时出现的麻烦。

在 Nginx 1. 11. 8版本之后，提供了\[ escape = default | json | none\]配置，它可以让 Nginx在记录变量时使用 JSON格式或默认字符。如果使用默认字符则会被转义，特别是当 POST请求中包含中文字符或需要转义的字符时，默认转义的操作会使日志无法记录明确的信息。

日志记录推荐使用如下格式：  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0xMODQ1ODc2NDI1_size_16_color_FFFFFF_t_70][]

使用 escape = json则日志内容不会被转义，中文字符可以直接在日志里面显示。日志的格式采用 JSON的方式进行配置，对后期的数据采集会有很大的帮助，当在日志里添加新的变量时，不会影响日志分析的流程。

## 日志存储 ##

日志存储通过 access\_ log来完成。

指令： access_ log
    语法： access_ log path [format [buffer = size] [gzip[ = level]] [flush = time] [if = condition]]; access_ log off;
    默认值： access_ log logs/ access. log combined;
    环境： http、 server、 location、 if in location、 limit_ except

*  在同一个阶段中，支持多种格式和文件的收集。
 *  若不在同一个阶段，则会以最小配置阶段的 access\_ log为指定文件。
 *  支持压缩存储，可以减少硬盘的使用空间。
 *  支持只记录某些状态。
 *  支持关闭日志记录。  
    指令 access\_ log只记录访问日志，关于错误信息的日志记录在 error\_ log上，示例如下：  
    ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0xMODQ1ODc2NDI1_size_16_color_FFFFFF_t_70 1][]  
    ![20190922225721753.jpg][]

**注意：日志应该存放在独立的硬盘上，最好和系统盘及存放 Nginx配置文件的硬盘相互独立，避免让日志硬盘的 I/ O影响服务器的其他服务。在高并发的情况下，可能每秒会生成几十兆的日志。**

# HTTP执行阶段 #

Nginx对请求的处理发生在多个 HTTP执行阶段，前面介绍的指令都是在这些阶段中执行的，了解这些阶段的执行顺序和用途，对后续原生模块、第三方模块的学习，以及使用 Lua开发新的功能都有非常重要的作用。

HTTP执行阶段配置在 ngx\_ http\_ core\_ module中，下载 Nginx的源码包后在 src/ http/ ngx\_ http\_ core\_ module. h中可以看到。

下面是 ngx\_ http\_ core\_ module. h中的一段源码：  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0xMODQ1ODc2NDI1_size_16_color_FFFFFF_t_70 2][]

通过上述配置，可以看出 Nginx包含 11个阶段，当请求进入 Nginx后，每个 HTTP执行阶段的作用见下表（按照执行顺序进行排列）。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0xMODQ1ODc2NDI1_size_16_color_FFFFFF_t_70 3][]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0xMODQ1ODc2NDI1_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20190922225444559.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0xMODQ1ODc2NDI1,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0xMODQ1ODc2NDI1_size_16_color_FFFFFF_t_70 1]: https://img-blog.csdnimg.cn/20190922225643215.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0xMODQ1ODc2NDI1,size_16,color_FFFFFF,t_70
[20190922225721753.jpg]: https://img-blog.csdnimg.cn/20190922225721753.jpg
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0xMODQ1ODc2NDI1_size_16_color_FFFFFF_t_70 2]: https://img-blog.csdnimg.cn/20190922225825788.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0xMODQ1ODc2NDI1,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0xMODQ1ODc2NDI1_size_16_color_FFFFFF_t_70 3]: https://img-blog.csdnimg.cn/20190922225907249.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0xMODQ1ODc2NDI1,size_16,color_FFFFFF,t_70