今天，我將演示 OpenResty Edge 另一個很酷的功能。即使用 Metric SQL 語言建立新的動態指標。

動態指標簡介

動態指標允許使用者透過即時編寫類似 SQL 的查詢語句來建立度量指標。OpenResty Edge 會自動生成高效率程式碼，以收集和彙總每個閘道器伺服器記憶體中的指標資料。之後資料會被報告給 web 控制檯，並實時顯示在漂亮的圖表中。

別擔心效率問題。系統使用機器編碼技術將使用者自定義的動態指標以及內建的標準動態指標轉換成高效的原生代碼。它會使用固定大小的記憶體進行流式聚合和統計。

在示例應用中啟用動態指標

讓我們進入 OpenResty Edge 的 Admin Web 控制檯。這是我們控制檯的樣本部署。每個使用者都有自己的本地部署。

我們可以繼續使用之前的示例應用，test-edge.com。

進入該應用程式。

點選這個選單項，進入動態指標頁面。

可以看到有兩種型別的動態指標。 一種被稱為使用者自定義的動態指標，是由使用者自己定義的。

另一種則是由 OpenResty Edge 預定義的標準動態指標。

今天這個教程是關於標準動態指標的。自定義的動態指標在另一個教程中介紹。

我們將使用 “Top 10 URIs by Request Counts” 這個指標作為例子來講解如何啟用一個標準的動態指標以及動態指標是如何運作的。

我們使用 OpenResty Edge 平臺提供的 Metric SQL 語言。你可以在我們的文件網站上找到這個語言的使用者手冊。

看一下這個指標的 Metric SQL 宣告。

它將所有的請求按 URI 進行分組，按照請求數進行降序排序，並選取請求數量最高的 10 組進行顯示。

你可以點選這個按鈕來隱藏 Metric SQL 語句。

到目前為止，你所看到的只是這個標準動態指標的定義。我們還沒有真正啟用它。

你需要點選 “Enable” 按鈕來啟用這個指標。

點選 “Go to Chart” 按鈕，進入動態指標的 Dashboard。

剛剛啟用的這個指標顯示在這裡。

如果想修改這個指標，你可以點選編輯按鈕，開啟編輯面板。

對於標準動態指標，你只能修改指標上報間隔。指標的名字和 Metric SQL 宣告都是隻讀的。

修改指標的上報間隔。為了方便演示，我們將指標的上報間隔改為 10 秒。注意較短的上報間隔會造成較高的開銷。我們建議上報間隔至少應設定為 60 秒。

點選 “Submit” 按鈕儲存剛才的改動。

測試

現在傳送請求，看看動態指標是如何運作的。我們可以使用名為 `wrk' 的開源工具在終端快速傳送許多請求。

wrk -d 1s http://test-edge.com/test1
wrk -d 1s http://test-edge.com/test2

等待 15 秒，傳送另一批請求。

檢查剛剛傳送的所有請求。可以看到所有的請求按照 URI 進行了分組，每組的請求數以柱狀圖的形式呈現，並按降序排序。

資料也可以以餅狀圖的形式顯示。

也可以以折線圖的形式顯示。

這跟我們期望的結果是一致的。

可以使用刪除按鈕來刪除現有的指標。

或者跳轉到標準動態指標的列表頁。

點選 “Disable” 按鈕禁用這個指標。

點選 “Confirm” 按鈕確認禁用這個指標。

回到 Dashboard，可以看到這個指標已經不再顯示了。

openresty.org 的標準動態指標

現在來看一下我們一個開源網站的標準動態指標。這些指標是基於該網站的真實流量。

在搜尋框中鍵入 openresty.org。

進入應用程式。

進入動態指標頁面。

如你所見，我們已經啟用了許多標準的動態指標。資料以各種方式顯示，如餅狀圖、柱狀圖和折線圖。

比如這個指標就很有意思。

點選這個按鈕，顯示它的 Metric SQL 語句定義。

該指標顯示了按 URI 分組的流量資料。

透過這樣的資料我們可以看出使用者對哪個 URI 最感興趣。

再看看這個指標。

點選檢視它的 Metric SQL 語句。

它列出了所有請求的客戶端和伺服器城市的名稱、緯度和經度。

你可以在地圖上看到客戶端城市和伺服器城市。會有一條弧線從客戶端連線到伺服器。從地圖上我們可以看到所有請求的地理分佈。

這就是我今天想講的內容。

如果你喜歡這個教程，請訂閱這個部落格網站和我們的 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、LuaJIT、GDB、SystemTap、LLVM、Perl 等，並編寫過 60 多個開源軟體庫。

關注我們

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

翻譯

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