在 OpenResty Edge 中配置錯誤日誌檔案
今天我想演示的是如何在 OpenResty Edge 中檢查應用的錯誤日誌和全域性錯誤日誌。
示例應用的錯誤日誌
像往常一樣,讓我們進入 OpenResty Edge 的 Admin Web 控制檯。這是我們控制檯的樣本部署。每個使用者都有自己的本地部署。
我們繼續使用 test-edge.com 域名的樣本應用。
進入這個應用。
點選這裡檢視該應用的錯誤日誌。
可以看到,這裡已經有了一些錯誤日誌記錄。這個頁面顯示了錯誤日誌相關的一些重要資訊。
比如說請求 ID,錯誤日誌資訊,主機名,請求體,客戶端 IP 地址等等。
現在我們來對應用做一些改動。改動之後再訪問 test-edge.com 這個域名會生成一個新的錯誤日誌資訊。
這裡我們已經定義好了一個頁面規則。
這個頁面規則設定了一個反向代理到一個預先定義的上游。
讓我們轉到 Upstreams 頁面。
編輯上游伺服器。
停用這個上游伺服器。上游伺服器被停用之後,我們訪問應用時將會得到一個 Bad Gateway 的錯誤。
儲存這個改動。
像往常一樣,需要釋出一個新的版本來推送我們剛才的改動。
點選這個按鈕。
釋出!
新版本現在已經同步到所有的閘道器伺服器上了。
現在,新的頁面規則已經被推送到所有的閘道器叢集和伺服器。
這些配置的變化不需要伺服器過載、重啟或二進位制升級。所以它是非常高效和可擴充套件的。
現在來傳送一個請求。
在終端上,用 curl 傳送請求。
curl -sSI http://test-edge.com
可以看到返回了 Bad Gateway 錯誤,這個錯誤將被記錄在應用的錯誤日誌中。
而且可以看到,伺服器端的響應裡有一個請求 ID。複製這個 ID,用它來查詢相應的日誌資訊。
現在回到應用的錯誤日誌頁面。檢查錯誤日誌資訊。不出所料,剛才的請求生成了錯誤日誌。新生成的錯誤日誌出現在列表的頂部。
Openresty.com 的錯誤日誌
這個應用的錯誤日誌比較少。現在來看一下我們線上其他應用的錯誤日誌。
轉到應用列表頁。
讓我們看看 OpenResty.com 網站的錯誤日誌。
轉到該頁面。
轉到錯誤日誌頁面。這裡記錄了更多的錯誤日誌。
頂部的過濾查詢條件有利於準確定位問題。
例如我們可以透過請求 ID 來過濾資訊。
或者透過閘道器。
伺服器。
錯誤日誌級別。
以及時間間隔。
現在來試試透過閘道器過濾訊息。
選擇 aws-us-west 閘道器。
可以看到,aws-us-west 閘道器下沒有任何錯誤日誌。
全域性錯誤日誌
在瞭解了應用的錯誤日誌之後,我們再來看看全域性錯誤日誌。全域性錯誤日誌顯示在 Dashboard 頁面上。
現在轉到 Dashboard 頁面去看看全域性錯誤日誌。
可以看到有三種型別的錯誤日誌。
全域性錯誤日誌。
Admin 站點的錯誤日誌。
日誌伺服器的錯誤日誌。
先來看看全域性錯誤日誌。
全域性錯誤日誌是由閘道器伺服器收集的,不隸屬於任何應用。
可以過濾錯誤日誌。
繼續看一下 Admin 站點的錯誤日誌。
這些錯誤日誌是從 Admin 控制檯收集的。
我們還支援對日誌進行條件過濾。
例如可以選擇日誌級別 “Error”。
可以看到 “Error” 級別和重複次數大於 1 的日誌被高亮顯示。
最後,來看一下日誌伺服器的錯誤日誌。
本頁面顯示的錯誤日誌來自 OpenResty Edge 日誌伺服器。
在這裡我們也可以過濾日誌。
可以看到,全域性錯誤日誌和應用錯誤日誌都有日誌級別,但不是所有級別的日誌都會被系統上報。
我們可以在全域性配置頁面設定要上報的日誌級別。
這裡我們把它設定為 “warn”,這意味著只會上報警告以及比警告級別更高的日誌。
可以設定的錯誤日誌級別有 “warn”、“error”、“crit”、“alert” 等等。
在你的本地部署中,你可以設定任意的日誌級別。
在伺服器上檢視錯誤日誌
現在讓我們來登入 OpenResty Edge 閘道器伺服器,看看 error.log 檔案。
檢查最後一條錯誤日誌資訊。
閘道器伺服器的錯誤日誌資訊都寫在這裡。
執行該命令。
我們可以看到閘道器伺服器的錯誤日誌資訊。
退出伺服器。
然後,我們登入 OpenResty Edge 的 Admin 伺服器,檢視 error.log 檔案。
看一下最後的錯誤日誌資訊。
OpenResty Edge Admin 的錯誤日誌資訊寫在這裡。
執行該命令。
可以看到 OpenResty Edge Admin 的錯誤日誌資訊。
這就是我今天想講的內容。
關於本文和關聯影片
本文和相關聯的影片都是完全由我們的 OpenResty Showman 產品從一個簡單的劇本檔案自動生成的。
關於作者
章亦春是開源 OpenResty® 專案創始人兼 OpenResty Inc. 公司 CEO 和創始人。
章亦春(Github ID: agentzh),生於中國江蘇,現定居美國灣區。他是中國早期開源技術和文化的倡導者和領軍人物,曾供職於多家國際知名的高科技企業,如 Cloudflare、雅虎、阿里巴巴, 是 “邊緣計算“、”動態追蹤 “和 “機器程式設計 “的先驅,擁有超過 22 年的程式設計及 16 年的開源經驗。作為擁有超過 4000 萬全球域名使用者的開源專案的領導者。他基於其 OpenResty® 開源專案打造的高科技企業 OpenResty Inc. 位於美國矽谷中心。其主打的兩個產品 OpenResty XRay(利用動態追蹤技術的非侵入式的故障剖析和排除工具)和 OpenResty Edge(最適合微服務和分散式流量的全能型閘道器軟體),廣受全球眾多上市及大型企業青睞。在 OpenResty 以外,章亦春為多個開源專案貢獻了累計超過百萬行程式碼,其中包括,Linux 核心、Nginx、LuaJIT、GDB、SystemTap、LLVM、Perl 等,並編寫過 60 多個開源軟體庫。
關注我們
如果您喜歡本文,歡迎關注我們 OpenResty Inc. 公司的部落格網站 。也歡迎掃碼關注我們的微信公眾號:
翻譯
我們提供了英文版原文和中譯版(本文)。我們也歡迎讀者提供其他語言的翻譯版本,只要是全文翻譯不帶省略,我們都將會考慮採用,非常感謝!