儀表板概覽指南
引導您如何使用登入 GIIP 平台後顯示的整體基礎設施狀態儀表板。
📋 概述
儀表板是一個整合監控介面，讓您能夠一目了然地掌握分佈在全週的基礎設施狀態。它通過可視化即時指標和費用數據，輔助您做出快速決策。
🧭 頁面結構 — 三層佈局 (giip #2443/#2444/#2445/#2446)
儀表板頂部只先回答兩個問題:「我現在必須決策什麼」與「所有專案進展如何」,其餘明細一律下移。目的是即使專案很多,概覽仍能裝進一個手機螢幕。
① 需要我決策的事項
最多顯示 5 筆「沒有人工判斷就無法推進」的議題。
- 範圍:僅限狀態為
NEEDS_DECISION或WARN的議題。 - REVIEW 滯留、閘門回退、60 分鐘無活動等由機器人每小時自動重新判定,因此不會出現在這裡(屬於第 ③ 層)。
- 沒有待確認事項時,顯示「暫無需要確認的事項」一行,而非空卡片。
- 超過 5 筆時顯示前 5 筆並附「還有 N 項」連結,跳轉到以
NEEDS_DECISION篩選的議題清單。 - 點擊每一列進入該議題詳情。
- 本層的數量本身就是自動化品質指標,自動化運作越好,數字越小。
② 專案狀態
對有存取權限的專案每個顯示一列。
| 項目 | 意義 |
|---|---|
| 進行中 | IN_PROGRESS 數量 |
| 等待中 | READY + PENDING 數量 |
| 受阻 | NEEDS_DECISION + WARN + 超過 60 分鐘無留言的 IN_PROGRESS + 閘門 3 次升級 |
- 號誌:受阻 ≥ 1 為 🔴;受阻為 0 且進行中+等待中 ≥ 1 為 🟢;全為 0 為 ⚪(以「—」代替數字)。
- ⚠️ 第 ② 層的**「受阻」比第 ① 層更廣**。第 ① 層是「需要人來決策的」,第 ② 層的受阻是「專案健康度」。
- 同一議題命中多個條件時只計一次(不重複統計)。
- 進行中但停滯超過 60 分鐘的議題會同時出現在進行中與受阻中 — 這是刻意設計,以便在一列內看出「在跑但卡住了」。
- 點擊某列即選取該專案,再次點擊取消選取。此選取僅在本儀表板畫面內生效(第 ③ 層隨後只顯示該專案)。
- 列右側的**「進入 →」按鈕則不同。點擊後會像頂部的專案選擇一樣切換登入工作階段所屬的專案**,頁面隨之重新載入,整個應用(伺服器清單、議題、KVS 等)都會切換到該專案。
- 螢幕較窄時文字會隱藏,只顯示 → 箭頭,功能相同。
- 在目前已進入的專案上,該按鈕會變成灰色的 ✓ 且無法點擊 — 因為點擊也只會重新載入頁面。
- 簡而言之:點擊列 = 只在本畫面內縮小範圍,「進入」= 真正切換到該專案。
- 已完成(
DONE)的議題不計入任何統計。
③ 受阻議題
把「議題卡在某處」的所有情形集中到同一個區塊。預設為摺疊（行動裝置上一律摺疊），標題旁的數量徽章讓您不展開也能知道有多少筆。
- 同一個議題只佔一列。以前拆成 5 個小工具，同一個議題會重複出現（實測：議題 #2148 同時出現在 3 個小工具中）。
- 取而代之的是把受阻原因並列為徽章。有兩個原因就會顯示兩個徽章。
| 徽章 | 含義 |
|---|---|
| 疑似偽造完成 | 狀態為 WARN — 完成判定被反覆推翻 |
| 等待使用者決策 | 狀態為 NEEDS_DECISION |
| 關卡已達 3 次 | 自動退回達到 3 次上限，需要人工確認 |
| 關卡退回 | 已退回 1 次以上，但尚未達到上限 |
| REVIEW 停滯 / PENDING 停滯 | 該狀態下 7 天以上無活動（括號內為天數） |
| 無 PR | 處於 REVIEW 但任何儲存庫中都沒有對應的 PR |
| 無活動 | IN_PROGRESS 但 60 分鐘以上沒有留言（括號內為分鐘數） |
- 徽章分三種顏色 — 紅色表示必須由人處理，黃色表示自動化正在重試或已停滯，灰色為輔助資訊。
- 在第 ② 層選擇專案後，此清單只顯示該專案。再次點擊同一列即可恢復全部。
- 已完成（
DONE）的議題不會出現。 - 先顯示前 20 筆，點擊「再顯示 N 筆」展開其餘（不是丟棄資料，只是摺疊顯示）。
③ 詳細 — 其餘區塊
在受阻議題下方，錯誤、基礎設施與參考統計區塊也全部採用摺疊式。 它們遵循同樣的規則（數量徽章／0 筆時置灰並下沉／記憶展開狀態）。
| 區塊 | 標題徽章統計的內容 | 初始狀態 | 內容 |
|---|---|---|---|
| 受阻議題 | 卡住的議題數 | 僅桌面端展開 | 參見上文 ③ |
| SES提案 | 待操作(pending+failed+analyzing)筆數 | 僅uLevel≥70顯示 | csn=0公開提案的狀態別摘要＋前3筆操作連結 |
| 未解決的議題 | 未完成議題的總數 | 一律摺疊 | 進行中／等待中的議題清單（每頁 25・50・100 筆） |
| 錯誤日誌 | 未解決的錯誤數 | 摺疊 | 總計／已解決／未解決／最近 四張卡片 + 依來源與嚴重度的分布 |
| 建議操作 | 建議筆數 | 摺疊 | 逐筆檢視並刪除長期未巡檢的伺服器 |
| 伺服器狀態統計 | 異常伺服器數 | 摺疊 | 專案／伺服器數 + 正常·異常環圈圖 + 異常伺服器清單 |
| 網域到期日 | 30 天內到期的網域數 | 摺疊 | 依到期時間由近至遠排序（已到期的筆數另有徽章） |
| 專案 & 伺服器 | 專案數 | 摺疊 | 每個專案的伺服器數／正常／異常（異常多的排在前） |
| KVS 活動摘要 | 有活動的 Factor 種類數 | 摺疊 | 最近 24 小時的收集情況 |
- 未解決的議題為何預設摺疊：它是儀表板上最長的清單，展開後會把下方所有區塊擠出畫面。即使摺疊，標題旁的數字就是總筆數，不展開也能知道有多少筆。
- 標題徽章不是「目前畫面上顯示的列數」，而是**「值得展開檢視的數量」**。例如錯誤日誌顯示的是未解決數而非錯誤總數，伺服器狀態顯示的是異常數而非伺服器總數。
- 查詢失敗時徽章顯示
…而不是 0 — 寫成 0 會發出「沒有問題」的錯誤訊號。 - 錯誤日誌區塊僅對
uLevel70 以上的帳號顯示。
摺疊 / 展開
- 各區塊標題旁的數量徽章在摺疊後依然可見 — 摺疊不會讓你失去資訊。
- 0 筆的區塊不隱藏，而是置灰並移到清單最下方，讓有內容的區塊始終排在上面。
- 首次開啟時：在行動裝置（視窗寬度小於 768px）第 ③ 層全部摺疊，因此第 ①② 層能落在首屏內。桌面端只展開第 ③ 層的第一個區塊（「受阻議題」）。
- 摺疊狀態依瀏覽器分別記憶，且只要您親自摺疊或展開過一次，您的選擇就優先於上述預設值。
- 在無痕視窗等儲存被阻擋的環境中頁面依然正常，只是不再記憶狀態。
- 摺疊內容會從頁面移除，展開時再載入(減輕行動裝置首次渲染負擔)。
🔍 核心組件說明
1. 即時資產狀態 (Asset Status)
以卡片形式顯示目前管理的伺服器和資料庫總數及狀態（Running、Stopped、Warning）。點擊卡片可跳轉至相應的列表頁面。
2. 全球基礎設施地圖 (Infrastructure Map)
在地圖上顯示伺服器所在的物理區域。如果特定區域的叢集發生故障，地圖上的圖標將閃爍紅色。
3. 多雲費用摘要
以圓餅圖 (Pie Chart) 形式顯示已連接雲帳號（如 Azure、AWS）本月的累計預計費用佔比。您可以查看較上月的增減趨勢。
4. 最新問題與警報
列出最近發生的嚴重 (Critical) 和警告 (Warning) 級別的問題。點擊問題可立即跳轉至詳細的原因分析頁面 Thread。
🛠️ 使用技巧
- 過濾: 通過儀表板頂部的 [選擇專案] 過濾器，您可以集中監控特定專案的數據。
- 重新整理: 儀表板數據每分鐘自動更新一次。如需手動重新整理，請點擊右上角的 [重新整理] 圖標。
💡 注意事項
- If specific metric displays as
Unknown, please check [Agent Status] of corresponding server first.
API 參考
有關此功能的 API 詳細規範，請參閱專用指南。
疑難排解
| 症狀 | 原因 | 解決 |
|---|---|---|
指標顯示為 Unknown | 對應伺服器的代理未回應 | 檢查伺服器的 [代理狀態] 並重新啟動代理。 |
| 儀表板數據不重新整理 | 自動重新整理（1分鐘週期）延遲或工作階段已過期 | 點擊右上角的 [重新整理] 圖標，或重新登入。 |
| 費用摘要為空 | 未連接雲帳號（Azure、AWS） | 檢查雲帳號整合設定。 |
| 僅顯示特定專案的數據 | 頂部的 [選擇專案] 過濾器已套用 | 將過濾器變更為全部，以顯示所有數據。 |
版本: 1.2
最後更新: 2026-09-15
源文件: giipv3/public/help/dashboard.zh-TW.md