网络拓扑指南

介绍如何使用网络拓扑（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-CN.md