Topolograph · routing analysis for network operations

Your network, as its protocols see it

Topolograph builds a model of the network from what its routing protocols report. Each new source adds its own independent layer to that model. Everything else is computed on it: primary and backup paths, links with no backup, search over network elements (prefixes, MAC addresses and more), and link or node failures simulated before maintenance starts. Analysis works from a single LSDB snapshot; a collector adds the stream of changes, and an AI agent answers questions from the same data.

OSPF · OSPFv3 · IS-IS · BGP / EVPN · 18 vendors
NetworkOSPF / IS-IS routersTopolograph modelgraph, paths, failures · Self-hosted · OnlineT+4 sCollector eventswhat changed and when · OnlineWhat happened in 15 minutes?T+4 s: pe15 ↔ core110 down4 paths → 2 · check the logs?AI agentanswers from the same data · MCP

How Topolograph learns your network and works with it

1. Snapshot and analysis Self-hosted · Online

An LSDB snapshot becomes a network model

What does a single snapshot give you?

The output of show ip ospf database router from one router becomes a static snapshot of the network: 13 routers, 26 links. You work with it offline, without access to the routers: path calculation, search over network elements, maintenance planning. The diagram shows the pe15 → pe30 path: cost 41, four equal-cost paths.

A link failure on the model

Can a link or a device be taken out of service?

The core10 ↔ core30 link is switched off on the model: SPF is recalculated, traffic moves to core11 ↔ core31, the cost goes from 41 to 50, and there are still four paths. The real network is not touched.

2. Continuous monitoring Online

The collector as a network sensor

What is changing in the network right now?

The Topolograph collector (watcher) receives routing protocol updates and passes on events about topology changes. It joins the network in one of three ways: a plain IGP adjacency, an IGP adjacency over GRE, or BGP-LS; in the demo it is a GRE adjacency with rr1. When the pe15 ↔ core110 link goes down, both of its ends flood new Router LSAs, the update reaches the collector, and a timestamped event arrives in Topolograph. Of the four pe15 → pe30 paths, two remain.

Historical routing analytics

What did the network look like at the time of the incident?

The timeline replays the collector events: the pe14 → core110 metric, the pe15 ↔ core110 link going down and coming back, a new network on core31, a TE metric. The cursor then moves between T+3 s and T+5 s: four paths before the failure, two after it. The T0 snapshot and any later state can be compared.

3. Investigation with an AI agent Agent 1.0

The AI agent answers from the same data

What happened in the network in the last 15 minutes?

The engineer asks the question. The agent calls the Topolograph MCP server tools for events and failure calculation, and answers with a reference to the data. Agent 2.0 already diagnoses incidents with a runbook agreed in advance: on an engineer's request, or automatically when an event opens a ticket. Read-only access, authorization and the explicit runbook steps make the diagnosis safe and several times faster.

Structure and pathsChanges over timeNetwork AI Agent
GRE / BGP-LSCollectorwatcherTopolographmodel · events · historylayers: snapshot T0 · collector eventspe14pe15core110core111core13rr1rr2core10core11core30core31pe30pe31failureT0 snapshot+4 s+14 s+24 s+34 s
Engineer question and AI agent answer Agent 1.0 · available
The engineer asksWhat happened in the network in the last 15 minutes?
The Topolograph agent answers

Five changes in 15 minutes:

  • T+2 s pe14 → core110 metric: 10 → 14
  • T+4 s the pe15 ↔ core110 link went down; pe15 → pe30 paths: 4 → 2, both through core111, cost 41
  • T+14 s a new network 31.31.31.0/24 appeared on core31
  • T+24 s the pe15 ↔ core110 link came back; the paths are back to 4
  • T+34 s the core10 → core11 TE metric changed

The protocol data does not show why the link went down. Check the pe15 and core110 logs for the time of the incident? Agent 2.0

