nginx日志自定义格式及缓存配置

目录

Nginx日志配置

设置access_log

设置error_log

open_log_file_cache设置缓存

如何配置proxy_cache模块

---

Nginx日志配置

Nginx日志分为两种：

access_log(访问日志)和error_log(错误日志)。

通过访问日志可以得到用户的IP地址，浏览器的信息，请求的处理时间等信息。

错误日志记录了访问出错的信息，可以帮助定位错误的原因。

设置access_log

访问日志主要记录客户端的请求。客户端向Nginx服务器发起的每一次请求都记录在这里。客户端IP，浏览器信息，referer，请求处理时间，请求URL等都可以在访问日志中得到。要记录哪些信息，你可以通过log_format指令定义

access_log path [format [buffer=size] [gzip[=level]] [flush=time] [if=condition]]; # 设置访问日志

access_log off; # 关闭访问日志

特殊值off,当前作用域下的所有请求日志都被关闭

作用域

可以应用access_log指令的作用域分别为http,server,location,limit_except。

在这几个作用域外使用该指令，nginx会报错

基本用法

access_log  /usr/local/webserver/nginx/logs/nginx_access.log

该例子指定日志的写入路径为

access_log  /usr/local/webserver/nginx/logs/nginx_access.log buffer=32k gzip flush=1m

该例子指定日志的写入路径为/usr/local/webserver/nginx/logs/nginx_access.log,日志格式使用默认的combined,指定日志的缓存大小为32k,日志写入前启用gzip进行压缩，压缩比使用默认值1，缓存数据有效时间为1分钟

Nginx预定义了名为combined日志格式，如果没有明确指定日志格式默认使用该格式：

log_format combined '$remote_addr - $remote_user [$time_local] '

                    '"$request" $status $body_bytes_sent '

                    '"$http_referer" "$http_user_agent"';

如果不想使用Nginx预定义的格式，可以通过log_format指令来自定义。

log_format name [escape=default|json] string …;

name 格式名称。在access_log指令中引用。

escape 设置变量中的字符编码方式是json还是default，默认是default。

string 要定义的日志格式内容。该参数可以有多个。参数中可以使用Nginx变量。

下面是log_format指令中常用的一些变量：

$bytes_sent:发送给客户端的总字节数

$body_bytes_sent:发送给客户端的字节数，不包括响应头的大小

$connection:连接序列号

$connection_requests:当前通过连接发出的请求数量

$mses:日志写入时间，单位为秒，精度是毫秒

$pipe:如果请求是通过http流水线发送，则其值为“p”,否则为“.”

$request_length:请求长度

$request_time:请求处理时长

$status:响应状态码

$time_iso8601:标准格式的本地时间

$time_local:通用日志格式下的本地时间

$http_referer:请求的referer地址

$http_user_agent:客户端浏览器信息

$remote_addr:客户端IP

$http_x_forwarded_for:当前端有代理服务器时，记录web节点记录客户端地址的配置

$request:完整的原始请求行

$remote_user:客户端用户名称

$request_url:完整的请求地址

自定义日志格式的使用：

access_log  /usr/local/webserver/nginx/logs/nginx_access.log  main

log_format main '$remote_addr - $remote_user [$time_local] '

                    '"$request" $status $body_bytes_sent '

                    '"$http_referer" "$http_user_agent"”$http_x_forwarded_for”';

使用log_format指令定义了一个main的格式，并在access_log指令中引用了它。

设置error_log

错误日志在Nginx中是通过error_log指令实现的。该指令记录服务器和请求处理过程中的错误信息

配置错误日志文件的路径和日志级别

error_log file [level];

Default:    

error_log logs/error.log error;

第一个参数指定日志的写入位置

第二个参数指定日志的级别，level可以是debug,info,notice,warn,error,crit,alert,emerg中的任意值

基本用法：

error_log  /usr/local/webserver/nginx/logs/nginx_error.log

open_log_file_cache设置缓存

open_log_file_cache设置日志文件描述符的缓存

open_log_file_cache max=N[inactive=time][min_uses=N][valid=time];

max:设置缓存中最多容纳的文件描述符数量

inactive:设置缓存存活时间

min_uses:在inactive时间段内，日志文件最少使用几次

valid:设置多久对日志文件名进行检查

off：不使用缓存

基本用法：open_log_file_cache max=1000 inactive=20s valid=1m min_uses=2;

如何配置proxy_cache模块

在nginx.conf文件中添加如下代码：

http{

    ......

    proxy_cache_path/data/nginx/tmp-test levels=1:2 keys_zone=tmp-test:100m inactive=7d max_size=1000g;

}

代码说明：

proxy_cache_path 缓存文件路径

levels 设置缓存文件目录层次；levels=1:2 表示两级目录

keys_zone 设置缓存名字和共享内存大小

inactive 在指定时间内没人访问则被删除

m ax_size 最大缓存空间，如果缓存空间满，默认覆盖掉缓存时间最长的资源。

当配置好之后，重启nginx，如果不报错，则配置的proxy_cache会生效

查看   proxy_cache_path / data/ nginx / 目录，

会发现生成了 tmp -test 文件夹。

如何使用proxy_cache

location /tmp-test/ {

  proxy_cache tmp-test;

  proxy_cache_valid  200 206 304 301 302 10d;

  proxy_cache_key $uri;

  proxy_set_header Host $host:$server_port;

  proxy_set_header X-Real-IP $remote_addr;

  proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;

  proxy_passhttp://127.0.0.1:8081/media_store.php/tmp-test/;

}

配置项介绍：

Proxy_cache tmp -test 使用名为 tmp -test 的对应缓存配置

proxy_cache_valid  200 206 304 301 302 10d; 对httpcode为200…的缓存10天

proxy_cache_key $uri  定义缓存唯一key,通过唯一key来进行hash存取

proxy_set_header  自定义http header头，用于发送给后端真实服务器。

proxy_pass   指代理后转发的路径，注意是否 需要 最后的 /

小结

Nginx中通过access_log和error_log指令配置访问日志和错误日志，通过log_format我们可以自定义日志格式。如果日志文件路径中使用了变量，我们可以通过open_log_file_cache指令来设置缓存，提升性能

参考文档资料:https://blog.csdn.net/dengjiexian123/article/details/53386586