查詢應用訪問日誌

配置 ClickHouse 訪問日誌伺服器,並在 Edge Admin 中篩選和匯出應用訪問日誌。

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 地址、請求頭和業務標識等敏感資訊。應限制查詢和匯出許可權, 並按照組織的日誌保留策略處理匯出檔案。