The same network is available in the interactive demoPaths, failures and events on a 13-router graph, no sign-up needed.
Open the interactive demoUpload your own LSDB

Questions Topolograph answers

  • Why did a prefix disappear?Comparing the graph at different moments shows when the prefix left the network.
    Self-hosted · OnlineOpen in the demo →
  • Can a link or a device be taken out of service?Simulating the failure on the graph shows where the traffic goes and which segments are left without a backup, before the work starts.
    Self-hosted · Online
  • Where will a new MPLS TE LSP with the required bandwidth go?CSPF over the TE attributes from the LSDB shows the LSP path for the requested bandwidth and how it behaves when a link fails.
    Self-hosted · OnlineOpen in the demo →
  • What changed before the incident?The collector event history and the graph at the time of the incident show what changed and in which order.
    Online
  • Where is the virtual machine with this MAC address now?An EVPN MAC lookup shows which VTEP or PE advertises it and which path the traffic takes to it.
    Online · BMPOpen in the demo →
  • The interface is up, so why is the adjacency not Full?The protocol shows that there is no adjacency, and Agent 2.0 checks the cause, for example MTU, with read-only commands from an approved runbook.
    Agent 2.0

Existing monitoring and Topolograph: complementing and extending network visibility

Zabbix, Prometheus and Cacti watch devices and interfaces. Topolograph shows how the network routes traffic and works alongside them.

Capability comparisonClassic monitoring and Topolograph across 6 criteriaShow the table
Classic monitoring Topolograph
Interface and device state✓The main task✕Outside the scope of Topolograph: the data stays in the existing monitoring
OSPF / BGP neighbor status~Through SNMP or exporters, device by device✓From the protocol, for the whole network at once (Online, collector)
Topology from the routing protocol~Needs integration or extra development✓From the LSDB or the collector (Self-hosted / Online)
SPF and ECMP paths~Needs separate development✓Built in (Self-hosted / Online)
What-if failures and links with no backup✕Usually not available✓Built in, on the model (Self-hosted / Online)
Routing changes over time~Logs and traps of single devices✓Events and the topology at the time of the event (Online)

Installation and connection options

Self-hosted (topolograph-docker) available

Topolograph runs in your infrastructure from topolograph-docker; LSDB snapshots and BGP topology from bmpwatcher stay under your control.

Network (LSDB snapshot)→Topolograph (self-hosted)

Online (topolograph.com) with a watcher in your network available

The watcher runs on a host in your network, is installed with one command from the UI, and sends topology changes to topolograph.com over an outbound HTTPS connection.

Network→Watcher
topolograph.com
Outbound HTTPS from the watcher host.

How to connect a watcher: three demo videos

A recording of a real connection to a router, from the install command to the first events in Topolograph. The videos are open to everyone; watchers run on topolograph.com (Online).

Demo videos3 minutes, from the install command to the first eventsOnlineTry on topolograph.com

Self-hosted and Online

Self-hosted: offline analysis of snapshots, free and in your own infrastructure. Online: watchers and event history on topolograph.com, free; events are kept for a limited time.

FeatureSelf-hosted (topolograph-docker)Online (topolograph.com)
LSDB upload, graph, path calculation, failure scenarios✅✅
API, SDK, MCP server✅✅
BGP and EVPN over BMP: peers, sessions, routescurrent state from bmpwatcher in Topology only mode; no eventswith change events
Watchers (OSPF / IS-IS)❌ (static topology from the LSDB only; demo graph)added from the UI and installed with one command
Network event history❌ (demo graph only)events are kept for a limited time

Re-uploading the LSDB through the API is also available in Self-hosted, but these are snapshots on demand, not a stream of watcher events.

Self-hosted

For an engineer

Understand your network in an evening: upload an LSDB and look at paths and failures.

Install
Online

For continuous monitoring

Watchers and event history for your domains, free on topolograph.com. Events are kept for a limited time.

Try on topolograph.com