查詢應用訪問日誌
Edge Admin 可以從 ClickHouse 日誌伺服器查詢應用訪問日誌,並按應用、時間和欄位 篩選結果。
此功能在 OpenResty Edge 26.12.1-1 中首次引入。
安裝 ClickHouse 和 Vector
查詢前,請先按照 使用 Vector 和 ClickHouse 採集 OpenResty Edge 日誌 安裝和配置採集服務。ClickHouse 部署在獨立的資料庫伺服器上,用於集中儲存日誌; Vector 部署在每個需要採集日誌的閘道器節點上,將本地日誌傳送到 ClickHouse。
該文件包含部署包下載、ClickHouse 和 Vector 安裝、HTTPS 配置、日誌讀取許可權及
採集驗證步驟。請使用版本匹配的部署包,並按文件配置包含 app_id 的 JSON
訪問日誌格式。確認日誌已經寫入 ClickHouse 後,再配置下述訪問日誌查詢連線。
配置訪問日誌伺服器
開啟 全域性配置 > 訪問日誌伺服器配置,開啟配置並填寫以下內容:
- ClickHouse 服務端點和資料庫名。預設資料庫名為
app。 - 查詢使用者名稱和密碼。預設使用者名稱為
oredge-reader。密碼不會回顯;編輯配置時 將密碼留空會保留原密碼。 - 是否驗證 TLS 證書,以及查詢超時時間。
儲存後,請確認 Edge Admin 能夠連線 ClickHouse,並且查詢賬號只能訪問所需的 日誌表。
查詢日誌
開啟目標應用的 訪問日誌 頁面。支援 HTTP、TCP、UDP、SSL、MQTT、MQTTS、 正向代理和 SOCKS5 應用。選擇時間範圍後執行查詢;單次查詢最多覆蓋 31 天。
可用列和篩選欄位由日誌表後設資料決定。一次查詢最多新增 32 個篩選條件,所有條件 之間使用 AND 關係:
- 文本欄位支援精確匹配和
*萬用字元;請求內容篩選使用不區分大小寫的包含匹配。 - 數值欄位支援
=、>、>=、<和<=,同一個數值欄位可以新增多個條件。
表格支援每頁 20、50 或 100 條記錄。Edge Admin 會隱藏內部列和原始資料來源列, 並自動使用當前應用 ID 限定查詢範圍。
匯出結果
點選 匯出 可以下載與當前應用、時間範圍和篩選條件相同的結果。匯出檔案為 Gzip 壓縮的 JSON Lines;每一行是一條 JSON 日誌記錄。
訪問日誌可能包含 IP 地址、請求頭和業務標識等敏感資訊。應限制查詢和匯出許可權, 並按照組織的日誌保留策略處理匯出檔案。