瞭解 OpenResty XRay 是如何做到幫助企業定位應用程式存在的問題以及最佳化其效率的。

瞭解更多 LIVE DEMO

在本教程中,我們將演示如何使用 OpenResty 附帶的 resty 命令列工具。

cd ~
export PATH=/usr/local/openresty/bin:$PATH
which resty

截圖 1

一般都是這個路徑。

我們可以透過 -V 選項檢查其版本號。

resty -V

截圖 3

如果你使用我們預構建的 Linux 二進位制包安裝 OpenResty,那麼你應該安裝 openresty-resty 包。

dnf list installed openresty-resty

截圖 4

因為它不在 openresty 主包中。

比如用 resty 命令來做“hello world”,就容易多了。

resty -e 'print("Hello World")'

截圖 6

注意 -e 選項。

或者在終端上執行一個 Lua 指令碼。

echo 'print("Hello World")' > hello.lua
cat hello.lua
resty hello.lua

截圖 8

所以這也是使用 OpenResty 編寫新的命令列應用程式的好方法。

這裡也可以實現非阻塞 I/O。

time resty -e 'ngx.sleep(1) ngx.say("done")'

截圖 10

讓我們使用 cosocket API 連線到 openresty.com 的 443 埠。

resty -e 'local sock = ngx.socket.tcp() print(sock:connect("openresty.com", 443))'

截圖 11

或者使用輕執行緒。

resty -e 'ngx.thread.wait(ngx.thread.spawn(function () print("in thread!") end))'

截圖 12

你也可以很容易地使用 Lua 模組。讓我們建立一個 test 模組。

mkdir lua/
vim lua/test.lua

lua/test.lua檔案是這樣的。

local _M = {}

function _M.hello() print("Hello") end

return _M

截圖 13

然後我們使用 -I 選項將 lua/ 目錄新增到 Lua 模組搜尋路徑中。

resty -I lua/ -e 'require "test".hello()'

截圖 14

如果沒有 -I 選項,它就找不到。

resty -e 'require "test".hello()'

截圖 15

這是因為 lua/ 目錄預設不在 Lua 模組的搜尋路徑中。

可以直接載入標準的 Lua 模組,比如 resty.shell

resty -e 'local ok, stdout = require "resty.shell".run([[echo ok]]) print(stdout)'

截圖 17

該模組用於非阻塞地執行少量 shell 命令。

我們也可以透過 --shdict 選項來定義 lua 共享記憶體字典。

resty --shdict 'dogs 10m' -e 'print(ngx.shared.dogs:set("age", 11))'

截圖 19

可以這樣定義多個共享詞典。

resty --shdict 'dogs 7m' --shdict 'cats 5m' -e 'print(ngx.shared.dogs, " ", ngx.shared.cats)'

截圖 20

它還可以方便地注入自定義的 nginx 配置程式碼。

resty --http-conf 'lua_regex_match_limit 102400;' -e 'print "ok"'

截圖 21

我們還可以玩玩 LuaJIT 的 JIT 編譯器。

讓我們建立一個跑得比較熱的 Lua 指令碼。

echo 'local a = 0 for i = 1, 1e8 do a = a + 1 end print(a)' > bench.lua
cat bench.lua

截圖 23

然後完全禁用 JIT 編譯器。

time resty -joff bench.lua

截圖 24

為了比較,我們可以檢查一下啟用 JIT 編譯器後速度有多快。

time resty bench.lua

截圖 25

或者我們可以用 -jv 選項檢查編譯後的 Lua 程式碼路徑,或者說“traces”。

resty -jv bench.lua

截圖 26

或者有更多的細節,比如編譯後的位元組碼轉儲,IR 程式碼轉儲,以及機器程式碼轉儲。

resty -jdump bench.lua

你可以隨時透過 -h 選項找到所有支援的功能。

resty -h

或者透過“restydoc”工具參考其文件。

restydoc resty-cli

如果你透過我們預建的二進位制包安裝 openresty,那麼你應該安裝 openresty-docopenresty-restydoc 包。

dnf list installed openresty-doc

截圖 30

我們將在另一個專門的影片教程中更深入地瞭解“restydoc”工具。 如果你喜歡這個教程,請訂閱這個部落格網站和我們的 YouTube 頻道B 站頻道。謝謝!

關於本文和關聯影片

本文和相關聯的影片都是完全由我們的 OpenResty Showman 產品從一個簡單的劇本檔案自動生成的。

關於作者

章亦春是開源 OpenResty® 專案創始人兼 OpenResty Inc. 公司 CEO 和創始人。

章亦春(Github ID: agentzh),生於中國江蘇,現定居美國灣區。他是中國早期開源技術和文化的倡導者和領軍人物,曾供職於多家國際知名的高科技企業,如 Cloudflare、雅虎、阿里巴巴, 是 “邊緣計算“、”動態追蹤 “和 “機器程式設計 “的先驅,擁有超過 22 年的程式設計及 16 年的開源經驗。作為擁有超過 4000 萬全球域名使用者的開源專案的領導者。他基於其 OpenResty® 開源專案打造的高科技企業 OpenResty Inc. 位於美國矽谷中心。其主打的兩個產品 OpenResty XRay(利用動態追蹤技術的非侵入式的故障剖析和排除工具)和 OpenResty Edge(最適合微服務和分散式流量的全能型閘道器軟體),廣受全球眾多上市及大型企業青睞。在 OpenResty 以外,章亦春為多個開源專案貢獻了累計超過百萬行程式碼,其中包括,Linux 核心、Nginx、LuaJITGDBSystemTapLLVM、Perl 等,並編寫過 60 多個開源軟體庫。

關注我們

如果您喜歡本文,歡迎關注我們 OpenResty Inc. 公司的部落格網站 。也歡迎掃碼關注我們的微信公眾號:

我們的微信公眾號

翻譯

我們提供了英文版原文和中譯版(本文) 。我們也歡迎讀者提供其他語言的翻譯版本,只要是全文翻譯不帶省略,我們都將會考慮採用,非常感謝!