Releases: Vadims06/topolograph
v2.63 (25.05.2026)
New Features
Watcher heartbeat and status card
OSPF Watcher and IS-IS Watcher now send periodic heartbeats to Topolograph. A new Watchers Status card on the monitoring page shows each connected watcher with its area/ASN and the time of last contact, auto-refreshed every 30 seconds.

Improvements
Monitoring page UI: Fixed layout.
Runtime upgrade
Python 3.11 → 3.12. Existing user passwords are transparently re-hashed on first login - no manual action required.
Fixes
- Fixed logout redirect error introduced in v2.62.
v2.62 (30.04.2026)
New Features
Multi-LSDB upload workflow
LSDB upload now supports both single-file and multi-file workflows in one screen, making bulk ingestion easier during onboarding and migration tasks.

Monitoring: broader event visibility
Monitoring now includes node-related events in addition to edge transitions, improving visibility during incident triage and change tracking.
Monitoring timeline and controls
Filter is added for the events in the Timeline. Fix max size of the Timeline to fit the screen size, better color-coded event markers.
Fixes
Monitoring panel behavior: Edge event panel layout and interactions were stabilized, and edge tooltip state now stays synchronized with timeline filtering.
Other Improved API stability and UI interfaces.
v2.61 (30.04.2026)
New Features
Multi-language support
The interface is available in English, Russian, Chinese, Portuguese, Spanish, and French, with French included alongside the earlier set.
Translations are maintained in topolograph-lang and shipped with the application as a submodule so language packs can move on their own cadence.
Fixes
Shortest-path lookup: Choosing a destination router in the shortest-path tool no longer shows invalid or empty choices when some router identifiers are missing from the current graph data.
v2.59 (28.03.2026)
v2.58 (08.03.2026)
Topolograph Release Notes v2.58
New Features
Traffic Engineering (TE) link attributes: Topolograph can now use TE data from your OSPF or IS-IS LSDB to show link-level traffic-engineering information on the diagram. You get visibility into link TE metric, administrative group (affinity), maximum and reservable bandwidth, and unreserved bandwidth per priority—useful for capacity planning, path analysis, and finding links that meet your TE constraints. When TE data is present, you can filter diagram links by TE metric or bandwidth from the UI and via the diagram edges API or the Topolograph SDK.

UI improvements:
- Graph background updated for better visibility
- Popup forms and compare form layout refined
- Edge tooltips: two-column layout and scroll for long attribute lists; bandwidth values formatted for readability
- Network Statistics text placement adjusted
- Network loading performance improved for large topologies
v2.57.2 (19.02.2025)
Improvements
- Build-in Napalm removed
- 'vector', 'fluentbit' exporters support is added
- Add network statistics and scoring system
- Watcher, new buttons: Pause, Enable Popups, Show Errors (show malformed BGP-LS messages)
Watch demo
v2.55 (09.01.2026)
Bug fix
- API shortest path calculation for IS-IS using either Node hostname or SystemID
v2.54 (16.12.2025)
Improvements
- BGP-LS is onboarded, #70
- Fix applied for Monitoring logs visualization
BGP-LS demo https://youtu.be/gL0iqXgPJlE
v2.53 (29.09.2025)
Topolograph v2.53.0 Release Notes
#69 Done
New Features
Admin Panel for users

Admin Panel base page

🔐 API Token Management
- Long-lived API tokens with optional expiry field
- API authentication now supports both basic auth and Bearer tokens
- Token authentication for all API endpoints
📊 Graph Sharing System
- Share graphs between users via email
- Permission levels (read/write/admin)
- Optional expiry dates for shared access
- Secure access control - only authorized users can access shared graphs
- User Portal integration for easy management

v2.52 (24.09.2025)
Topolograph Release Notes v2.51
New Features
🔍 Enhanced Network Query Capabilities
Universal Node Identification
- New Parameter: Added
node_idparameter to/api/network/{graph_time}endpoint - Universal Support: Works with both OSPF (Router ID) and IS-IS (System ID/LSP ID) protocols
- Query Mode: Find all networks terminated by a specific node
- Usage:
GET /api/network/{graph_time}?node_id=10.10.10.1
Relative Time Filtering for Events
- New Parameter: Added
last_minutesparameter to event endpoints - Endpoints Affected:
/api/events/{graph_time}/networks/api/events/{graph_time}/adjacency
- Functionality: Get events from the last X minutes instead of absolute time ranges
- Usage:
GET /api/events/{graph_time}/networks?last_minutes=30
📊 New Monitoring API Endpoints
Graph Status Analysis
- New Endpoint:
GET /api/graph/{graph_time}/status- Analyzes network graph health
- Returns connection status and event summaries
- Includes host up/down events and cost change events
Enhanced Event Retrieval
-
New Endpoint:
GET /api/events/{graph_time}/networks- Network-specific event monitoring
- Returns network up/down events and cost changes
-
New Endpoint:
GET /api/events/{graph_time}/adjacency- Link-specific event monitoring
- Returns host up/down events and cost changes
🔧 Enhanced Graph Filtering
Advanced Query Filters
- New Parameters for
GET /api/graph:protocol: Filter by OSPF or IS-ISarea: Filter by specific areawatcher_name: Filter by watcher instancelatest_only: Return only the latest graph per watcher
- Usage:
GET /api/graph?protocol=OSPF&area=0.0.0.0&latest_only=true
API Schema Changes
Updated Response Formats
Network Endpoint Response
- Enhanced Description: Updated to reflect multiple query modes
- New Query Modes:
- Get all networks (no parameters)
- Get specific network by network/mask
- Find networks by IP address
- Find all networks terminated by a specific node
Event Response Schema
- New Fields:
single_host_up_events: Array of host up events as structured objectssingle_host_down_events: Array of host down events as structured objectsadjacency_cost_change_events: Array of link cost change eventsnetwork_cost_change_events: Array of network cost change events
Error Handling Improvements
- Enhanced Error Responses: Added 404 responses for "No graphs found" scenarios
- Better Error Messages: More descriptive error messages for API consumers
Backward Compatibility
✅ Fully Backward Compatible: All existing API calls continue to work without changes
✅ Optional Parameters: All new parameters are optional with sensible defaults
✅ Existing Endpoints: No breaking changes to existing endpoint behavior
Usage Examples
Find Networks by Node ID
# Find all networks terminated by OSPF Router ID
GET /api/network/2024-01-15T10:30:00Z?node_id=10.10.10.1
# Find all networks terminated by IS-IS System ID
GET /api/network/2024-01-15T10:30:00Z?node_id=0100.1001.0001Get Recent Events
# Get network events from last 30 minutes
GET /api/events/2024-01-15T10:30:00Z/networks?last_minutes=30
# Get adjacency events from last 60 minutes
GET /api/events/2024-01-15T10:30:00Z/adjacency?last_minutes=60Filter Graphs
# Get latest OSPF graphs only
GET /api/graph?protocol=OSPF&latest_only=true
# Get graphs from specific watcher
GET /api/graph?watcher_name=production-watcher&area=0.0.0.0Monitor Graph Status
# Check graph health and connectivity
GET /api/graph/2024-01-15T10:30:00Z/statusTechnical Improvements
- Performance Optimization: Improved network lookup using direct RID-to-network mapping
- Cost Change Integration: Path calculations now use updated link costs from watcher events
- Enhanced Monitoring: Better event tracking and status reporting
- Schema Validation: Improved API response validation and error handling
For detailed API documentation, please refer to the Swagger UI at /api/docs



