摘要：給出的日志等級(jí)順序就是記錄最小到最嚴(yán)謹(jǐn)?shù)娜罩镜燃?jí)順序。錯(cuò)誤日志格式不支持自定義日志格式但他同樣記錄當(dāng)前時(shí)間日志等級(jí)和具體信息等數(shù)據(jù)。日志緩沖區(qū)當(dāng)系統(tǒng)處于負(fù)載狀態(tài)時(shí)，啟用日志緩沖區(qū)以降低進(jìn)程阻塞。

原文鏈接： 何曉東 博客

如果想統(tǒng)計(jì)網(wǎng)站的訪(fǎng)問(wèn)來(lái)源信息，可以用 php 獲取信息，記錄到數(shù)據(jù)庫(kù)的形式，也可以直接使用 nginx 提供的訪(fǎng)問(wèn)日志，來(lái)記錄網(wǎng)站的訪(fǎng)問(wèn)詳情，管理員可以通過(guò)分析 nginx 的訪(fǎng)問(wèn)日志，來(lái)分析用戶(hù)的訪(fǎng)問(wèn)來(lái)源，訪(fǎng)問(wèn)行為詳情，網(wǎng)站頁(yè)面訪(fǎng)問(wèn)熱度等。此外，nginx 自身也有錯(cuò)誤日志，方便運(yùn)維人員調(diào)試 nginx。對(duì)于記錄日志的行為，如果每次進(jìn)行磁盤(pán)操作，將會(huì)較多的耗費(fèi)資源，基于這個(gè)情況可以開(kāi)啟 nginx 日志緩沖區(qū)，緩沖區(qū)滿(mǎn)或者定時(shí)寫(xiě)入的時(shí)間到了，再一次寫(xiě)入日志。

nginx 在處理請(qǐng)求后立即在訪(fǎng)問(wèn)日志中寫(xiě)入有關(guān)客戶(hù)端請(qǐng)求的信息。默認(rèn)情況下，訪(fǎng)問(wèn)日志位 logs/access.log 中，信息以預(yù)定義的組合格式寫(xiě)入日志。
想要精確記錄訪(fǎng)問(wèn)信息，就需要自定義一個(gè)更加完整的訪(fǎng)問(wèn)日志格式，如下所示：

http {
    log_format geoproxy
    "[$time_local] $remote_addr "
    "$realip_remote_addr $remote_user "
    "$request_method $server_protocol "
    "$scheme $server_name $uri $status "
    "$request_time $body_bytes_sent "
    "$geoip_city_country_code3 $geoip_region "
    ""$geoip_city" $http_x_forwarded_for "
    "$upstream_status $upstream_response_time "
    ""$http_referer" "$http_user_agent"";
    ...
}

這個(gè)日志配置被命名為 geoproxy，它使用許多 nginx 變量來(lái)演示 nginx 日志記錄功能。詳細(xì)講解配置選項(xiàng)中各個(gè)變量的具體含義：

當(dāng)用戶(hù)發(fā)起請(qǐng)求時(shí)，會(huì)記錄服務(wù)器時(shí)間 $time_local, $remote_user 值為通過(guò)基本授權(quán)的用戶(hù)名稱(chēng)；

用于 nginx 處理 geoip_proxy 和 realip_header 指令的打開(kāi)連接的 IP 地址和客戶(hù)端 IP 地址；

之后記錄 HTTP 請(qǐng)求方法 $request_method、協(xié)議 $server_protocol 和 HTTP 方法 $scheme：http 或 https；

當(dāng)然還有服務(wù)器名稱(chēng) $server_name、請(qǐng)求的 URI 和響應(yīng)狀態(tài)碼；

除基本信息外，還有一些統(tǒng)計(jì)的結(jié)果數(shù)據(jù)：包括請(qǐng)求處理的毫秒級(jí)時(shí)間 $request_time、服務(wù)器響應(yīng)的數(shù)據(jù)塊大小 $body_bytes_sent；
此外，客戶(hù)端所在國(guó)家 $geoip_city_country_code3、地區(qū) $geoip_region 和城市信息 $geoip_city 也被記錄在內(nèi)；

