網路拓撲指南

介紹如何使用網路拓撲（Net3D）介面，它將您的伺服器、資料庫以及它們之間的連線以3D空間的形式視覺化。

🚀 前往網路拓撲頁面 →

📋 概述

網路拓撲將目前專案（CSN）下的伺服器與資料庫以3D圖形呈現。節點之間的連線代表實際的SQL通訊，其顏色與粒子流動速度會依負載狀態即時變化。資料會依已登入工作階段的CSN載入。

🔍 介面配置

1. 節點（Nodes）

• 伺服器顯示為球體（sphere），資料庫顯示為圓柱體（cylinder）。
• 節點顏色代表狀態：正常為藍色/綠色；負載超過閾值時為紅色；作用中查詢超過閾值時為紅色系；存在開啟中的交易（Open Transaction）時為橘色。
• 若節點被直接指定了自訂顏色，則優先套用該顏色。

2. 連線（Links）

連接節點的線是SQL通訊路徑。它會依CPU負載從綠色 → 黃色 → 橘色 → 紅色變化，最近有SQL活動的連線上方向性粒子流動更快。

3. 節點詳情氣泡（Node Bubble）

點擊節點後，鏡頭會移動至該節點並彈出詳情氣泡。伺服器顯示主機詳情與IP清單，資料庫顯示DB詳情。您可以在氣泡中儲存自訂顏色與備註，或透過**修改（Modify）**按鈕開啟伺服器/資料庫的詳情編輯視窗。

4. 搜尋與自動重新整理

在介面的搜尋框中依名稱尋找節點並立即聚焦。開啟自動重新整理開關後，資料會定期重新整理。

5. Known Nodes（外部節點管理）

將未註冊的外部節點作為Known Nodes進行管理。在清單視窗中可以刪除節點或解除其IP位址的關聯。

6. 時間軸與時光旅行（History 模式）

在介面底部的時間軸上選擇過去的某個時間點，即可回溯到該時刻的拓撲狀態（History 模式）。啟用時，右下角會顯示HISTORY MODE及目標時間。

7. 設定（閾值）

在設定視窗中調整節點/連線負載警告閾值與作用中查詢危險閾值等，顏色標準會立即重新計算並反映到圖形中。

🛠️ 使用技巧

• 右下角顯示目前正在顯示的節點數與連線數。
• 如果沒有任何節點或資料，會出現**[註冊機器]或[註冊資料庫]**的引導畫面，點擊後將跳轉至對應的註冊頁面。
• 當節點與連線總數較多（約超過700）時，為提升效能會自動減少粒子效果。

💡 注意事項

• 本頁面需要登入，並依工作階段的CSN顯示資料。
• 若自訂顏色或備註儲存失敗，錯誤會記錄在瀏覽器主控台中。

疑難排解

症狀	原因	解決方法
未顯示節點，只顯示註冊引導	目前CSN下沒有已註冊的伺服器/資料庫	點擊[註冊機器]或[註冊資料庫]先註冊資產。
停在「Loading Universe...」	資料載入延遲或工作階段過期	開啟自動重新整理或重新整理頁面，必要時重新登入。
顯示 Error 訊息	資料查詢API呼叫失敗	稍後重試；若反覆出現，請檢查CSN與網路狀態。
自訂顏色/備註無法儲存	儲存API回應並非成功（200）	檢查瀏覽器主控台的錯誤並重試。
節點顏色與預期不符	由負載/作用中查詢閾值設定導致	在設定視窗中調整閾值。

---

版本: 1.0 最後更新: 2026-07-22 原始檔: giipv3/public/help/network-topology.zh-TW.md