get_interface_metrics
Pull interface metrics (bytes, errors, discards, utilization, status) for a device interface over a time window to assess port performance; resolves interface instance before returning datapoints.
Instructions
Pull interface-level metrics (in/out bytes, errors, discards, utilization, status) for a device's interface over a time window. Answers 'how is this port performing?' Resolves the Interface-family DataSource and the instance matching the interface name before fetching datapoints.
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": {
"device_id": "<device_id>",
"interface": "<interface>"
},
"name": "get_interface_metrics"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| metrics | No | Comma-separated datapoint names. Defaults to RxRate, TxRate, ErrorsIn, ErrorsOut, DiscardsIn, DiscardsOut, InterfaceStatus. | |
| device_id | Yes | Device ID | |
| interface | Yes | Interface name or substring (case-insensitive), e.g. 'Gi0/1', 'eth0' | |
| hours_back | No | Hours of history to pull (default: 1) |