變量 $http_x_forwarded_for 用于記錄由其它代理服務(wù)器發(fā)起的請(qǐng)求的 X-Forwarded-For 頭消息；

upstream 模塊中一些數(shù)據(jù)也被記錄到日志里：被代理服務(wù)器的響應(yīng)狀態(tài)碼 $upstream_status 、建立鏈接和從上游服務(wù)器接收響應(yīng)主體最后一個(gè)字節(jié)的時(shí)間 $upstream_response_time、 建立和上游服務(wù)器的鏈接時(shí)間 $upstream_connect_time、建立鏈接和從上游響應(yīng)頭的第一個(gè)字節(jié)的時(shí)間 $upstream_header_time。

請(qǐng)求來(lái)源 $http_referer 和用戶(hù)代理 $http_user_agent 也可以被記錄在日志里；

nginx 的日志記錄功能非常強(qiáng)大和靈活的，需要注意的是：用于定義日志格式的 log_format 指令僅適用于 http 塊級(jí)指令內(nèi)，所有時(shí)間值均以毫秒為單位，以毫秒分辨率進(jìn)行測(cè)量。。

這個(gè)格式的日志配置將產(chǎn)生如下類(lèi)型的日志：

[25/Feb/2019:16:20:42 +0000] 10.0.1.16 192.168.0.122 Derek
GET HTTP/1.1 http www.example.com / 200 0.001 370 USA MI
"Ann Arbor" - 200 0.001 "-" "curl/7.47.0"

如果需要使用這個(gè)日志配置，需要結(jié)合使用 access_log 指令，access_log指令接收一個(gè)日志目錄和使用的配置名作為參數(shù)：

server {
    access_log /var/log/nginx/access.log geoproxy;
    ...
}

access_log 能在多個(gè)上下文使用，每個(gè)上下文中可以定義各自的日志目錄和日志記錄格式。

結(jié)論： nginx 中的日志模塊允許為不同的場(chǎng)景配置日志格式，以便查看不同的日志文件。

在實(shí)際運(yùn)用中，為不同上下文配置不同的日志會(huì)非常有用，記錄的日志內(nèi)容可以簡(jiǎn)單的信息，也可以詳細(xì)記錄所有必要信息。不僅如此，日志內(nèi)容除了支持文本
也能記錄 json 格式和 xml 格式數(shù)據(jù)。實(shí)際上 nginx 日志有助于您了解服務(wù)器流量、客戶(hù)端使用情況和客戶(hù)端來(lái)源等信息。此外，訪(fǎng)問(wèn)日志還可以幫助您定位與上游服務(wù)器或特定 uri 相關(guān)的響應(yīng)和問(wèn)題；對(duì)于測(cè)試來(lái)講，訪(fǎng)問(wèn)日志同樣有用，它可以用于分析流量情況，模擬真實(shí)的用戶(hù)交互場(chǎng)景。日志在故障排除、調(diào)試、應(yīng)用分析及業(yè)務(wù)調(diào)整中作用是不可或缺的。

為了精確定位 nginx 的錯(cuò)誤日志，使用自帶的 error_log 指令定義錯(cuò)誤日志目錄及記錄錯(cuò)誤日志的等級(jí)，配置如下：

error_log /var/log/nginx/error.log warn;

error_log 指令配置時(shí)需要一個(gè)必選的日志目錄和一個(gè)可選的錯(cuò)誤等級(jí)選項(xiàng)。
除 if 指令外，error_log 指令能在所有的上下文中使用。錯(cuò)誤日志等級(jí)包括：
debug、info、notice、warn、error、crit、alert 和 emerg。給出的日志
等級(jí)順序就是記錄最小到最嚴(yán)謹(jǐn)?shù)娜罩镜燃?jí)順序。需要注意的是 debug 日志
需要在編譯 nginx 服務(wù)器時(shí)，帶上 --with-debug 標(biāo)識(shí)才能使用。

