3D 网络拓扑指南
引导您如何通过 GIIP 的 3D 可视化引擎，立体地管理整个基础设施的连接状态和数据流。
📋 概述
3D 网络拓扑超越了以文本为中心的基础设施管理方式，在三维空间中实现了实际服务器之间的物理/逻辑连接关系。通过它，您可以直观地掌握复杂的网络结构，并快速识别故障点。
🎮 核心操作与功能
1. 3D 空间控制
- 旋转/移动/缩放: 使用鼠标左键（旋转）、右键（移动）和滚轮（放大/缩小）自由探索基础设施地图。
- 选择节点: 点击单台服务器（节点），即可查看该服务器的规格、当前负载及已连接的相邻节点信息。
2. 实时流量可视化
通过移动的粒子 (Particle) 精确显示服务器之间流动的动态数据包的方向和量。
- 颜色含义: 正常 (绿色)、高负载 (黄色)、连接故障/威胁 (红色)。
3. 时间旅行 (Time Travel)
拖动底部的等时间线工具栏，可以复原过去特定时间点的网络状态。这对于分析故障发生时的连接状态并查明根本原因非常有用。
🔍 高级搜索与过滤
- 节点搜索: 输入特定 IP 或主机名，在数千个节点中即时追踪该服务器的位置。
- 按组查看: 按数据中心、项目或服务组应用过滤器，集中监控感兴趣的区域。
💡 使用技巧
- 安全威胁检测: 如果生成了异于平时的外部连接节点，或流量集中流向特定节点，请立即执行安全检查。
- 架构设计验证: 您可以视觉上验证系统部署后是否与设计的网络拓扑一致。
API 参考
有关此功能的 API 详细规范，请参阅单独的指南。
故障排除
| 症状 | 原因 | 解决方法 |
|---|---|---|
| 3D 地图无法渲染，仅显示空白画面 | 浏览器中的 WebGL（硬件加速）被禁用或不受支持 | 使用支持 WebGL 的浏览器，启用硬件加速后刷新页面。 |
| 节点搜索找不到特定服务器 | IP/主机名有误，或节点被分组过滤器隐藏 | 确认输入的 IP 或主机名，清除数据中心/分组过滤器后重新搜索。 |
| 流量粒子不移动或不显示颜色 | 该节点的实时流量数据尚未采集 | 确认代理正在采集数据，并等待数据到达。 |
| 时间旅行中看不到过去时间点的状态 | 所选时间段没有采集到历史数据 | 将时间线工具栏拖动到已采集数据的时间段进行查询。 |
版本: 1.0 最后更新: 2026-03-19 源文件:
giipv3/public/help/sql3d.zh-CN.md