3D Network Topology Guide
Learn how to manage the connection status and data flow of your entire infrastructure in 3D through GIIP's 3D visualization engine.
📋 Overview
3D Network Topology moves beyond text-centric infrastructure management by implementing physical/logical connection relationships between actual servers in a 3D space. This allows you to intuitively understand complex network structures and quickly identify failover points.
🎮 Key Operations & Features
1. 3D Space Control
- Rotate/Move/Zoom: Use the left mouse button (rotate), right mouse button (move), and scroll wheel (zoom in/out) to navigate the infrastructure map freely.
- Select Node: Click on an individual server (node) to view its specs, current load, and connected adjacent node information.
2. Real-time Traffic Visualization
Precisely shows the direction and volume of packets flowing between servers using moving particles.
- Color Meanings: Normal (Green), High Load (Yellow), Connection Failure/Threat (Red).
3. Time Travel
Drag the timeline bar at the bottom to review the network state at a specific point in the past. This is useful for identifying root causes by analyzing connection status at the time a failure occurred.
🔍 Advanced Search & Filtering
- Node Search: Enter a specific IP or hostname to instantly track the location of that server among thousands of nodes.
- Group View: Apply filters by Datacenter, Project, or Service Group to focus monitoring on specific areas.
💡 Tips
- Security Threat Detection: Perform an immediate security check if abnormal external connection nodes are created or if traffic spikes toward a specific node.
- Architecture Design Verification: Visually verify whether the deployed system matches the intended network topology design.
API Reference
For detailed API specifications of this feature, refer to the separate guide.
Troubleshooting
| Symptom | Cause | Solution |
|---|---|---|
| The 3D map does not render and only a blank screen appears | WebGL (hardware acceleration) is disabled or unsupported in the browser | Use a WebGL-capable browser, enable hardware acceleration, and refresh. |
| Node search cannot find a specific server | The IP/hostname is wrong or the node is hidden by a group filter | Verify the entered IP or hostname, clear the Datacenter/Group filter, and search again. |
| Traffic particles do not move or show no color | Real-time traffic data for the node has not been collected yet | Confirm the agent is collecting data and wait until data arrives. |
| Time Travel shows no state for a past point | No historical data was collected for the selected period | Drag the timeline bar to a period that has collected data. |
Version: 1.0
Last Updated: 2026-03-19
Source: giipv3/public/help/sql3d.en.md