當(dāng)服務(wù)器配置出錯(cuò)時(shí)，首先需要查看錯(cuò)誤日志以定位問(wèn)題。錯(cuò)誤日志
也是定位應(yīng)用服務(wù)器(如 FastCGI 服務(wù))的利器。通過(guò)錯(cuò)誤日志，我們可以調(diào)試 worker 進(jìn)程連接錯(cuò)誤、內(nèi)存分配、客戶(hù)端 IP 和 應(yīng)用服務(wù)器等問(wèn)題。錯(cuò)誤日志格式不支持自定義日志格式；但他同樣記錄當(dāng)前時(shí)間、日志等級(jí)和具體信息等數(shù)據(jù)。

注意： 錯(cuò)誤日志的默認(rèn)設(shè)置適用于全局。要覆蓋它，請(qǐng)將 error_log 指令放在 main（頂級(jí)）配置上下文中。error_log 在開(kāi)源 NGINX 1.5.2 版中添加了在同一配置級(jí)別指定多個(gè)指令的功能。

通過(guò) syslog 將日志發(fā)送到統(tǒng)一服務(wù)器

既然不再需要將日志寫(xiě)到磁盤(pán)的某個(gè)目錄，而是發(fā)送到統(tǒng)一的日志服務(wù)器，則將原有的目錄部分替換為服務(wù)器 ip 即可，配置如下：

error_log syslog:server=10.0.1.42 debug;
access_log syslog:server=10.0.1.42,tag=nginx,severity=info geoproxy;

#error_log server=unix:/var/log/nginx.sock debug;
#access_log syslog:server=[2001:db8::1]:1234,facility=local7,tag=nginx,severity=info;

error_log 和 access_log 指令的 syslog 參數(shù)緊跟冒號(hào) : 和一些參數(shù)選項(xiàng)。包括：必選的 server 標(biāo)記表示需要連接的 IP、DNS 名稱(chēng)或 UNIX 套接字；
可以使用如上注釋的高端玩。

可選參數(shù)有 facility、severity、tag:

server 參數(shù)接收帶端口的 IP 地址或 DNS 名稱(chēng)；默認(rèn)是 UDP 514 端口。

facility 參數(shù)設(shè)置syslog 的類(lèi)型 facility，值是 syslog RFC 標(biāo)準(zhǔn)定義的 23 個(gè)值中一個(gè)，默認(rèn)值為 local7。其他可能的值是：auth，authpriv，daemon，cron，ftp，lpr，kern，mail，news，syslog，user，uucp，local0 ... local7

tag 參數(shù)表示日志文件中顯示時(shí)候的標(biāo)題，默認(rèn)值是 nginx。

severity 設(shè)置消息嚴(yán)重程度，默認(rèn)是 info 級(jí)別日志。

當(dāng)系統(tǒng)處于負(fù)載狀態(tài)時(shí)，啟用日志緩沖區(qū)以降低 nginx worker 進(jìn)程阻塞。大量的磁盤(pán)讀寫(xiě)和 cpu 資源使用對(duì)于服務(wù)器資源也是一種巨大消耗。將日志數(shù)據(jù)緩沖到內(nèi)存中可能是很小的一個(gè)優(yōu)化手段，buffer 參數(shù)意義是緩沖區(qū)的大小，功能是當(dāng)緩沖區(qū)已經(jīng)寫(xiě)滿(mǎn)時(shí)，日志會(huì)被寫(xiě)入文件中；flush 參數(shù)意義是緩沖區(qū)內(nèi)日志在緩沖區(qū)內(nèi)存中保存的最長(zhǎng)時(shí)間，功能即當(dāng)緩存中的日志超過(guò)最大緩存時(shí)間，也會(huì)被寫(xiě)入到文件中，不足的地方即寫(xiě)入到日志文件的日志有些許延遲，即時(shí)調(diào)試中應(yīng)當(dāng)關(guān)閉日志緩沖。。配置如下：

http {
    access_log /var/log/nginx/access.log main buffer=32k flush=1m;
}

參考鏈接：

nginx cook book

nginx 配置日志

如常，給大家推薦一波課程，我看過(guò)的，質(zhì)量很高 -> 去瞅瞅