notification
Subscribe to real-time GNS3 event notifications and read buffered events for node state changes, link updates, and log messages. Supports filtering by event type.
Instructions
Subscribe to GNS3 server event notifications and read buffered events.
GNS3 streams real-time events: node state changes, link updates, log messages, etc. This tool subscribes to the stream in background and buffers events for on-demand reading.
Actions: - subscribe: Start listening to notification stream (controller or project-level) - read: Read buffered events (supports diff/all/last modes with optional action filter) - unsubscribe: Stop listening and clear buffer - status: Check subscription status and buffer stats
Event types (action field): Controller: compute., project., template.*, log.error, log.warning, log.info, ping Project: node.created/updated/deleted, link.created/updated/deleted, drawing.created/updated/deleted, snapshot.restored, ping
Examples: # Subscribe to all events >>> notification(action="subscribe")
# Subscribe to specific project events
>>> notification(action="subscribe", project_id="abc-123")
# Read new events since last read
>>> notification(action="read")
# Read only node events
>>> notification(action="read", filter_action="node.")
# Read only log errors
>>> notification(action="read", filter_action="log.error")
# Check status
>>> notification(action="status")Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Read mode: 'diff' (new since last read, default), 'all' (entire buffer), 'last' (last N events) | diff |
| limit | No | Max events to return (default: 100) | |
| action | Yes | Action: 'subscribe' (start listening), 'read' (get events), 'unsubscribe' (stop), 'status' (check subscription) | |
| project_id | No | Project ID for project-level notifications. Omit for controller-level (all events). | |
| filter_action | No | Filter events by action prefix (e.g., 'node.updated', 'log.error', 'link.') |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |