Skip to content

Osprey 1.0.0

Choose a tag to compare

@MichelW6667 MichelW6667 released this 18 Jul 11:30
· 7 commits to main since this release

Osprey 1.0.0. Network Topology Intelligence for OSPF, IS-IS, BGP, and MPLS — passive discovery, protocol-accurate modeling, simulation, time travel, and incident correlation in one pane of glass.

The 1.0 milestone. Every feature line is complete, every known issue triaged to a fix or an explicitly documented behavior, and the release was exercised end-to-end by a full operational dress rehearsal — twelve live drills covering failover, re-homing, MAC mobility, PE isolation, alerting, audit, and traffic — before this build was cut.

Highlights since 0.9.9

Paths across domains — the network as one fabric

  • Cross-domain path stitching: when source and destination live in different ASes (or different tenants), the path tool now draws the actual chain of IGP segments along the BGP AS path — per-segment costs, instance labels, and an honest confidence per segment. Reverse paths render even without BGP telemetry on the far side.
  • eBGP transitions carry their physical reality: the actual port pair from LLDP/CDP, session-address-to-port binding, shared switch fabrics between borders (named, with attachment ports), and route-server transits recovered from the RS's own RIB. Every claim is evidence-gated — ambiguity is stated, never guessed. Transitions are drawn on the canvas, so a multi-domain path no longer visually breaks at the border.
  • Administrative-distance correct, everywhere: path-to-prefix decisions now honor AD exactly as routers do — across protocols, for externals, and on dual-IGP devices — with the cheaper road-not-taken called out when protocols disagree.
  • Tenant-aware verdicts: querying across tenant boundaries yields a clear, honest diagnosis instead of a confusing partial path.

MPLS L2VPN — complete

  • VPWS wires and VPLS instances (introduced in 0.9.9) are now feature-complete: dual-driver support hardened with a strict parity gate between the standard PW-MIB and the pre-standard dialect real routers ship, signalling surfaced for every class (LDP / static / EVPN), and the full layer documented in the user guide.

Sharper diagnostics

  • Consistent-but-wrong timers are now visible: OSPF requires both ends of a link to agree on hello/dead — so a link-wide template mistake always agrees with itself and was structurally invisible to pairwise checks. The timer-consistency report now flags agreeing non-default pairs.
  • The LSDB browser is RFC-exact per area type: stub and NSSA areas are discovered as such from the router's own configuration, and protocol-impossible LSAs that some agents replicate into every area are filtered rather than displayed.

EVPN correctness

  • Member counts survive monitoring gaps: a MAC that ages out while the BGP telemetry session is down is reconciled the moment the reconnect dump completes — counts can no longer freeze at pre-outage values.
  • A dying BGP session now sweeps its EVPN state: losing a peer is an implicit withdrawal of everything it advertised; EVPN memberships now drop and the PE-lost symptom fires within seconds of a session death, matching what the prefix side always did.

Reliability

  • BGP sessions on routers that cannot export BMP are now discovered via SNMP, so session-level visibility no longer depends on telemetry support.
  • Fresh SNMP targets without pollable interfaces no longer count phantom failures and back themselves into a corner — discovery reaches them immediately.
  • OSPFv3 interface timers are now read from the correct MIB columns (previously every v3 interface showed a plausible-but-wrong 40/120).
  • Alert cooldowns survive service restarts, and L2 topology merging is hardened: neighbors resolve on chassis identity and globally-unique hostnames, eliminating phantom and duplicate entries.

Install

curl -LO https://github.com/wijnberg-net/osprey/releases/latest/download/osprey_amd64.deb
curl -LO https://github.com/wijnberg-net/osprey/releases/latest/download/SHA256SUMS
sha256sum -c SHA256SUMS
sudo apt install ./osprey_amd64.deb

Debian 12+, Ubuntu 24.04+ (bare metal, Proxmox LXC, or VM). PostgreSQL, NATS, and nginx are pulled in as dependencies; services start under systemd and a self-signed TLS certificate is generated on first install. Open https://your-server/ and log in with the admin account created during setup.

Free evaluation: all features, up to 32 devices, no time limit. Commercial licensing: sales@wijnberg.net.

Full documentation: https://www.wijnberg.net/osprey/docs