thruk_list_hosts
Retrieve a list of monitored hosts with optional filtering by state, hostgroup, custom variables, and more. Supports sorting and pagination to narrow down results.
Instructions
List monitored hosts.
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": "thruk_list_hosts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Sort order: a column name, optionally prefixed with '-' for descending (e.g. 'name', '-last_check'); comma-separate multiple keys. Defaults to 'name'. | name |
| limit | No | ||
| filter | No | Structured filter tree supporting AND/OR nesting. Two node types: leaf: {"type":"leaf", "field":"...", "op":"...", "value":...} group: {"type":"group", "operator":"and"|"or", "conditions":[...]} Available fields: address, custom_var, hostgroup, name, state Operators: eq, gte, in, lte, neq, regex Examples: # Hosts DOWN in HG_AGILE: {"type":"group","operator":"and","conditions":[ {"type":"leaf","field":"hostgroup","op":"eq","value":"HG_AGILE"}, {"type":"leaf","field":"state","op":"eq","value":"down"} ]} # Hosts in HG_AGILE OR with KERNEL=windows: {"type":"group","operator":"or","conditions":[ {"type":"leaf","field":"hostgroup","op":"eq","value":"HG_AGILE"}, {"type":"leaf","field":"custom_var","op":"eq","value":{"var":"KERNEL","val":"windows"}} ]} | |
| offset | No | ||
| columns | No | Comma-separated columns to return. Omit for a curated default set tuned for this tool; pass '' (empty string) to return all available columns. | |
| backends | No | Comma-separated backend names (sites). Omit for all backends. |