get_events_timeline
Description: This tool returns node/host up/down events already grouped into chronological time waves (server-side), so you can narrate a network incident ("instability started at T from device X; a flapping burst from device Y; reconverged at T+n") without scanning hundreds of raw events. Waves hold adjacency up/down only: metric (cost) changes are not in them, so for "what happened" also call get_adjacency_events for the same window and report its cost changes with the waves. Events exist ONLY for watcher-monitored graphs (is_monitored=true); first call get_all_graphs(is_monitored=true, latest_only=true). Returns wave summaries only (no nested event arrays): to get a wave's individual events, call get_adjacency_events with that wave's start_ts/end_ts.
Input fields: graph_time (str): The graph time to filter events. start_time (str, optional): Start time in ISO format (e.g., 2025-06-30T20:00:00Z) end_time (str, optional): End time in ISO format. Defaults to current time if not provided. last_minutes (int, optional): Look back this many minutes; overrides start_time/end_time. page (int, optional): Page number (1-indexed) over the waves list. per_page (int, optional): Number of waves per page.
Output fields: EventsTimelineResponse: A dictionary with keys: - graph_time, watcher_name - gap_multiplier, median_gap_sec: how the grouping was computed - waves: list of per-wave summaries, each with wave_number, start_ts, end_ts (ISO 8601, reusable as start_time/end_time), duration_sec, event_count, distinct_devices, trigger_device, pattern ("outage" left down / "flap" down then up / "up" only ups), converged (recovery seen within the queried window; a recovery after end_time is not counted) - pagination: page, per_page, total, total_pages
Equivalent to GET /events/{graph_time}/adjacency/timeline.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"graph_time": "<graph_time>"
},
"name": "get_events_timeline"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| end_time | No | ||
| per_page | No | ||
| graph_time | Yes | ||
| start_time | No | ||
| last_minutes | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| waves | Yes | ||
| graph_time | Yes | ||
| pagination | Yes | ||
| watcher_name | Yes | ||
| gap_multiplier | Yes | ||
| median_gap_sec | Yes |