📜 操作日誌（Operation Logs）
操作日誌用於記錄系統中的關鍵操作和介面呼叫，是稽核、排錯和安全合規的重要依據。
一句話理解
誰在什麼時間、在哪個模組、做了什麼事，結果是成功還是失敗，都能在這裡查到。
🔍 日誌列表裡能看到什麼
在操作日誌頁面，可以逐行查看每一條記錄的核心資訊：
操作時間
- 記錄這次操作發生的精確時間
- 點擊時間（有權限時為藍色連結）可以打開詳情抽屜，查看完整請求資訊
操作人
- 執行這次操作的使用者暱稱 / 帳號
- 用於追蹤責任人或協作排查
操作內容
- 以可讀的描述展示本次操作，例如：建立環境、修改分組、授權使用者等
- 支援多語言顯示，便於不同語言團隊使用
所屬模組
- 表示本次操作發生在哪個業務模組，例如：環境管理、分組管理、成員與權限等
- 方便按模組快速篩選問題範圍
狀態
- 成功：綠色標記，顯示「成功」
- 失敗：紅色標記，滑鼠懸停可查看簡要錯誤資訊（
errorMsg）
操作 IP 與地點
- 操作 IP：發起請求的 IP 位址
- 操作地點：基於 IP 解析出的地理位置（國家/地區/城市等）
耗時
- 記錄本次請求從發起到返回的耗時（ms）
- 用顏色表示效能狀況：
- 綠色：< 200ms
- 黃色：200–500ms
- 紅色：> 500ms
瀏覽器與終端系統
- 記錄發起請求時的瀏覽器類型和作業系統
- 有助於排查特定終端環境下的相容性問題
🎯 如何快速篩選需要的日誌
頁面頂部提供了一組篩選條件，用來縮小搜尋範圍：
按操作人搜尋
- 在「搜尋操作人」輸入框中輸入暱稱或使用者名稱
- 按 Enter 或修改內容後自動重新載入列表
按 IP / 地點搜尋
- 在「搜尋操作 IP 或地點」中輸入關鍵字
- 適合排查某個辦公網路、某個地區的集中異常
按模組篩選
- 透過「篩選模組」下拉框選擇指定模組
- 模組選項由後端即時下發，確保與實際業務模組保持一致
按時間範圍篩選
- 預設時間範圍為最近 7 天
- 可透過時間選擇器設定精確的開始和結束時間
- 修改時間範圍後，系統會根據新條件自動重新載入資料
結合底部分頁元件，你可以快速在大量日誌中定位到目標時間段和目標操作。
📂 查看單條操作的詳細資訊
當你需要深入排查某一次操作時，可以點擊「操作時間」連結，打開右側詳情抽屜，查看更完整的請求資訊：
基礎資訊
- 日誌 ID、TraceID
- 操作人、操作時間
- 操作內容、所屬模組
- 操作 IP、操作地點
- 瀏覽器、終端系統
- 狀態（成功/失敗）、耗時
請求資訊
- 請求 URI（介面位址）
- 請求標頭（JSON 格式展示）
- 請求主體（body，已格式化顯示）
回應資訊
- 回應標頭（JSON 格式展示）
- 回應主體（回傳資料或錯誤資訊，已格式化顯示）
詳情抽屜中所有 JSON 內容都經過格式化處理，支援捲動瀏覽，便於複製到其他工具中進一步分析。
TraceID 用途
TraceID 可用於在後端日誌系統或鏈路追蹤平臺中，繼續追蹤同一次請求的完整鏈路，幫助快速定位伺服器端問題。
🧭 常見使用場景
排查某個操作失敗原因
- 先在列表中透過操作人 / 模組 / 時間範圍篩選出目標操作
- 看狀態是否為「失敗」，將滑鼠移到狀態上查看簡要錯誤資訊
- 如需更多資訊，點擊操作時間進入詳情，查看請求參數與回應主體
稽核高風險操作
- 例如分組權限變更、成員停用、帳務相關操作等
- 可按模組篩選相關記錄，並按時間順序審查操作人和操作內容
分析效能瓶頸
- 在列表中關注「耗時」欄位的紅色/黃色標記
- 對耗時較長的操作，進入詳情查看請求路徑和參數，交給技術同仁進一步優化
定位異常來源
- 當發現異常行為（例如頻繁重試、批次刪除失敗）時
- 透過 IP / 地點 + 操作人組合篩查，判斷是否為內部誤操作或外部異常訪問
🔒 安全與合規建議
合理的日誌保留週期
- 建議根據企業內部安全與合規要求設定日誌保留週期（例如 6 個月或 1 年）
- 在保證可追溯性的同時，避免長期堆積占用過多儲存空間
控制訪問權限
- 操作日誌通常只需對管理員、稽核人員開放
- 建議對普通使用者關閉訪問入口，避免洩露過多系統內部資訊
敏感資訊保護
- 在查看請求/回應主體時，注意其中可能包含部分敏感欄位（如帳號、手機號等）
- 建議內部培訓時提醒相關人員遵守資料隱私與合規要求
透過操作日誌，你可以對系統內的重要操作做到「事前可控、事中可查、事後可追」，為日常維運、安全稽核和問題排查提供可靠依據。