get_device_sdwan_monitor
Read a device's live SD-WAN runtime status through FortiManager to see per-member link health, bandwidth, and SLA metrics. Use it to check uplink performance and find members breaching SLA targets.
Instructions
Read a device's LIVE SD-WAN Monitor status through the FortiManager proxy.
Unlike get_device_sdwan (which reads the device-DB SD-WAN config),
this proxies the device's live monitor API to return current SD-WAN
runtime state -- the data the FortiManager "SD-WAN Monitor" view shows:
per-member link status and up/down bandwidth (
virtual-wan/members)per-member SLA health for each health-check: latency, jitter, packet loss and which SLA targets are met (
virtual-wan/health-check)
Use it to answer "how are the uplinks doing right now / which member is breaching SLA", which the config read cannot answer.
Args: adom: ADOM name (defaults to DEFAULT_ADOM / "root" when omitted) device: Managed device name (e.g. "FGT-HQ"). Defaults to DEFAULT_DEVICE when omitted; required if that is not configured.
Returns: dict with keys: - adom, device - members: raw virtual-wan/members proxy response (None if it failed) - health_check: raw virtual-wan/health-check proxy response (None if it failed) - summary: condensed member links/bandwidth + per-member SLA - unverified: reads that failed while the other one worked; a failed read adds nothing to the summary - error / error_code: on failure, or when both reads failed
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_device_sdwan_monitor"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| adom | No | ||
| device | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||