稽核日誌
功能概述
稽核日誌（Audit Logs）記錄 Domain（網域）內所有使用者的操作行為。每一筆紀錄包含操作時間、操作者帳號、來源 IP、事件描述與執行結果，構成可追溯的完整軌跡。
此功能的用途在於回答「誰、在什麼時間、從哪裡、做了什麼、成功或失敗」，適用於安全稽核、權限異動追溯，以及設備或帳號行為異常時的問題排查。日誌為系統自動產生，唯讀，無法由使用者新增、修改或刪除。
使用情境與適用對象
- Domain 超級使用者：本頁面僅具備 Domain Superuser 權限的帳號可存取。Subdomain 超級使用者與一般使用者不會在選單中看到此項目，詳見〈Subdomain 的管理〉。
- 安全稽核：定期檢視登入紀錄與帳號安全操作（密碼變更、MFA 重設、帳號解鎖、社群帳號繫結），確認無異常來源 IP 或非預期的權限提升。
- 權限異動追溯：確認某位使用者的資料夾、HMI 或群組權限是何時、由誰調整。
- 問題排查：當設備、授權或儀表板狀態與預期不符時，回查該時段內的相關操作與其結果。
- 技術支援：匯出指定時段的日誌，作為回報問題時的佐證資料。
功能細節說明
進入頁面
於左側選單選擇〔Domain〕>〔活動紀錄〕。進入頁面時會自動以預設條件發出查詢，無須手動觸發。
預設的快速範圍為〔過去 7 天〕，但查詢區間受 3 天上限限制（詳見限制條件與注意事項），因此首次載入實際取得的是最近 3 天的紀錄，並顯示〔時間範圍限制〕提示。
設定查詢時間範圍
畫面右上方的時間範圍選擇器顯示目前使用的範圍名稱與起訖時間，點擊後可切換查詢條件：
- 〔快速範圍〕：〔過去 1 小時〕、〔過去 3 小時〕、〔過去 6 小時〕、〔今天〕、〔過去 7 天〕、〔過去 30 天〕。選定後立即以該範圍重新查詢。
- 〔自訂時間範圍〕：分別填入〔從〕與〔到〕的日期與時間，按〔套用〕送出查詢；〔清除〕會將範圍重設為最近 3 天，〔取消〕則關閉選擇器且不變更條件。
- 重新整理：選擇器右側的重新整理按鈕，以目前條件重新取得資料。查詢結果不會自動更新，需以此按鈕或重新套用範圍才會取得新產生的紀錄。
查詢範圍下方的資訊標籤依序顯示目前查詢區間、結果總筆數，以及目前頁面所顯示的區段。
日誌欄位說明
| 欄位 | 說明 |
|---|---|
| 〔建立時間〕 | 事件產生的時間，格式為 YYYY-MM-DD HH:mm:ss |
| 〔使用者 / IP〕 | 執行該操作的帳號名稱，以及發出請求的來源 IP |
| 〔訊息〕 | 事件描述，由系統的訊息範本代入實際值產生，完整清單見記錄的事件一覽 |
| 〔結果〕 | 該次操作的 HTTP 狀態碼，判讀方式見下節 |
| 最右側的複製按鈕 | 將該筆紀錄的訊息代碼（如 log_10001）複製到剪貼簿 |
〔建立時間〕、〔使用者 / IP〕與〔結果〕三欄的欄寬可拖曳標題右緣調整；〔訊息〕欄為彈性寬度，內容過長時以省略號截斷。
判讀〔結果〕欄
〔結果〕欄顯示該次操作的 HTTP 狀態碼：
- 綠色標籤：狀態碼為
2開頭（如200），代表操作成功。 - 紅色標籤：其餘狀態碼，代表操作失敗。狀態碼本身可用於判斷失敗性質，例如權限不足或請求內容有誤。
失敗的操作同樣會留下紀錄，因此登入失敗、權限不足的存取嘗試皆可在此追溯。
分頁瀏覽
查詢結果會一次載入後於前端分頁，因此切換頁次不會重新查詢。頁面底部可設定每頁顯示 10、20、50 或 100 筆（預設 20 筆），並以左右箭頭切換頁次。
匯出 CSV
按畫面右上方的〔匯出〕可將查詢結果下載為 CSV 檔：
- 匯出內容為當次查詢的全部紀錄，而非僅目前頁面所顯示的部分。
- 欄位依序為建立時間、Username、IP、訊息、結果。
- 檔名格式為
audit-logs_{開始日期}_{結束日期}.csv。 - 檔案以 UTF-8（含 BOM）編碼，可直接以 Excel 開啟而不會出現亂碼。
- 查詢結果為空時，〔匯出〕按鈕為停用狀態。
記錄的事件一覽
下列為系統目前會記錄的事件。訊息中以大括號標示的部分（如 {username}）為實際值的代入位置，顯示時會替換為對應的帳號、資料夾路徑或設備 hardware key 等資訊。訊息代碼即複製按鈕所取得的識別字串，可於回報問題時用以精確指出事件類型。
登入與帳號安全
| 訊息代碼 | 訊息範本 |
|---|---|
log_10001 | 使用者 {username} 已登入 |
log_err01_10001 | 未知使用者登入失敗 |
log_err02_10001 | 使用者 {username} 登入失敗 |
log_10069 | 使用者 {username} 社群登入成功 |
log_10070 | 管理員解除使用者 {username} 的社群帳號繫結 |
log_10071 | 使用者自行解除 {username} 的社群帳號繫結 |
log_10003 | 已驗證使用者 {username} 的新電子郵件 |
log_10004 | 已為使用者 {username} 申請重設密碼信件 |
log_10005 | 已變更使用者 {username} 的密碼（透過重設密碼信件） |
log_10008 | 已申請變更電子郵件 |
log_10009 | 已變更密碼 |
log_10077 | 管理員已解鎖使用者 |
log_10078 | 管理員已重設使用者 {username} 的 MFA |
log_10079 | 已送出刪除帳號申請 |
log_10080 | 已取消我的帳號刪除申請 |
使用者管理
| 訊息代碼 | 訊息範本 |
|---|---|
log_10016 | 已建立使用者 |
log_10017 | 已啟用使用者 |
log_10019 | 已刪除使用者 |
log_10010 | 已變更使用者 {username} 的電子郵件與公司名稱 |
log_10020 | 已將使用者 {username} 的公司名稱從 {old_company_name} 更新為 |
log_10021 | 已更新使用者 {username} 的密碼 |
log_10015 | 已將使用者語言從 {old_lang} 更新為 |
log_10081 | 已更新使用者 {username} 的地圖設定 |
log_10084 | 已為使用者 {username} 建立 API 金鑰，名稱為 |
log_10085 | 已為使用者 {username} 移除 API 金鑰，名稱為 |
群組與權限
| 訊息代碼 | 訊息範本 |
|---|---|
log_10007 | 已將使用者 {usernames} 加入群組 |
log_10072 | 已更新使用者 {username} 在群組 {group_name} 的權限 |
log_10023 | 已從 HMI 群組 {group_name} 刪除使用者 |
log_10006 | 已將使用者 {usernames} 加入 HMI |
log_10039 | 已授予使用者 {usernames} 對 HMI {hw_key} 的權限 |
log_10041 | 已更新使用者 {username} 對 HMI {hw_key} 的權限 |
log_10042 | 已刪除使用者 {username} 對 HMI {hw_key} 的權限 |
log_10018 | 已將使用者 {usernames} 加入資料夾 |
log_10068 | 已為資料夾 {folder_path} 新增使用者 {username} 權限 |
資料夾（Directory）
| 訊息代碼 | 訊息範本 |
|---|---|
log_10013 | 已建立資料夾 |
log_10011 | 已將資料夾 {old_folder_name} 重新命名為 |
log_10045 | 已刪除資料夾 |
log_10012 | 已將資源移至 {parent_folder_name}，資料夾 {resource_folder_names}，HMI |
HMI 群組
| 訊息代碼 | 訊息範本 |
|---|---|
log_10024 | 已建立 HMI 群組 |
log_10025 | 已將 HMI 群組 {old_group_name} 重新命名為 |
log_10026 | 已刪除 HMI 群組 |
log_10014 | 已將 HMIs {hmis} 加入 HMI 群組 |
log_10030 | 已將 HMIs {hw_keys} 從 HMI 群組 {group_name} 移除 |
HMI 設備與 Domain 異動
| 訊息代碼 | 訊息範本 |
|---|---|
log_10036 | 已將 HMI {hw_key} 加入此 Domain |
log_10035 | 已將 HMI {hw_key} 從此 Domain 移除 |
log_10051 | 已使用 session ID／密碼新增 HMI |
log_10040 | 已更新 HMI {hw_key} 資訊 |
log_10098 | 已更新 HMI {hw_key} 位置 |
log_10082 | 已將 HMI {hw_key} 加入地圖最愛 |
log_10083 | 已將 HMI {hw_key} 自地圖最愛移除 |
log_10037 | 已申請將 HMI {hw_key} 轉移至 Domain |
log_10038 | 已將 HMI {hw_key} 從 {source_domain_name} 轉移至 {target_domain_name} 的狀態設為 |
log_10044 | 已取消 HMI {hw_key} 的轉移申請 |
EasyAccess 2.0
| 訊息代碼 | 訊息範本 |
|---|---|
log_10046 | 已為新 HMI {hw_key} 開始 EasyAccess 2.0 試用 |
log_10049 | 已為 HMI {hw_key} 開始 EasyAccess 2.0 試用 |
log_10047 | 已使用卡片 {activation_code} 為新 HMI {hw_key} 啟用 EasyAccess 2.0 |
log_10050 | 已使用卡片 {activation_code} 為 HMI {hw_key} 啟用 EasyAccess 2.0 |
log_10048 | 已停用 HMI {hw_key} 的 EasyAccess 2.0 |
Dashboard 與儀表板訂閱
| 訊息代碼 | 訊息範本 |
|---|---|
log_10061 | HMI {hw_key} 已啟用儀表板 |
log_10062 | 既有 HMI {hw_key} 已啟用儀表板 |
log_10063 | HMI {hw_key} 的儀表板為試用狀態 |
log_10064 | 既有 HMI {hw_key} 的儀表板為試用狀態 |
log_10065 | HMI {hw_key} 的儀表板已停用 |
log_10032 | 已為新 HMI {hw_key} 開始儀表板試用 |
log_10034 | 已為 HMI ({hw_key}) 開始儀表板試用 |
log_10043 | 已將 HMI {hw_key} 的儀表板狀態從 {old_state} 變更為 |
log_10066 | 已新增 HMI {hw_key} 的儀表板 Tag 擴充卡 |
log_10028 | 已為 HMI {hw_key} 新增儀表板，套用既有的儀表板訂閱，名稱為 |
log_10029 | 已為新 HMI {hw_key} 啟用儀表板，套用既有的儀表板訂閱，名稱為 |
log_10031 | 已使用卡片 {activation_code} 為新 HMI {hw_key} 啟用儀表板，儀表板訂閱名稱為 |
log_10033 | 已使用卡片 {activation_code} 為 HMI {hw_key} 新增儀表板訂閱卡，儀表板訂閱名稱為 |
log_10056 | 已使用卡片 {activation_code} 建立名稱為 {dashboard_subscription_name} 的儀表板訂閱 |
log_10057 | 已使用卡片 {activation_code} 新增至名稱為 {dashboard_subscription_name} 的儀表板訂閱 |
log_10058 | 已更新名稱為 {dashboard_subscription_name} 的儀表板訂閱中的 HMI，新 HMI 為 |
log_10059 | 已將儀表板訂閱名稱從 {old_dashboard_subscription_name} 更新為 |
log_10060 | HMIs {hw_keys} 的儀表板訂閱狀態已從 {old_state} 變更為 |
log_10055 | 已刪除名稱為 {dashboard_subscription_name} 的儀表板訂閱 |
log_10090 | 已建立儀表板 |
log_10091 | 已發布儀表板 |
log_10092 | 已更新儀表板 {name} 資訊 |
log_10094 | 已更新儀表板 {name} 權限 |
log_10095 | 已移除儀表板 {name} 的發布模式 |
log_10093 | 已刪除儀表板 |
警報
| 訊息代碼 | 訊息範本 |
|---|---|
log_10105 | 已建立警報規則 |
log_10107 | 已更新警報規則 |
log_10106 | 已刪除警報規則 |
log_10108 | 已建立警報分類 |
log_10109 | 已更新警報分類 |
log_10110 | 已刪除警報分類 |
log_10096 | 已在儀表板 {dashboard_name} 上確認警報 |
log_10097 | 已在管理介面上確認警報 |
log_10067 | 已刪除 HMI {hw_key} 的警報歷史紀錄 |
資料來源與備份
| 訊息代碼 | 訊息範本 |
|---|---|
log_10100 | 已更新或建立資料來源 |
log_10101 | 已更新資料來源中繼資料 |
log_10099 | 已備份資料來源 |
log_10102 | 已備份趨勢資料 |
log_10103 | 已備份歷史資料表 |
log_10104 | 已檢查儀表板專案資料來源 |
相簿
| 訊息代碼 | 訊息範本 |
|---|---|
log_10086 | 已上傳相簿中的新檔案 |
log_10088 | 已更新相簿中的檔案 |
log_10089 | 已從相簿複製檔案 |
log_10087 | 已刪除相簿中的檔案 |
Domain 與系統設定
| 訊息代碼 | 訊息範本 |
|---|---|
log_10002 | 已建立 Domain |
log_10111 | 已更新 Domain 名稱 |
log_10073 | 已更新 Domain 安全性設定 |
log_10074 | 已更新自訂 Domain 設定 |
log_10075 | 已更新使用者安全性設定 |
log_10076 | 已更新 MFA 設定 |
log_10052 | 已更新活動報告設定 |
log_10053 | 已更新多使用者連線設定 |
log_10054 | 已更新專案名稱更新設定 |
限制條件與注意事項
- 可查詢的資料最早為 180 天前：系統僅提供最近 180 天內的活動紀錄，超過 180 天的資料無法查詢。
- 單次查詢的時間範圍上限為 3 天：若指定的區間超過 3 天，系統會自動將開始時間調整為「結束時間往前推 3 天」，並顯示〔時間範圍限制〕提示。需要查詢更長的期間時，請分段查詢並分別匯出。
- 〔過去 7 天〕與〔過去 30 天〕同樣受 3 天上限限制：選擇這兩個快速範圍後，實際取得的仍是結束時間往前 3 天內的紀錄。
- 開始時間必須早於結束時間：否則不會送出查詢，並顯示提示訊息。
- 僅 Domain 超級使用者可存取：需具備 Domain Superuser 權限，其他權限的帳號不會在選單中看到〔活動紀錄〕。
- 日誌為唯讀：無法新增、修改或刪除任何紀錄。
- 查詢結果不會自動更新：需按重新整理按鈕或重新套用時間範圍。
- 登入相關事件可能顯示為
anonymous：登入事件在身分驗證完成前產生，〔使用者〕欄可能顯示anonymous，實際帳號與瀏覽器資訊記錄於〔訊息〕欄中。 - 匯出範圍為當次查詢的全部紀錄：不受目前頁次與每頁筆數影響。
常見問題
Q：為什麼選了〔過去 7 天〕，查到的卻只有最近 3 天的紀錄？ A：單次查詢的時間範圍上限為 3 天。選擇超過 3 天的範圍時，系統會自動將開始時間調整為結束時間往前 3 天，並顯示〔時間範圍限制〕提示。需要更長期間的資料時，請分段查詢。
Q：〔結果〕欄顯示 200 代表什麼？ A：該欄顯示操作的 HTTP 狀態碼。2 開頭（如 200）為綠色標籤，代表操作成功；其餘狀態碼為紅色標籤，代表操作失敗。
Q：匯出的 CSV 只包含目前頁面的資料嗎？ A：不會。匯出的是當次查詢的全部紀錄，與目前頁次及每頁筆數設定無關。
Q：為什麼有些紀錄的〔使用者〕欄顯示 anonymous？ A：登入相關事件是在身分驗證完成之前產生的，此時尚無對應帳號，因此該欄顯示 anonymous；嘗試登入的帳號名稱與瀏覽器資訊會記錄在〔訊息〕欄中。
Q：複製按鈕複製的是什麼內容？ A：該筆紀錄的訊息代碼（例如 log_10001），可在回報問題時用以精確指出事件類型。
Q：登入失敗或權限不足的操作會被記錄嗎？ A：會。失敗的操作同樣會留下紀錄，並在〔結果〕欄以紅色標籤顯示對應的 HTTP 狀態碼。