Nginx配置中的log_format用法梳理（設(shè)置詳細(xì)的日志格式）

?

nginx服務(wù)器日志相關(guān)指令主要有兩條：一條是log_format，用來(lái)設(shè)置日志格式；另外一條是access_log，用來(lái)指定日志文件的存放路徑、格式和緩存大小，可以參加ngx_http_log_module。一般在nginx的配置文件中日記配置(/usr/local/nginx/conf/nginx.conf)。

log_format指令用來(lái)設(shè)置日志的記錄格式，它的語(yǔ)法如下：log_format name?format?{format?...}其中name表示定義的格式名稱，format表示定義的格式樣式。log_format有一個(gè)默認(rèn)的、無(wú)須設(shè)置的combined日志格式設(shè)置，相當(dāng)于Apache的combined日志格式，其具體參數(shù)如下：log_format combined?'$remote_addr-$remote_user [$time_local]'‘"$request"$status $body_bytes_sent’‘"$http_referer"?"$http_user_agent"’也可以自定義一份日志的記錄格式，不過(guò)要注意，log_format指令設(shè)置的名稱在配置文件中是不能重復(fù)的。假設(shè)將Nginx服務(wù)器作為Web服務(wù)器，位于負(fù)載均衡設(shè)備、Squid、Nginx反向代理之后，不能獲取到客戶端的真實(shí)IP地址了。原因是經(jīng)過(guò)反向代理后，由于在客戶端和Web服務(wù)器之間增加了中間層，因此Web服務(wù)器無(wú)法直接拿到客戶端的IP。通過(guò)$remote_addr變量拿到的將是反向代理服務(wù)器的IP地址。但是，反向代理服務(wù)器在轉(zhuǎn)發(fā)請(qǐng)求的HTTP頭信息中，可以增加X(jué)-Forwarded-For信息，用以記錄原有的客戶端IP地址和原來(lái)客戶端請(qǐng)求的服務(wù)器地址。這時(shí)候，要用log_format指令設(shè)置日志格式，讓日志記錄X-Forearded-For信息中的IP地址，即客戶的真實(shí)IP。例如，創(chuàng)建一個(gè)名為mylogformat的日志格式，再$http_x_forwarded_forlog_for變量記錄用戶的X_Forwarded-For IP 地址：log_format mylogformat?'$http_x_forwarded_for_$remote_user [$time_local]'‘"$request"$status $body_bytes_sent’‘"$http_referer"?"$http_user_agent"’在日志格式樣式中，變量$remote_addr和$http_x_forwarded_for用于記錄IP地址；$remote_user用于記錄遠(yuǎn)程客戶端用戶名稱；$time_local用于記錄訪問(wèn)時(shí)間與時(shí)區(qū)；$request用于記錄請(qǐng)求URL與HTTP協(xié)議；$status用于記錄請(qǐng)求狀態(tài)，例如成功時(shí)狀態(tài)為200，頁(yè)面找不到時(shí)狀態(tài)為404；$body_bytes_sent用于記錄發(fā)送客戶端的文件主體內(nèi)容大小；$http_referer用于記錄是從哪個(gè)頁(yè)面鏈接訪問(wèn)過(guò)來(lái)的；$http_user_agent用于記錄客戶瀏覽器的相關(guān)信息。

一般來(lái)說(shuō)：nginx的log_format有很多可選的參數(shù)用于指示服務(wù)器的活動(dòng)狀態(tài)，默認(rèn)的是：

1 2 3

log_format? main??'$remote_addr - $remote_user [$time_local] "$request" ' ??????????????????'$status $body_bytes_sent "$http_referer" ' ??????????????????'"$http_user_agent" "$http_x_forwarded_for"';

想要記錄更詳細(xì)的信息需要自定義設(shè)置log_format，具體可設(shè)置的參數(shù)格式及說(shuō)明如下：

參數(shù) 說(shuō)明 示例 $remote_addr 客戶端地址 211.28.65.253 $remote_user 客戶端用戶名稱 -- $time_local 訪問(wèn)時(shí)間和時(shí)區(qū) 18/Jul/2012:17:00:01 +0800 $request 請(qǐng)求的URI和HTTP協(xié)議 "GET /article-10000.html HTTP/1.1" $http_host 請(qǐng)求地址，即瀏覽器中你輸入的地址（IP或域名） www.wang.com 192.168.100.100 $status HTTP請(qǐng)求狀態(tài) 200 $upstream_status upstream狀態(tài) 200 $body_bytes_sent 發(fā)送給客戶端文件內(nèi)容大小 1547 $http_referer url跳轉(zhuǎn)來(lái)源 https://www.baidu.com/ $http_user_agent 用戶終端瀏覽器等信息 "Mozilla/4.0 (compatible; MSIE 8.0; Windows NT 5.1; Trident/4.0; SV1; GTB7.0; .NET4.0C; $ssl_protocol SSL協(xié)議版本 TLSv1 $ssl_cipher 交換數(shù)據(jù)中的算法 RC4-SHA $upstream_addr 后臺(tái)upstream的地址，即真正提供服務(wù)的主機(jī)地址 10.10.10.100:80 $request_time 整個(gè)請(qǐng)求的總時(shí)間 0.205 $upstream_response_time 請(qǐng)求過(guò)程中，upstream響應(yīng)時(shí)間 0.002

如下是在nginx的LB代理層使用過(guò)的一個(gè)配置（nginx.conf中配置）：

1 2 3

log_format? main??'$remote_addr $remote_user [$time_local] "$request" ' ??????????????????'$status $body_bytes_sent "$http_referer" ' ??????????????????'$http_user_agent $http_x_forwarded_for $request_time $upstream_response_time $upstream_addr $upstream_status';

然后在nginx.conf文件或vhosts/*.conf文件中的access_log日志中指定級(jí)別為main。如下：

1 2	access_log? logs/wiki_access.log main; error_log?? logs/wiki_error.log;

重啟nginx服務(wù)后生效。日志截取如下（可以從日志中看到代理到后端哪臺(tái)機(jī)器上的哪個(gè)端口上，負(fù)載訪問(wèn)的狀態(tài)值等都能看到）：

[root@lb-ng01 logs]# tail -f /data/nginx/logs/wiki_access.log
........
110.156.114.121 - [11/Aug/2017:09:57:19 +0800] "GET /rest/mywork/latest/status/notification/count?_=1502416641768 HTTP/1.1" 200 67 "http://wiki.wang-inc.com/pages/viewpage.action?pageId=11174759" Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3112.78 Safari/537.36 - 0.006 0.006?12.129.120.121:8090?200
112.116.25.18 - [11/Aug/2017:09:57:24 +0800] "POST /json/startheartbeatactivity.action HTTP/1.1" 200 234 "http://wiki.wang-inc.com/pages/resumedraft.action?draftId=12058756&draftShareId=014b0741-df00-4fdc-90ca-4bf934f914d1" Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/59.0.3071.115 Safari/537.36 - 0.023 0.023?12.129.120.121:8090?200

總結(jié)

以上是生活随笔為你收集整理的Nginx配置中的log_format用法梳理（设置详细的日志格式）的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。