get_collector_health
Check collector health to investigate outages: see whether collectors are down, downstream device counts, uptime, optional alert history, and recent status checks/events as evidence.
Instructions
Enriched collector status: whether each collector is down, downstream device count, uptime, and optional alert history. Leading indicator for site-level events. Prefer this over get_collectors when investigating potential outages. The collector asked for by collector_id, and each collector not known to be up, carries evidence: its latest status check and its five latest events.
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_collector_health"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| collector_id | No | Single collector ID. Other scope args are ignored if set. | |
| history_days | No | History lookback in days | |
| include_history | No | Include recent alerts on a device named for the collector's hostname. A collector with no such device returns an empty list, which does not show it stayed up. The API cannot narrow rows to CollectorDown; each row's alert_type names what it is. A failed read is null with history_warning, not an empty list. | |
| collector_group_id | No | Restrict to collectors in this group |