Topology Maps

989 views
Skip to first unread message

Mouad Mimouni

unread,
Jan 2, 2018, 7:57:57 AM1/2/18
to NetBox
Hi,
How to use the "topology maps" function ? I looked at the netbox documentation but I did not understand how to do it
Thanks

Brian Candler

unread,
Jan 3, 2018, 4:51:46 AM1/3/18
to NetBox
To get started:

1. Go to "Admin" section (after logging in, click on the person icon on top right and select "Admin")
2. Click on "Topology maps"
3. Click on "Add topology map"
4. Enter name "everything"
5. In "device patterns" just enter a single dot (.)
6. Click "Save"
7. At top right click "View site" to get back to main Netbox page
8. On the front page, under "Global topology maps", click "everything"

This will draw a picture of all the devices you have, all on the same row, showing any configured interconnections you have between them.  It's not very useful like this.

You can improve it by:

1. Making separate topology maps which are specific to a site. These are visible under Organisation > Sites > (pick a site) at the bottom right-hand corner.
2. Dividing your topology map into rows. For example, in device patterns you can enter

rtr
sw
edge

The first row of the diagram will show devices with "rtr" in their name; the second row will show devices with "sw" in their name; and the third row will show devices with "edge" in their name.

Or a pattern like this:

gw
sw|modem
.

will show devices with "gw" in the first line, devices with "sw" or "modem" on the second line, and all other devices on the third line.

It's no replacement for drawing a proper network diagram I'm afraid.

Mouad Mimouni

unread,
Jan 3, 2018, 5:25:50 AM1/3/18
to NetBox
Hello,
Thank you for your help, so we can draw the interconnection between the different interfaces of each equipment in our architecture?

Brian Candler

unread,
Jan 3, 2018, 5:50:09 AM1/3/18
to NetBox
If you configure connections between device ports in Netbox, the topology graph will show them.

Mouad Mimouni

unread,
Jan 4, 2018, 3:10:39 AM1/4/18
to NetBox
Thank you for tour help :)))

Len Joubert

unread,
Jan 6, 2018, 9:22:55 AM1/6/18
to NetBox
Hi All, testing netbox and need some help with topology maps; can/how do I create a regex to display all the devices associated to a site to display on the topology map (other than regex the names of the devices individually).
As there is no good naming convention currently for the devices at the spesific site, however all devices are obviously associated to the site.

thanks

Brian Candler

unread,
Jan 6, 2018, 6:09:46 PM1/6/18
to NetBox
The whole topology map can be limited to a single site: this is selected from a dropdown when you create the topology map.  If you do this, it will only show devices from that site.

Otherwise: you have to write regular expressions to match the device names (and if your naming convention doesn't include the site name in the device name, then yes this is very tedious).

Like I said: this feature is very limited and is not really not a replacement for a drawing tool.  You may be better off exporting the data (via SQL or API) and then generating input to graphviz yourself.
Reply all
Reply to author
Forward
0 new messages