You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+40-23Lines changed: 40 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,25 +1,38 @@
1
1
# Topolograph
2
-
Topolograph.com is a Web Python-based tool, which is aimed at visualizing OSPF/ISIS topology and working with the OSPF/ISIS network offline! No any logins and passwords!
3
-
The Topolograph visualizes OSPF/ISIS network topology based on LinkState DataBase scrapped from a single network device ( thanks OSPF/ISIS =). You can upload a txt file or boot up docker's version of Topolograph on your PC and the Topolograph takes OSPF via NAPALM's methods by itself. Then you can build the shortest path from a source to a destination, get backup paths, emulate link outage along the path or change OSPF/ISIS link cost on the fly! Additionally, you can simulate a device outage and see appropriate network reaction. Build reports about the network.
4
-
Once you upload your OSPF/ISIS to Topolograph - you save the state of your network. After any changes on a network (i.e. redistribution from BGP to OSPF via route-maps with prefix-lists) - upload the network once again and compare them between each other.
* Do not require any logins and passwords - accept LSDB from txt file or via Rest API
13
-
* Docker version is available. Launch local copy of Topolograph site on your PC
14
-
* Once you get your network graph - build the shortests paths
15
-
* Simulate a link outage and discover backup paths or backup of backup paths...
16
-
* Simulate a router shutdown. Look at traffic flow around the failed router
17
-
* Find the most loaded nodes and edges, fault tolerant nodes.
18
-
* Check network reaction to IGP cost change on a link
19
-
* Compare the network state at different times
20
-
* Discover backuped/not-backuped networks in Analytics/Network heatmap
21
-
* Discover asymmetric paths
22
-
* Build arbitrary topologies based on YAML. Yaml file topology visualization.
2
+
3
+
Topolograph is a web-based Python tool designed to visualize OSPF and IS-IS network topologies and analyze them offline — with no logins or passwords required.
4
+
5
+
Topolograph builds OSPF/IS-IS network topology based on Link-State Database (LSDB) data collected from a single network device (thanks to the distributed nature of OSPF and IS-IS 🙂).
6
+
You can upload LSDB output as a text file, or establish a GRE or BGP-LS session using OSPF Watcher or IS-IS Watcher, and visualize the topology in a local, Dockerized Topolograph UI.
7
+
8
+
Once uploaded, the topology represents a snapshot of your network state.
9
+
After making changes — for example, redistributing routes from BGP into OSPF using route-maps and prefix-lists — you can upload the updated topology and compare it with the previous one to clearly see what has changed.
@@ -60,10 +73,13 @@ LSA 1 and LSA 2 is mandatory and have to exist in the same file. LSA 5 is option
60
73
| Huawei | display isis lsdb verbose | YES, but need tested LSDB for checking it | No, (need tested LSDB for adding it) |
61
74
| ZTE | show isis database verbose | YES, but need tested LSDB for checking it | No, (need tested LSDB for adding it) |
62
75
76
+
# Visualization via BGP-LS
77
+
* Please check README of [IS-IS Watcher](https://github.com/Vadims06/isiswatcher) how to setup BGP-LS session.
63
78
64
79
### How to start
65
80
- run commands specifically to your vendor (from Supported vendors table) on a single device ( if you have multiple areas - do it on ABR) save all commands output in a single file with .txt or .log extension and upload the file to Topolograph
66
-
- upload programmatically via Rest API. Multi devices LSDBs are supported via API only (v2.34).
81
+
- upload programmatically via Rest API. Multi devices LSDBs are supported via API only (v2.34).
82
+
- get topology via [OSPF Watcher](https://github.com/Vadims06/ospfwatcher) or [IS-IS Watcher](https://github.com/Vadims06/isiswatcher)
67
83
68
84
### Expected file's extension
69
85
- .txt
@@ -73,7 +89,8 @@ LSA 1 and LSA 2 is mandatory and have to exist in the same file. LSA 5 is option
73
89
**YouTube**
74
90
* OSPF Watcher. Real time Monitoring with instant notification. https://youtu.be/2IHbxmDVMA0
75
91
* IS-IS Watcher. Track the whole IS-IS domain from a single router https://youtu.be/7ZQFSe1szk8
76
-
* OSPF/IS-IS AI Agent: MCP for Network Protocols, https://youtu.be/92YBRXqZWUo
92
+
* OSPF/IS-IS AI Agent: MCP for Network Protocols, https://youtu.be/92YBRXqZWUo
93
+
* BGP-LS in Action: Monitoring IS-IS networks via IS-IS Watcher and Topolograph, https://youtu.be/gL0iqXgPJlE
77
94
78
95
## Upload OSPF LSDB to the Topolograph and Building the shortest paths
79
96
This demo shows how to get OSPF topology visual and interact with it.
0 commit comments